org.opencms.main
Class CmsRuntimeException

java.lang.Object
  java.lang.Throwable
      java.lang.Exception
          java.lang.RuntimeException
              org.opencms.main.CmsRuntimeException

All Implemented Interfaces:

Serializable, I_CmsThrowable

Direct Known Subclasses:

CmsIllegalArgumentException, CmsIllegalStateException, CmsInitException

public class CmsRuntimeException
extends RuntimeException
implements I_CmsThrowable

A replacement for RuntimeException to obtain fully localized exception messages for OpenCms.

Since:

6.0.0

See Also:

Serialized Form

Field Summary

protected CmsMessageContainer

m_message The container for the localized message.

Constructor Summary

CmsRuntimeException(CmsMessageContainer message)
Creates a new localized Exception.

CmsRuntimeException(CmsMessageContainer message, Throwable cause)
Creates a new localized Exception that also containes a root cause.

Method Summary

CmsRuntimeException	createException(CmsMessageContainer container, Throwable cause) Creates a copied instance of this localized exception.
String	getLocalizedMessage() Returns a localized exception message based on the OpenCms default locale.
String	getLocalizedMessage(Locale locale) Returns a localized exception message based on the given Locale.
String	getMessage() Returns a localized exception message based on the OpenCms default locale.
CmsMessageContainer	getMessageContainer() Returns the localized message container used to build this localized exception.

Methods inherited from class java.lang.Throwable

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

Methods inherited from class java.lang.Object

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

Field Detail

m_message

protected CmsMessageContainer m_message

The container for the localized message.

Constructor Detail

CmsRuntimeException

public CmsRuntimeException(CmsMessageContainer message)

Creates a new localized Exception.

Parameters:

message - the localized message container to use

CmsRuntimeException

public CmsRuntimeException(CmsMessageContainer message,
                           Throwable cause)

Creates a new localized Exception that also containes a root cause.

Parameters:

message - the localized message container to use

cause - the Exception root cause

Method Detail

createException

public CmsRuntimeException createException(CmsMessageContainer container,
                                           Throwable cause)

Creates a copied instance of this localized exception.

Parameters:

container - the message container

cause - the root cause

Returns:

a copied instance of this localized exception

getLocalizedMessage

public String getLocalizedMessage()

Description copied from interface: I_CmsThrowable

Returns a localized exception message based on the OpenCms default locale.

Specified by:

getLocalizedMessage in interface I_CmsThrowable

Overrides:

getLocalizedMessage in class Throwable

Returns:

a localized exception message based on the OpenCms default locale

See Also:

I_CmsThrowable.getLocalizedMessage()

getLocalizedMessage

public String getLocalizedMessage(Locale locale)

Description copied from interface: I_CmsThrowable

Returns a localized exception message based on the given Locale.

Specified by:

getLocalizedMessage in interface I_CmsThrowable

Parameters:

locale - the Locale to get the message for

Returns:

a localized exception message based on the given Locale

See Also:

I_CmsThrowable.getLocalizedMessage(Locale)

getMessage

public String getMessage()

Description copied from interface: I_CmsThrowable

Returns a localized exception message based on the OpenCms default locale.

Specified by:

getMessage in interface I_CmsThrowable

Overrides:

getMessage in class Throwable

Returns:

a localized exception message based on the OpenCms default locale

See Also:

Throwable.getMessage()

getMessageContainer

public CmsMessageContainer getMessageContainer()

Description copied from interface: I_CmsThrowable

Returns the localized message container used to build this localized exception.

Specified by:

getMessageContainer in interface I_CmsThrowable

Returns:

the localized message container used to build this localized exception

See Also:

I_CmsThrowable.getMessageContainer()