Package org.apache.juneau

Class BasicRuntimeException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

org.apache.juneau.BasicRuntimeException

All Implemented Interfaces:

Serializable

Direct Known Subclasses:

BasicHttpException, BeanRuntimeException, ClassMetaRuntimeException, ConfigException, ContextRuntimeException, ExecutableException, InvalidAnnotationException, InvalidDataConversionException, ObjectRestException, ParseException, PatternException, RemoteMetadataException, SerializeException, VarResolverException

public class BasicRuntimeException
extends RuntimeException

Subclass of runtime exceptions that take in a message and zero or more arguments.

See Also:

Constructor Summary

Constructors

Constructor	Description
BasicRuntimeException(String message, Object... args)	Constructor.
BasicRuntimeException(Throwable cause)	Constructor.
BasicRuntimeException(Throwable cause, String message, Object... args)	Constructor.

Method Summary

Modifier and Type	Method	Description
protected final void	assertModifiable()	Throws an UnsupportedOperationException if the unmodifiable flag is set on this bean.
Throwable	fillInStackTrace()
<T extends Throwable> T	getCause(Class<T> c)	Same as Throwable.getCause() but searches the throwable chain for an exception of the specified type.
String	getMessage()
Throwable	initCause(Throwable cause)
boolean	isUnmodifiable()	Returns true if this bean is unmodifiable.
BasicRuntimeException	setMessage(String message, Object... args)	Sets the detail message on this exception.
void	setStackTrace(StackTraceElement[] stackTrace)
protected BasicRuntimeException	setUnmodifiable()	Specifies whether this bean should be unmodifiable.
Throwable	unwrap()	Returns the caused-by exception if there is one.

Methods inherited from class java.lang.Throwable

addSuppressed, getCause, getLocalizedMessage, getStackTrace, getSuppressed, printStackTrace, printStackTrace, printStackTrace, toString

Methods inherited from class java.lang.Object

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

Constructor Details

BasicRuntimeException

public BasicRuntimeException(Throwable cause,
 String message,
 Object... args)

Constructor.

Parameters:

cause - The cause of this exception.

message - The MessageFormat-style message.

args - Optional MessageFormat-style arguments.

BasicRuntimeException

public BasicRuntimeException(String message,
 Object... args)

Constructor.

Parameters:

message - The MessageFormat-style message.

args - Optional MessageFormat-style arguments.

BasicRuntimeException

public BasicRuntimeException(Throwable cause)

Constructor.

Parameters:

cause - The cause of this exception.

Method Details

setUnmodifiable

protected BasicRuntimeException setUnmodifiable()

Specifies whether this bean should be unmodifiable.

When enabled, attempting to set any properties on this bean will cause an UnsupportedOperationException.

Returns:

This object.

isUnmodifiable

public boolean isUnmodifiable()

Returns true if this bean is unmodifiable.

Returns:

true if this bean is unmodifiable.

assertModifiable

protected final void assertModifiable()

Throws an UnsupportedOperationException if the unmodifiable flag is set on this bean.

getCause

public <T extends Throwable> T getCause(Class<T> c)

Same as Throwable.getCause() but searches the throwable chain for an exception of the specified type.

Type Parameters:

T - The throwable type to search for.

Parameters:

c - The throwable type to search for.

Returns:

The exception, or null if not found.

setMessage

public BasicRuntimeException setMessage(String message,
 Object... args)

Sets the detail message on this exception.

Parameters:

message - The message.

args - The message args.

Returns:

This object.

getMessage

public String getMessage()

Overrides:

getMessage in class Throwable

fillInStackTrace

public Throwable fillInStackTrace()

Overrides:

fillInStackTrace in class Throwable

initCause

public Throwable initCause(Throwable cause)

Overrides:

initCause in class Throwable

setStackTrace

public void setStackTrace(StackTraceElement[] stackTrace)

Overrides:

setStackTrace in class Throwable

unwrap

public Throwable unwrap()

Returns the caused-by exception if there is one.

Returns:

The caused-by exception if there is one, or this exception if there isn't.