pi9s7qa6c
/
MiNotesPlusDemo
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

gtask注释

Browse Source
master
qw1ko 2 years ago
parent c2420de4b7
commit 4c70348c82
4 changed files with 54 additions and 111 deletions
Show Stats Download Patch File Download Diff File

38
Notes-master2/src/net/micode/notes/gtask/data/MetaData.java
Unescape View File

@ -1,19 +1,3 @@
/*
* Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package net.micode.notes.gtask.data;
import android.database.Cursor;
@ -27,36 +11,40 @@ import org.json.JSONObject;
public class MetaData extends Task {
private final static String TAG = MetaData.class.getSimpleName();
// 类的简写名称存入字符串TAG中，通过调用getSimpleName ()函数实现
private String mRelatedGid = null;
// 设置数据，即生成元数据库
public void setMeta(String gid, JSONObject metaInfo) {
try {
try { //将这对键值放入metaInfo这个jsonobject对象中
metaInfo.put(GTaskStringUtils.META_HEAD_GTASK_ID, gid);
} catch (JSONException e) {
} catch (JSONException e) { //输出错误信息
Log.e(TAG, "failed to put related gid");
}
setNotes(metaInfo.toString());
setName(GTaskStringUtils.META_NOTE_NAME);
//调用Task类中的setNotes ()和setName ()函数
}
public String getRelatedGid() {
//getRelatedGid函数定义
return mRelatedGid;
}
@Override
public boolean isWorthSaving() {
//isWorthSaving函数定义
return getNotes() != null;
}
@Override
public void setContentByRemoteJSON(JSONObject js) {
//定义setContentByRemoteJSON函数
super.setContentByRemoteJSON(js);
if (getNotes() != null) {
if (getNotes() != null) {//判断当前数据是否为空，若为空则返回真即值得保存
try {
JSONObject metaInfo = new JSONObject(getNotes().trim());
mRelatedGid = metaInfo.getString(GTaskStringUtils.META_HEAD_GTASK_ID);
} catch (JSONException e) {
//输出警告信息
Log.w(TAG, "failed to get related gid");
mRelatedGid = null;
}
@ -65,17 +53,19 @@ public class MetaData extends Task {
@Override
public void setContentByLocalJSON(JSONObject js) {
// this function should not be called
throw new IllegalAccessError("MetaData:setContentByLocalJSON should not be called");
//使用本地json数据对象设置元数据内容，一般不会用到，若用到，则抛出异常
throw new IllegalAccessError("MetaData:setContentByLocalJSON should not be called");//传递非法参数异常
}
@Override
public JSONObject getLocalJSONFromContent() {
//从元数据内容中获取本地json对象，一般不会用到，若用到，则抛出异常
throw new IllegalAccessError("MetaData:getLocalJSONFromContent should not be called");
}
@Override
public int getSyncAction(Cursor c) {
//获取同步动作状态，一般不会用到，若用到，则抛出异常
throw new IllegalAccessError("MetaData:getSyncAction should not be called");
}

40
Notes-master2/src/net/micode/notes/gtask/data/Node.java
Unescape View File

@ -1,51 +1,35 @@
/*
* Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package net.micode.notes.gtask.data;
import android.database.Cursor;
import org.json.JSONObject;
public abstract class Node {
public static final int SYNC_ACTION_NONE = 0;
public abstract class Node {//定义各种常量
public static final int SYNC_ACTION_NONE = 0;// 本地和云端都无可更新内容
public static final int SYNC_ACTION_ADD_REMOTE = 1;
public static final int SYNC_ACTION_ADD_REMOTE = 1;// 在远程云端增加内容
public static final int SYNC_ACTION_ADD_LOCAL = 2;
public static final int SYNC_ACTION_ADD_LOCAL = 2;// 在本地增加内容
public static final int SYNC_ACTION_DEL_REMOTE = 3;
public static final int SYNC_ACTION_DEL_REMOTE = 3;// 在远程云端删除内容
public static final int SYNC_ACTION_DEL_LOCAL = 4;
public static final int SYNC_ACTION_DEL_LOCAL = 4;// 在本地删除内容
public static final int SYNC_ACTION_UPDATE_REMOTE = 5;
public static final int SYNC_ACTION_UPDATE_REMOTE = 5;// 将本地内容更新到远程云端
public static final int SYNC_ACTION_UPDATE_LOCAL = 6;
public static final int SYNC_ACTION_UPDATE_LOCAL = 6;// 将远程云端内容更新到本地
public static final int SYNC_ACTION_UPDATE_CONFLICT = 7;
public static final int SYNC_ACTION_UPDATE_CONFLICT = 7;// 同步出现冲突
public static final int SYNC_ACTION_ERROR = 8;
public static final int SYNC_ACTION_ERROR = 8;// 同步出现错误
private String mGid;
private String mName;
private long mLastModified;
private long mLastModified;//记录最后一次修改时间
private boolean mDeleted;
private boolean mDeleted;//表征是否被删除
public Node() {
mGid = null;

41
Notes-master2/src/net/micode/notes/gtask/data/SqlData.java
Unescape View File

@ -1,19 +1,3 @@
/*
* Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package net.micode.notes.gtask.data;
import android.content.ContentResolver;
@ -37,14 +21,13 @@ import org.json.JSONObject;
public class SqlData {
private static final String TAG = SqlData.class.getSimpleName();
private static final int INVALID_ID = -99999;
//得到类的简写名称存入字符串TAG中，通过调用getSimpleName ()函数实现
private static final int INVALID_ID = -99999;//将mDataId初始值置为-99999
public static final String[] PROJECTION_DATA = new String[] {
DataColumns.ID, DataColumns.MIME_TYPE, DataColumns.CONTENT, DataColumns.DATA1,
DataColumns.DATA3
};
//以下五个变量作为sql表中5列的编号
public static final int DATA_ID_COLUMN = 0;
public static final int DATA_MIME_TYPE_COLUMN = 1;
@ -54,7 +37,8 @@ public class SqlData {
public static final int DATA_CONTENT_DATA_1_COLUMN = 3;
public static final int DATA_CONTENT_DATA_3_COLUMN = 4;
//定义以下八个变量
//构造函数，用于初始化数据
private ContentResolver mContentResolver;
private boolean mIsCreate;
@ -71,8 +55,8 @@ public class SqlData {
private ContentValues mDiffDataValues;
public SqlData(Context context) {
mContentResolver = context.getContentResolver();
public SqlData(Context context) { //判断是否直接用Content生成，是为true，否则为false
mContentResolver = context.getContentResolver();//mContentResolver用于获取ContentProvider提供的数据
mIsCreate = true;
mDataId = INVALID_ID;
mDataMimeType = DataConstants.NOTE;
@ -82,7 +66,7 @@ public class SqlData {
mDiffDataValues = new ContentValues();
}
public SqlData(Context context, Cursor c) {
public SqlData(Context context, Cursor c) { //判断是否直接用Content生成，是为true，否则为false
mContentResolver = context.getContentResolver();
mIsCreate = false;
loadFromCursor(c);
@ -98,8 +82,9 @@ public class SqlData {
}
public void setContent(JSONObject js) throws JSONException {
//如果传入的JSONObject对象中有DataColumns.ID这一项，则设置，否则设为INVALID_ID
long dataId = js.has(DataColumns.ID) ? js.getLong(DataColumns.ID) : INVALID_ID;
if (mIsCreate || mDataId != dataId) {
if (mIsCreate || mDataId != dataId) {
mDiffDataValues.put(DataColumns.ID, dataId);
}
mDataId = dataId;
@ -130,7 +115,7 @@ public class SqlData {
mDataContentData3 = dataContentData3;
}
public JSONObject getContent() throws JSONException {
public JSONObject getContent() throws JSONException {//创建JSONObject对象。并将相关数据放入其中，并返回
if (mIsCreate) {
Log.e(TAG, "it seems that we haven't created this in database yet");
return null;
@ -144,7 +129,7 @@ public class SqlData {
return js;
}
public void commit(long noteId, boolean validateVersion, long version) {
public void commit(long noteId, boolean validateVersion, long version) {//commit函数用于把当前造作所做的修改保存到数据库
if (mIsCreate) {
if (mDataId == INVALID_ID && mDiffDataValues.containsKey(DataColumns.ID)) {
@ -183,7 +168,7 @@ public class SqlData {
mIsCreate = false;
}
public long getId() {
public long getId() {//获取当前id
return mDataId;
}
}

46
Notes-master2/src/net/micode/notes/gtask/data/SqlNote.java
Unescape View File

@ -1,19 +1,3 @@
/*
* Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package net.micode.notes.gtask.data;
import android.appwidget.AppWidgetManager;
@ -41,8 +25,8 @@ import java.util.ArrayList;
public class SqlNote {
private static final String TAG = SqlNote.class.getSimpleName();
private static final int INVALID_ID = -99999;
private static final int INVALID_ID = -99999;//将其初始值-99999
// 集合了interface NoteColumns中所有SF常量（17个）
public static final String[] PROJECTION_NOTE = new String[] {
NoteColumns.ID, NoteColumns.ALERTED_DATE, NoteColumns.BG_COLOR_ID,
NoteColumns.CREATED_DATE, NoteColumns.HAS_ATTACHMENT, NoteColumns.MODIFIED_DATE,
@ -51,7 +35,7 @@ public class SqlNote {
NoteColumns.LOCAL_MODIFIED, NoteColumns.ORIGIN_PARENT_ID, NoteColumns.GTASK_ID,
NoteColumns.VERSION
};
//以下设置17个列的编号
public static final int ID_COLUMN = 0;
public static final int ALERTED_DATE_COLUMN = 1;
@ -85,7 +69,7 @@ public class SqlNote {
public static final int GTASK_ID_COLUMN = 15;
public static final int VERSION_COLUMN = 16;
//定义了17个内部的变量，其中12个可以由content中获得，5个需要初始化为0或者new
private Context mContext;
private ContentResolver mContentResolver;
@ -122,17 +106,17 @@ public class SqlNote {
private ArrayList<SqlData> mDataList;
public SqlNote(Context context) {
mContext = context;
public SqlNote(Context context) {//构造函数只有context，对所有的变量进行初始化
mContext = context;//变量赋值
mContentResolver = context.getContentResolver();
mIsCreate = true;
mIsCreate = true;//初始化
mId = INVALID_ID;
mAlertDate = 0;
mAlertDate = 0;//初始化
mBgColorId = ResourceParser.getDefaultBgId(context);
mCreatedDate = System.currentTimeMillis();
mCreatedDate = System.currentTimeMillis();//调用系统函数获得创建时间
mHasAttachment = 0;
mModifiedDate = System.currentTimeMillis();
mParentId = 0;
mModifiedDate = System.currentTimeMillis();//最后一次修改时间初始化为创建时间
mParentId = 0;//初始化
mSnippet = "";
mType = Notes.TYPE_NOTE;
mWidgetId = AppWidgetManager.INVALID_APPWIDGET_ID;
@ -143,7 +127,7 @@ public class SqlNote {
mDataList = new ArrayList<SqlData>();
}
public SqlNote(Context context, Cursor c) {
public SqlNote(Context context, Cursor c) {//构造函数有context和一个数据库的cursor，多数变量通过cursor指向的一条记录直接进行初始化
mContext = context;
mContentResolver = context.getContentResolver();
mIsCreate = false;
@ -153,8 +137,8 @@ public class SqlNote {
loadDataContent();
mDiffNoteValues = new ContentValues();
}
public SqlNote(Context context, long id) {
//SqlNote(Context context, long id)与SqlNote(Context context, long id)的实现方式基本相同
public SqlNote(Context context, long id) {//构造函数，对获取的id进行初始化
mContext = context;
mContentResolver = context.getContentResolver();
mIsCreate = false;
@ -166,7 +150,7 @@ public class SqlNote {
}
private void loadFromCursor(long id) {
private void loadFromCursor(long id) {//通过id获得对应的ContentResolver中的cursor
Cursor c = null;
try {
c = mContentResolver.query(Notes.CONTENT_NOTE_URI, PROJECTION_NOTE, "(_id=?)",

Write Preview
Loading…
Cancel
Save