javax.portlet

Class PortletException

public class PortletException extends Exception

The PortletException class defines a general exception that a portlet can throw when it is unable to perform its operation successfully.
Field Summary
Throwablecause
Constructor Summary
PortletException()
Constructs a new portlet exception.
PortletException(String text)
Constructs a new portlet exception with the given text.
PortletException(String text, Throwable cause)
Constructs a new portlet exception when the portlet needs to do the following:
  • throw an exception
  • include the "root cause" exception
  • include a description message
PortletException(Throwable cause)
Constructs a new portlet exception when the portlet needs to throw an exception.
Method Summary
ThrowablegetCause()
Returns the cause of this throwable or null if the cause is nonexistent or unknown.
voidprintStackTrace()
Prints the stack trace of this exception to the standard error stream.
voidprintStackTrace(PrintStream out)
Prints the stack trace of this exception to the specified print stream.
voidprintStackTrace(PrintWriter out)
Prints the stack trace of this exception to the specified print writer.

Field Detail

cause

private Throwable cause

Constructor Detail

PortletException

public PortletException()
Constructs a new portlet exception.

PortletException

public PortletException(String text)
Constructs a new portlet exception with the given text. The portlet container may use the text write it to a log.

Parameters: text the exception text

PortletException

public PortletException(String text, Throwable cause)
Constructs a new portlet exception when the portlet needs to do the following:

Parameters: text the exception text cause the root cause

PortletException

public PortletException(Throwable cause)
Constructs a new portlet exception when the portlet needs to throw an exception. The exception's message is based on the localized message of the underlying exception.

Parameters: cause the root cause

Method Detail

getCause

public Throwable getCause()
Returns the cause of this throwable or null if the cause is nonexistent or unknown. (The cause is the throwable that caused this throwable to get thrown.)

This implementation returns the cause that was supplied via one of the constructors requiring a Throwable.

Returns: the cause of this throwable or null if the cause is nonexistent or unknown.

printStackTrace

public void printStackTrace()
Prints the stack trace of this exception to the standard error stream.

printStackTrace

public void printStackTrace(PrintStream out)
Prints the stack trace of this exception to the specified print stream.

Parameters: out the PrintStream to be used for output

printStackTrace

public void printStackTrace(PrintWriter out)
Prints the stack trace of this exception to the specified print writer.

Parameters: out the PrintWriter to be used for output