org.clapper.util.misc

Class VersionMismatchException

java.lang.Object

java.lang.Throwable

java.lang.Exception

org.clapper.util.misc.NestedException

org.clapper.util.misc.VersionMismatchException

All Implemented Interfaces:

java.io.Serializable

public class VersionMismatchException
extends NestedException

Thrown by version-sensitive classes to indicate a fatal version mismatch.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
VersionMismatchException(java.lang.String message, java.lang.String expectedVersion, java.lang.String foundVersion) Constructs an exception containing an error message, but no nested exception.
VersionMismatchException(java.lang.String bundleName, java.lang.String messageKey, java.lang.String defaultMsg, java.lang.Object[] msgParams, java.lang.String expectedVersion, java.lang.String foundVersion) Constructs an exception containing a resource bundle name, a message key, and a default message (in case the resource bundle can't be found).
VersionMismatchException(java.lang.String bundleName, java.lang.String messageKey, java.lang.String defaultMsg, java.lang.Object[] msgParams, java.lang.Throwable exception, java.lang.String expectedVersion, java.lang.String foundVersion) Constructs an exception containing a resource bundle name, a message key, a default message format (in case the resource bundle can't be found), arguments to be incorporated in the message via java.text.MessageFormat, and another exception.
VersionMismatchException(java.lang.String bundleName, java.lang.String messageKey, java.lang.String defaultMsg, java.lang.String expectedVersion, java.lang.String foundVersion) Constructs an exception containing a resource bundle name, a message key, and a default message (in case the resource bundle can't be found).
VersionMismatchException(java.lang.String bundleName, java.lang.String messageKey, java.lang.String defaultMsg, java.lang.Throwable exception, java.lang.String expectedVersion, java.lang.String foundVersion) Constructs an exception containing a resource bundle name, a message key, a default message (in case the resource bundle can't be found), and another exception.
VersionMismatchException(java.lang.String message, java.lang.Throwable exception, java.lang.String expectedVersion, java.lang.String foundVersion) Constructs an exception containing another exception and a message.

Method Summary

Modifier and Type	Method and Description
java.lang.String	getExpectedVersion() Get the expected version string from this exception.
java.lang.String	getFoundVersion() Get the found version string from this exception.

Methods inherited from class org.clapper.util.misc.NestedException

getMessage, getMessage, getMessages, getMessages, getMessages, getNestedException, printStackTrace, printStackTrace, printStackTrace, printStackTrace, printStackTrace, printStackTrace, toString

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getStackTrace, getSuppressed, initCause, setStackTrace

Methods inherited from class java.lang.Object

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

Constructor Detail

VersionMismatchException

public VersionMismatchException(java.lang.String message,
                                java.lang.String expectedVersion,
                                java.lang.String foundVersion)

Constructs an exception containing an error message, but no nested exception.

Parameters:

message - the message to associate with this exception

expectedVersion - string representing the expected version

foundVersion - string representing the found version

See Also:

getExpectedVersion(), getFoundVersion()

VersionMismatchException

public VersionMismatchException(java.lang.String message,
                                java.lang.Throwable exception,
                                java.lang.String expectedVersion,
                                java.lang.String foundVersion)

Constructs an exception containing another exception and a message.

Parameters:

message - the message to associate with this exception

expectedVersion - string representing the expected version

foundVersion - string representing the found version

exception - the exception to contain

See Also:

getExpectedVersion(), getFoundVersion()

VersionMismatchException

public VersionMismatchException(java.lang.String bundleName,
                                java.lang.String messageKey,
                                java.lang.String defaultMsg,
                                java.lang.String expectedVersion,
                                java.lang.String foundVersion)

Constructs an exception containing a resource bundle name, a message key, and a default message (in case the resource bundle can't be found). Using this constructor is equivalent to calling the VersionMismatchException(String,String,String,Object[],String,String) constructor with a null pointer for the Object[] parameter. Calls to NestedException.getMessage(Locale) will attempt to retrieve the top-most message (i.e., the message from this exception, not from nested exceptions) by querying the named resource bundle. Calls to NestedException.printStackTrace(PrintWriter,Locale) will do the same, where applicable. The message is not retrieved until one of those methods is called, because the desired locale is passed into getMessage() and printStackTrace(), not this constructor.

Parameters:

bundleName - resource bundle name

messageKey - the key to the message to find in the bundle

defaultMsg - the default message

expectedVersion - string representing the expected version

foundVersion - string representing the found version

See Also:

getExpectedVersion(), getFoundVersion(), VersionMismatchException(String,String,String,Object[],String,String), Throwable.getLocalizedMessage()

VersionMismatchException

public VersionMismatchException(java.lang.String bundleName,
                                java.lang.String messageKey,
                                java.lang.String defaultMsg,
                                java.lang.Object[] msgParams,
                                java.lang.String expectedVersion,
                                java.lang.String foundVersion)

Constructs an exception containing a resource bundle name, a message key, and a default message (in case the resource bundle can't be found). Using this constructor is equivalent to calling the VersionMismatchException(String,String,String,Object[],String,String) constructor, with a null pointer for the Object[] parameter. Calls to NestedException.getMessage(Locale) will attempt to retrieve the top-most message (i.e., the message from this exception, not from nested exceptions) by querying the named resource bundle. Calls to NestedException.printStackTrace(PrintWriter,Locale) will do the same, where applicable. The message is not retrieved until one of those methods is called, because the desired locale is passed into getMessage() and printStackTrace(), not this constructor.

Parameters:

bundleName - resource bundle name

messageKey - the key to the message to find in the bundle

defaultMsg - the default message

msgParams - parameters to the message, if any, or null

expectedVersion - string representing the expected version

foundVersion - string representing the found version

See Also:

getExpectedVersion(), getFoundVersion(), VersionMismatchException(String,String,String,Object[],String,String), Throwable.getLocalizedMessage()

VersionMismatchException

public VersionMismatchException(java.lang.String bundleName,
                                java.lang.String messageKey,
                                java.lang.String defaultMsg,
                                java.lang.Throwable exception,
                                java.lang.String expectedVersion,
                                java.lang.String foundVersion)

Constructs an exception containing a resource bundle name, a message key, a default message (in case the resource bundle can't be found), and another exception. Using this constructor is equivalent to calling the VersionMismatchException(String,String,String,Object[],String,String) constructor, with a null pointer for the Object[] parameter. Calls to NestedException.getMessage(Locale) will attempt to retrieve the top-most message (i.e., the message from this exception, not from nested exceptions) by querying the named resource bundle. Calls to NestedException.printStackTrace(PrintWriter,Locale) will do the same, where applicable. The message is not retrieved until one of those methods is called, because the desired locale is passed into getMessage() and printStackTrace(), not this constructor.

Parameters:

bundleName - resource bundle name

messageKey - the key to the message to find in the bundle

defaultMsg - the default message

exception - the exception to nest

expectedVersion - string representing the expected version

foundVersion - string representing the found version

See Also:

getExpectedVersion(), getFoundVersion(), VersionMismatchException(String,String,String,Object[],String,String), NestedException.getMessage(Locale)

VersionMismatchException

public VersionMismatchException(java.lang.String bundleName,
                                java.lang.String messageKey,
                                java.lang.String defaultMsg,
                                java.lang.Object[] msgParams,
                                java.lang.Throwable exception,
                                java.lang.String expectedVersion,
                                java.lang.String foundVersion)

Constructs an exception containing a resource bundle name, a message key, a default message format (in case the resource bundle can't be found), arguments to be incorporated in the message via java.text.MessageFormat, and another exception. Calls to NestedException.getMessage(Locale) will attempt to retrieve the top-most message (i.e., the message from this exception, not from nested exceptions) by querying the named resource bundle. Calls to NestedException.printStackTrace(PrintWriter,Locale) will do the same, where applicable. The message is not retrieved until one of those methods is called, because the desired locale is passed into getMessage() and printStackTrace(), not this constructor.

Parameters:

bundleName - resource bundle name

messageKey - the key to the message to find in the bundle

defaultMsg - the default message

msgParams - parameters to the message, if any, or null

exception - exception to be nested

expectedVersion - string representing the expected version

foundVersion - string representing the found version

See Also:

getExpectedVersion(), getFoundVersion(), VersionMismatchException(String,String,String,Object[],String,String), NestedException.getMessage(Locale)

Method Detail

getExpectedVersion

public java.lang.String getExpectedVersion()

Get the expected version string from this exception.

Returns:

the expected version string

getFoundVersion

public java.lang.String getFoundVersion()

Get the found version string from this exception.

Returns:

the found version string