Class AbstractHiddenException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

org.refcodes.exception.AbstractHiddenException

All Implemented Interfaces:

Serializable, ErrorCodeAccessor, Trap

public abstract class AbstractHiddenException
extends RuntimeException
implements Trap

Base exception for hidden (unchecked) / subsystem exceptions, providing functionality for exception specific multi-language messages. A hidden exception is an exception not representing the behavior of a system by its declared checked and runtime exceptions. Moreover, hidden exceptions may originate from subsystems wrapped by a system without the wrapping system being able to declare the actual subsystem's aCause in its declarations (due to e.g. interface compliance reasons). You as a programmer cannot take care to prevent such exception as them may be even undocumented. Such exceptions may be exceptions wrapping an actual aCause. Requiring a hidden exceptions may point to problems of your software design, the use of hidden exceptrions should be avoided.

See Also:

• Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from interface ErrorCodeAccessor

ErrorCodeAccessor.ErrorCodeBuilder<B>, ErrorCodeAccessor.ErrorCodeMutator, ErrorCodeAccessor.ErrorCodeProperty

Constructor Summary

Constructors

Constructor	Description
AbstractHiddenException(String aMessage, Throwable aCause)	Instantiates the class AbstractHiddenException.
AbstractHiddenException(String aMessage, Throwable aCause, String aErrorCode)	Instantiates the class AbstractHiddenException.
AbstractHiddenException(Throwable aCause)	Instantiates the class AbstractHiddenException.
AbstractHiddenException(Throwable aCause, String aErrorCode)	Instantiates the class AbstractHiddenException.

Method Summary

Modifier and Type	Method	Description
String	getErrorCode()	Provides the according exception code.

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

Methods inherited from interface Trap

getPatternArguments, toLocalizedMessage, toMessage, toMessage, toMessage, toShortLocalizedMessage, toShortMessage

Constructor Details

AbstractHiddenException

public AbstractHiddenException(String aMessage,
 Throwable aCause)

Instantiates the class AbstractHiddenException.

See Also:

• RuntimeException(java.lang.String, java.lang.Throwable)

AbstractHiddenException

public AbstractHiddenException(Throwable aCause)

Instantiates the class AbstractHiddenException.

See Also:

• RuntimeException(java.lang.Throwable)

AbstractHiddenException

public AbstractHiddenException(String aMessage,
 Throwable aCause,
 String aErrorCode)

Instantiates the class AbstractHiddenException.

Parameters:

aErrorCode - The exception code to be assigned to the exception. An exception code can be provided when creating an exception and it can be used by the business logic to retrieve a language depended exception aMessage (multi-language support) from a language pack instead of just providing the single language aMessage as being stored by the default exceptions.

See Also:

• RuntimeException(java.lang.String, java.lang.Throwable)

AbstractHiddenException

public AbstractHiddenException(Throwable aCause,
 String aErrorCode)

Instantiates the class AbstractHiddenException.

Parameters:

aErrorCode - The exception code to be assigned to the exception. An exception code can be provided when creating an exception and it can be used by the business logic to retrieve a language depended exception aMessage (multi-language support) from a language pack instead of just providing the single language aMessage as being stored by the default exceptions.

See Also:

• RuntimeException(java.lang.Throwable)

Method Details

getErrorCode

public String getErrorCode()

Provides the according exception code. An exception code can be provided when creating an exception and it can be used by the business logic to retrieve a language depended exception aMessage (multi-language support) from a language pack instead of just providing the single language aMessage as being stored by the default exceptions.

Specified by:

getErrorCode in interface ErrorCodeAccessor

Returns:

The exception code in question.