From 6fa32305a6a46357fb7199879f044bcb6a14ddac Mon Sep 17 00:00:00 2001
From: Marcus <3160876878@qq.com>
Date: Fri, 14 Apr 2023 14:23:11 +0800
Subject: [PATCH] =?UTF-8?q?=E6=B7=BB=E5=8A=A0=E4=BA=86tool=E4=B8=AD?=
 =?UTF-8?q?=E5=A4=9A=E5=A4=84=E6=B3=A8=E9=87=8A?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../net/micode/notes/tool/BackupUtils.java    | 20 ++++++++++++++-----
 .../java/net/micode/notes/tool/DataUtils.java |  9 ++++++++-
 .../micode/notes/tool/GTaskStringUtils.java   |  3 +++
 .../net/micode/notes/tool/ResourceParser.java |  4 ++++
 4 files changed, 30 insertions(+), 6 deletions(-)

diff --git a/app/src/main/java/net/micode/notes/tool/BackupUtils.java b/app/src/main/java/net/micode/notes/tool/BackupUtils.java
index d2f3d68..6d8ea0a 100644
--- a/app/src/main/java/net/micode/notes/tool/BackupUtils.java
+++ b/app/src/main/java/net/micode/notes/tool/BackupUtils.java
@@ -40,9 +40,13 @@ public class BackupUtils {
     private static final String TAG = "BackupUtils";
     // Singleton stuff
     private static BackupUtils sInstance;
-
+    /*
+     * synchronized关键字代表该方法加锁：
+     * 任何一个线程运行到该方法都得检测是否在其它线程运用到了该方法
+     */
     public static synchronized BackupUtils getInstance(Context context) {
         if (sInstance == null) {
+            //如果当前备份缺失，则重新定义一个
             sInstance = new BackupUtils(context);
         }
         return sInstance;
@@ -67,12 +71,16 @@ public class BackupUtils {
 
     private BackupUtils(Context context) {
         mTextExport = new TextExport(context);
-    }
-
+    }//构造函数
+    /*
+     * 判断外部存储功能是否可用
+     */
     private static boolean externalStorageAvailable() {
         return Environment.MEDIA_MOUNTED.equals(Environment.getExternalStorageState());
     }
-
+    /*
+     * 获取有关文本的一些信息
+     */
     public int exportToText() {
         return mTextExport.exportToText();
     }
@@ -322,7 +330,9 @@ public class BackupUtils {
                 DateFormat.format(context.getString(R.string.format_date_ymd),
                         System.currentTimeMillis())));
         File file = new File(sb.toString());
-
+        /*
+         * 如果文件不存在则抛出异常
+         */
         try {
             if (!filedir.exists()) {
                 filedir.mkdir();
diff --git a/app/src/main/java/net/micode/notes/tool/DataUtils.java b/app/src/main/java/net/micode/notes/tool/DataUtils.java
index 378bfb2..8a27ab8 100644
--- a/app/src/main/java/net/micode/notes/tool/DataUtils.java
+++ b/app/src/main/java/net/micode/notes/tool/DataUtils.java
@@ -34,10 +34,16 @@ import net.micode.notes.ui.NotesListAdapter.AppWidgetAttribute;
 import java.util.ArrayList;
 import java.util.HashSet;
 
+/**
+ * 数据工具包
+ * 功能：定义了一些用来处理便签数据的方法（包括删除、转移、计数、查找、校验）以及异常处理
+ */
 
 public class DataUtils {
     public static final String TAG = "DataUtils";
-
+    /*
+     * 此方法用于批删除便签（包括一些特殊情况的处理）
+     */
     public static boolean batchDeleteNotes(ContentResolver resolver, HashSet<Long> ids) {
         if (ids == null) {
             Log.d(TAG, "the ids is null");
@@ -50,6 +56,7 @@ public class DataUtils {
 
         ArrayList<ContentProviderOperation> operationList = new ArrayList<ContentProviderOperation>();
         for (long id : ids) {
+            //若发现是根文件则跳过此执行语句
             if (id == Notes.ID_ROOT_FOLDER) {
                 Log.e(TAG, "Don't delete system folder root");
                 continue;
diff --git a/app/src/main/java/net/micode/notes/tool/GTaskStringUtils.java b/app/src/main/java/net/micode/notes/tool/GTaskStringUtils.java
index 666b729..a9e2f17 100644
--- a/app/src/main/java/net/micode/notes/tool/GTaskStringUtils.java
+++ b/app/src/main/java/net/micode/notes/tool/GTaskStringUtils.java
@@ -16,6 +16,9 @@
 
 package net.micode.notes.tool;
 
+/**
+ * 定义了一些静态字符串常量，为jsonObject提供了键，是一种编程规范
+ */
 public class GTaskStringUtils {
 
     public final static String GTASK_JSON_ACTION_ID = "action_id";
diff --git a/app/src/main/java/net/micode/notes/tool/ResourceParser.java b/app/src/main/java/net/micode/notes/tool/ResourceParser.java
index ea5fc30..09c8fb8 100644
--- a/app/src/main/java/net/micode/notes/tool/ResourceParser.java
+++ b/app/src/main/java/net/micode/notes/tool/ResourceParser.java
@@ -22,6 +22,10 @@ import android.preference.PreferenceManager;
 import net.micode.notes.R;
 import net.micode.notes.ui.activities.NotesPreferenceActivity;
 
+/**
+ * 资源分析器
+ * 功能：获取资源并将其应用的进程中
+ */
 public class ResourceParser {
 
     public static final int YELLOW = 0;