添加注释

src/Notes-master/app/src/main/java/net/micode/notes/gtask/remote/GTaskASyncTask.java

@@ -1,4 +1,3 @@
-
 /*
  * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
  *
@@ -28,23 +27,32 @@ import net.micode.notes.R;
 import net.micode.notes.ui.NotesListActivity;
 import net.micode.notes.ui.NotesPreferenceActivity;
 
-
+/**
+ * GTaskASyncTask类用于在后台执行Google任务同步操作，继承自AsyncTask
+ * 提供了同步进度通知、错误处理和完成回调等功能
+ */
 public class GTaskASyncTask extends AsyncTask<Void, String, Integer> {
     
+    // 通知ID，用于标识同步过程中的通知
     private static int GTASK_SYNC_NOTIFICATION_ID = 5234235;
     
+    /**
+     * 同步完成监听器接口，用于在同步完成时回调
+     */
     public interface OnCompleteListener {
         void onComplete();
     }
     
-    private Context mContext;
-    
-    private NotificationManager mNotifiManager;
-    
-    private GTaskManager mTaskManager;
-    
-    private OnCompleteListener mOnCompleteListener;
-    
+    private Context mContext;                     // 应用上下文
+    private NotificationManager mNotifiManager;   // 通知管理器
+    private GTaskManager mTaskManager;            // Google任务管理器
+    private OnCompleteListener mOnCompleteListener; // 同步完成监听器
+
+    /**
+     * 构造函数
+     * @param context 应用上下文
+     * @param listener 同步完成监听器
+     */
     public GTaskASyncTask(Context context, OnCompleteListener listener) {
         mContext = context;
         mOnCompleteListener = listener;
@@ -53,18 +61,31 @@ public class GTaskASyncTask extends AsyncTask<Void, String, Integer> {
         mTaskManager = GTaskManager.getInstance();
     }
     
+    /**
+     * 取消同步操作
+     */
     public void cancelSync() {
         mTaskManager.cancelSync();
     }
     
+    /**
+     * 发布同步进度
+     * @param message 进度消息
+     */
     public void publishProgess(String message) {
         publishProgress(new String[]{
                 message
         });
     }
     
+    /**
+     * 显示同步通知
+     * @param tickerId 通知提示文本资源ID
+     * @param content  通知内容
+     */
     private void showNotification(int tickerId, String content) {
         PendingIntent pendingIntent;
+        // 根据同步状态设置点击通知后的跳转目标
         if (tickerId != R.string.ticker_success) {
             pendingIntent = PendingIntent.getActivity(mContext, 0, new Intent(mContext,
                     NotesPreferenceActivity.class), PendingIntent.FLAG_IMMUTABLE);
@@ -72,6 +93,8 @@ public class GTaskASyncTask extends AsyncTask<Void, String, Integer> {
             pendingIntent = PendingIntent.getActivity(mContext, 0, new Intent(mContext,
                     NotesListActivity.class), PendingIntent.FLAG_IMMUTABLE);
         }
+        
+        // 构建通知
         Notification.Builder builder = new Notification.Builder(mContext)
                 .setAutoCancel(true)
                 .setContentTitle(mContext.getString(R.string.app_name))
@@ -79,30 +102,50 @@ public class GTaskASyncTask extends AsyncTask<Void, String, Integer> {
                 .setContentIntent(pendingIntent)
                 .setWhen(System.currentTimeMillis())
                 .setOngoing(true);
+        
         Notification notification = builder.getNotification();
         mNotifiManager.notify(GTASK_SYNC_NOTIFICATION_ID, notification);
     }
     
+    /**
+     * 后台执行同步操作
+     * @param unused 参数
+     * @return 同步结果状态码
+     */
     @Override
     protected Integer doInBackground(Void... unused) {
+        // 发布登录进度
         publishProgess(mContext.getString(R.string.sync_progress_login, NotesPreferenceActivity
                 .getSyncAccountName(mContext)));
+        // 执行同步并返回结果
         return mTaskManager.sync(mContext, this);
     }
     
+    /**
+     * 更新同步进度
+     * @param progress 进度消息
+     */
     @Override
     protected void onProgressUpdate(String... progress) {
+        // 显示同步中的通知
         showNotification(R.string.ticker_syncing, progress[0]);
+        // 如果上下文是GTaskSyncService，发送广播
         if (mContext instanceof GTaskSyncService) {
             ((GTaskSyncService) mContext).sendBroadcast(progress[0]);
         }
     }
     
+    /**
+     * 同步完成后执行
+     * @param result 同步结果状态码
+     */
     @Override
     protected void onPostExecute(Integer result) {
+        // 根据同步结果显示不同的通知
         if (result == GTaskManager.STATE_SUCCESS) {
             showNotification(R.string.ticker_success, mContext.getString(
                     R.string.success_sync_account, mTaskManager.getSyncAccount()));
+            // 记录最后同步时间
             NotesPreferenceActivity.setLastSyncTime(mContext, System.currentTimeMillis());
         } else if (result == GTaskManager.STATE_NETWORK_ERROR) {
             showNotification(R.string.ticker_fail, mContext.getString(R.string.error_sync_network));
@@ -112,6 +155,8 @@ public class GTaskASyncTask extends AsyncTask<Void, String, Integer> {
             showNotification(R.string.ticker_cancel, mContext
                     .getString(R.string.error_sync_cancelled));
         }
+        
+        // 异步调用完成监听器
         if (mOnCompleteListener != null) {
             new Thread(new Runnable() {
                 
@@ -121,4 +166,4 @@ public class GTaskASyncTask extends AsyncTask<Void, String, Integer> {
             }).start();
         }
     }
-}
+}