Update Note.java

java/net/micode/notes/model/Note.java

@@ -49,8 +49,10 @@ public class Note {
         values.put(NoteColumns.MODIFIED_DATE, createdTime);
         values.put(NoteColumns.TYPE, Notes.TYPE_NOTE);
         values.put(NoteColumns.LOCAL_MODIFIED, 1);
-        values.put(NoteColumns.PARENT_ID, folderId);
+        values.put(NoteColumns.PARENT_ID, folderId);//将数据写入数据库表格
         Uri uri = context.getContentResolver().insert(Notes.CONTENT_NOTE_URI, values);
+      //ContentResolver()主要是实现外部应用对ContentProvider中的数据
+        //进行添加、删除、修改和查询操作
 
         long noteId = 0;
         try {
@@ -65,38 +67,38 @@ public class Note {
         return noteId;
     }
 
-    public Note() {
+    public Note() {//定义两个变量用来存储便签的数据，一个是存储便签属性、一个是存储便签内容
         mNoteDiffValues = new ContentValues();
         mNoteData = new NoteData();
     }
 
-    public void setNoteValue(String key, String value) {
+    public void setNoteValue(String key, String value) {//设置数据库表格的标签属性数据
         mNoteDiffValues.put(key, value);
         mNoteDiffValues.put(NoteColumns.LOCAL_MODIFIED, 1);
         mNoteDiffValues.put(NoteColumns.MODIFIED_DATE, System.currentTimeMillis());
     }
 
-    public void setTextData(String key, String value) {
+    public void setTextData(String key, String value) {//设置数据库表格的标签文本内容的数据
         mNoteData.setTextData(key, value);
     }
 
-    public void setTextDataId(long id) {
+    public void setTextDataId(long id) {//设置文本数据的ID
         mNoteData.setTextDataId(id);
     }
 
-    public long getTextDataId() {
+    public long getTextDataId() {//得到文本数据的ID
         return mNoteData.mTextDataId;
     }
 
-    public void setCallDataId(long id) {
+    public void setCallDataId(long id) {//设置电话号码数据的ID
         mNoteData.setCallDataId(id);
     }
 
-    public void setCallData(String key, String value) {
+    public void setCallData(String key, String value) {//得到电话号码数据的ID
         mNoteData.setCallData(key, value);
     }
 
-    public boolean isLocalModified() {
+    public boolean isLocalModified() {//判断是否本地修改
         return mNoteDiffValues.size() > 0 || mNoteData.isLocalModified();
     }
 
@@ -130,6 +132,7 @@ public class Note {
         return true;
     }
 
+//定义一个基本的便签内容的数据类，主要包含文本数据和电话号码数据
     private class NoteData {
         private long mTextDataId;
 
@@ -177,7 +180,7 @@ public class Note {
             mNoteDiffValues.put(NoteColumns.LOCAL_MODIFIED, 1);
             mNoteDiffValues.put(NoteColumns.MODIFIED_DATE, System.currentTimeMillis());
         }
-
+//将新的数据通过Uri的操作存储到数据库
         Uri pushIntoContentResolver(Context context, long noteId) {
             /**
              * Check for safety
@@ -209,7 +212,7 @@ public class Note {
                     operationList.add(builder.build());
                 }
                 mTextDataValues.clear();
-            }
+            }//把文本数据存入DataColumns
 
             if(mCallDataValues.size() > 0) {
                 mCallDataValues.put(DataColumns.NOTE_ID, noteId);
@@ -231,7 +234,7 @@ public class Note {
                     operationList.add(builder.build());
                 }
                 mCallDataValues.clear();
-            }
+            }//把电话号码数据存入DataColumns
 
             if (operationList.size() > 0) {
                 try {
@@ -246,7 +249,7 @@ public class Note {
                     Log.e(TAG, String.format("%s: %s", e.toString(), e.getMessage()));
                     return null;
                 }
-            }
+            }//存储过程中的异常处理
             return null;
         }
     }