diff --git a/src/net/micode/notes/gtask/exception/ActionFailureException.java b/src/net/micode/notes/gtask/exception/ActionFailureException.java index 15504be..dd48138 100644 --- a/src/net/micode/notes/gtask/exception/ActionFailureException.java +++ b/src/net/micode/notes/gtask/exception/ActionFailureException.java @@ -16,18 +16,41 @@ package net.micode.notes.gtask.exception; +/** + * ActionFailureException 是一个自定义运行时异常类,用于表示Google Tasks同步过程中发生的操作失败。 + * 当与Google Tasks服务交互的操作(如创建、更新或删除任务)未能成功完成时,抛出此异常。 + * 此类继承自RuntimeException,因此不需要在方法签名中显式声明。 + */ public class ActionFailureException extends RuntimeException { + // 序列化版本UID,用于确保序列化和反序列化过程中的版本一致性 private static final long serialVersionUID = 4425249765923293627L; + /** + * 构造一个不带详细消息的ActionFailureException实例。 + * 通常在不需要提供额外错误信息时使用。 + */ public ActionFailureException() { super(); } - public ActionFailureException(String paramString) { - super(paramString); + /** + * 构造一个带详细消息的ActionFailureException实例。 + * 通常在需要提供特定错误信息时使用。 + * + * @param message 详细描述异常原因的消息字符串 + */ + public ActionFailureException(String message) { + super(message); } - public ActionFailureException(String paramString, Throwable paramThrowable) { - super(paramString, paramThrowable); + /** + * 构造一个带详细消息和原始异常的ActionFailureException实例。 + * 通常在需要包装另一个异常并传递其信息时使用。 + * + * @param message 详细描述异常原因的消息字符串 + * @param cause 导致此异常的原始异常 + */ + public ActionFailureException(String message, Throwable cause) { + super(message, cause); } -} +} \ No newline at end of file diff --git a/src/net/micode/notes/gtask/exception/NetworkFailureException.java b/src/net/micode/notes/gtask/exception/NetworkFailureException.java index b08cfb1..23e4e8f 100644 --- a/src/net/micode/notes/gtask/exception/NetworkFailureException.java +++ b/src/net/micode/notes/gtask/exception/NetworkFailureException.java @@ -16,18 +16,41 @@ package net.micode.notes.gtask.exception; +/** + * NetworkFailureException 是一个自定义异常类,用于表示与网络相关的操作失败。 + * 当应用程序尝试与Google Tasks服务进行通信,但由于网络连接问题而失败时,抛出此异常。 + * 此类继承自Exception,属于受检查异常,因此需要在方法签名中显式声明或捕获处理。 + */ public class NetworkFailureException extends Exception { + // 序列化版本UID,用于确保序列化和反序列化过程中的版本一致性 private static final long serialVersionUID = 2107610287180234136L; + /** + * 构造一个不带详细消息的NetworkFailureException实例。 + * 通常在不需要提供额外错误信息时使用。 + */ public NetworkFailureException() { super(); } - public NetworkFailureException(String paramString) { - super(paramString); + /** + * 构造一个带详细消息的NetworkFailureException实例。 + * 通常在需要提供特定错误信息时使用。 + * + * @param message 详细描述异常原因的消息字符串 + */ + public NetworkFailureException(String message) { + super(message); } - public NetworkFailureException(String paramString, Throwable paramThrowable) { - super(paramString, paramThrowable); + /** + * 构造一个带详细消息和原始异常的NetworkFailureException实例。 + * 通常在需要包装另一个异常并传递其信息时使用。 + * + * @param message 详细描述异常原因的消息字符串 + * @param cause 导致此异常的原始异常 + */ + public NetworkFailureException(String message, Throwable cause) { + super(message, cause); } -} +} \ No newline at end of file