Merge branch 'develop' of https://bdgit.educoder.net/m6wf5oeyl/MiNotes into wushuxian_branch

# Conflicts:
#	.gitignore
#	.idea/.gitignore
#	doc/小米便签的代码标注.docx
#	src/main/AndroidManifest.xml
#	src/main/java/net/micode/notes/data/Contact.java
#	src/main/java/net/micode/notes/data/Notes.java
#	src/main/java/net/micode/notes/data/NotesDatabaseHelper.java
#	src/main/java/net/micode/notes/data/NotesProvider.java
#	src/main/java/net/micode/notes/ui/AlarmAlertActivity.java
#	src/main/res/drawable-hdpi/edit_red.9.png

.gitignore

@@ -1,3 +1,3 @@
-/doc/~$模板-开源软件泛读、标注和维护报告文档 .docx
+/src/Notes/
-/src/Notes-master1/
+/src/.idea/
 /.idea/

.idea/.gitignore

@@ -1,3 +0,0 @@
-# Default ignored files
-/shelf/
-/workspace.xml

src/main/AndroidManifest.xml

@@ -17,8 +17,7 @@
 
 <!--- 定义应用程序的名称和版本号 -->
 <manifest xmlns:android="http://schemas.android.com/apk/res/android"
-    xmlns:tools="http://schemas.android.com/tools"
+    package="net.micode.notes"
-
     android:versionCode="1"
     android:versionName="0.1" >
 
@@ -52,15 +51,12 @@
         <!--- 应用程序的入口 NotesListActivity -->
         <activity
             android:name=".ui.NotesListActivity"
+            android:exported="true"
             android:configChanges="keyboardHidden|orientation|screenSize"
+            android:label="@string/app_name"
             android:launchMode="singleTop"
             android:theme="@style/NoteTheme"
-<<<<<<<< HEAD:src/main/AndroidManifest.xml
-            android:windowSoftInputMode="adjustPan"
-            android:exported="true">
-========
             android:windowSoftInputMode="adjustPan" >
->>>>>>>> b654a61 (code):src/Notes/app/src/main/AndroidManifest.xml
 
             <!--- 定义该 Activity 为启动器，即默认启动的 Activity -->
             <intent-filter>
@@ -74,19 +70,8 @@
             android:name=".ui.NoteEditActivity"
             android:configChanges="keyboardHidden|orientation|screenSize"
             android:launchMode="singleTop"
-            android:theme="@style/NoteTheme"
+            android:theme="@style/NoteTheme" >
-            android:exported="true">
-
-<<<<<<<< HEAD:src/main/AndroidManifest.xml
-            <intent-filter android:scheme="http"
-                tools:ignore="AppLinkUrlError">
-                <action android:name="android.intent.action.VIEW" />
-                <category android:name="android.intent.category.DEFAULT" />
-                <data android:mimeType="vnd.android.cursor.item/text_note" />
-                <data android:mimeType="vnd.android.cursor.item/call_note" />
-            </intent-filter>
 
-========
             <!--- 笔记编辑 Activity 的 Intent Filter，用于接收其他应用程序发送过来的消息 -->
             <intent-filter>
                 <action android:name="android.intent.action.VIEW" />
@@ -97,7 +82,6 @@
             </intent-filter>
 
             <!--- 笔记编辑 Activity 的 Intent Filter，用于接收其他应用程序发送过来的消息 -->
->>>>>>>> b654a61 (code):src/Notes/app/src/main/AndroidManifest.xml
             <intent-filter>
                 <action android:name="android.intent.action.INSERT_OR_EDIT" />
                 <category android:name="android.intent.category.DEFAULT" />
@@ -122,20 +106,14 @@
         <provider
             android:name="net.micode.notes.data.NotesProvider"
             android:authorities="micode_notes"
-            android:multiprocess="true"
+            android:multiprocess="true" />
-            android:exported="false" />
 
         <!--- 笔记小部件，支持两种大小 -->
         <receiver
             android:name=".widget.NoteWidgetProvider_2x"
-<<<<<<<< HEAD:src/main/AndroidManifest.xml
-            android:label="@string/app_widget2x2"
-            android:exported="true">
-========
             android:label="@string/app_widget2x2" >
 
             <!--- 笔记小部件的 Intent Filter，用于接收系统广播和小部件更新操作 -->
->>>>>>>> b654a61 (code):src/Notes/app/src/main/AndroidManifest.xml
             <intent-filter>
                 <action android:name="android.appwidget.action.APPWIDGET_UPDATE" />
                 <action android:name="android.appwidget.action.APPWIDGET_DELETED" />
@@ -149,8 +127,7 @@
         </receiver>
         <receiver
             android:name=".widget.NoteWidgetProvider_4x"
-            android:label="@string/app_widget4x4"
+            android:label="@string/app_widget4x4" >
-            android:exported="true">
 
             <!--- 笔记小部件的 Intent Filter，用于接收系统广播和小部件更新操作 -->
             <intent-filter>
@@ -165,13 +142,8 @@
                 android:resource="@xml/widget_4x_info" />
         </receiver>
 
-<<<<<<<< HEAD:src/main/AndroidManifest.xml
-        <receiver android:name=".ui.AlarmInitReceiver"
-            android:exported="true">
-========
         <!--- 启动时需要初始化闹钟服务 -->
         <receiver android:name=".ui.AlarmInitReceiver" >
->>>>>>>> b654a61 (code):src/Notes/app/src/main/AndroidManifest.xml
             <intent-filter>
                 <action android:name="android.intent.action.BOOT_COMPLETED" />
             </intent-filter>
@@ -186,6 +158,7 @@
         <!--- 闹钟提示 Activity -->
         <activity
             android:name=".ui.AlarmAlertActivity"
+            android:label="@string/app_name"
             android:launchMode="singleInstance"
             android:theme="@android:style/Theme.Holo.Wallpaper.NoTitleBar" >
         </activity>

src/main/java/net/micode/notes/data/Contact.java

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 
-package net.micode.notes.data;
+package net.micode.notes.data;//属于data这个包
 
 import android.content.Context;
 import android.database.Cursor;
@@ -28,60 +28,61 @@ import java.util.HashMap;
  * @Package:        net.micode.notes.data
  * @ClassName:      Contact
  * @Description:
-  * @Author:         WUSHUXIAN
+ * Contact类用于查询联系人信息并进行缓存。
-  * @CreateDate:     2023/12/20 23:26
+ * 该类包含一个静态的HashMap作为缓存，存储电话号码和对应的联系人名字。
+ * 通过调用getContact方法可以根据给定的电话号码查询联系人名字。
+ * 如果缓存中已经存在该电话号码对应的联系人名字，则直接返回缓存中的结果，否则通过查询数据库获取联系人名字并更新缓存。
+ * 该类还定义了一个私有的SQL筛选语句用于查询联系人信息。
+ * 注意：该类是线程不安全的，如果需要在多线程环境下使用，请做好同步控制
+ * @Author:         YangYizhe
+ * @CreateDate:     12/17/2023 10:10 AM
  * @Version:        1.0
  */
 public class Contact {
+    /**
+     * 作为缓存,存储电话号码和对应的联系人名字
+     */
     private static HashMap<String, String> sContactCache;
-    private static final String TAG = "Contact";
+    private static final String TAG = "Contact";//设置日志TAG标签
 
+    //查询联系人的SQL筛选语句
     private static final String CALLER_ID_SELECTION = "PHONE_NUMBERS_EQUAL(" + Phone.NUMBER
     + ",?) AND " + Data.MIMETYPE + "='" + Phone.CONTENT_ITEM_TYPE + "'"
     + " AND " + Data.RAW_CONTACT_ID + " IN "
             + "(SELECT raw_contact_id "
             + " FROM phone_lookup"
             + " WHERE min_match = '+')";
-     /**
+    //获取联系人
-      * @method          getContact
-      * @description:
-      * @date:           2023/12/21 19:18
-      * @author:         WuShuxian
-      * @param:          context
-      * @param:          phoneNumber
-      * @return:         String
-      */
     public static String getContact(Context context, String phoneNumber) {
-        //
+        if(sContactCache == null) {/*如果缓存为空，就新建一个*/
-        if(sContactCache == null) {
             sContactCache = new HashMap<String, String>();
         }
 
-        if(sContactCache.containsKey(phoneNumber)) {
+        if(sContactCache.containsKey(phoneNumber)) {/*如果缓存中已经有该电话号码对应的联系人名字，就直接返回*/
             return sContactCache.get(phoneNumber);
         }
 
         String selection = CALLER_ID_SELECTION.replace("+",
-                PhoneNumberUtils.toCallerIDMinMatch(phoneNumber));
+                PhoneNumberUtils.toCallerIDMinMatch(phoneNumber));//将电话号码转换为最小匹配模式，用于筛选
         Cursor cursor = context.getContentResolver().query(
                 Data.CONTENT_URI,
                 new String [] { Phone.DISPLAY_NAME },
-                selection,
+                selection,//使用筛选条件
                 new String[] { phoneNumber },
                 null);
 
-        if (cursor != null && cursor.moveToFirst()) {
+        if (cursor != null && cursor.moveToFirst()) {//如果找到了符合条件的联系人
             try {
-                String name = cursor.getString(0);
+                String name = cursor.getString(0);//获取联系人名字
-                sContactCache.put(phoneNumber, name);
+                sContactCache.put(phoneNumber, name);//将电话号码和联系人名字添加到缓存中
-                return name;
+                return name;//返回联系人名字
             } catch (IndexOutOfBoundsException e) {
                 Log.e(TAG, " Cursor get string error " + e.toString());
                 return null;
             } finally {
-                cursor.close();
+                cursor.close();//关闭游标
             }
-        } else {
+        } else {/*没找到*/
             Log.d(TAG, "No contact matched with number:" + phoneNumber);
             return null;
         }

src/main/java/net/micode/notes/data/Notes.java

@@ -17,17 +17,11 @@
 package net.micode.notes.data;
 
 import android.net.Uri;
-/**
+//Notes类就定义了很多常量，是小米便签的数据库
-  * @Package:        net.micode.notes.data
-  * @ClassName:      Notes
-  * @Description:
-  * @Author:         WuShuxian
-  * @CreateDate:     2023/12/21 19:32
-  * @Version:        1.0
- */
 public class Notes {
     public static final String AUTHORITY = "micode_notes";
     public static final String TAG = "Notes";
+    //三个type
     public static final int TYPE_NOTE     = 0;
     public static final int TYPE_FOLDER   = 1;
     public static final int TYPE_SYSTEM   = 2;
@@ -38,6 +32,7 @@ public class Notes {
      * {@link Notes#ID_TEMPARAY_FOLDER } is for notes belonging no folder
      * {@link Notes#ID_CALL_RECORD_FOLDER} is to store call records
      */
+    //不同种类的文件夹
     public static final int ID_ROOT_FOLDER = 0;
     public static final int ID_TEMPARAY_FOLDER = -1;
     public static final int ID_CALL_RECORD_FOLDER = -2;
@@ -53,12 +48,12 @@ public class Notes {
     public static final int TYPE_WIDGET_INVALIDE      = -1;
     public static final int TYPE_WIDGET_2X            = 0;
     public static final int TYPE_WIDGET_4X            = 1;
-
+    //数据常量 包括普通note和call_note
     public static class DataConstants {
         public static final String NOTE = TextNote.CONTENT_ITEM_TYPE;
         public static final String CALL_NOTE = CallNote.CONTENT_ITEM_TYPE;
     }
-
+    //两个指针，一个找便签和文件夹，一个用来找数据
     /**
      * Uri to query all notes and folders
      */
@@ -67,72 +62,201 @@ public class Notes {
     /**
      * 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
+         * <P> Type: INTEGER (long) </P>
+         */
         public static final String ID = "_id";
 
+        /**
+         * The parent's id for note or folder
+         * <P> Type: INTEGER (long) </P>
+         */
         public static final String PARENT_ID = "parent_id";
 
+        /**
+         * Created data for note or folder
+         * <P> Type: INTEGER (long) </P>
+         */
         public static final String CREATED_DATE = "created_date";
 
+        /**
+         * Latest modified date
+         * <P> Type: INTEGER (long) </P>
+         */
         public static final String MODIFIED_DATE = "modified_date";
 
+
+        /**
+         * Alert date
+         * <P> Type: INTEGER (long) </P>
+         */
         public static final String ALERTED_DATE = "alert_date";
 
+        /**
+         * Folder's name or text content of note
+         * <P> Type: TEXT </P>
+         */
         public static final String SNIPPET = "snippet";
 
+        /**
+         * Note's widget id
+         * <P> Type: INTEGER (long) </P>
+         */
         public static final String WIDGET_ID = "widget_id";
 
+        /**
+         * Note's widget type
+         * <P> Type: INTEGER (long) </P>
+         */
         public static final String WIDGET_TYPE = "widget_type";
 
+        /**
+         * Note's background color's id
+         * <P> Type: INTEGER (long) </P>
+         */
         public static final String BG_COLOR_ID = "bg_color_id";
 
+        /**
+         * For text note, it doesn't has attachment, for multi-media
+         * note, it has at least one attachment
+         * <P> Type: INTEGER </P>
+         */
         public static final String HAS_ATTACHMENT = "has_attachment";
 
+        /**
+         * Folder's count of notes
+         * <P> Type: INTEGER (long) </P>
+         */
         public static final String NOTES_COUNT = "notes_count";
 
+        /**
+         * The file type: folder or note
+         * <P> Type: INTEGER </P>
+         */
         public static final String TYPE = "type";
 
+        /**
+         * The last sync id
+         * <P> Type: INTEGER (long) </P>
+         */
         public static final String SYNC_ID = "sync_id";
 
+        /**
+         * Sign to indicate local modified or not
+         * <P> Type: INTEGER </P>
+         */
         public static final String LOCAL_MODIFIED = "local_modified";
 
+        /**
+         * Original parent id before moving into temporary folder
+         * <P> Type : INTEGER </P>
+         */
         public static final String ORIGIN_PARENT_ID = "origin_parent_id";
 
+        /**
+         * The gtask id
+         * <P> Type : TEXT </P>
+         */
         public static final String GTASK_ID = "gtask_id";
 
+        /**
+         * The version code
+         * <P> Type : INTEGER (long) </P>
+         */
         public static final String VERSION = "version";
-    }
 
-    public interface DataColumns {
+        public static final String PASSWORD = "password";
 
+        public static final String IMPORTANCE = "importance";
+    }//便签的各种属性
+    /*
+     * 便签数据在数据库中的表头
+     */
+    public interface DataColumns {
+        /**
+         * The unique ID for a row
+         * <P> Type: INTEGER (long) </P>
+         */
         public static final String ID = "_id";
 
+        /**
+         * The MIME type of the item represented by this row.
+         * <P> Type: Text </P>
+         */
         public static final String MIME_TYPE = "mime_type";
 
+        /**
+         * The reference id to note that this data belongs to
+         * <P> Type: INTEGER (long) </P>
+         */
         public static final String NOTE_ID = "note_id";
 
+        /**
+         * Created data for note or folder
+         * <P> Type: INTEGER (long) </P>
+         */
         public static final String CREATED_DATE = "created_date";
 
+        /**
+         * Latest modified date
+         * <P> Type: INTEGER (long) </P>
+         */
         public static final String MODIFIED_DATE = "modified_date";
 
+        /**
+         * Data's content
+         * <P> Type: TEXT </P>
+         */
         public static final String CONTENT = "content";
 
+
+        /**
+         * 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
+         * integer data type
+         * <P> Type: INTEGER </P>
+         */
         public static final String DATA2 = "data2";
 
+        /**
+         * 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
+         * TEXT data type
+         * <P> Type: TEXT </P>
+         */
         public static final String DATA4 = "data4";
 
+        /**
+         * 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
+         * <P> Type: Integer 1:check list mode 0: normal mode </P>
+         */
         public static final String MODE = DATA1;
 
         public static final int MODE_CHECK_LIST = 1;
@@ -142,12 +266,19 @@ public class Notes {
         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");
-    }
+    }//一种是文本textnote
 
     public static final class CallNote implements DataColumns {
-
+        /**
+         * Call date for this record
+         * <P> Type: INTEGER (long) </P>
+         */
         public static final String CALL_DATE = DATA1;
 
+        /**
+         * Phone number for this record
+         * <P> Type: TEXT </P>
+         */
         public static final String PHONE_NUMBER = DATA3;
 
         public static final String CONTENT_TYPE = "vnd.android.cursor.dir/call_note";
@@ -155,5 +286,5 @@ public class Notes {
         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");
-    }
+    }//另一种是通话类型的callnote
 }

src/main/java/net/micode/notes/data/NotesDatabaseHelper.java

@@ -16,31 +16,22 @@
 
 package net.micode.notes.data;
 
-import android.content.ContentValues;//就是用于保存一些数据（string boolean ...）信息，这些信息可以被数据库操作时使用。
+import android.content.ContentValues;
 import android.content.Context;
-import android.database.sqlite.SQLiteDatabase;//主要提供了对应于添加、删除、更新、查询的操作方法： insert()、delete()、update()和query()。配合content.values
+import android.database.sqlite.SQLiteDatabase;
-import android.database.sqlite.SQLiteOpenHelper;//用来管理数据的创建和版本更新
+import android.database.sqlite.SQLiteOpenHelper;
 import android.util.Log;
-
+//引用了同一个包中的另一个子包Notes中一些接口
 import net.micode.notes.data.Notes.DataColumns;
 import net.micode.notes.data.Notes.DataConstants;
 import net.micode.notes.data.Notes.NoteColumns;
 
-/**
+//数据库操作
-  * @Package:        net.micode.notes.data
-  * @ClassName:      NotesDatabaseHelper
-  * @Description:    便签数据库操作底层实现
-  * @Author:         WuShuxian
-  * @CreateDate:     2023/12/21 19:46
-  * @Version:        1.0
- */
 public class NotesDatabaseHelper extends SQLiteOpenHelper {
     private static final String DB_NAME = "note.db";
 
     private static final int DB_VERSION = 4;
-    /**
+    //接口两部分一个Note一个DATA
-    * 接口，创建数据库表头
-    */
     public interface TABLE {
         public static final String NOTE = "note";
 
@@ -50,9 +41,7 @@ public class NotesDatabaseHelper extends SQLiteOpenHelper {
     private static final String TAG = "NotesDatabaseHelper";
 
     private static NotesDatabaseHelper mInstance;
-    /**
+    //基于NoteColumn创建一个NOTE_TABLE表格，并附上初始数据
-    * 便签的属性数据库
-    */
     private static final String CREATE_NOTE_TABLE_SQL =
         "CREATE TABLE " + TABLE.NOTE + "(" +
             NoteColumns.ID + " INTEGER PRIMARY KEY," +
@@ -73,9 +62,7 @@ public class NotesDatabaseHelper extends SQLiteOpenHelper {
             NoteColumns.GTASK_ID + " TEXT NOT NULL DEFAULT ''," +
             NoteColumns.VERSION + " INTEGER NOT NULL DEFAULT 0" +
         ")";
-    /**
+    //主要基于datacolumn来创建DATA_TABLE
-    * 便签的内容数据库
-    */
     private static final String CREATE_DATA_TABLE_SQL =
         "CREATE TABLE " + TABLE.DATA + "(" +
             DataColumns.ID + " INTEGER PRIMARY KEY," +
@@ -90,13 +77,13 @@ public class NotesDatabaseHelper extends SQLiteOpenHelper {
             DataColumns.DATA4 + " TEXT NOT NULL DEFAULT ''," +
             DataColumns.DATA5 + " TEXT NOT NULL DEFAULT ''" +
         ")";
-
+    //这个数据是关于INDEX编号的
     private static final String CREATE_DATA_NOTE_ID_INDEX_SQL =
         "CREATE INDEX IF NOT EXISTS note_id_index ON " +
         TABLE.DATA + "(" + DataColumns.NOTE_ID + ");";
 
     /**
-     * 文件夹内移进便签时需要修改的数据
+     * Increase folder's note count when move note to the folder
      */
     private static final String NOTE_INCREASE_FOLDER_COUNT_ON_UPDATE_TRIGGER =
         "CREATE TRIGGER increase_folder_count_on_update "+
@@ -106,9 +93,9 @@ public class NotesDatabaseHelper extends SQLiteOpenHelper {
         "   SET " + NoteColumns.NOTES_COUNT + "=" + NoteColumns.NOTES_COUNT + " + 1" +
         "  WHERE " + NoteColumns.ID + "=new." + NoteColumns.PARENT_ID + ";" +
         " END";
-
+    //移入note时触发，修改一系列数据，从哪来之类的
     /**
-     * 便签移出文件夹时需要修改的数据
+     * Decrease folder's note count when move note from folder
      */
     private static final String NOTE_DECREASE_FOLDER_COUNT_ON_UPDATE_TRIGGER =
         "CREATE TRIGGER decrease_folder_count_on_update " +
@@ -119,9 +106,9 @@ public class NotesDatabaseHelper extends SQLiteOpenHelper {
         "  WHERE " + NoteColumns.ID + "=old." + NoteColumns.PARENT_ID +
         "  AND " + NoteColumns.NOTES_COUNT + ">0" + ";" +
         " END";
-
+    //移除Note时触发，与上面移入对应
     /**
-     * 插入（新建）便签时需要修改的数据
+     * Increase folder's note count when insert new note to the folder
      */
     private static final String NOTE_INCREASE_FOLDER_COUNT_ON_INSERT_TRIGGER =
         "CREATE TRIGGER increase_folder_count_on_insert " +
@@ -131,9 +118,9 @@ public class NotesDatabaseHelper extends SQLiteOpenHelper {
         "   SET " + NoteColumns.NOTES_COUNT + "=" + NoteColumns.NOTES_COUNT + " + 1" +
         "  WHERE " + NoteColumns.ID + "=new." + NoteColumns.PARENT_ID + ";" +
         " END";
-
+    //插入Note
     /**
-     * 删除便签时需要修改的数据
+     * Decrease folder's note count when delete note from the folder
      */
     private static final String NOTE_DECREASE_FOLDER_COUNT_ON_DELETE_TRIGGER =
         "CREATE TRIGGER decrease_folder_count_on_delete " +
@@ -144,7 +131,7 @@ public class NotesDatabaseHelper extends SQLiteOpenHelper {
         "  WHERE " + NoteColumns.ID + "=old." + NoteColumns.PARENT_ID +
         "  AND " + NoteColumns.NOTES_COUNT + ">0;" +
         " END";
-
+    //删除note
     /**
      * Update note's content when insert data with type {@link DataConstants#NOTE}
      */
@@ -157,7 +144,7 @@ public class NotesDatabaseHelper extends SQLiteOpenHelper {
         "   SET " + NoteColumns.SNIPPET + "=new." + DataColumns.CONTENT +
         "  WHERE " + NoteColumns.ID + "=new." + DataColumns.NOTE_ID + ";" +
         " END";
-
+    //当给note插入新数据时触发
     /**
      * Update note's content when data with {@link DataConstants#NOTE} type has changed
      */
@@ -169,7 +156,7 @@ public class NotesDatabaseHelper extends SQLiteOpenHelper {
         "  UPDATE " + TABLE.NOTE +
         "   SET " + NoteColumns.SNIPPET + "=new." + DataColumns.CONTENT +
         "  WHERE " + NoteColumns.ID + "=new." + DataColumns.NOTE_ID + ";" +
-        " END";
+        " END";//note数据被修改update
 
     /**
      * Update note's content when data with {@link DataConstants#NOTE} type has deleted
@@ -182,7 +169,7 @@ public class NotesDatabaseHelper extends SQLiteOpenHelper {
         "  UPDATE " + TABLE.NOTE +
         "   SET " + NoteColumns.SNIPPET + "=''" +
         "  WHERE " + NoteColumns.ID + "=old." + DataColumns.NOTE_ID + ";" +
-        " END";
+        " END";//更新已经删除的便签的数据
 
     /**
      * Delete datas belong to note which has been deleted
@@ -193,7 +180,7 @@ public class NotesDatabaseHelper extends SQLiteOpenHelper {
         " BEGIN" +
         "  DELETE FROM " + TABLE.DATA +
         "   WHERE " + DataColumns.NOTE_ID + "=old." + NoteColumns.ID + ";" +
-        " END";
+        " END";//删除 已经被删除的便签的数据
 
     /**
      * Delete notes belong to folder which has been deleted
@@ -204,7 +191,7 @@ public class NotesDatabaseHelper extends SQLiteOpenHelper {
         " BEGIN" +
         "  DELETE FROM " + TABLE.NOTE +
         "   WHERE " + NoteColumns.PARENT_ID + "=old." + NoteColumns.ID + ";" +
-        " END";
+        " END";//删除 已删除folder文件夹 中的便签要修改的数据
 
     /**
      * Move notes belong to folder which has been moved to trash folder
@@ -217,12 +204,12 @@ public class NotesDatabaseHelper extends SQLiteOpenHelper {
         "  UPDATE " + TABLE.NOTE +
         "   SET " + NoteColumns.PARENT_ID + "=" + Notes.ID_TRASH_FOLER +
         "  WHERE " + NoteColumns.PARENT_ID + "=old." + NoteColumns.ID + ";" +
-        " END";
+        " END";//移动trash_folder中的便签
 
     public NotesDatabaseHelper(Context context) {
         super(context, DB_NAME, null, DB_VERSION);
     }
-
+    //构造函数
     public void createNoteTable(SQLiteDatabase db) {
         db.execSQL(CREATE_NOTE_TABLE_SQL);
         reCreateNoteTableTriggers(db);
@@ -246,48 +233,49 @@ public class NotesDatabaseHelper extends SQLiteOpenHelper {
         db.execSQL(NOTE_INCREASE_FOLDER_COUNT_ON_INSERT_TRIGGER);
         db.execSQL(FOLDER_DELETE_NOTES_ON_DELETE_TRIGGER);
         db.execSQL(FOLDER_MOVE_NOTES_ON_TRASH_TRIGGER);
-    }
+    }//数据库操作的API，重新创建
-     /**
+
-      * @method          createSystemFolder
-      * @description:    创建系统缺省文件夹：通话记录、缺省根目录、临时文件夹、回收文件夹
-      * @date:           2023/12/21 20:19
-      * @author:         WuShuxian
-      * @param:          db
-      * @return:         void
-      */
     private void createSystemFolder(SQLiteDatabase db) {
         ContentValues values = new ContentValues();
 
-        //通话记录文件夹
+        /**
+         * call record foler for call notes
+         */
         values.put(NoteColumns.ID, Notes.ID_CALL_RECORD_FOLDER);
         values.put(NoteColumns.TYPE, Notes.TYPE_SYSTEM);
         db.insert(TABLE.NOTE, null, values);
 
-        //缺省根目录
+        /**
+         * root folder which is default folder
+         */
         values.clear();
         values.put(NoteColumns.ID, Notes.ID_ROOT_FOLDER);
         values.put(NoteColumns.TYPE, Notes.TYPE_SYSTEM);
         db.insert(TABLE.NOTE, null, values);
 
-        //临时文件夹
+        /**
+         * temporary folder which is used for moving note
+         */
         values.clear();
         values.put(NoteColumns.ID, Notes.ID_TEMPARAY_FOLDER);
         values.put(NoteColumns.TYPE, Notes.TYPE_SYSTEM);
         db.insert(TABLE.NOTE, null, values);
 
-        //回收站文件夹
+        /**
+         * create trash folder
+         */
         values.clear();
         values.put(NoteColumns.ID, Notes.ID_TRASH_FOLER);
         values.put(NoteColumns.TYPE, Notes.TYPE_SYSTEM);
         db.insert(TABLE.NOTE, null, values);
-    }
+    }//创建系统文件夹
 
     public void createDataTable(SQLiteDatabase db) {
         db.execSQL(CREATE_DATA_TABLE_SQL);
         reCreateDataTableTriggers(db);
         db.execSQL(CREATE_DATA_NOTE_ID_INDEX_SQL);
         Log.d(TAG, "data table has been created");
-    }
+    }//创建数据表格
 
     private void reCreateDataTableTriggers(SQLiteDatabase db) {
         db.execSQL("DROP TRIGGER IF EXISTS update_note_content_on_insert");
@@ -297,45 +285,38 @@ public class NotesDatabaseHelper extends SQLiteOpenHelper {
         db.execSQL(DATA_UPDATE_NOTE_CONTENT_ON_INSERT_TRIGGER);
         db.execSQL(DATA_UPDATE_NOTE_CONTENT_ON_UPDATE_TRIGGER);
         db.execSQL(DATA_UPDATE_NOTE_CONTENT_ON_DELETE_TRIGGER);
-    }
+    }//类似于recreatenotetable，重新创建触发器
 
     static synchronized NotesDatabaseHelper getInstance(Context context) {
         if (mInstance == null) {
             mInstance = new NotesDatabaseHelper(context);
         }
         return mInstance;
-    }
+    }//sync同步，同一时刻只有一个线程执行
 
     @Override
     public void onCreate(SQLiteDatabase db) {
-        createNoteTable(db);//属性数据库
+        createNoteTable(db);
-        createDataTable(db);//内容数据库
+        createDataTable(db);
-    }
+    }//创建Note Data两个表格
-     /**
+
-      * @method          onUpgrade
-      * @description:    便签版本更新？没有使用者判断不了
-      * @date:           2023/12/21 20:42
-      * @author:         WuShuxian
-      * @param:
-      * @return:
-      */
     @Override
     public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
         boolean reCreateTriggers = false;
         boolean skipV2 = false;
-        //V1->V2
+
         if (oldVersion == 1) {
             upgradeToV2(db);
             skipV2 = true; // this upgrade including the upgrade from v2 to v3
             oldVersion++;
         }
-        //V2->V3
+
         if (oldVersion == 2 && !skipV2) {
             upgradeToV3(db);
             reCreateTriggers = true;
             oldVersion++;
         }
-        //V3->V4
+
         if (oldVersion == 3) {
             upgradeToV4(db);
             oldVersion++;
@@ -350,19 +331,15 @@ public class NotesDatabaseHelper extends SQLiteOpenHelper {
             throw new IllegalStateException("Upgrade notes database to version " + newVersion
                     + "fails");
         }
-    }
+    }//数据库版本更新
-    /**
+
-    * 升级到V2，修改相应数据库
-    */
     private void upgradeToV2(SQLiteDatabase db) {
         db.execSQL("DROP TABLE IF EXISTS " + TABLE.NOTE);
         db.execSQL("DROP TABLE IF EXISTS " + TABLE.DATA);
         createNoteTable(db);
         createDataTable(db);
-    }
+    }//更新到V2
-    /**
+
-    * 升级到V3，修改相应数据库
-    */
     private void upgradeToV3(SQLiteDatabase db) {
         // drop unused triggers
         db.execSQL("DROP TRIGGER IF EXISTS update_note_modified_date_on_insert");
@@ -376,12 +353,10 @@ public class NotesDatabaseHelper extends SQLiteOpenHelper {
         values.put(NoteColumns.ID, Notes.ID_TRASH_FOLER);
         values.put(NoteColumns.TYPE, Notes.TYPE_SYSTEM);
         db.insert(TABLE.NOTE, null, values);
-    }
+    }//更新到V3
-    /**
+
-    * 升级到V4，修改相应数据库
-    */
     private void upgradeToV4(SQLiteDatabase db) {
         db.execSQL("ALTER TABLE " + TABLE.NOTE + " ADD COLUMN " + NoteColumns.VERSION
                 + " INTEGER NOT NULL DEFAULT 0");
-    }
+    }//更新到V4
 }

src/main/java/net/micode/notes/data/NotesProvider.java

@@ -1,22 +1,5 @@
-/*
- * 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.app.SearchManager;
 import android.content.ContentProvider;
 import android.content.ContentUris;
@@ -33,19 +16,15 @@ import net.micode.notes.R;
 import net.micode.notes.data.Notes.DataColumns;
 import net.micode.notes.data.Notes.NoteColumns;
 import net.micode.notes.data.NotesDatabaseHelper.TABLE;
-
+//为存储和获取数据提供接口。可以在不同的应用程序之间共享数据
-/**
+//ContentProvider提供的方法
-  * @Package:        net.micode.notes.data
+//query：查询
-  * @ClassName:      NotesProvider
+//insert：插入
-  * @Description:    为存储和获取数据提供接口。可以在不同的应用程序之间共享数据
+//update：更新
-  * @Author:         WuShuxian
+//delete：删除
-  * @CreateDate:     2023/12/21 20:50
+//getType：得到数据类型
-  * @Version:        1.0
- */
 public class NotesProvider extends ContentProvider {
-    /**
+    // UriMatcher用于匹配Uri
-    *  UriMatcher用于匹配Uri
-    */
     private static final UriMatcher mMatcher;
 
     private NotesDatabaseHelper mHelper;
@@ -61,7 +40,9 @@ public class NotesProvider extends ContentProvider {
     private static final int URI_SEARCH_SUGGEST  = 6;
 
     static {
+        // 创建UriMatcher时，调用UriMatcher(UriMatcher.NO_MATCH)表示不匹配任何路径的返回码
         mMatcher = new UriMatcher(UriMatcher.NO_MATCH);
+        // 把需要匹配Uri路径全部给注册上
         mMatcher.addURI(Notes.AUTHORITY, "note", URI_NOTE);
         mMatcher.addURI(Notes.AUTHORITY, "note/#", URI_NOTE_ITEM);
         mMatcher.addURI(Notes.AUTHORITY, "data", URI_DATA);
@@ -72,10 +53,10 @@ public class NotesProvider extends ContentProvider {
     }
 
     /**
-     * 搜索字段
      * x'0A' represents the '\n' character in sqlite. For title and content in the search result,
      * we will trim '\n' and white space in order to show more information.
      */
+    // 声明 NOTES_SEARCH_PROJECTION
     private static final String NOTES_SEARCH_PROJECTION = NoteColumns.ID + ","
             + NoteColumns.ID + " AS " + SearchManager.SUGGEST_COLUMN_INTENT_EXTRA_DATA + ","
             + "TRIM(REPLACE(" + NoteColumns.SNIPPET + ", x'0A','')) AS " + SearchManager.SUGGEST_COLUMN_TEXT_1 + ","
@@ -83,7 +64,7 @@ public class NotesProvider extends ContentProvider {
             + R.drawable.search_result + " AS " + SearchManager.SUGGEST_COLUMN_ICON_1 + ","
             + "'" + Intent.ACTION_VIEW + "' AS " + SearchManager.SUGGEST_COLUMN_INTENT_ACTION + ","
             + "'" + Notes.TextNote.CONTENT_TYPE + "' AS " + SearchManager.SUGGEST_COLUMN_INTENT_DATA;
-
+    // 声明NOTES_SNIPPET_SEARCH_QUERY
     private static String NOTES_SNIPPET_SEARCH_QUERY = "SELECT " + NOTES_SEARCH_PROJECTION
             + " FROM " + TABLE.NOTE
             + " WHERE " + NoteColumns.SNIPPET + " LIKE ?"
@@ -91,25 +72,24 @@ public class NotesProvider extends ContentProvider {
             + " AND " + NoteColumns.TYPE + "=" + Notes.TYPE_NOTE;
 
     @Override
+    // Context只有在onCreate()中才被初始化
+    // 对mHelper进行实例化
     public boolean onCreate() {
         mHelper = NotesDatabaseHelper.getInstance(getContext());
         return true;
     }
-    /**
+
-      * @Package:        net.micode.notes.data
-      * @ClassName:      NotesProvider
-      * @Description:    查询Uri在数据库中的位置
-      * @Author:         WuShuxian
-      * @CreateDate:     2023/12/21 21:06
-      * @Version:        1.0
-     */
     @Override
+    // 查询uri在数据库中对应的位置
     public Cursor query(Uri uri, String[] projection, String selection, String[] selectionArgs,
                         String sortOrder) {
         Cursor c = null;
-        SQLiteDatabase db = mHelper.getReadableDatabase();//读数据库
+        // 获取可读数据库
+        SQLiteDatabase db = mHelper.getReadableDatabase();
         String id = null;
+        // 匹配查找uri
         switch (mMatcher.match(uri)) {
+            // 对于不同的匹配值，在数据库中查找相应的条目
             case URI_NOTE:
                 c = db.query(TABLE.NOTE, projection, selection, selectionArgs, null, null,
                         sortOrder);
@@ -131,6 +111,7 @@ public class NotesProvider extends ContentProvider {
             case URI_SEARCH:
             case URI_SEARCH_SUGGEST:
                 if (sortOrder != null || projection != null) {
+                    // 不合法的参数异常
                     throw new IllegalArgumentException(
                             "do not specify sortOrder, selection, selectionArgs, or projection" + "with this query");
                 }
@@ -138,6 +119,8 @@ public class NotesProvider extends ContentProvider {
                 String searchString = null;
                 if (mMatcher.match(uri) == URI_SEARCH_SUGGEST) {
                     if (uri.getPathSegments().size() > 1) {
+                        // getPathSegments()方法得到一个String的List，
+                        // 在uri.getPathSegments().get(1)为第2个元素
                         searchString = uri.getPathSegments().get(1);
                     }
                 } else {
@@ -149,7 +132,7 @@ public class NotesProvider extends ContentProvider {
                 }
 
                 try {
-                    searchString = String.format("%%%s%%", searchString);//在新建便签并输入内容保存后会跳到这里，暂时不知道为什么
+                    searchString = String.format("%%%s%%", searchString);
                     c = db.rawQuery(NOTES_SNIPPET_SEARCH_QUERY,
                             new String[] { searchString });
                 } catch (IllegalStateException ex) {
@@ -157,6 +140,7 @@ public class NotesProvider extends ContentProvider {
                 }
                 break;
             default:
+                // 抛出异常
                 throw new IllegalArgumentException("Unknown URI " + uri);
         }
         if (c != null) {
@@ -165,22 +149,18 @@ public class NotesProvider extends ContentProvider {
         return c;
     }
 
-     /**
-      * @method          insert
-      * @description:    插入一个Uri，只有新建便签并保存后才会触发，修改内容不会触发
-      * @date:           2023/12/21 21:16
-      * @author:         WuShuxian
-      * @param:
-      * @return:
-      */
     @Override
+    // 插入一个uri
     public Uri insert(Uri uri, ContentValues values) {
+        // 获得可写的数据库
         SQLiteDatabase db = mHelper.getWritableDatabase();
         long dataId = 0, noteId = 0, insertedId = 0;
         switch (mMatcher.match(uri)) {
+            // 新增一个条目
             case URI_NOTE:
                 insertedId = noteId = db.insert(TABLE.NOTE, null, values);
                 break;
+            // 如果存在，查找NOTE_ID
             case URI_DATA:
                 if (values.containsKey(DataColumns.NOTE_ID)) {
                     noteId = values.getAsLong(DataColumns.NOTE_ID);
@@ -193,6 +173,7 @@ public class NotesProvider extends ContentProvider {
                 throw new IllegalArgumentException("Unknown URI " + uri);
         }
         // Notify the note uri
+        // notifyChange获得一个ContextResolver对象并且更新里面的内容
         if (noteId > 0) {
             getContext().getContentResolver().notifyChange(
                     ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, noteId), null);
@@ -204,20 +185,17 @@ public class NotesProvider extends ContentProvider {
                     ContentUris.withAppendedId(Notes.CONTENT_DATA_URI, dataId), null);
         }
 
+        // 返回插入的uri的路径
         return ContentUris.withAppendedId(uri, insertedId);
     }
-     /**
+
-      * @method          delete
-      * @description:    删除一个Uri，删除便签时会触发
-      * @date:           2023/12/21 21:17
-      * @author:         WuShuxian
-      * @param:
-      * @return:
-      */
     @Override
+    // 删除一个uri
     public int delete(Uri uri, String selection, String[] selectionArgs) {
+        //Uri代表要操作的数据，Android上可用的每种资源 -包括 图像、视频片段、音频资源等都可以用Uri来表示。
         int count = 0;
         String id = null;
+        // 获得可写的数据库
         SQLiteDatabase db = mHelper.getWritableDatabase();
         boolean deleteData = false;
         switch (mMatcher.match(uri)) {
@@ -226,7 +204,7 @@ public class NotesProvider extends ContentProvider {
                 count = db.delete(TABLE.NOTE, selection, selectionArgs);
                 break;
             case URI_NOTE_ITEM:
-                id = uri.getPathSegments().get(1);//修改便签内容时会触发，原因不明
+                id = uri.getPathSegments().get(1);
                 /**
                  * ID that smaller than 0 is system folder which is not allowed to
                  * trash
@@ -259,15 +237,9 @@ public class NotesProvider extends ContentProvider {
         }
         return count;
     }
-     /**
+
-      * @method          update
-      * @description:    更新Uri，修改便签时会触发。期间会跳到delete中执行，原因不明
-      * @date:           2023/12/21 21:19
-      * @author:         WuShuxian
-      * @param:
-      * @return:
-      */
     @Override
+    // 更新一个uri
     public int update(Uri uri, ContentValues values, String selection, String[] selectionArgs) {
         int count = 0;
         String id = null;
@@ -307,10 +279,12 @@ public class NotesProvider extends ContentProvider {
         return count;
     }
 
+    // 将字符串解析成规定格式
     private String parseSelection(String selection) {
         return (!TextUtils.isEmpty(selection) ? " AND (" + selection + ')' : "");
     }
 
+    //增加一个noteVersion
     private void increaseNoteVersion(long id, String selection, String[] selectionArgs) {
         StringBuilder sql = new StringBuilder(120);
         sql.append("UPDATE ");
@@ -333,6 +307,7 @@ public class NotesProvider extends ContentProvider {
             sql.append(selectString);
         }
 
+        // execSQL()方法可以执行insert、delete、update和CREATE TABLE之类有更改行为的SQL语句
         mHelper.getWritableDatabase().execSQL(sql.toString());
     }
 

src/main/java/net/micode/notes/ui/AlarmAlertActivity.java

@@ -46,23 +46,21 @@ public class AlarmAlertActivity extends Activity implements OnClickListener, OnD
     @Override
     protected void onCreate(Bundle savedInstanceState) {
         super.onCreate(savedInstanceState);
-        // 设置界面显示——无标题
+
-        requestWindowFeature(Window.FEATURE_NO_TITLE);
+        requestWindowFeature(Window.FEATURE_NO_TITLE);//设置界面显示——无标题
 
         final Window win = getWindow();
-        // 设置窗体属性——在锁屏时显示
+
-        win.addFlags(WindowManager.LayoutParams.FLAG_SHOW_WHEN_LOCKED);
+        win.addFlags(WindowManager.LayoutParams.FLAG_SHOW_WHEN_LOCKED);//设置窗体属性——在锁屏时显示
 
         if (!isScreenOn()) {
-            // 设置窗体属性——保持点亮、点亮屏幕、允许点亮时解锁
+            win.addFlags(WindowManager.LayoutParams.FLAG_KEEP_SCREEN_ON//保持点亮、点亮屏幕、允许点亮时解锁
-            win.addFlags(WindowManager.LayoutParams.FLAG_KEEP_SCREEN_ON
                     | WindowManager.LayoutParams.FLAG_TURN_SCREEN_ON
                     | WindowManager.LayoutParams.FLAG_ALLOW_LOCK_WHILE_SCREEN_ON
                     | WindowManager.LayoutParams.FLAG_LAYOUT_INSET_DECOR);
         }
 
-        // 获取传递的 Intent
+        Intent intent = getIntent();//获取传递的 Intent
-        Intent intent = getIntent();
 
         try {
             // 从 Intent 中获取数据并处理——获取标签 ID
@@ -80,24 +78,33 @@ public class AlarmAlertActivity extends Activity implements OnClickListener, OnD
 
         mPlayer = new MediaPlayer();
         if (DataUtils.visibleInNoteDatabase(getContentResolver(), mNoteId, Notes.TYPE_NOTE)) {
-            // 显示对话框
+            showActionDialog();// 显示对话框
-            showActionDialog();
+            playAlarmSound();// 播放闹钟提示音
-            // 播放闹钟提示音
-            playAlarmSound();
         } else {
-            // 结束当前 Activity
+            finish();// 结束当前 Activity
-            finish();
         }
     }
-
+    /**
+     * @method  isScreenOn
+     * @description
+     * 判断屏幕是否锁屏，调用系统函数判断，最后返回值是布尔类型
+     * @date: 12/23/2023 11:21 PM
+     * @author: YangYizhe
+     * @param
+     * @return
+     */
     private boolean isScreenOn() {
-        //判断屏幕是否锁屏，调用系统函数判断，最后返回值是布尔类型
         PowerManager pm = (PowerManager) getSystemService(Context.POWER_SERVICE);
         return pm.isScreenOn();
     }
-
+    /**
+     * @method  playAlarmSound
+     * @description
+     * 播放闹钟提示音
+     * @date: 12/23/2023 11:21 PM
+     * @author: YangYizhe
+     */
     private void playAlarmSound() {
-        //闹钟提示音激发
         Uri url = RingtoneManager.getActualDefaultRingtoneUri(this, RingtoneManager.TYPE_ALARM);
         //调用系统的铃声管理URI，得到闹钟提示音
         int silentModeStreams = Settings.System.getInt(getContentResolver(),
@@ -110,19 +117,12 @@ public class AlarmAlertActivity extends Activity implements OnClickListener, OnD
         }
         try {
             mPlayer.setDataSource(this, url);
-            //方法：setDataSource(Context context, Uri uri) 
-            //解释：无返回值，设置多媒体数据来源【根据 Uri】
             mPlayer.prepare();
-            //准备同步
+            mPlayer.setLooping(true);//设置是否循环播放
-            mPlayer.setLooping(true);
+            mPlayer.start();//开始播放
-            //设置是否循环播放
-            mPlayer.start();
-            //开始播放
         } catch (IllegalArgumentException e) {
             // TODO Auto-generated catch block
             e.printStackTrace();
-            //e.printStackTrace()函数功能是抛出异常， 还将显示出更深的调用信息
-            //System.out.println(e)，这个方法打印出异常，并且输出在哪里出现的异常
         } catch (SecurityException e) {
             // TODO Auto-generated catch block
             e.printStackTrace();
@@ -134,61 +134,67 @@ public class AlarmAlertActivity extends Activity implements OnClickListener, OnD
             e.printStackTrace();
         }
     }
-
+    /**
-    private void showActionDialog() {
+     * @method  showActionDialog
-        AlertDialog.Builder dialog = new AlertDialog.Builder(this);
+     * @description
-        /* AlertDialog的构造方法全部是Protected的
+     * AlertDialog的构造方法全部是Protected的
      * 所以不能直接通过new一个AlertDialog来创建出一个AlertDialog。
      * 要创建一个AlertDialog，就要用到AlertDialog.Builder中的create()方法
      * 如这里的dialog就是新建了一个AlertDialog
+     * @date: 12/23/2023 11:28 PM
+     * @author: YangYizhe
      */
-        dialog.setTitle(R.string.app_name);
+    private void showActionDialog() {
-        //为对话框设置标题
+        AlertDialog.Builder dialog = new AlertDialog.Builder(this);
-        dialog.setMessage(mSnippet);
+        dialog.setTitle(R.string.app_name);//为对话框设置标题
-        //为对话框设置内容
+        dialog.setMessage(mSnippet);//为对话框设置内容
-        dialog.setPositiveButton(R.string.notealert_ok, this);
+        dialog.setPositiveButton(R.string.notealert_ok, this);//给对话框添加"Yes"按钮
-        //给对话框添加"Yes"按钮
         if (isScreenOn()) {
-            dialog.setNegativeButton(R.string.notealert_enter, this);
+            dialog.setNegativeButton(R.string.notealert_enter, this);//对话框添加"No"按钮
-        }//对话框添加"No"按钮
+        }
         dialog.show().setOnDismissListener(this);
     }
-
+    /**
+     * @method  onClick
+     * @description 处理点击事件
+     * @date: 12/23/2023 11:27 PM
+     * @author: YangYizhe
+     * @param dialog
+     * @param which
+     */
     public void onClick(DialogInterface dialog, int which) {
-        switch (which) {
+        switch (which) {//用which来选择click后下一步的操作
-            //用which来选择click后下一步的操作
+            case DialogInterface.BUTTON_NEGATIVE://这是取消操作
-            case DialogInterface.BUTTON_NEGATIVE:
+                Intent intent = new Intent(this, NoteEditActivity.class);//实现两个类间的数据传输
-                //这是取消操作
+                intent.setAction(Intent.ACTION_VIEW);//设置动作属性
-                Intent intent = new Intent(this, NoteEditActivity.class);
+                intent.putExtra(Intent.EXTRA_UID, mNoteId);//实现key-value对     EXTRA_UID为key；mNoteId为键
-                //实现两个类间的数据传输
+                startActivity(intent);//开始动作
-                intent.setAction(Intent.ACTION_VIEW);
-                //设置动作属性
-                intent.putExtra(Intent.EXTRA_UID, mNoteId);
-                //实现key-value对
-                //EXTRA_UID为key；mNoteId为键
-                startActivity(intent);
-                //开始动作
                 break;
             default:
-                //这是确定操作
                 break;
         }
     }
-
+    /**
+     * @method  onDismiss
+     * @description 忽略
+     * @date: 12/23/2023 11:25 PM
+     * @author: YangYizhe
+     * @param dialog
+     */
     public void onDismiss(DialogInterface dialog) {
-        //忽略
+        stopAlarmSound();//停止闹钟声音
-        stopAlarmSound();
-        //停止闹钟声音
         finish();
-        //完成该动作
     }
-
+    /**
+     * @method  stopAlarmSound
+     * @description 停止闹钟的声音
+     * @date: 12/23/2023 11:26 PM
+     * @author: YangYizhe
+     */
     private void stopAlarmSound() {
         if (mPlayer != null) {
-            mPlayer.stop();
+            mPlayer.stop();//停止播放
-            //停止播放
+            mPlayer.release();//释放MediaPlayer对象
-            mPlayer.release();
-            //释放MediaPlayer对象
             mPlayer = null;
         }
     }