Class OpenImageCoreException

java.lang.Object
java.lang.Throwable
java.lang.Exception
java.lang.RuntimeException
java.lang.IllegalArgumentException
cloud.opencode.base.image.core.exception.OpenImageCoreException
All Implemented Interfaces:
OpenExceptionMeta, Serializable
public class OpenImageCoreException extends IllegalArgumentException implements OpenExceptionMeta
Argument-validation exception thrown by the image core module. 图像核心模块抛出的参数校验异常。

Indicates a failure rooted in core image data types — exceeding the MAX_PIXELS cap, raster buffer length mismatch, or codec-record / Raster interop length violation.

表示根植于核心图像数据类型的参数失败 — 超过 MAX_PIXELS 上限、 栅格缓冲长度不匹配，或 codec record 与 Raster 互通时的长度违规。

Hierarchy | 继承关系: Per the project's "upgrade-replacement" convention this class extends IllegalArgumentException (not OpenException) so that callers using catch (IllegalArgumentException e) or AssertJ isInstanceOf keep working, while OpenExceptionMeta provides component/error-code metadata. 按项目"升级替代"约定，本类继承 IllegalArgumentException（而非 OpenException），从而保持 JDK 习惯（catch、 isInstanceOf）依然生效；同时通过 OpenExceptionMeta 暴露组件名与错误码元数据。

Sister class | 姊妹类: For codec-layer runtime failures (decode bomb, malformed bytes, native-encoder error, magic-byte mismatch) see cloud.opencode.base.image.codec.exception.OpenImageCodecException, which extends OpenException. Semantic split: core = argument validation, codec = decode/encode runtime. codec 层的运行时失败（解码炸弹、字节畸形、原生编码器错误、magic byte 不匹配） 见 OpenImageCodecException（继承 OpenException）。语义分工： core = 参数校验、codec = 编解码运行时。

Since:
JDK 25, opencode-base-image V1.0.4
Author:
Leon Soo www.LeonSoo.com
See Also:

  • Constructor Details

    • OpenImageCoreException

      public OpenImageCoreException(String message)
      Constructs a new exception with the specified detail message. 用指定的详细信息构造新异常。
      Parameters:
      message - the detail message | 详细信息

    • OpenImageCoreException

      public OpenImageCoreException(String message, Throwable cause)
      Constructs a new exception with the specified detail message and cause. 用指定的详细信息和原因构造新异常。
      Parameters:
      message - the detail message | 详细信息
      cause - the cause | 原因

  • Method Details