实现背景及切换

修改了
menu/note_list.xml
strings.xml
layout/note_list.xml
NoteListActivity.java

README.md

@@ -1,2 +0,0 @@
-# xiaomi_mini
-

src/main/java/net/micode/notes/gtask/exception/ActionFailureException.java

@@ -39,4 +39,3 @@ public class ActionFailureException extends RuntimeException {
         super(paramString, paramThrowable);
     }
 }
-

src/main/java/net/micode/notes/gtask/exception/NetworkFailureException.java

@@ -42,3 +42,4 @@ public class NetworkFailureException extends Exception {
         super(paramString, paramThrowable);
     }
 }
+

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

@@ -33,78 +33,102 @@ import net.micode.notes.data.Notes.TextNote;
 
 import java.util.ArrayList;
 
-
+/**
+ * @classname: Note
+ * @description:完成便签的创建以及便签后续的更新操作（设置属性值，完成数据同步）
+ * 允许批量执行操作，可以将便签放至内存存储器中
+ * @date: 2024/1/2 21:31
+ * @author: Xia Yanbo
+*/
 public class Note {
     private ContentValues mNoteDiffValues;
     private NoteData mNoteData;
     private static final String TAG = "Note";
     /**
      * Create a new note id for adding a new note to databases
+      * @classname: Note
+      * @description:创建或者修改一个新的便签
+      * @date: 2024/1/2 20:36
+      * @author: Xia Yanbo
+      * @param:context上下文
+      * @param:folderId 所属包的id
+      * @return:noteID新笔记记录的id
      */
-    public static synchronized long getNewNoteId(Context context, long folderId) {
+    public static synchronized long getNewNoteId(Context context, long folderId) {//控制类的所有实例的并发访问
         // Create a new note in the database
+        //初始化变量的信息
         ContentValues values = new ContentValues();
         long createdTime = System.currentTimeMillis();
-        values.put(NoteColumns.CREATED_DATE, createdTime);
-        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);
-        Uri uri = context.getContentResolver().insert(Notes.CONTENT_NOTE_URI, values);
+        values.put(NoteColumns.CREATED_DATE, createdTime);//创建时间
+        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);//所属包的id
+        Uri uri = context.getContentResolver().insert(Notes.CONTENT_NOTE_URI, values);//插入新的便签记录（标记）
 
         long noteId = 0;
         try {
-            noteId = Long.valueOf(uri.getPathSegments().get(1));
-        } catch (NumberFormatException e) {
+            noteId = Long.valueOf(uri.getPathSegments().get(1));//获取新笔记纪录的id
+        } catch (NumberFormatException e) {//获取失败报错
             Log.e(TAG, "Get note id error :" + e.toString());
             noteId = 0;
         }
+        //如果noteid为-1抛出id错误的信息
         if (noteId == -1) {
             throw new IllegalStateException("Wrong note id:" + noteId);
         }
         return noteId;
     }
-
+    //初始化定义两个变量用来存储便签的数据，一个是存储便签属性、一个是存储便签内容
     public Note() {
-        mNoteDiffValues = new ContentValues();
-        mNoteData = new NoteData();
+        mNoteDiffValues = new ContentValues();//便签属性
+        mNoteData = new NoteData();//便签内容
     }
-
+    //设置便签的属性
     public void setNoteValue(String key, String value) {
-        mNoteDiffValues.put(key, value);
-        mNoteDiffValues.put(NoteColumns.LOCAL_MODIFIED, 1);
-        mNoteDiffValues.put(NoteColumns.MODIFIED_DATE, System.currentTimeMillis());
+        mNoteDiffValues.put(key, value);//键值，id
+        mNoteDiffValues.put(NoteColumns.LOCAL_MODIFIED, 1);//本地编辑修改位
+        mNoteDiffValues.put(NoteColumns.MODIFIED_DATE, System.currentTimeMillis());//修改日期
     }
-
+    //设置文本数据（标记）
     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);
     }
-
+    //设置通话数据
     public void setCallData(String key, String value) {
         mNoteData.setCallData(key, value);
     }
-
+    //判断本地的文件有没有被修改
     public boolean isLocalModified() {
         return mNoteDiffValues.size() > 0 || mNoteData.isLocalModified();
     }
-
+    /**
+     * @classname: Note
+     * @methodname syncNote
+     * @description:同步便签
+     * @date: 2024/1/2 20:54
+     * @author: Xia Yanbo
+     * @param:context
+     * @param:noteid便签的id号
+     * @return:boolean返回更新是否正确完成
+    */
     public boolean syncNote(Context context, long noteId) {
         if (noteId <= 0) {
             throw new IllegalArgumentException("Wrong note id:" + noteId);
         }
-
+        //没有修改过则不需要更新
         if (!isLocalModified()) {
             return true;
         }
@@ -112,7 +136,7 @@ public class Note {
         /**
          * In theory, once data changed, the note should be updated on {@link NoteColumns#LOCAL_MODIFIED} and
          * {@link NoteColumns#MODIFIED_DATE}. For data safety, though update note fails, we also update the
-         * note data info
+         * note data info数据发生变化则更新数据（标记）
          */
         if (context.getContentResolver().update(
                 ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, noteId), mNoteDiffValues, null,
@@ -120,8 +144,8 @@ public class Note {
             Log.e(TAG, "Update note error, should not happen");
             // Do not return, fall through
         }
-        mNoteDiffValues.clear();
-
+        mNoteDiffValues.clear();//清除属性
+        //如果笔记在本地被修改过，并且推送至ContentResolver失败，则返回false
         if (mNoteData.isLocalModified()
                 && (mNoteData.pushIntoContentResolver(context, noteId) == null)) {
             return false;
@@ -131,86 +155,97 @@ public class Note {
     }
 
     private class NoteData {
-        private long mTextDataId;
+        private long mTextDataId;//文本数据的id
 
-        private ContentValues mTextDataValues;
+        private ContentValues mTextDataValues;//存储文本数据的键值对
 
-        private long mCallDataId;
+        private long mCallDataId;//通话数据的id
 
-        private ContentValues mCallDataValues;
-
-        private static final String TAG = "NoteData";
+        private ContentValues mCallDataValues;//存储通话数据
 
+        private static final String TAG = "NoteData";//记录标签，为日志记录打上标签。
+        //给新来的见证便签的键值以及id
         public NoteData() {
             mTextDataValues = new ContentValues();
             mCallDataValues = new ContentValues();
             mTextDataId = 0;
             mCallDataId = 0;
         }
-
+        //比较文本大小，确定是否被修改过
         boolean isLocalModified() {
             return mTextDataValues.size() > 0 || mCallDataValues.size() > 0;
         }
-
+        //设置文本数据的id
         void setTextDataId(long id) {
             if(id <= 0) {
                 throw new IllegalArgumentException("Text data id should larger than 0");
             }
             mTextDataId = id;
         }
-
+        //设置通话数据的id
         void setCallDataId(long id) {
             if (id <= 0) {
                 throw new IllegalArgumentException("Call data id should larger than 0");
             }
             mCallDataId = id;
         }
-
+        //设置通话数据的id
         void setCallData(String key, String value) {
             mCallDataValues.put(key, value);
             mNoteDiffValues.put(NoteColumns.LOCAL_MODIFIED, 1);
             mNoteDiffValues.put(NoteColumns.MODIFIED_DATE, System.currentTimeMillis());
         }
-
+        //设置文本数据
         void setTextData(String key, String value) {
             mTextDataValues.put(key, value);
             mNoteDiffValues.put(NoteColumns.LOCAL_MODIFIED, 1);
             mNoteDiffValues.put(NoteColumns.MODIFIED_DATE, System.currentTimeMillis());
         }
-
+        /**
+         * @classname: NoteData
+         * @methodname pushIntoContentResolver
+         * @description:将笔记中的内容放至内容存储器当中，执行所有待执行的动作
+         * @date: 2024/1/2 21:10
+         * @author: Xia Yanbo
+         * @param:noteId便签id
+         * @param:context存了文本的上下文
+         * @return:uri更新过数据后的标识符
+        */
         Uri pushIntoContentResolver(Context context, long noteId) {
             /**
              * Check for safety
              */
+            //检查笔记的id是否正确
             if (noteId <= 0) {
                 throw new IllegalArgumentException("Wrong note id:" + noteId);
             }
-
+            //创建行动列表
             ArrayList<ContentProviderOperation> operationList = new ArrayList<ContentProviderOperation>();
             ContentProviderOperation.Builder builder = null;
-
+            //如果文本数据不为空，进行更新操作
             if(mTextDataValues.size() > 0) {
                 mTextDataValues.put(DataColumns.NOTE_ID, noteId);
+                // 如果文本数据ID为0，说明是新插入的数据
                 if (mTextDataId == 0) {
                     mTextDataValues.put(DataColumns.MIME_TYPE, TextNote.CONTENT_ITEM_TYPE);
                     Uri uri = context.getContentResolver().insert(Notes.CONTENT_DATA_URI,
-                            mTextDataValues);
+                            mTextDataValues);//设置对应的关键键值，插入新的文本数据
                     try {
-                        setTextDataId(Long.valueOf(uri.getPathSegments().get(1)));
-                    } catch (NumberFormatException e) {
+                        setTextDataId(Long.valueOf(uri.getPathSegments().get(1)));//获取数据的id
+                    } catch (NumberFormatException e) {//获取失败打印错误信息
                         Log.e(TAG, "Insert new text data fail with noteId" + noteId);
                         mTextDataValues.clear();
                         return null;
                     }
-                } else {
+                } else {//创建一个更新操作，并设置更新的数据和条件
                     builder = ContentProviderOperation.newUpdate(ContentUris.withAppendedId(
                             Notes.CONTENT_DATA_URI, mTextDataId));
                     builder.withValues(mTextDataValues);
-                    operationList.add(builder.build());
+                    operationList.add(builder.build());//将更新操作添加到操作列表中
                 }
                 mTextDataValues.clear();
             }
-
+            //同理如果通信数据不为空，进行更新操作
             if(mCallDataValues.size() > 0) {
                 mCallDataValues.put(DataColumns.NOTE_ID, noteId);
                 if (mCallDataId == 0) {
@@ -232,19 +267,19 @@ public class Note {
                 }
                 mCallDataValues.clear();
             }
-
+            //行动列表非空
             if (operationList.size() > 0) {
-                try {
+                try { // 使用内容解析器（ContentResolver）的applyBatch方法来批量执行操作列表中的操作
                     ContentProviderResult[] results = context.getContentResolver().applyBatch(
                             Notes.AUTHORITY, operationList);
                     return (results == null || results.length == 0 || results[0] == null) ? null
-                            : ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, noteId);
+                            : ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, noteId);//返回操作完成后的结果
                 } catch (RemoteException e) {
                     Log.e(TAG, String.format("%s: %s", e.toString(), e.getMessage()));
                     return null;
                 } catch (OperationApplicationException e) {
                     Log.e(TAG, String.format("%s: %s", e.toString(), e.getMessage()));
-                    return null;
+                    return null;//报错反馈
                 }
             }
             return null;

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

@@ -31,37 +31,43 @@ import net.micode.notes.data.Notes.NoteColumns;
 import net.micode.notes.data.Notes.TextNote;
 import net.micode.notes.tool.ResourceParser.NoteBgResources;
 
-
+/**
+ * @classname: WorkingNote
+ * @description:活动中的便签类，是对正处于用户编辑等工作状态下的便签，可以对于便签做
+ * 更新组件，修改内容，设置提醒，背景颜色修改等在便签内进行文本编辑工作时可以进行的操作
+ * @date: 2024/1/4 11:03
+ * @author: Xia Yanbo
+*/
 public class WorkingNote {
     // Note for the working note
-    private Note mNote;
+    private Note mNote;//便签对象
     // Note Id
-    private long mNoteId;
+    private long mNoteId;//便签的id
     // Note content
-    private String mContent;
+    private String mContent;//内容字符串
     // Note mode
-    private int mMode;
+    private int mMode;//便签所处的模式（任务清单/普通）
 
-    private long mAlertDate;
+    private long mAlertDate;//提醒时间
 
-    private long mModifiedDate;
+    private long mModifiedDate;//修改日期
 
-    private int mBgColorId;
+    private int mBgColorId;//背景颜色
 
-    private int mWidgetId;
+    private int mWidgetId;//小插件的id号
 
-    private int mWidgetType;
+    private int mWidgetType;//小插件的类型
 
-    private long mFolderId;
+    private long mFolderId;//所属便签包的id号
 
-    private Context mContext;
+    private Context mContext;//便签的上下文
 
-    private static final String TAG = "WorkingNote";
+    private static final String TAG = "WorkingNote";//用于接收日志的标签
 
-    private boolean mIsDeleted;
-
-    private NoteSettingChangedListener mNoteSettingStatusListener;
+    private boolean mIsDeleted;//表示是否已经被删除
 
+    private NoteSettingChangedListener mNoteSettingStatusListener;//设置一个监听器，监听便签设置的改变
+    //定义数据的字段
     public static final String[] DATA_PROJECTION = new String[] {
             DataColumns.ID,
             DataColumns.CONTENT,
@@ -71,7 +77,7 @@ public class WorkingNote {
             DataColumns.DATA3,
             DataColumns.DATA4,
     };
-
+    //定义便签的字段
     public static final String[] NOTE_PROJECTION = new String[] {
             NoteColumns.PARENT_ID,
             NoteColumns.ALERTED_DATE,
@@ -80,7 +86,7 @@ public class WorkingNote {
             NoteColumns.WIDGET_TYPE,
             NoteColumns.MODIFIED_DATE
     };
-
+    //数据相关的参数
     private static final int DATA_ID_COLUMN = 0;
 
     private static final int DATA_CONTENT_COLUMN = 1;
@@ -88,7 +94,7 @@ public class WorkingNote {
     private static final int DATA_MIME_TYPE_COLUMN = 2;
 
     private static final int DATA_MODE_COLUMN = 3;
-
+    //便签相关的参数
     private static final int NOTE_PARENT_ID_COLUMN = 0;
 
     private static final int NOTE_ALERTED_DATE_COLUMN = 1;
@@ -102,19 +108,38 @@ public class WorkingNote {
     private static final int NOTE_MODIFIED_DATE_COLUMN = 5;
 
     // New note construct
+    /**
+     * @classname: WorkingNote
+     * @methodname WorkingNote
+     * @description:构造函数，构造一个新的便签，完成初始赋值
+     * @date: 2024/1/3 19:26
+     * @author: Xia Yanbo
+     * @param:context相关的文本
+     * @param:folderId所属包的id
+    */
     private WorkingNote(Context context, long folderId) {
         mContext = context;
         mAlertDate = 0;
         mModifiedDate = System.currentTimeMillis();
         mFolderId = folderId;
         mNote = new Note();
-        mNoteId = 0;
+        mNoteId = 0;//初始化笔记id为0
         mIsDeleted = false;
         mMode = 0;
         mWidgetType = Notes.TYPE_WIDGET_INVALIDE;
     }
 
     // Existing note construct
+    /**
+     * @classname: WorkingNote
+     * @methodname WorkingNote
+     * @description:从现有的笔记创建工作中的笔记（被使用）
+     * @date: 2024/1/3 21:33
+     * @author: Xia Yanbo
+     * @param:context上下文
+     * @param:noteId笔记的id号
+     * @param:folderId所属文件夹的id
+    */
     private WorkingNote(Context context, long noteId, long folderId) {
         mContext = context;
         mNoteId = noteId;
@@ -123,14 +148,23 @@ public class WorkingNote {
         mNote = new Note();
         loadNote();
     }
-
+    /**
+     * @classname: WorkingNote
+     * @methodname loadNote
+     * @description:加载/读取便签
+     * @date: 2024/1/3 21:34
+     * @author: Xia Yanbo
+    */
     private void loadNote() {
+        //查询数据库，获取与给定笔记id关联的笔记
         Cursor cursor = mContext.getContentResolver().query(
                 ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, mNoteId), NOTE_PROJECTION, null,
                 null, null);
 
         if (cursor != null) {
+            //如果cursor不为空，移动到结果集的第一行
             if (cursor.moveToFirst()) {
+                //从结果集获取各个属性值
                 mFolderId = cursor.getLong(NOTE_PARENT_ID_COLUMN);
                 mBgColorId = cursor.getInt(NOTE_BG_COLOR_ID_COLUMN);
                 mWidgetId = cursor.getInt(NOTE_WIDGET_ID_COLUMN);
@@ -139,33 +173,43 @@ public class WorkingNote {
                 mModifiedDate = cursor.getLong(NOTE_MODIFIED_DATE_COLUMN);
             }
             cursor.close();
-        } else {
+        } else {//如果找不到关联的笔记抛出异常
             Log.e(TAG, "No note with id:" + mNoteId);
             throw new IllegalArgumentException("Unable to find note with id " + mNoteId);
         }
+        // 调用loadNoteData方法，继续加载与笔记相关的其他数据（标记）
         loadNoteData();
     }
-
+    /**
+     * @classname: WorkingNote
+     * @methodname loadNoteData
+     * @description:将便签里的数据加载进去并存储
+     * @date: 2024/1/3 21:48
+     * @author: Xia Yanbo
+    */
     private void loadNoteData() {
+        //查询数据库，获取与给定笔记id关联的笔记
         Cursor cursor = mContext.getContentResolver().query(Notes.CONTENT_DATA_URI, DATA_PROJECTION,
                 DataColumns.NOTE_ID + "=?", new String[] {
                     String.valueOf(mNoteId)
                 }, null);
 
         if (cursor != null) {
+            //光标移动到查询结果的第一行
             if (cursor.moveToFirst()) {
                 do {
-                    String type = cursor.getString(DATA_MIME_TYPE_COLUMN);
+                    String type = cursor.getString(DATA_MIME_TYPE_COLUMN);//获取当前笔记的类型
+                    //如果笔记是普通的笔记，获取笔记内容、模式、id等参数完成赋值
                     if (DataConstants.NOTE.equals(type)) {
                         mContent = cursor.getString(DATA_CONTENT_COLUMN);
                         mMode = cursor.getInt(DATA_MODE_COLUMN);
                         mNote.setTextDataId(cursor.getLong(DATA_ID_COLUMN));
-                    } else if (DataConstants.CALL_NOTE.equals(type)) {
+                    } else if (DataConstants.CALL_NOTE.equals(type)) {//如果数据是通话数据，从数据行中直接获取数据id
                         mNote.setCallDataId(cursor.getLong(DATA_ID_COLUMN));
                     } else {
                         Log.d(TAG, "Wrong note type with type:" + type);
                     }
-                } while (cursor.moveToNext());
+                } while (cursor.moveToNext());//光标移动到下一行
             }
             cursor.close();
         } else {
@@ -173,7 +217,7 @@ public class WorkingNote {
             throw new IllegalArgumentException("Unable to find note's data with id " + mNoteId);
         }
     }
-
+    //创建一个空的便签，设置属性以及资源的id号等等信息
     public static WorkingNote createEmptyNote(Context context, long folderId, int widgetId,
             int widgetType, int defaultBgColorId) {
         WorkingNote note = new WorkingNote(context, folderId);
@@ -182,15 +226,17 @@ public class WorkingNote {
         note.setWidgetType(widgetType);
         return note;
     }
-
+    //读取便签的内容
     public static WorkingNote load(Context context, long id) {
         return new WorkingNote(context, id, 0);
     }
 
     public synchronized boolean saveNote() {
+        //检查笔记是否有保存的价值
         if (isWorthSaving()) {
             if (!existInDatabase()) {
-                if ((mNoteId = Note.getNewNoteId(mContext, mFolderId)) == 0) {
+                // 如果不在数据库里，根据包的id和上下文获取一个新的笔记ID，如果获取失败则返回false并记录日志
+                if ((mNoteId = Note.getNewNoteId(mContext, mFolderId)) == 0) {//获取失败返回的id是0
                     Log.e(TAG, "Create new note fail with id:" + mNoteId);
                     return false;
                 }
@@ -200,6 +246,7 @@ public class WorkingNote {
 
             /**
              * Update widget content if there exist any widget of this note
+             * 当组件发生变化时，对笔记设置状态的监听器进行更新？
              */
             if (mWidgetId != AppWidgetManager.INVALID_APPWIDGET_ID
                     && mWidgetType != Notes.TYPE_WIDGET_INVALIDE
@@ -211,12 +258,13 @@ public class WorkingNote {
             return false;
         }
     }
-
+    //检查是否位于数据库中
     public boolean existInDatabase() {
         return mNoteId > 0;
     }
-
+    //检查便签是否具有保存的价值
     private boolean isWorthSaving() {
+        //如果在数据库中已经存在而本地没有修改，或者便签已被删除了，或者便签为空，不值得保存
         if (mIsDeleted || (!existInDatabase() && TextUtils.isEmpty(mContent))
                 || (existInDatabase() && !mNote.isLocalModified())) {
             return false;
@@ -224,11 +272,11 @@ public class WorkingNote {
             return true;
         }
     }
-
+    //设置笔记设置状态的监听器为工作状态
     public void setOnSettingStatusChangedListener(NoteSettingChangedListener l) {
         mNoteSettingStatusListener = l;
     }
-
+    //设置提醒的日期
     public void setAlertDate(long date, boolean set) {
         if (date != mAlertDate) {
             mAlertDate = date;
@@ -238,7 +286,7 @@ public class WorkingNote {
             mNoteSettingStatusListener.onClockAlertChanged(date, set);
         }
     }
-
+    //删除标记值
     public void markDeleted(boolean mark) {
         mIsDeleted = mark;
         if (mWidgetId != AppWidgetManager.INVALID_APPWIDGET_ID
@@ -247,6 +295,7 @@ public class WorkingNote {
         }
     }
 
+    //设置背景的颜色id
     public void setBgColorId(int id) {
         if (id != mBgColorId) {
             mBgColorId = id;
@@ -256,9 +305,10 @@ public class WorkingNote {
             mNote.setNoteValue(NoteColumns.BG_COLOR_ID, String.valueOf(id));
         }
     }
-
+    //设置任务清单模式
     public void setCheckListMode(int mode) {
         if (mMode != mode) {
+            //进行任务清单模式必要组件的的设置
             if (mNoteSettingStatusListener != null) {
                 mNoteSettingStatusListener.onCheckListModeChanged(mMode, mode);
             }
@@ -266,7 +316,7 @@ public class WorkingNote {
             mNote.setTextData(TextNote.MODE, String.valueOf(mMode));
         }
     }
-
+    //设定组件相关的类型id等信息
     public void setWidgetType(int type) {
         if (type != mWidgetType) {
             mWidgetType = type;
@@ -280,24 +330,25 @@ public class WorkingNote {
             mNote.setNoteValue(NoteColumns.WIDGET_ID, String.valueOf(mWidgetId));
         }
     }
-
+    //设置当前工作便签的文本
     public void setWorkingText(String text) {
         if (!TextUtils.equals(mContent, text)) {
-            mContent = text;
+            mContent = text;//文本不一样时更新内容
             mNote.setTextData(DataColumns.CONTENT, mContent);
         }
     }
-
+    //将便签转化为通话便签
     public void convertToCallNote(String phoneNumber, long callDate) {
         mNote.setCallData(CallNote.CALL_DATE, String.valueOf(callDate));
         mNote.setCallData(CallNote.PHONE_NUMBER, phoneNumber);
         mNote.setNoteValue(NoteColumns.PARENT_ID, String.valueOf(Notes.ID_CALL_RECORD_FOLDER));
     }
-
+    //获取是否设置有提醒
     public boolean hasClockAlert() {
         return (mAlertDate > 0 ? true : false);
     }
 
+    //根据需要，返回对应的参数值
     public String getContent() {
         return mContent;
     }
@@ -341,7 +392,13 @@ public class WorkingNote {
     public int getWidgetType() {
         return mWidgetType;
     }
-
+    /**
+     * @classname: WorkingNote
+     * @description:接口，进行便签设置状态的监听，
+     * 并根据状态改变调用相应的背景颜色，任务清单模式，时间提醒，组件更新功能
+     * @date: 2024/1/4 9:22
+     * @author: Xia Yanbo
+    */
     public interface NoteSettingChangedListener {
         /**
          * Called when the background color of current note has just changed
@@ -355,6 +412,7 @@ public class WorkingNote {
 
         /**
          * Call when user create note from widget
+         * 实际完成的是更新控件并通知调用者的工作
          */
         void onWidgetChanged();
 

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

@@ -22,19 +22,34 @@ import android.app.AlertDialog;
 import android.app.PendingIntent;
 import android.app.SearchManager;
 import android.appwidget.AppWidgetManager;
+import android.content.ContentResolver;
 import android.content.ContentUris;
+import android.content.ContentValues;
 import android.content.Context;
 import android.content.DialogInterface;
 import android.content.Intent;
 import android.content.SharedPreferences;
+import android.database.Cursor;
+import android.graphics.Bitmap;
+import android.graphics.BitmapFactory;
+import android.graphics.Matrix;
 import android.graphics.Paint;
+import android.graphics.drawable.BitmapDrawable;
+import android.graphics.drawable.Drawable;
+import android.net.Uri;
+import android.os.Build;
 import android.os.Bundle;
+import android.os.Environment;
 import android.preference.PreferenceManager;
+import android.provider.DocumentsContract;
+import android.provider.MediaStore;
+import android.text.Editable;
 import android.text.Spannable;
 import android.text.SpannableString;
 import android.text.TextUtils;
 import android.text.format.DateUtils;
 import android.text.style.BackgroundColorSpan;
+import android.text.style.ImageSpan;
 import android.util.Log;
 import android.view.LayoutInflater;
 import android.view.Menu;
@@ -43,10 +58,12 @@ import android.view.MotionEvent;
 import android.view.View;
 import android.view.View.OnClickListener;
 import android.view.WindowManager;
+import android.widget.Button;
 import android.widget.CheckBox;
 import android.widget.CompoundButton;
 import android.widget.CompoundButton.OnCheckedChangeListener;
 import android.widget.EditText;
+import android.widget.ImageButton;
 import android.widget.ImageView;
 import android.widget.LinearLayout;
 import android.widget.TextView;
@@ -65,6 +82,7 @@ import net.micode.notes.ui.NoteEditText.OnTextViewChangeListener;
 import net.micode.notes.widget.NoteWidgetProvider_2x;
 import net.micode.notes.widget.NoteWidgetProvider_4x;
 
+import java.io.FileNotFoundException;
 import java.util.HashMap;
 import java.util.HashSet;
 import java.util.Map;
@@ -78,6 +96,7 @@ import java.util.regex.Pattern;
  * @date: 2023/12/27 0:08
  * @author: Xia Yanbo
 */
+
 public class NoteEditActivity extends Activity implements OnClickListener,
         NoteSettingChangedListener, OnTextViewChangeListener {
     //定义视图组件的基本数据（后面出现在了操作菜可选项里）
@@ -158,6 +177,7 @@ public class NoteEditActivity extends Activity implements OnClickListener,
     private String mUserQuery; // 用户输入的查询字符串
 
     private Pattern mPattern; // 用于匹配用户查询的正则表达式模式对象
+    private final int PHOTO_REQUEST = 1;//请求码
 
     /**
      * @classname: NoteEditActivity
@@ -177,8 +197,22 @@ public class NoteEditActivity extends Activity implements OnClickListener,
             return;
         }
         initResources();
-    }
 
+        //根据id获取添加图片的按钮
+        final ImageButton add_img_btn = (ImageButton) findViewById(R.id.add_img_btn);
+        //为点击图片按钮设置监听器
+        add_img_btn.setOnClickListener(new View.OnClickListener() {
+            @Override
+            public void onClick(View view) {
+                Log.d(TAG, "onClick add image button");
+                //允许用户插入特殊类型的数据
+                Intent loadImage = new Intent(Intent.ACTION_GET_CONTENT);
+                loadImage.addCategory(Intent.CATEGORY_OPENABLE);
+                loadImage.setType("image/*");
+                startActivityForResult(loadImage, PHOTO_REQUEST);
+            }
+        });
+    }
     /**
      * Current activity may be killed when the memory is low. Once it is killed, for another time
      * user load this activity, we should restore the former state
@@ -330,6 +364,8 @@ public class NoteEditActivity extends Activity implements OnClickListener,
          * TODO: Add the menu for setting alert. Currently disable it because the DateTimePicker
          * is not ready
          */
+        //插入之后初始化
+        convertToImage();
         showAlertHeader();
     }
     /**
@@ -604,6 +640,7 @@ public class NoteEditActivity extends Activity implements OnClickListener,
         } else {
             menu.findItem(R.id.menu_delete_remind).setVisible(false);
         }
+
         return true;
     }
     /**
@@ -652,6 +689,15 @@ public class NoteEditActivity extends Activity implements OnClickListener,
             mWorkingNote.setCheckListMode(mWorkingNote.getCheckListMode() == 0 ?
                     TextNote.MODE_CHECK_LIST : 0);
         }
+//        else if(item.getItemId()==  R.id.menu_secret)
+//        {
+//            mWorkingNote.setSecretMode();
+//
+//        }
+//        else if(item.getItemId()==  R.id.menu_quit_secret)
+//        {
+//            mWorkingNote.setSecretMode();
+//        }
         //分享
         else if(item.getItemId()==  R.id.menu_share)
         {
@@ -748,10 +794,6 @@ public class NoteEditActivity extends Activity implements OnClickListener,
      * @description:
      * @date: 2023/12/25 21:34
      * @author: Xia Yanbo
-     * @param:
-     * @param:
-     * @param:
-     * @return:
     */
     public void onClockAlertChanged(long date, boolean set) {
         /**
@@ -847,7 +889,7 @@ public class NoteEditActivity extends Activity implements OnClickListener,
         int index = 0;
         for (String item : items) {
             if(!TextUtils.isEmpty(item)) {
-                mEditTextList.addView(getListItem(item, index));//添加列表项（标记：实现的关键步骤addView）
+                mEditTextList.addView(getListItem(item, index));//添加列表项（标记：实现的关键步骤addView，getlistitem）
                 index++;
             }
         }
@@ -954,6 +996,7 @@ public class NoteEditActivity extends Activity implements OnClickListener,
             mNoteEditor.setText(getHighlightQueryResult(mWorkingNote.getContent(), mUserQuery));
             mEditTextList.setVisibility(View.GONE);
             mNoteEditor.setVisibility(View.VISIBLE);
+            convertToImage();
         }
     }
     /**
@@ -1052,4 +1095,174 @@ public class NoteEditActivity extends Activity implements OnClickListener,
     private void showToast(int resId, int duration) {
         Toast.makeText(this, resId, duration).show();
     }
+    //路径字符串格式 转换为 图片image格式
+    private void convertToImage() {
+        NoteEditText noteEditText = (NoteEditText) findViewById(R.id.note_edit_view); //获取当前的edit
+        Editable editable = noteEditText.getText();//1.获取text
+        String noteText = editable.toString(); //2.将note内容转换为字符串
+        int length = editable.length(); //内容的长度
+        //3.截取img片段 [local]+uri+[local]，提取uri
+        for(int i = 0; i < length; i++) {
+            for(int j = i; j < length; j++) {
+                String img_fragment = noteText.substring(i, j+1); //img_fragment：关于图片路径的片段
+                if(img_fragment.length() > 15 && img_fragment.endsWith("[/local]") && img_fragment.startsWith("[local]")){
+                    int limit = 7;  //[local]为7个字符
+                    //[local][/local]共15个字符，剩下的为真正的path长度
+                    int len = img_fragment.length()-15;
+                    //从[local]之后的len个字符就是path
+                    String path = img_fragment.substring(limit,limit+len);//获取到了图片路径
+                    Bitmap bitmap = null;
+                    Log.d(TAG, "图片的路径是："+path);
+                    try {
+                        bitmap = BitmapFactory.decodeFile(path);//将图片路径解码为图片格式
+                    } catch (Exception e) {
+                        e.printStackTrace();
+                    }
+                    if(bitmap!=null){  //若图片存在
+                        Log.d(TAG, "图片不为null");
+                        ImageSpan imageSpan = new ImageSpan(NoteEditActivity.this, bitmap);
+                        //4.创建一个SpannableString对象，以便插入用ImageSpan对象封装的图像
+                        String ss = "[local]" + path + "[/local]";
+                        SpannableString spannableString = new SpannableString(ss);
+                        //5.将指定的标记对象附加到文本的开始...结束范围
+                        spannableString.setSpan(imageSpan, 0, ss.length(), Spannable.SPAN_EXCLUSIVE_EXCLUSIVE);
+                        Log.d(TAG, "Create spannable string success!");
+                        Editable edit_text = noteEditText.getEditableText();
+                        edit_text.delete(i,i+len+15); //6.删掉图片路径的文字
+                        edit_text.insert(i, spannableString); //7.在路径的起始位置插入图片
+                    }
+                }
+            }
+        }
+    }
+
+    //重写onActivityResult()来处理返回的数据
+    protected void onActivityResult(int requestCode, int resultCode, Intent intent) {
+        super.onActivityResult(requestCode, resultCode, intent);
+        ContentResolver resolver = getContentResolver();
+        switch (requestCode) {
+            case PHOTO_REQUEST:
+                Uri originalUri = intent.getData(); //1.获得图片的真实路径
+                Bitmap bitmap = null;
+                try {
+                    bitmap = BitmapFactory.decodeStream(resolver.openInputStream(originalUri));//2.解码图片
+                } catch (FileNotFoundException e) {
+                    Log.d(TAG, "onActivityResult: get file_exception");
+                    e.printStackTrace();
+                }
+
+                if(bitmap != null){
+                    //3.根据Bitmap对象创建ImageSpan对象
+                    Log.d(TAG, "onActivityResult: bitmap is not null");
+                    ImageSpan imageSpan = new ImageSpan(NoteEditActivity.this, bitmap);
+                    String path = getPath(this,originalUri);
+                    //4.使用[local][/local]将path括起来，用于之后方便识别图片路径在note中的位置
+                    String img_fragment= "[local]" + path + "[/local]";
+                    //创建一个SpannableString对象，以便插入用ImageSpan对象封装的图像
+                    SpannableString spannableString = new SpannableString(img_fragment);
+                    spannableString.setSpan(imageSpan, 0, img_fragment.length(), Spannable.SPAN_EXCLUSIVE_EXCLUSIVE);
+                    //5.将选择的图片追加到EditText中光标所在位置
+                    NoteEditText e = (NoteEditText) findViewById(R.id.note_edit_view);
+                    int index = e.getSelectionStart(); //获取光标所在位置
+                    Log.d(TAG, "Index是: " + index);
+                    Editable edit_text = e.getEditableText();
+                    edit_text.insert(index, spannableString); //将图片插入到光标所在位置
+
+                    mWorkingNote.mContent = e.getText().toString();
+                    //6.把改动提交到数据库中,两个数据库表都要改的
+                    ContentResolver contentResolver = getContentResolver();
+                    ContentValues contentValues = new ContentValues();
+                    final long id = mWorkingNote.getNoteId();
+                    contentValues.put("snippet",mWorkingNote.mContent);
+                    contentResolver.update(Uri.parse("content://micode_notes/note"), contentValues,"_id=?",new String[]{""+id});
+                    ContentValues contentValues1 = new ContentValues();
+                    contentValues1.put("content",mWorkingNote.mContent);
+                    contentResolver.update(Uri.parse("content://micode_notes/data"), contentValues1,"mime_type=? and note_id=?", new String[]{"vnd.android.cursor.item/text_note",""+id});
+
+                }else{
+                    Toast.makeText(NoteEditActivity.this, "获取图片失败", Toast.LENGTH_SHORT).show();
+                }
+                break;
+            default:
+                break;
+        }
+    }
+
+    //获取文件的real path
+    public String getPath(final Context context, final Uri uri) {
+
+        final boolean isKitKat = Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT;
+
+        // DocumentProvider
+        if (isKitKat && DocumentsContract.isDocumentUri(context, uri)) {
+            // ExternalStorageProvider
+//            if (isExternalStorageDocument(uri)) {
+//                final String docId = DocumentsContract.getDocumentId(uri);
+//                final String[] split = docId.split(":");
+//                final String type = split[0];
+//
+//                if ("primary".equalsIgnoreCase(type)) {
+//                    return Environment.getExternalStorageDirectory() + "/" + split[1];
+//                }
+//            }
+//            // DownloadsProvider
+//            else if (isDownloadsDocument(uri)) {
+//                final String id = DocumentsContract.getDocumentId(uri);
+//                final Uri contentUri = ContentUris.withAppendedId(Uri.parse("content://downloads/public_downloads"), Long.valueOf(id));
+//                return getDataColumn(context, contentUri, null, null);
+//            }
+            // MediaProvider
+//            else
+            if (isMediaDocument(uri)) {
+                final String docId = DocumentsContract.getDocumentId(uri);
+                final String[] split = docId.split(":");
+                final String type = split[0];
+
+                Uri contentUri = null;
+                if ("image".equals(type)) {
+                    contentUri = MediaStore.Images.Media.EXTERNAL_CONTENT_URI;
+                }
+
+                final String selection = "_id=?";
+                final String[] selectionArgs = new String[]{split[1]};
+
+                return getDataColumn(context, contentUri, selection, selectionArgs);
+            }
+        }
+        // Media
+        else if ("content".equalsIgnoreCase(uri.getScheme())) {
+            return getDataColumn(context, uri, null, null);
+        }
+        // File
+        else if ("file".equalsIgnoreCase(uri.getScheme())) {
+            return uri.getPath();
+        }
+        return null;
+    }
+
+    //获取数据列_获取此 Uri 的数据列的值。这对MediaStore Uris 和其他基于文件的 ContentProvider。
+    public String getDataColumn(Context context, Uri uri, String selection, String[] selectionArgs) {
+
+        Cursor cursor = null;
+        final String column = "_data";
+        final String[] projection = {column};
+
+        try {
+            cursor = context.getContentResolver().query(uri, projection, selection, selectionArgs, null);
+            if (cursor != null && cursor.moveToFirst()) {
+                final int column_index = cursor.getColumnIndexOrThrow(column);
+                return cursor.getString(column_index);
+            }
+        } finally {
+            if (cursor != null)
+                cursor.close();
+        }
+        return null;
+    }
+
+    //是否为媒体文件
+    public boolean isMediaDocument(Uri uri) {
+        return "com.android.providers.media.documents".equals(uri.getAuthority());
+    }
+
 }

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

@@ -79,6 +79,8 @@ import java.io.InputStreamReader;
 import java.util.HashSet;
 
 public class NotesListActivity extends Activity implements OnClickListener, OnItemLongClickListener {
+    //首页背景变换
+    private int mode = -1;
     private static final int FOLDER_NOTE_LIST_QUERY_TOKEN = 0;
 
     private static final int FOLDER_LIST_QUERY_TOKEN      = 1;
@@ -139,6 +141,7 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
     protected void onCreate(Bundle savedInstanceState) {
         super.onCreate(savedInstanceState);
         setContentView(R.layout.note_list);
+        getWindow().setBackgroundDrawableResource(R.drawable.decade);//将decade作为初始背景
         initResources();
 
         /**
@@ -772,12 +775,28 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
         } else {
             Log.e(TAG, "Wrong state:" + mState);
         }
+
+        if(mode==-1){//decade
+            menu.findItem(R.id.menu_decade).setVisible(false);
+        }
+        else if(mode==1){//zio
+            menu.findItem(R.id.menu_zio).setVisible(false);
+        }
+
         return true;
     }
 
     @Override
     public boolean onOptionsItemSelected(MenuItem item) {
-            if(item.getItemId()==R.id.menu_new_folder){
+            if(item.getItemId()==R.id.menu_decade){
+                mode = -1;
+                getWindow().setBackgroundDrawableResource(R.drawable.decade);
+            }
+            else if(item.getItemId()==R.id.menu_zio){
+                mode = 1;
+                getWindow().setBackgroundDrawableResource(R.drawable.zio);
+            }
+            else if(item.getItemId()==R.id.menu_new_folder){
                 showCreateOrModifyFolderDialog(true);
             }
             else if(item.getItemId()==R.id.menu_export_text ){

src/main/res/layout/note_edit.xml

@@ -395,6 +395,15 @@
                 android:layout_marginRight="6dip"
                 android:layout_marginBottom="-7dip"
                 android:src="@drawable/selected" />
+
         </FrameLayout>
     </LinearLayout>
+    <ImageButton
+        android:id="@+id/add_img_btn"
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content"
+        android:layout_marginLeft="7dp"
+        android:layout_marginTop="600dp"
+        android:layout_marginBottom="7dp"
+        android:src="@android:drawable/ic_menu_gallery" />
 </FrameLayout>

src/main/res/layout/note_list.xml

@@ -18,8 +18,8 @@
 <FrameLayout
     xmlns:android="http://schemas.android.com/apk/res/android"
     android:layout_width="fill_parent"
-    android:layout_height="fill_parent"
-    android:background="@drawable/list_background">
+    android:layout_height="fill_parent">
+    <!--android:background="@drawable/list_background"-->
 
     <LinearLayout
         android:layout_width="fill_parent"

src/main/res/menu/note_list.xml

@@ -36,4 +36,12 @@
     <item
         android:id="@+id/menu_search"
         android:title="@string/menu_search"/>
+
+    <item
+        android:id="@+id/menu_decade"
+        android:title="@string/menu_decade"/>
+
+    <item
+        android:id="@+id/menu_zio"
+        android:title="@string/menu_zio"/>
 </menu>

src/main/res/menu/sub_folder.xml

@@ -21,4 +21,11 @@
     <item
         android:id="@+id/menu_new_note"
         android:title="@string/notelist_menu_new"/>
+    <item
+        android:id="@+id/menu_secret"
+        android:title="@string/menu_secret"/>
+
+    <item
+        android:id="@+id/menu_quit_secret"
+        android:title="@string/menu_quit_secret"/>
 </menu>

src/main/res/values-zh-rCN/strings.xml

@@ -71,6 +71,8 @@
     <string name="alert_message_delete_note">确认要删除该条便签吗?</string>
     <string name="alert_message_delete_folder">确认删除文件夹及所包含的便签吗？</string>
     <string name="format_move_notes_to_folder">已将所选 %1$d 条便签移到 %2$s 文件夹</string>
+    <string name="menu_secret">私密模式</string>
+    <string name="menu_quit_secret">退出私密模式</string>
     <!-- export text -->
     <string name="error_sdcard_unmounted">SD卡被占用，不能操作</string>
     <string name="error_sdcard_export">导出文本时发生错误，请检查SD卡</string>

src/main/res/values/strings.xml

@@ -39,6 +39,11 @@
     <string name="file_path">/MIUI/notes/</string>
     <string name="file_name_txt_format">notes_%s.txt</string>
     <!-- notes list string -->
+
+    <!--首页背景切换-->
+    <string name="menu_decade">Background: decade</string>
+    <string name="menu_zio">Background: zio</string>
+
     <string name="format_folder_files_count">(%d)</string>
     <string name="menu_create_folder">New Folder</string>
     <string name="menu_export_text">Export text</string>

src/main/res/values/styles.xml

@@ -64,6 +64,6 @@
 
     <style name="NoteActionBarStyle" parent="@android:style/Widget.Holo.Light.ActionBar.Solid">
         <item name="android:displayOptions" />
-        <item name="android:visibility">gone</item>
+        <item name="android:visibility">visible</item>
     </style>
 </resources>