Class OpenException

java.lang.Object
java.lang.Throwable
java.lang.Exception
java.lang.RuntimeException
cloud.opencode.base.core.exception.OpenException
All Implemented Interfaces:
Serializable
Direct Known Subclasses:
OpenIOException, OpenTimeoutException, OpenUnsupportedOperationException
public class OpenException extends RuntimeException
OpenException - Unified exception base class for OpenCode components OpenException - OpenCode 组件统一异常基类

Base exception for all OpenCode components with error code and component name support.

所有组件异常都应继承此类，支持错误码和组件名称，便于异常分类和定位。

Important | 重要说明: Note that OpenIllegalArgumentException and OpenIllegalStateException do NOT extend this class. They extend IllegalArgumentException and IllegalStateException respectively, so catch(OpenException e) will NOT catch those exceptions.

注意：OpenIllegalArgumentException 和 OpenIllegalStateException 并不继承此类。 它们分别继承自 IllegalArgumentException 和 IllegalStateException， 因此 catch(OpenException e) 无法捕获这两类异常。

Features | 主要功能:

  • Error code support - 错误码支持
  • Component name support - 组件名称支持
  • Formatted message output [Component] (Code) Message - 格式化消息输出
  • RuntimeException (unchecked) - 非受检异常

Usage Examples | 使用示例:

throw new OpenException("Operation failed");
throw new OpenException("Core", "CORE_001", "Parameter required");
throw new OpenException("IO failed", cause);

Security | 安全性:

  • Thread-safe: Yes (immutable) - 线程安全: 是 (不可变)
  • Serializable: Yes - 可序列化: 是
Since:
JDK 25, opencode-base-core V1.0.0
Author:
Leon Soo www.LeonSoo.com
See Also:

  • Constructor Details

    • OpenException

      public OpenException(String message)
      Creates 创建异常
      Parameters:
      message - the value | 异常消息

    • OpenException

      public OpenException(String message, Throwable cause)
      Creates 创建异常（带原因）
      Parameters:
      message - the value | 异常消息
      cause - the value | 原始异常

    • OpenException

      public OpenException(String component, String errorCode, String message)
      Creates 创建异常（带组件和错误码）
      Parameters:
      component - the value | 组件名称
      errorCode - the value | 错误码
      message - the value | 异常消息

    • OpenException

      public OpenException(String component, String errorCode, String message, Throwable cause)
      Creates 创建异常（完整参数）
      Parameters:
      component - the value | 组件名称
      errorCode - the value | 错误码
      message - the value | 异常消息
      cause - the value | 原始异常

  • Method Details

    • getErrorCode

      public String getErrorCode()
      Gets 获取错误码
      Returns:
      the result | 错误码，可能为 null

    • getComponent

      public String getComponent()
      Gets 获取组件名称
      Returns:
      the result | 组件名称，可能为 null

    • getRawMessage

      public String getRawMessage()
      Gets 获取原始消息（不含组件和错误码前缀）
      Returns:
      the result | 原始消息

    • getMessage

      public String getMessage()
      Gets 获取格式化的异常消息

      格式: [组件] (错误码) 消息

      Overrides:
      getMessage in class Throwable
      Returns:
      the result | 格式化的消息