Class OpenFunctionalException

All Implemented Interfaces:
Serializable
Direct Known Subclasses:
OpenMatchException

public class OpenFunctionalException extends OpenException
OpenFunctionalException - Base exception for functional operations OpenFunctionalException - 函数式操作的基础异常

Base exception for all functional programming related errors including monad failures, computation errors, and pipeline exceptions.

所有函数式编程相关错误的基础异常,包括 Monad 失败、计算错误和管道异常。

Features | 主要功能:

  • Component identification - 组件标识
  • Error code support - 错误码支持
  • Factory methods for common errors - 常见错误的工厂方法

Usage Examples | 使用示例:

// Direct creation
throw new OpenFunctionalException("Computation failed");

// With cause
throw new OpenFunctionalException("Mapping failed", cause);

// Factory methods
throw OpenFunctionalException.computationFailed("Division by zero");
throw OpenFunctionalException.noValue("Option is empty");

Security | 安全性:

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

    • COMPONENT

      protected static final String COMPONENT
      Component name for functional module 函数式模块的组件名称
      See Also:
  • Constructor Details

    • OpenFunctionalException

      public OpenFunctionalException(String message)
      Create exception with message 创建带消息的异常
      Parameters:
      message - error message | 错误消息
    • OpenFunctionalException

      public OpenFunctionalException(String message, Throwable cause)
      Create exception with message and cause 创建带消息和原因的异常
      Parameters:
      message - error message | 错误消息
      cause - original exception | 原始异常
    • OpenFunctionalException

      public OpenFunctionalException(String errorCode, String message)
      Create exception with error code and message 创建带错误码和消息的异常
      Parameters:
      errorCode - error code | 错误码
      message - error message | 错误消息
    • OpenFunctionalException

      public OpenFunctionalException(String errorCode, String message, Throwable cause)
      Create exception with error code, message and cause 创建带错误码、消息和原因的异常
      Parameters:
      errorCode - error code | 错误码
      message - error message | 错误消息
      cause - original exception | 原始异常
  • Method Details

    • computationFailed

      public static OpenFunctionalException computationFailed(String message)
      Create exception for computation failure 为计算失败创建异常
      Parameters:
      message - error message | 错误消息
      Returns:
      exception instance | 异常实例
    • computationFailed

      public static OpenFunctionalException computationFailed(String message, Throwable cause)
      Create exception for computation failure with cause 为带原因的计算失败创建异常
      Parameters:
      message - error message | 错误消息
      cause - original exception | 原始异常
      Returns:
      exception instance | 异常实例
    • noValue

      public static OpenFunctionalException noValue(String message)
      Create exception for missing value 为缺少值创建异常
      Parameters:
      message - error message | 错误消息
      Returns:
      exception instance | 异常实例
    • invalidState

      public static OpenFunctionalException invalidState(String message)
      Create exception for invalid state 为无效状态创建异常
      Parameters:
      message - error message | 错误消息
      Returns:
      exception instance | 异常实例
    • mappingFailed

      public static OpenFunctionalException mappingFailed(Throwable cause)
      Create exception for mapping failure 为映射失败创建异常
      Parameters:
      cause - original exception | 原始异常
      Returns:
      exception instance | 异常实例
    • filterFailed

      public static OpenFunctionalException filterFailed(String message)
      Create exception for filter failure 为过滤失败创建异常
      Parameters:
      message - error message | 错误消息
      Returns:
      exception instance | 异常实例