Package org.deltava.util

Class ControllerException

java.lang.Object

java.lang.Throwable

java.lang.Exception

org.deltava.util.ControllerException

All Implemented Interfaces:

Serializable

Direct Known Subclasses:

CommandException, DAOException, GenericServlet.ForbiddenException, GenericServlet.NotFoundException, ServiceException

public abstract class ControllerException
extends Exception

An exception class to define a common singure for exceptions handled by the Command Controller servlet.

Since:

1.0

Version:

6.0

Author:

Luke

See Also:

• Serialized Form

Constructor Summary

Constructors

Constructor	Description
ControllerException(String msg)	Creates a new controller exception with a given message.
ControllerException(String msg, Throwable t)	Create a new ControllerException with an error message and underlying cause.
ControllerException(Throwable t)	Wraps a thrown exception.

Method Summary

Modifier and Type	Method	Description
String	getForwardURL()	Returns the URL that the Controller servlet should forward the request to.
boolean	getLogStackDump()	Returns whether the handling class should log this Exception's stack trace.
int	getStatusCode()	Returns the HTTP status code to set on the error page.
boolean	isWarning()	Returns whether this exception to be logged as a warning, not an error.
void	setForwardURL(String url)	Updates the URL that the Controller servlet should forward the request to.
void	setLogStackDump(boolean doLog)	Updates whether the handling class should log this Exception's stack trace.
void	setStatusCode(int code)	Sets the HTTP status code to set on the error page.
void	setWarning(boolean isWarn)	Sets this exception to be logged as a warning, not an error.

Methods inherited from class java.lang.Throwable

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

Methods inherited from class java.lang.Object

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

Constructor Details

ControllerException

public ControllerException(Throwable t)

Wraps a thrown exception. This assumes the stack trace of the original execption.

Parameters:

t - the thrown exception to wrap

See Also:

• Throwable.getCause()

ControllerException

public ControllerException(String msg)

Creates a new controller exception with a given message.

Parameters:

msg - the message for the exception

ControllerException

public ControllerException(String msg,
 Throwable t)

Create a new ControllerException with an error message and underlying cause.

Parameters:

msg - the error message

t - the root cause Exception

Method Details

getLogStackDump

public boolean getLogStackDump()

Returns whether the handling class should log this Exception's stack trace.

Returns:

TRUE if the stack trace should be logged, otherwise FALSE

See Also:

• setLogStackDump(boolean)

getForwardURL

public String getForwardURL()

Returns the URL that the Controller servlet should forward the request to.

Returns:

the URL to forward to, or null

See Also:

• setForwardURL(String)

isWarning

public boolean isWarning()

Returns whether this exception to be logged as a warning, not an error.

Returns:

TRUE if a warning, otherwise FALSE

See Also:

• setWarning(boolean)

getStatusCode

public int getStatusCode()

Returns the HTTP status code to set on the error page.

Returns:

the HTTP status code

See Also:

• setStatusCode(int)

setLogStackDump

public void setLogStackDump(boolean doLog)

Updates whether the handling class should log this Exception's stack trace.

Parameters:

doLog - TRUE if the stack trace should be logged, otherwise FALSE

See Also:

• getLogStackDump()

setForwardURL

public void setForwardURL(String url)

Updates the URL that the Controller servlet should forward the request to.

Parameters:

url - the URL to forward to

See Also:

• getForwardURL()

setWarning

public void setWarning(boolean isWarn)

Sets this exception to be logged as a warning, not an error.

Parameters:

isWarn - TRUE if a warning, otherwise FALSE

See Also:

• isWarning()

setStatusCode

public void setStatusCode(int code)

Sets the HTTP status code to set on the error page.

Parameters:

code - the HTTP status code

See Also:

• getStatusCode()