Class OpenClassLoaderException

java.lang.Object
java.lang.Throwable
java.lang.Exception
java.lang.RuntimeException
cloud.opencode.base.core.exception.OpenException
cloud.opencode.base.classloader.exception.OpenClassLoaderException
All Implemented Interfaces:
Serializable
public class OpenClassLoaderException extends OpenException
ClassLoader Component Unified Exception ClassLoader 组件统一异常

Exception class for class loading, resource access and metadata reading operations.

用于类加载、资源访问和元数据读取操作的异常类。

Features | 主要功能:

  • Class not found exception - 类未找到异常
  • Class load failed exception - 类加载失败异常
  • Resource not found exception - 资源未找到异常
  • Resource read failed exception - 资源读取失败异常
  • Metadata parse failed exception - 元数据解析失败异常

Usage Examples | 使用示例:

throw OpenClassLoaderException.classNotFound("com.example.MyClass");
throw OpenClassLoaderException.resourceNotFound("config.yml");
throw OpenClassLoaderException.classLoadFailed("MyClass", cause);

Security | 安全性:

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

  • Constructor Details

    • OpenClassLoaderException

      public OpenClassLoaderException(String message)
      Create exception with message 创建带消息的异常
      Parameters:
      message - exception message | 异常消息

    • OpenClassLoaderException

      public OpenClassLoaderException(String message, Throwable cause)
      Create exception with message and cause 创建带消息和原因的异常
      Parameters:
      message - exception message | 异常消息
      cause - root cause | 原始异常

  • Method Details

    • classNotFound

      public static OpenClassLoaderException classNotFound(String className)
      Create class not found exception 创建类未找到异常
      Parameters:
      className - class name | 类名
      Returns:
      exception instance | 异常实例

    • classNotFound

      public static OpenClassLoaderException classNotFound(String className, Throwable cause)
      Create class not found exception with cause 创建带原因的类未找到异常
      Parameters:
      className - class name | 类名
      cause - root cause | 原始异常
      Returns:
      exception instance | 异常实例

    • classLoadFailed

      public static OpenClassLoaderException classLoadFailed(String className, Throwable cause)
      Create class load failed exception 创建类加载失败异常
      Parameters:
      className - class name | 类名
      cause - root cause | 原始异常
      Returns:
      exception instance | 异常实例

    • resourceNotFound

      public static OpenClassLoaderException resourceNotFound(String resourceName)
      Create resource not found exception 创建资源未找到异常
      Parameters:
      resourceName - resource name | 资源名
      Returns:
      exception instance | 异常实例

    • resourceReadFailed

      public static OpenClassLoaderException resourceReadFailed(String resourceName, Throwable cause)
      Create resource read failed exception 创建资源读取失败异常
      Parameters:
      resourceName - resource name | 资源名
      cause - root cause | 原始异常
      Returns:
      exception instance | 异常实例

    • metadataParseFailed

      public static OpenClassLoaderException metadataParseFailed(String className, Throwable cause)
      Create metadata parse failed exception 创建元数据解析失败异常
      Parameters:
      className - class name | 类名
      cause - root cause | 原始异常
      Returns:
      exception instance | 异常实例

    • scanFailed

      public static OpenClassLoaderException scanFailed(String packageName, Throwable cause)
      Create scan failed exception 创建扫描失败异常
      Parameters:
      packageName - package name | 包名
      cause - root cause | 原始异常
      Returns:
      exception instance | 异常实例

    • classLoaderClosed

      public static OpenClassLoaderException classLoaderClosed()
      Create class loader closed exception 创建类加载器已关闭异常
      Returns:
      exception instance | 异常实例

    • getClassName

      public Optional<String> getClassName()
      Get the class name associated with this exception 获取与此异常关联的类名
      Returns:
      optional class name | 可选的类名

    • getResourceName

      public Optional<String> getResourceName()
      Get the resource name associated with this exception 获取与此异常关联的资源名
      Returns:
      optional resource name | 可选的资源名