Package org.apache.commons.math

Class MathException

java.lang.Object

java.lang.Throwable

java.lang.Exception

org.apache.commons.math.MathException

All Implemented Interfaces:

Serializable, MathThrowable

Direct Known Subclasses:

CardanEulerSingularityException, ConvergenceException, DerivativeException, DimensionMismatchException, DuplicateSampleAbscissaException, EstimationException, EventException, FunctionEvaluationException, IntegratorException, MathConfigurationException, NotARotationMatrixException, NotPositiveDefiniteMatrixException, NotSymmetricMatrixException

public class MathException
extends Exception
implements MathThrowable

Base class for commons-math checked exceptions.

Supports nesting, emulating JDK 1.4 behavior if necessary.

Adapted from .

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor	Description
MathException()	Constructs a new MathException with no detail message.
MathException(String pattern, Object... arguments)	Deprecated. as of 2.2 replaced by MathException(Localizable, Object...)
MathException(Throwable rootCause)	Constructs a new MathException with specified nested Throwable root cause.
MathException(Throwable rootCause, String pattern, Object... arguments)	Deprecated. as of 2.2 replaced by MathException(Throwable, Localizable, Object...)
MathException(Throwable rootCause, Localizable pattern, Object... arguments)	Constructs a new MathException with specified formatted detail message and nested Throwable root cause.
MathException(Localizable pattern, Object... arguments)	Constructs a new MathException with specified formatted detail message.

Method Summary

Modifier and Type	Method	Description
Object[]	getArguments()	Gets the arguments used to build the message of this throwable.
Localizable	getGeneralPattern()	Gets the localizable pattern used to build the general part of the message of this throwable.
String	getLocalizedMessage()	Gets the message in the system default locale.
String	getMessage()	Gets the message in a conventional US locale.
String	getMessage(Locale locale)	Gets the message in a specified locale.
String	getPattern()	Deprecated. as of 2.2 replaced by getSpecificPattern() and getGeneralPattern()
Localizable	getSpecificPattern()	Gets the localizable pattern used to build the specific part of the message of this throwable.
void	printStackTrace()	Prints the stack trace of this exception to the standard error stream.
void	printStackTrace(PrintStream out)	Prints the stack trace of this exception to the specified stream.

Methods inherited from class java.lang.Throwable

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

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

MathException

public MathException()

Constructs a new MathException with no detail message.

MathException

@Deprecated
public MathException(String pattern,
                     Object... arguments)

Deprecated.

as of 2.2 replaced by MathException(Localizable, Object...)

Constructs a new MathException with specified formatted detail message. Message formatting is delegated to MessageFormat.

Parameters:

pattern - format specifier

arguments - format arguments

MathException

public MathException(Localizable pattern,
                     Object... arguments)

Constructs a new MathException with specified formatted detail message. Message formatting is delegated to MessageFormat.

Parameters:

pattern - format specifier

arguments - format arguments

Since:

2.2

MathException

public MathException(Throwable rootCause)

Constructs a new MathException with specified nested Throwable root cause.

Parameters:

rootCause - the exception or error that caused this exception to be thrown.

MathException

@Deprecated
public MathException(Throwable rootCause,
                     String pattern,
                     Object... arguments)

Deprecated.

as of 2.2 replaced by MathException(Throwable, Localizable, Object...)

Constructs a new MathException with specified formatted detail message and nested Throwable root cause. Message formatting is delegated to MessageFormat.

Parameters:

rootCause - the exception or error that caused this exception to be thrown.

pattern - format specifier

arguments - format arguments

Since:

1.2

MathException

public MathException(Throwable rootCause,
                     Localizable pattern,
                     Object... arguments)

Constructs a new MathException with specified formatted detail message and nested Throwable root cause. Message formatting is delegated to MessageFormat.

Parameters:

rootCause - the exception or error that caused this exception to be thrown.

pattern - format specifier

arguments - format arguments

Since:

2.2

Method Detail

getPattern

@Deprecated
public String getPattern()

Deprecated.

as of 2.2 replaced by getSpecificPattern() and getGeneralPattern()

Gets the pattern used to build the message of this throwable.

Returns:

the pattern used to build the message of this throwable

Since:

1.2

getSpecificPattern

public Localizable getSpecificPattern()

Gets the localizable pattern used to build the specific part of the message of this throwable.

Specified by:

getSpecificPattern in interface MathThrowable

Returns:

localizable pattern used to build the specific part of the message of this throwable

Since:

2.2

getGeneralPattern

public Localizable getGeneralPattern()

Gets the localizable pattern used to build the general part of the message of this throwable.

Specified by:

getGeneralPattern in interface MathThrowable

Returns:

localizable pattern used to build the general part of the message of this throwable

Since:

2.2

getArguments

public Object[] getArguments()

Gets the arguments used to build the message of this throwable.

Specified by:

getArguments in interface MathThrowable

Returns:

the arguments used to build the message of this throwable

getMessage

public String getMessage(Locale locale)

Gets the message in a specified locale.

Specified by:

getMessage in interface MathThrowable

Parameters:

locale - Locale in which the message should be translated

Returns:

localized message

Since:

1.2

getMessage

public String getMessage()

Gets the message in a conventional US locale.

Specified by:

getMessage in interface MathThrowable

Overrides:

getMessage in class Throwable

Returns:

localized message

getLocalizedMessage

public String getLocalizedMessage()

Gets the message in the system default locale.

Specified by:

getLocalizedMessage in interface MathThrowable

Overrides:

getLocalizedMessage in class Throwable

Returns:

localized message

printStackTrace

public void printStackTrace()

Prints the stack trace of this exception to the standard error stream.

Overrides:

printStackTrace in class Throwable

printStackTrace

public void printStackTrace(PrintStream out)

Prints the stack trace of this exception to the specified stream.

Overrides:

printStackTrace in class Throwable

Parameters:

out - the PrintStream to use for output