1

src/model/Note.java

@@ -23,7 +23,7 @@ import android.content.Context;
 import android.content.OperationApplicationException;
 import android.net.Uri;
 import android.os.RemoteException;
-import android.util.Log;
+import android.util.Log;//输出日志
 
 import net.micode.notes.data.Notes;
 import net.micode.notes.data.Notes.CallNote;
@@ -39,28 +39,28 @@ public class Note {
     private NoteData mNoteData;
     private static final String TAG = "Note";
     /**
-     * Create a new note id for adding a new note to databases
+     * 为数据库添加的新便签创建一个新ID
      */
     public static synchronized long getNewNoteId(Context context, long folderId) {
-        // Create a new note in the database
+        //在数据库中创建新便签
         ContentValues values = new ContentValues();
-        long createdTime = System.currentTimeMillis();
+        long createdTime = System.currentTimeMillis();//便签创建时间
-        values.put(NoteColumns.CREATED_DATE, createdTime);
+        values.put(NoteColumns.CREATED_DATE, createdTime);//创建时间
-        values.put(NoteColumns.MODIFIED_DATE, createdTime);
+        values.put(NoteColumns.MODIFIED_DATE, createdTime);//修改时间
-        values.put(NoteColumns.TYPE, Notes.TYPE_NOTE);
+        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 {
             noteId = Long.valueOf(uri.getPathSegments().get(1));
         } catch (NumberFormatException e) {
             Log.e(TAG, "Get note id error :" + e.toString());
             noteId = 0;
-        }
+        }//采用 try catch 语句来捕获输入便签ID异常并处理
         if (noteId == -1) {
-            throw new IllegalStateException("Wrong note id:" + noteId);
+            throw new IllegalStateException("Wrong note id:" + noteId);//非法状态警告："ID错误"
         }
         return noteId;
     }
@@ -68,7 +68,7 @@ public class Note {
     public Note() {
         mNoteDiffValues = new ContentValues();
         mNoteData = new NoteData();
-    }
+    }//定义两个变量来存储新便签数据，mNoteDiffValues：便签属性、mNoteData：便签数据
 
     public void setNoteValue(String key, String value) {
         mNoteDiffValues.put(key, value);