Class OpenSignatureException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

cloud.opencode.base.crypto.exception.OpenSignatureException

All Implemented Interfaces:

Serializable

public class OpenSignatureException
extends RuntimeException

Exception for digital signature operations - Runtime exception for signature generation and verification failures 签名相关异常 - 数字签名生成和验证失败时的运行时异常

Features | 主要功能:

• Algorithm context in error messages - 错误消息中包含算法上下文
• Covers signature generation and verification failures - 涵盖签名生成和验证失败

Usage Examples | 使用示例:

throw new OpenSignatureException("Ed25519", "Signature verification failed");
throw new OpenSignatureException("Invalid signature", cause);

Security | 安全性:

• Thread-safe: Yes - 线程安全: 是
• Null-safe: Partial - 空值安全: 部分

Since:

JDK 25, opencode-base-crypto V1.0.0

Author:

Leon Soo www.LeonSoo.com

See Also:

• OpenCode.cloud
• Serialized Form

Constructor Summary

Constructors

Constructor	Description
OpenSignatureException(String message)	Constructs a new OpenSignatureException with the specified message.
OpenSignatureException(String algorithm, String message)	Constructs a new OpenSignatureException with algorithm and message.
OpenSignatureException(String algorithm, String message, Throwable cause)	Constructs a new OpenSignatureException with algorithm, message and cause.
OpenSignatureException(String message, Throwable cause)	Constructs a new OpenSignatureException with the specified message and cause.

Method Summary

Modifier and Type	Method	Description
String	algorithm()	Returns the signature algorithm associated with this exception.
static OpenSignatureException	invalidFormat(String algorithm, String format)	Creates an exception for invalid signature format.
static OpenSignatureException	invalidSignature(String algorithm)	Creates an exception for invalid signatures.
static OpenSignatureException	signFailed(String algorithm, Throwable cause)	Creates an exception for signature generation failures.
static OpenSignatureException	verifyFailed(String algorithm, Throwable cause)	Creates an exception for signature verification failures.

Methods inherited from class Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Details

OpenSignatureException

public OpenSignatureException(String message)

Constructs a new OpenSignatureException with the specified message. 使用指定消息构造新的签名异常

Parameters:

message - the detail message

OpenSignatureException

public OpenSignatureException(String message,
 Throwable cause)

Constructs a new OpenSignatureException with the specified message and cause. 使用指定消息和原因构造新的签名异常

Parameters:

message - the detail message

cause - the cause

OpenSignatureException

public OpenSignatureException(String algorithm,
 String message)

Constructs a new OpenSignatureException with algorithm and message. 使用算法和消息构造新的签名异常

Parameters:

algorithm - the signature algorithm

message - the detail message

OpenSignatureException

public OpenSignatureException(String algorithm,
 String message,
 Throwable cause)

Constructs a new OpenSignatureException with algorithm, message and cause. 使用算法、消息和原因构造新的签名异常

Parameters:

algorithm - the signature algorithm

message - the detail message

cause - the cause

Method Details

algorithm

public String algorithm()

Returns the signature algorithm associated with this exception. 返回与此异常关联的签名算法

Returns:

the algorithm, or null if not specified

signFailed

public static OpenSignatureException signFailed(String algorithm,
 Throwable cause)

Creates an exception for signature generation failures. 创建签名生成失败时的异常

Parameters:

algorithm - the signature algorithm

cause - the underlying cause

Returns:

a new OpenSignatureException

verifyFailed

public static OpenSignatureException verifyFailed(String algorithm,
 Throwable cause)

Creates an exception for signature verification failures. 创建签名验证失败时的异常

Parameters:

algorithm - the signature algorithm

cause - the underlying cause

Returns:

a new OpenSignatureException

invalidSignature

public static OpenSignatureException invalidSignature(String algorithm)

Creates an exception for invalid signatures. 创建签名无效时的异常

Parameters:

algorithm - the signature algorithm

Returns:

a new OpenSignatureException

invalidFormat

public static OpenSignatureException invalidFormat(String algorithm,
 String format)

Creates an exception for invalid signature format. 创建签名格式无效时的异常

Parameters:

algorithm - the signature algorithm

format - the invalid format description

Returns:

a new OpenSignatureException