添加了对WorkingNote类的注释

app/src/main/java/net/micode/notes/model/Note.java

@@ -53,7 +53,9 @@ public class Note {
         values.put(NoteColumns.LOCAL_MODIFIED, 1);
         values.put(NoteColumns.PARENT_ID, folderId);
         Uri uri = context.getContentResolver().insert(Notes.CONTENT_NOTE_URI, values);
-
+        /**
+        ContentResolver()主要是实现外部应用对ContentProvider中的数据进行添加、删除、修改和查询操作
+         */
         long noteId = 0;
         try {
             noteId = Long.valueOf(uri.getPathSegments().get(1));
@@ -67,6 +69,9 @@ public class Note {
         return noteId;
     }
 
+    /**
+     用来存储便签的数据，一个是存储便签属性、一个是存储便签内容
+     */
     public Note() {
         mNoteDiffValues = new ContentValues();
         mNoteData = new NoteData();
@@ -81,18 +86,30 @@ public class Note {
     public void setTextData(String key, String value) {
         mNoteData.setTextData(key, value);
     }
+    /**
+     设置文本数据的ID
+     */
 
     public void setTextDataId(long id) {
         mNoteData.setTextDataId(id);
     }
+    /**
+     得到文本数据的ID
+     */
 
     public long getTextDataId() {
         return mNoteData.mTextDataId;
     }
+    /**
+     设置电话号码数据的ID
+     */
 
     public void setCallDataId(long id) {
         mNoteData.setCallDataId(id);
     }
+    /**
+     得到电话号码数据的ID
+     */
 
     public void setCallData(String key, String value) {
         mNoteData.setCallData(key, value);
@@ -132,6 +149,9 @@ public class Note {
         return true;
     }
 
+    /**
+     * 定义一个基本的便签内容的数据类，主要包含文本数据和电话号码数据
+     */
     private class NoteData {
         private long mTextDataId;
 
@@ -187,6 +207,9 @@ public class Note {
             if (noteId <= 0) {
                 throw new IllegalArgumentException("Wrong note id:" + noteId);
             }
+            /**
+             * 判断数据是否合法
+             */
 
             ArrayList<ContentProviderOperation> operationList = new ArrayList<ContentProviderOperation>();
             ContentProviderOperation.Builder builder = null;
@@ -212,6 +235,9 @@ public class Note {
                 }
                 mTextDataValues.clear();
             }
+            /**
+             * 把文本数据存入DataColumns
+             */
 
             if (mCallDataValues.size() > 0) {
                 mCallDataValues.put(DataColumns.NOTE_ID, noteId);

app/src/main/java/net/micode/notes/model/WorkingNote.java

@@ -62,6 +62,9 @@ public class WorkingNote {
 
     private NoteSettingChangedListener mNoteSettingStatusListener;
 
+    /**
+     * 声明 DATA_PROJECTION字符串数组
+     */
     public static final String[] DATA_PROJECTION = new String[]{
             DataColumns.ID,
             DataColumns.CONTENT,
@@ -102,6 +105,10 @@ public class WorkingNote {
     private static final int NOTE_MODIFIED_DATE_COLUMN = 5;
 
     // New note construct
+
+    /**
+     * WorkingNote的构造函数
+     * */
     private WorkingNote(Context context, long folderId) {
         mContext = context;
         mAlertDate = 0;
@@ -124,6 +131,9 @@ public class WorkingNote {
         loadNote();
     }
 
+    /**
+     * 通过数据库调用query函数找到第一个条目
+     */
     private void loadNote() {
         Cursor cursor = mContext.getContentResolver().query(
                 ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, mNoteId), NOTE_PROJECTION, null,
@@ -151,7 +161,9 @@ public class WorkingNote {
                 DataColumns.NOTE_ID + "=?", new String[]{
                         String.valueOf(mNoteId)
                 }, null);
-
+/**
+ * 查看第一项是否存在
+ */
         if (cursor != null) {
             if (cursor.moveToFirst()) {
                 do {
@@ -174,6 +186,9 @@ public class WorkingNote {
         }
     }
 
+    /**
+     * 创建空的Note  传参：context，文件夹id，widget，背景颜色
+     */
     public static WorkingNote createEmptyNote(Context context, long folderId, int widgetId,
                                               int widgetType, int defaultBgColorId) {
         WorkingNote note = new WorkingNote(context, folderId);
@@ -229,6 +244,10 @@ public class WorkingNote {
         mNoteSettingStatusListener = l;
     }
 
+    /**
+     * 设置AlertDate
+     * 若 mAlertDate与data不同，则更改mAlertDate并设定NoteValue
+     */
     public void setAlertDate(long date, boolean set) {
         if (date != mAlertDate) {
             mAlertDate = date;
@@ -239,6 +258,9 @@ public class WorkingNote {
         }
     }
 
+    /**
+     * 设定删除标记
+     */
     public void markDeleted(boolean mark) {
         mIsDeleted = mark;
         if (mWidgetId != AppWidgetManager.INVALID_APPWIDGET_ID
@@ -247,6 +269,9 @@ public class WorkingNote {
         }
     }
 
+    /**
+     *设定背景颜色
+     */
     public void setBgColorId(int id) {
         if (id != mBgColorId) {
             mBgColorId = id;
@@ -257,6 +282,9 @@ public class WorkingNote {
         }
     }
 
+    /**
+     *设定检查列表模式
+     */
     public void setCheckListMode(int mode) {
         if (mMode != mode) {
             if (mNoteSettingStatusListener != null) {
@@ -267,6 +295,9 @@ public class WorkingNote {
         }
     }
 
+    /**
+     *设定WidgetType
+     */
     public void setWidgetType(int type) {
         if (type != mWidgetType) {
             mWidgetType = type;
@@ -274,6 +305,9 @@ public class WorkingNote {
         }
     }
 
+    /**
+     *设定WidgetId
+     */
     public void setWidgetId(int id) {
         if (id != mWidgetId) {
             mWidgetId = id;
@@ -281,6 +315,9 @@ public class WorkingNote {
         }
     }
 
+    /**
+     *设定setWorkingText
+     */
     public void setWorkingText(String text) {
         if (!TextUtils.equals(mContent, text)) {
             mContent = text;