Notes.java 注释

代码解读/MiNotes-master/app/src/main/java/net/micode/notes/data/Notes.java

@@ -1,25 +1,13 @@
-/*
- * 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.data;
 
+import android.content.ContentUris;
 import android.net.Uri;
+// Notes 类中定义了很多常量，这些常量大多是int型和string型
 public class Notes {
     public static final String AUTHORITY = "micode_notes";
     public static final String TAG = "Notes";
+
+    //以下三个常量对NoteColumns.TYPE的值进行设置时会用到
     public static final int TYPE_NOTE     = 0;
     public static final int TYPE_FOLDER   = 1;
     public static final int TYPE_SYSTEM   = 2;
@@ -35,12 +23,24 @@ public class Notes {
     public static final int ID_CALL_RECORD_FOLDER = -2;
     public static final int ID_TRASH_FOLER = -3;
 
-    public static final String INTENT_EXTRA_ALERT_DATE = "net.micode.notes.alert_date";
+    public static final String INTENT_EXTRA_ALERT_DATE =
-    public static final String INTENT_EXTRA_BACKGROUND_ID = "net.micode.notes.background_color_id";
+
-    public static final String INTENT_EXTRA_WIDGET_ID = "net.micode.notes.widget_id";
+            "net.micode.notes.alert_date";
-    public static final String INTENT_EXTRA_WIDGET_TYPE = "net.micode.notes.widget_type";
+    public static final String INTENT_EXTRA_BACKGROUND_ID =
-    public static final String INTENT_EXTRA_FOLDER_ID = "net.micode.notes.folder_id";
+
-    public static final String INTENT_EXTRA_CALL_DATE = "net.micode.notes.call_date";
+            "net.micode.notes.background_color_id";
+    public static final String INTENT_EXTRA_WIDGET_ID =
+
+            "net.micode.notes.widget_id";
+    public static final String INTENT_EXTRA_WIDGET_TYPE =
+
+            "net.micode.notes.widget_type";
+    public static final String INTENT_EXTRA_FOLDER_ID =
+
+            "net.micode.notes.folder_id";
+    public static final String INTENT_EXTRA_CALL_DATE =
+
+            "net.micode.notes.call_date";
 
     public static final int TYPE_WIDGET_INVALIDE      = -1;
     public static final int TYPE_WIDGET_2X            = 0;
@@ -54,13 +54,20 @@ public class Notes {
     /**
      * Uri to query all notes and folders
      */
-    public static final Uri CONTENT_NOTE_URI = Uri.parse("content://" + AUTHORITY + "/note");
+    public static final Uri CONTENT_NOTE_URI = Uri.parse("content://" +
+
+            AUTHORITY + "/note");//定义查询便签和文件夹的指针。
+
+//    public static final Uri my_URI = ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI , 10);
 
     /**
      * Uri to query data
      */
-    public static final Uri CONTENT_DATA_URI = Uri.parse("content://" + AUTHORITY + "/data");
+    public static final Uri CONTENT_DATA_URI = Uri.parse("content://" +
+
+            AUTHORITY + "/data");//定义查找数据的指针。
 
+    // 定义NoteColumns的常量,用于后面创建数据库的表头
     public interface NoteColumns {
         /**
          * The unique ID for a row
@@ -72,7 +79,7 @@ public class Notes {
          * The parent's id for note or folder
          * <P> Type: INTEGER (long) </P>
          */
-        public static final String PARENT_ID = "parent_id";
+        public static final String PARENT_ID = "parent_id";//为什么会有parent_id
 
         /**
          * Created data for note or folder
@@ -140,7 +147,7 @@ public class Notes {
          * The last sync id
          * <P> Type: INTEGER (long) </P>
          */
-        public static final String SYNC_ID = "sync_id";
+        public static final String SYNC_ID = "sync_id";//同步
 
         /**
          * Sign to indicate local modified or not
@@ -165,8 +172,9 @@ public class Notes {
          * <P> Type : INTEGER (long) </P>
          */
         public static final String VERSION = "version";
-    }
+    }//这些常量主要是定义便签的属性的。
 
+    // 定义DataColumns的常量,用于后面创建数据库的表头
     public interface DataColumns {
         /**
          * The unique ID for a row
@@ -206,41 +214,45 @@ public class Notes {
 
 
         /**
-         * Generic data column, the meaning is {@link #MIMETYPE} specific, used for
+         * Generic data column, the meaning is {@link #MIMETYPE} specific, 
+         used for
          * integer data type
          * <P> Type: INTEGER </P>
          */
         public static final String DATA1 = "data1";
 
         /**
-         * Generic data column, the meaning is {@link #MIMETYPE} specific, used for
+         * Generic data column, the meaning is {@link #MIMETYPE} specific, 
+         used for
          * integer data type
          * <P> Type: INTEGER </P>
          */
         public static final String DATA2 = "data2";
 
         /**
-         * Generic data column, the meaning is {@link #MIMETYPE} specific, used for
+         * Generic data column, the meaning is {@link #MIMETYPE} specific, 
+         used for
          * TEXT data type
          * <P> Type: TEXT </P>
          */
         public static final String DATA3 = "data3";
 
         /**
-         * Generic data column, the meaning is {@link #MIMETYPE} specific, used for
+         * Generic data column, the meaning is {@link #MIMETYPE} specific, 
+         used for
          * TEXT data type
          * <P> Type: TEXT </P>
          */
         public static final String DATA4 = "data4";
 
         /**
-         * Generic data column, the meaning is {@link #MIMETYPE} specific, used for
+         * Generic data column, the meaning is {@link #MIMETYPE} specific, 
+         used for
          * TEXT data type
          * <P> Type: TEXT </P>
          */
         public static final String DATA5 = "data5";
-    }
+    }//主要是定义存储便签内容数据的
-
     public static final class TextNote implements DataColumns {
         /**
          * Mode to indicate the text in check list mode or not
@@ -250,12 +262,18 @@ public class Notes {
 
         public static final int MODE_CHECK_LIST = 1;
 
-        public static final String CONTENT_TYPE = "vnd.android.cursor.dir/text_note";
+        public static final String CONTENT_TYPE =
 
-        public static final String CONTENT_ITEM_TYPE = "vnd.android.cursor.item/text_note";
+                "vnd.android.cursor.dir/text_note";
 
-        public static final Uri CONTENT_URI = Uri.parse("content://" + AUTHORITY + "/text_note");
+        public static final String CONTENT_ITEM_TYPE =
-    }
+
+                "vnd.android.cursor.item/text_note";
+
+        public static final Uri CONTENT_URI = Uri.parse("content://" +
+
+                AUTHORITY + "/text_note");
+    }//文本内容的数据结构
 
     public static final class CallNote implements DataColumns {
         /**
@@ -270,10 +288,16 @@ public class Notes {
          */
         public static final String PHONE_NUMBER = DATA3;
 
-        public static final String CONTENT_TYPE = "vnd.android.cursor.dir/call_note";
+        public static final String CONTENT_TYPE =
 
-        public static final String CONTENT_ITEM_TYPE = "vnd.android.cursor.item/call_note";
+                "vnd.android.cursor.dir/call_note";
 
-        public static final Uri CONTENT_URI = Uri.parse("content://" + AUTHORITY + "/call_note");
+        public static final String CONTENT_ITEM_TYPE =
-    }
+
+                "vnd.android.cursor.item/call_note";
+
+        public static final Uri CONTENT_URI = Uri.parse("content://" +
+
+                AUTHORITY + "/call_note");
+    }//电话内容的数据结构
 }