Package studio.mevera.imperat.exception

Class ResponseException

java.lang.Object

java.lang.Throwable

java.lang.Exception

studio.mevera.imperat.exception.CommandException

studio.mevera.imperat.exception.ResponseException

All Implemented Interfaces:

Serializable

Direct Known Subclasses:

ArgumentParseException

public abstract class ResponseException
extends CommandException

Base class for all exceptions whose user-facing message is driven by the ResponseRegistry — i.e. argument parsing failures, flag errors, validation violations, and cooldowns.

The central throwable resolver handles every ResponseException uniformly: it looks up the ResponseKey in the registry and sends the resolved content (with placeholders) to the source.

NOT for structural/flow exceptions like InvalidSyntaxException or PermissionDeniedException — those extend CommandException directly and carry their own plain message.

See Also:

• Serialized Form

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	ResponseException(@NotNull ResponseKey responseKey)
protected	ResponseException(@NotNull ResponseKey responseKey, @Nullable PlaceholderDataProvider placeholderDataProvider)

Method Summary

Modifier and Type	Method	Description
@Nullable PlaceholderDataProvider	getPlaceholderDataProvider()
@NotNull ResponseKey	getResponseKey()	Guaranteed non-null — every ResponseException must carry a key.
static ResponseException	of(@NotNull ResponseKey responseKey)	Factory for creating an inline ResponseException with the given key.
<S extends CommandSource> ResponseException	withContextPlaceholders(CommandContext<S> ctx)
ResponseException	withPlaceholder(String key, String value)
ResponseException	withPlaceholder(String key, Supplier<String> valueSupplier)
ResponseException	withPlaceholder(Placeholder placeholder)

Methods inherited from class java.lang.Throwable

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

Methods inherited from class java.lang.Object

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

Constructor Details

ResponseException

protected ResponseException(@NotNull
 @NotNull ResponseKey responseKey)

Parameters:

responseKey - the registry key used to look up the response message

ResponseException

protected ResponseException(@NotNull
 @NotNull ResponseKey responseKey,
 @Nullable
 @Nullable PlaceholderDataProvider placeholderDataProvider)

Method Details

of

public static ResponseException of(@NotNull
 @NotNull ResponseKey responseKey)

Factory for creating an inline ResponseException with the given key.

getResponseKey

@NotNull
public @NotNull ResponseKey getResponseKey()

Guaranteed non-null — every ResponseException must carry a key.

getPlaceholderDataProvider

@Nullable
public @Nullable PlaceholderDataProvider getPlaceholderDataProvider()

withPlaceholder

public ResponseException withPlaceholder(String key,
 String value)

withPlaceholder

public ResponseException withPlaceholder(String key,
 Supplier<String> valueSupplier)

withContextPlaceholders

public <S extends CommandSource> ResponseException withContextPlaceholders(CommandContext<S> ctx)

withPlaceholder

public ResponseException withPlaceholder(Placeholder placeholder)