com.levigo.util.log.qualified
Class AbstractQualifiedRuntimeException

java.lang.Object
  java.lang.Throwable
      java.lang.Exception
          java.lang.RuntimeException
              com.levigo.util.log.qualified.AbstractQualifiedRuntimeException

All Implemented Interfaces:

QualifiedLogEvent, QualifiedMessage, UnresolvedQualifiedLogEvent, UnresolvedQualifiedMessage, Serializable

Direct Known Subclasses:

JadiceRuntimeException

public abstract class AbstractQualifiedRuntimeException
extends RuntimeException
implements UnresolvedQualifiedLogEvent

Author:

hennejg

See Also:

Serialized Form

Constructor Summary

AbstractQualifiedRuntimeException(MessageID messageId, Object... args)

AbstractQualifiedRuntimeException(MessageID messageId, Throwable cause, Object... args)

Method Summary

Object[]	getArguments()
String	getId() returns the message id of this logging event in the format COMPONENT_ID-EVENT_ID.
Level	getLevel()
String	getMessage() Resolves and returns the human-readable message text of this qualified entity using the current default locale, i.e.
String	getMessage(Locale locale) Resolves and returns the human-readable message text of this qualified entity using the specified Locale.
MessageID	getMessageID()
Throwable	getThrowable() returns a associated Throwable which may be the cause of the QualifiedLogEvent.

Methods inherited from class java.lang.Throwable

fillInStackTrace, getCause, getLocalizedMessage, getStackTrace, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

AbstractQualifiedRuntimeException

public AbstractQualifiedRuntimeException(MessageID messageId,
                                         Object... args)

AbstractQualifiedRuntimeException

public AbstractQualifiedRuntimeException(MessageID messageId,
                                         Throwable cause,
                                         Object... args)

Method Detail

getMessageID

public MessageID getMessageID()

Specified by:

getMessageID in interface UnresolvedQualifiedMessage

getId

public String getId()

Description copied from interface: QualifiedMessage

returns the message id of this logging event in the format COMPONENT_ID-EVENT_ID. The COMPONENT_ID and EVENT_ID may contain arbitrary characters except the dash (-).

Specified by:

getId in interface QualifiedMessage

Returns:

getArguments

public Object[] getArguments()

Specified by:

getArguments in interface UnresolvedQualifiedMessage

getMessage

public String getMessage()

Description copied from interface: QualifiedMessage

Resolves and returns the human-readable message text of this qualified entity using the current default locale, i.e. the one returned by Locale.getDefault().

Caveats:

• Resolving the message text may consume an unpredictable amount of time.
• Message IDs are not guaranteed to be accompanied with a human-readable message. Therefore this method may return null.

Specified by:

getMessage in interface QualifiedMessage

Overrides:

getMessage in class Throwable

Returns:

a human readable message text for this QualifiedMessage entity.

getMessage

public String getMessage(Locale locale)

Description copied from interface: UnresolvedQualifiedMessage

Resolves and returns the human-readable message text of this qualified entity using the specified Locale. Message IDs are not guaranteed to be accompanied with a human-readable message. Therefore this method may return null.

Specified by:

getMessage in interface UnresolvedQualifiedMessage

Parameters:

locale - the Locale in which so resolve the message

Returns:

a human readable message text for this QualifiedMessage entity, or null if no human-readable message is available

getLevel

public Level getLevel()

Specified by:

getLevel in interface QualifiedLogEvent

getThrowable

public Throwable getThrowable()

Description copied from interface: QualifiedLogEvent

returns a associated Throwable which may be the cause of the QualifiedLogEvent.

Specified by:

getThrowable in interface QualifiedLogEvent

Returns:

a associated Throwable or null