v1.0

src/Notesmaster2/app/build.gradle.kts

@@ -14,13 +14,6 @@ android {
         versionName = "1.0"
 
         testInstrumentationRunner = "androidx.test.runner.AndroidJUnitRunner"
-        packaging {
-            resources.excludes.add("META-INF/DEPENDENCIES");
-            resources.excludes.add("META-INF/NOTICE");
-            resources.excludes.add("META-INF/LICENSE");
-            resources.excludes.add("META-INF/LICENSE.txt");
-            resources.excludes.add("META-INF/NOTICE.txt");
-        }
     }
 
     buildTypes {
@@ -33,8 +26,15 @@ android {
         }
     }
     compileOptions {
-        sourceCompatibility = JavaVersion.VERSION_11
+        sourceCompatibility = JavaVersion.VERSION_1_8
-        targetCompatibility = JavaVersion.VERSION_11
+        targetCompatibility = JavaVersion.VERSION_1_8
+    }
+    packaging {
+        resources.excludes.add("META-INF/DEPENDENCIES");
+        resources.excludes.add("META-INF/NOTICE");
+        resources.excludes.add("META-INF/LICENSE");
+        resources.excludes.add("META-INF/LICENSE.txt");
+        resources.excludes.add("META-INF/NOTICE.txt");
     }
 }
 
@@ -44,11 +44,11 @@ dependencies {
     implementation(libs.material)
     implementation(libs.activity)
     implementation(libs.constraintlayout)
-    implementation(fileTree(mapOf(
+//    implementation(fileTree(mapOf(
-        "dir" to "D:\\APP\\Notesmaster\\httpcomponents-client-4.5.14-bin",
+//        "dir" to "G:\\AndroidProject\\Notesmaster2\\httpcomponents-client-4.5.14-bin\\lib",
-        "include" to listOf("*.aar", "*.jar"),
+//        "include" to listOf("*.aar", "*.jar"),
-        "exclude" to listOf("")
+//        "exclude" to listOf("")
-    )))
+//    )))
     //    部分需要重新修改
 //    implementation(fileTree(mapOf(
 //        "dir" to "D:\\Code\\AndroidCode\\Notesmaster\\httpcomponents-client-4.5.14-bin\\lib",
@@ -56,9 +56,9 @@ dependencies {
 //        "exclude" to listOf("")
 //    )))
     //修改为如下代码：
-    implementation(files("D:\\APP\\Notesmaster\\httpcomponents-client-4.5.14-bin\\lib\\httpclient-osgi-4.5.14.jar"))
+    implementation(files("G:\\AndroidProject\\Notesmaster2\\httpcomponents-client-4.5.14-bin\\lib\\httpclient-osgi-4.5.14.jar"))
-    implementation(files("D:\\APP\\Notesmaster\\httpcomponents-client-4.5.14-bin\\lib\\httpclient-win-4.5.14.jar"))
+    implementation(files("G:\\AndroidProject\\Notesmaster2\\httpcomponents-client-4.5.14-bin\\lib\\httpclient-win-4.5.14.jar"))
-    implementation(files("D:\\APP\\Notesmaster\\httpcomponents-client-4.5.14-bin\\lib\\httpcore-4.4.16.jar"))
+    implementation(files("G:\\AndroidProject\\Notesmaster2\\httpcomponents-client-4.5.14-bin\\lib\\httpcore-4.4.16.jar"))
     testImplementation(libs.junit)
     androidTestImplementation(libs.ext.junit)
     androidTestImplementation(libs.espresso.core)

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

@@ -34,12 +34,23 @@ import net.micode.notes.data.Notes.DataColumns;
 import net.micode.notes.data.Notes.NoteColumns;
 import net.micode.notes.data.NotesDatabaseHelper.TABLE;
 
-//uri匹配器、NotesDatabaseHelper实类与日志标记的定义。
+
 public class NotesProvider extends ContentProvider {
+    //    Android 应用程序中的一部分：内容提供者（ContentProvider）。
+//    内容提供者是 Android 四大组件之一，它允许应用程序之间共享数据。
+
+    //概述：
+    //NotesProvider的主要功能是作为一个内容提供者，为其他应用程序或组件提供对“Notes”数据的访问。
+    //它允许其他应用程序查询、插入、更新或删除标签数据。
+    //通过URI匹配，NotesProvider能够区分对哪种数据类型的请求（例如，单独的标签、标签的数据、文件夹操作等），并执行相应的操作。
+
+    //用于匹配不同URI的UriMatcher对象，通常用于解析传入的URI，并确定应该执行哪种操作。
     private static final UriMatcher mMatcher;
 
-    private NotesDatabaseHelper mHelper;
+    //NotesDatabaseHelper实类，用来操作SQLite数据库，负责创建、更新和查询数据库。
 
+    private NotesDatabaseHelper mHelper;
+    //标签，输出日志时用来表示是该类发出的消息
     private static final String TAG = "NotesProvider";
     //6个URI的匹配码，用于区分不同的URI类型
     private static final int URI_NOTE            = 1;
@@ -49,23 +60,14 @@ public class NotesProvider extends ContentProvider {
 
     private static final int URI_SEARCH          = 5;
     private static final int URI_SEARCH_SUGGEST  = 6;
-    //实例化一个mMatcher对象，并进一步定义uri的匹配规则。
+    //进一步定义了URI匹配规则和搜索查询的投影
-    //
+    //功能概述：
-    //这种写法是Android开发中常见的初始化静态成员变量的方式，特别是当涉及到内容提供者（Content Providers）时。
+    //初始化了一个UriMatcher对象mMatcher，并添加了一系列的URI匹配规则。
-    //
+    //解读：
-    //静态初始化块确保了在类加载时mMatcher就被初始化，并且所有的URI匹配规则也一并设置好了。这样做使得代码组织清晰，所有与URI匹配相关的设置都集中在一个地方，方便管理和维护
-    //————————————————
-    //
-
-    ////功能概述：
-    ////初始化了一个UriMatcher对象mMatcher，并添加了一系列的URI匹配规则。
-    ////解读：
-
-
     static {
         //创建了一个UriMatcher实例，并设置默认匹配码为NO_MATCH，表示如果没有任何URI匹配，则返回这个码。
         mMatcher = new UriMatcher(UriMatcher.NO_MATCH);
-        //添加规则，当URI的authority为Notes.AUTHORITY，路径为note时，返回匹配码URI_NOTE
+        //添加规则，当URI的authority为Notes.AUTHORITY，路径为note时，返回匹配码URI_NOTE。
         mMatcher.addURI(Notes.AUTHORITY, "note", URI_NOTE);
         //添加规则，当URI的authority为Notes.AUTHORITY，路径为note/后跟一个数字（#代表数字）时，返回匹配码URI_NOTE_ITEM。
         mMatcher.addURI(Notes.AUTHORITY, "note/#", URI_NOTE_ITEM);
@@ -83,6 +85,8 @@ 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.
      */
+    //功能概述：
+    //一个 SQL 查询的投影部分，用于定义查询返回的结果集中应该包含哪些列。
     //解读：（每行对应）
     //返回笔记的 ID。
     //笔记的 ID 也被重命名为 SUGGEST_COLUMN_INTENT_EXTRA_DATA，这通常用于 Android 的搜索建议中，作为传递给相关 Intent 的额外数据。
@@ -91,14 +95,16 @@ public class NotesProvider extends ContentProvider {
     //返回一个用于搜索建议图标的资源 ID，并命名为 SUGGEST_COLUMN_ICON_1。
     //返回一个固定的 Intent 动作 ACTION_VIEW，并命名为 SUGGEST_COLUMN_INTENT_ACTION。
     //返回一个内容类型，并命名为 SUGGEST_COLUMN_INTENT_DATA。
-    private static final String NOTES_SEARCH_PROJECTION = NoteColumns.ID + "," //返回笔记的 ID
+
+    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 + ","
         + "TRIM(REPLACE(" + NoteColumns.SNIPPET + ", x'0A','')) AS " + SearchManager.SUGGEST_COLUMN_TEXT_2 + ","
         + 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;
-
+    //功能概述：
+    //完整的 SQL 查询语句，用于从 TABLE.NOTE 表中检索信息
     //解读：
     // 使用上面定义的投影来选择数据。
     // 并指定从哪个表中选择数据。
@@ -106,12 +112,12 @@ public class NotesProvider extends ContentProvider {
     // ①搜索 SNIPPET 列中包含特定模式的行（? 是一个占位符，实际查询时会用具体的值替换）。
     // ②父ID不为回收站的ID：排除那些父 ID 为回收站的行。
     // ③只选择类型为note（标签）的行。
+
     private static String NOTES_SNIPPET_SEARCH_QUERY = "SELECT " + NOTES_SEARCH_PROJECTION
         + " FROM " + TABLE.NOTE
         + " WHERE " + NoteColumns.SNIPPET + " LIKE ?"
         + " AND " + NoteColumns.PARENT_ID + "<>" + Notes.ID_TRASH_FOLER
         + " AND " + NoteColumns.TYPE + "=" + Notes.TYPE_NOTE;
-
     //重写onCreate方法：
     //getContext() 方法被调用以获取当前组件的上下文（Context），以便 NotesDatabaseHelper 能够访问应用程序的资源和其他功能
     //mHelper用于存储从 NotesDatabaseHelper.getInstance 方法返回的实例。这样，该实例就可以在整个组件的其他方法中被访问和使用。
@@ -121,7 +127,7 @@ public class NotesProvider extends ContentProvider {
         mHelper = NotesDatabaseHelper.getInstance(getContext());
         return true;
     }
-
+    //功能：查询数据
     @Override
     public Cursor query(Uri uri, String[] projection, String selection, String[] selectionArgs,
             String sortOrder) {
@@ -156,7 +162,8 @@ public class NotesProvider extends ContentProvider {
                 id = uri.getPathSegments().get(1);
                 c = db.query(TABLE.DATA, projection, DataColumns.ID + "=" + id
                         + parseSelection(selection), selectionArgs, null, null, sortOrder);
-                break;//URI_SEARCH 和 URI_SEARCH_SUGGEST：处理搜索查询。
+                break;
+            //URI_SEARCH 和 URI_SEARCH_SUGGEST：处理搜索查询。
             //  代码首先检查是否提供了不应与搜索查询一起使用的参数（如 sortOrder, selection, selectionArgs, 或 projection）。
             //  如果提供了这些参数，则抛出一个 IllegalArgumentException。
             //  根据 URI 类型，从 URI 的路径段或查询参数中获取搜索字符串 searchString。
@@ -191,6 +198,7 @@ public class NotesProvider extends ContentProvider {
                     Log.e(TAG, "got exception: " + ex.toString());
                 }
                 break;
+            //未知URI处理：
             default:
                 throw new IllegalArgumentException("Unknown URI " + uri);
         }
@@ -201,17 +209,18 @@ public class NotesProvider extends ContentProvider {
         }
         return c;
     }
-
+    //功能：插入数据
     //参数：Uri 用来标识要插入数据的表，ContentValues对象包含要插入的键值对
     @Override
     public Uri insert(Uri uri, ContentValues values) {
-
+        //获取数据库
-//参数：Uri 用来标识要插入数据的表，ContentValues对象包含要插入的键值对
+        //三个长整型变量，分别用来存储数据项ID、便签ID 和插入行的ID
         SQLiteDatabase db = mHelper.getWritableDatabase();
         long dataId = 0, noteId = 0, insertedId = 0;
         //对于 URI_NOTE，将values插入到 TABLE.NOTE 表中，并返回插入行的 ID。
         //对于 URI_DATA，首先检查values是否包含 DataColumns.NOTE_ID，如果包含，则获取其值。如果不包含，记录一条日志信息。然后，将 values 插入到 TABLE.DATA 表中，并返回插入行的 ID。
         //如果 uri 不是已知的 URI 类型，则抛出一个 IllegalArgumentException。
+
         switch (mMatcher.match(uri)) {
             case URI_NOTE:
                 insertedId = noteId = db.insert(TABLE.NOTE, null, values);
@@ -227,12 +236,10 @@ public class NotesProvider extends ContentProvider {
             default:
                 throw new IllegalArgumentException("Unknown URI " + uri);
         }
-        // Notify the note uri
         // 功能：通知变化
         // 如果noteId 或 dataId 大于 0（即成功插入了数据），则使用 ContentResolver 的 notifyChange 方法通知监听这些 URI 的观察者，告知数据已经改变。
         // ContentUris.withAppendedId 方法用于在基本 URI 后面追加一个 ID，形成完整的 URI。
         // Notify the note uri
-
         if (noteId > 0) {
             getContext().getContentResolver().notifyChange(
                     ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, noteId), null);
@@ -246,6 +253,7 @@ public class NotesProvider extends ContentProvider {
         //返回包含新插入数据项ID 的 Uri。允许调用者知道新插入的数据项的位置
         return ContentUris.withAppendedId(uri, insertedId);
     }
+    //功能：删除数据项
     //参数：uri：标识要删除数据的表或数据项。  selection：一个可选的 WHERE 子句，用于指定删除条件。  selectionArgs：一个可选的字符串数组，用于替换 selection 中的占位符
     @Override
     public int delete(Uri uri, String selection, String[] selectionArgs) {
@@ -262,6 +270,7 @@ public class NotesProvider extends ContentProvider {
             //URI_NOTE_ITEM:  从 URI 中解析出 ID。检查 ID 是否小于等于 0，如果是，则不执行删除操作；否则执行删除操作并返回被删除的行数
             //URI_DATA：       执行删除操作并返回被删除的行数。设置 deleteData 为 true，表示删除了 DATA 表中的数据。
             //URI_DATA_ITEM：  先从 URI 中解析出 ID，然后执行删除操作并返回被删除的行数，并设置 deleteData 为 true，表示删除了 DATA 表中的数据。
+
             case URI_NOTE:
                 selection = "(" + selection + ") AND " + NoteColumns.ID + ">0 ";
                 count = db.delete(TABLE.NOTE, selection, selectionArgs);
@@ -273,9 +282,6 @@ public class NotesProvider extends ContentProvider {
                  * trash
                  */
                 long noteId = Long.valueOf(id);
-                //如果 count 大于 0，说明有数据被删除。
-                //如果 deleteData 为 true，则通知监听 Notes.CONTENT_NOTE_URI 的观察者，数据已改变。
-                //通知监听传入 uri 的观察者数据已改变。
                 if (noteId <= 0) {
                     break;
                 }
@@ -295,6 +301,9 @@ public class NotesProvider extends ContentProvider {
             default:
                 throw new IllegalArgumentException("Unknown URI " + uri);
         }
+        //如果 count 大于 0，说明有数据被删除。
+        //如果 deleteData 为 true，则通知监听 Notes.CONTENT_NOTE_URI 的观察者，数据已改变。
+        //通知监听传入 uri 的观察者数据已改变。
         if (count > 0) {
             if (deleteData) {
                 getContext().getContentResolver().notifyChange(Notes.CONTENT_NOTE_URI, null);
@@ -303,6 +312,7 @@ public class NotesProvider extends ContentProvider {
         }
         return count;
     }
+    //功能：更新数据库的数据
     //参数：uri：标识要更新数据的表或数据项。  values：一个包含新值的键值对集合。
     //     selection：一个可选的 WHERE 子句，用于指定更新条件。  selectionArgs：一个可选的字符串数组，用于替换 selection 中的占位符。
 
@@ -321,7 +331,6 @@ public class NotesProvider extends ContentProvider {
             //URI_NOTE_ITEM：从 URI 中解析出 ID，并调用 increaseNoteVersion 方法，传入解析出的 ID，最后在note表执行更新操作并返回被更新的行数。
             //URI_DATA：在data表执行更新操作并返回被更新的行数。设置 updateData 为 true，表示更新了 DATA 表中的数据。
             //URI_DATA_ITEM：从 URI 中解析出 ID。执行更新操作并返回被更新的行数。置 updateData 为 true，表示更新了 DATA 表中的数据。
-
             case URI_NOTE:
                 increaseNoteVersion(-1, selection, selectionArgs);
                 count = db.update(TABLE.NOTE, values, selection, selectionArgs);
@@ -345,11 +354,10 @@ public class NotesProvider extends ContentProvider {
             default:
                 throw new IllegalArgumentException("Unknown URI " + uri);
         }
-
-        if (count > 0) {
         //如果 count 大于 0，说明有数据被更新。
         //如果 updateData 为 true，则通知监听 Notes.CONTENT_NOTE_URI 的观察者数据已改变。
         //通知监听传入 uri 的观察者数据已改变。
+        if (count > 0) {
             if (updateData) {
                 getContext().getContentResolver().notifyChange(Notes.CONTENT_NOTE_URI, null);
             }
@@ -357,12 +365,10 @@ public class NotesProvider extends ContentProvider {
         }
         return count;
     }
-
     //解析传入的条件语句：一个 SQL WHERE 子句的一部分
     private String parseSelection(String selection) {
         return (!TextUtils.isEmpty(selection) ? " AND (" + selection + ')' : "");
     }
-
     //更新note表的version列，将其值增加 1。
     private void increaseNoteVersion(long id, String selection, String[] selectionArgs) {
         StringBuilder sql = new StringBuilder(120);

src/Notesmaster2/app/src/main/java/net/micode/notes/gtask/data/SqlNote.java

@@ -523,4 +523,3 @@ public class SqlNote {
         mIsCreate = false;
     }
 }
-

src/Notesmaster2/app/src/main/java/net/micode/notes/gtask/data/Task.java

@@ -349,4 +349,3 @@ public class Task extends Node {
     }
 
 }
-

src/Notesmaster2/app/src/main/java/net/micode/notes/gtask/data/TaskList.java

@@ -366,5 +366,3 @@ public class TaskList extends Node {
         return this.mIndex;
     }
 }
-
-

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

@@ -13,29 +13,16 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-/*
+
- * Description：支持小米便签运行过程中的运行异常处理。
- */
 package net.micode.notes.gtask.exception;
 
 public class ActionFailureException extends RuntimeException {
     private static final long serialVersionUID = 4425249765923293627L;
-    /*
-     * serialVersionUID相当于java类的身份证。主要用于版本控制。
-     * serialVersionUID作用是序列化时保持版本的兼容性，即在版本升级时反序列化仍保持对象的唯一性。
-     * Made By Cuican13
-     */
 
     public ActionFailureException() {
         super();
     }
-    /*
+
-     * 在JAVA类中使用super来引用父类的成分，用this来引用当前对象.
-     * 如果一个类从另外一个类继承，我们new这个子类的实例对象的时候，这个子类对象里面会有一个父类对象。
-     * 怎么去引用里面的父类对象呢？使用super来引用
-     * 也就是说，此处super()以及super (paramString)可认为是Exception ()和Exception (paramString)
-     * Made By Cuican24
-     */
     public ActionFailureException(String paramString) {
         super(paramString);
     }

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

@@ -14,31 +14,15 @@
  * limitations under the License.
  */
 
-/*
- * Description：支持小米便签运行过程中的网络异常处理。
- */
-
 package net.micode.notes.gtask.exception;
 
 public class NetworkFailureException extends Exception {
     private static final long serialVersionUID = 2107610287180234136L;
-    /*
-     * serialVersionUID相当于java类的身份证。主要用于版本控制。
-     * serialVersionUID作用是序列化时保持版本的兼容性，即在版本升级时反序列化仍保持对象的唯一性。
-     * Made By Cuican13
-     */
 
     public NetworkFailureException() {
-
         super();
     }
-    /*
+
-     * 在JAVA类中使用super来引用父类的成分，用this来引用当前对象.
-     * 如果一个类从另外一个类继承，我们new这个子类的实例对象的时候，这个子类对象里面会有一个父类对象。
-     * 怎么去引用里面的父类对象呢？使用super来引用
-     * 也就是说，此处super()以及super (paramString)可认为是Exception ()和Exception (paramString)
-     * Made By Cuican
-     */
     public NetworkFailureException(String paramString) {
         super(paramString);
     }