1

src/小米标签代码/src/net/micode/notes/gtask/exception/ActionFailureException.java

@@ -16,18 +16,53 @@
 
 package net.micode.notes.gtask.exception;
 
+/**
+ * ActionFailureException 类
+ * 表示在执行Google Tasks同步操作时发生的动作失败异常
+ * 
+ * 继承自RuntimeException（运行时异常），属于非受检异常
+ * 通常用于表示程序逻辑错误或同步操作失败，调用方不需要强制捕获
+ * 
+ * 应用场景：
+ * 1. 创建、更新或删除Google Task时发生失败
+ * 2. JSON数据生成或解析失败
+ * 3. 数据库操作失败
+ * 4. 其他同步相关的业务逻辑错误
+ */
 public class ActionFailureException extends RuntimeException {
+    /**
+     * 序列化版本UID
+     * 用于保持类的版本兼容性，在序列化和反序列化过程中验证类的版本一致性
+     */
     private static final long serialVersionUID = 4425249765923293627L;
 
+    /**
+     * 默认构造函数
+     * 创建一个不包含详细错误信息的ActionFailureException
+     */
     public ActionFailureException() {
-        super();
+        super(); // 调用父类RuntimeException的无参构造函数
     }
 
+    /**
+     * 带错误消息的构造函数
+     * 创建一个包含指定错误消息的ActionFailureException
+     * 
+     * @param paramString 错误描述信息，用于说明异常发生的原因
+     */
     public ActionFailureException(String paramString) {
-        super(paramString);
+        super(paramString); // 调用父类RuntimeException的带消息构造函数
     }
 
+    /**
+     * 带错误消息和原因的构造函数
+     * 创建一个包含指定错误消息和根本原因的ActionFailureException
+     * 通常用于异常链，将底层异常包装为更高级别的异常
+     * 
+     * @param paramString 错误描述信息，用于说明异常发生的原因
+     * @param paramThrowable 导致此异常的根本原因（底层异常）
+     */
     public ActionFailureException(String paramString, Throwable paramThrowable) {
-        super(paramString, paramThrowable);
+        super(paramString, paramThrowable); // 调用父类RuntimeException的带消息和原因的构造函数
     }
-}
+}