de.smartics.exceptions
Class AbstractCoreRuntimeException

Package class diagram package AbstractCoreRuntimeException
java.lang.Object
  extended by java.lang.Throwable
      extended by java.lang.Exception
          extended by java.lang.RuntimeException
              extended by de.smartics.exceptions.AbstractCoreRuntimeException
All Implemented Interfaces:
CoreException, Serializable
Direct Known Subclasses:
AbstractLocalizedRuntimeException, AbstractMessageRuntimeException

public abstract class AbstractCoreRuntimeException
     
     
extends RuntimeException
implements CoreException

The base implementation of the core runtime exception that supports unique identifying and exception codes for unchecked exceptions.

See Also:
Serialized Form

Field Summary
protected  de.smartics.exceptions.ExceptionInfo info
          Reference to common exception information.
 
Constructor Summary
protected AbstractCoreRuntimeException(Code code)
          Constructor.
protected AbstractCoreRuntimeException(String message, Code code)
          Constructor.
protected AbstractCoreRuntimeException(String message, Throwable cause, Code code)
          Constructor.
protected AbstractCoreRuntimeException(Throwable cause, Code code)
          Constructor.
 
Method Summary
 Throwable getCause()
          Returns the cause of this throwable or null if the cause is nonexistent or unknown.
 Code getCode()
          Returns the error or exception code of the exception.
 ExceptionId<?> getId()
          Returns the unique identifier of the exception.
 Date getTime()
          Returns the time the exception has been raised.
 String toString()
          Returns the string representation of the exception.
 void truncateCause()
          Truncates the cause from the exception dependent on the ThrowableHandleMode set to the thread-local context.
 
Methods inherited from class java.lang.Throwable
fillInStackTrace, getLocalizedMessage, getMessage, getStackTrace, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 
Methods inherited from interface de.smartics.exceptions.CoreException
getLocalizedMessage, getMessage, getStackTrace, setStackTrace
 

Field Detail

info

protected final de.smartics.exceptions.ExceptionInfo info
Reference to common exception information. Currently this is the exception identifier and the exception code.

Constructor Detail

AbstractCoreRuntimeException

protected AbstractCoreRuntimeException(Code code)
Constructor.

Parameters:
code - the error or exception code of the exception.
See Also:
AbstractCoreRuntimeException(String, Throwable, Code)

AbstractCoreRuntimeException

protected AbstractCoreRuntimeException(String message,
                                       Code code)
Constructor.

Parameters:
message - the detail message (which is saved for later retrieval by the Throwable.getMessage() method). Only used if there is no localised message in the bundle.
code - the error or exception code of the exception.
See Also:
AbstractCoreRuntimeException(String, Throwable, Code)

AbstractCoreRuntimeException

protected AbstractCoreRuntimeException(Throwable cause,
                                       Code code)
Constructor.

Parameters:
cause - the cause (which is saved for later retrieval by the getCause() method). (A null value is permitted, and indicates that the cause is nonexistent or unknown.)
code - the error or exception code of the exception.
See Also:
AbstractCoreRuntimeException(String, Throwable, Code)

AbstractCoreRuntimeException

protected AbstractCoreRuntimeException(String message,
                                       Throwable cause,
                                       Code code)
                                throws NullPointerException
Constructor.

Parameters:
message - the detail message (which is saved for later retrieval by the Throwable.getMessage() method). Only used if there is no localised message in the bundle.
cause - the cause (which is saved for later retrieval by the getCause() method). (A null value is permitted, and indicates that the cause is nonexistent or unknown.)
code - the error or exception code of the exception.
Throws:
NullPointerException - if the code is null.
See Also:
RuntimeException.RuntimeException(java.lang.String,java.lang.Throwable)
Method Detail

getId

public final ExceptionId<?> getId()
Returns the unique identifier of the exception. The identifier is used to track an exception in different tiers.

This identifier must never be null.

Specified by:
getId in interface CoreException
Returns:
the unique identifier of the exception.

getCode

public final Code getCode()
Returns the error or exception code of the exception.

This code must never be null.

Specified by:
getCode in interface CoreException
Returns:
the error or exception code of the exception.

getTime

public final Date getTime()
Description copied from interface: CoreException
Returns the time the exception has been raised. The time instance is created and stored as soon as the exception is constructed.

Specified by:
getTime in interface CoreException
Returns:
the time the exception has been raised.

getCause

public final Throwable getCause()
Description copied from interface: CoreException
Returns the cause of this throwable or null if the cause is nonexistent or unknown. (The cause is the throwable that caused this throwable to get thrown.)

This implementation returns the cause that was supplied via one of the constructors requiring a Throwable. While it is typically unnecessary to override this method, a subclass can override it to return a cause set by some other means. This is appropriate for a "legacy chained throwable" that predates the addition of chained exceptions to Throwable. Note that it is not necessary to override any of the PrintStackTrace methods, all of which invoke the getCause method to determine the cause of a throwable.

Specified by:
getCause in interface CoreException
Overrides:
getCause in class Throwable
Returns:
the cause of this throwable or null if the cause is nonexistent or unknown.

truncateCause

public final void truncateCause()
Description copied from interface: CoreException
Truncates the cause from the exception dependent on the ThrowableHandleMode set to the thread-local context. After running this method the cause will be truncate and the full stack trace will no longer be available.

Specified by:
truncateCause in interface CoreException

toString

public String toString()
Returns the string representation of the exception.

May be overridden by subclasses in an application (not a library) to change the string representation. Usually an implementation of CodeMessageFormatter should be set to the de.smartics.exceptions.ExceptionContext.

Overrides:
toString in class Throwable
Returns:
the string representation of the object.


Copyright © 2007-2013 Kronseder & Reiner GmbH - smartics. All Rights Reserved.