添加了tool中多处注释

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();

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;

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";

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;