Package com.ibm.websphere.security

Class WSSecurityException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.security.GeneralSecurityException

com.ibm.websphere.security.WSSecurityException

All Implemented Interfaces:

Serializable

Direct Known Subclasses:

CertificateMapFailedException, CertificateMapNotSupportedException, CustomRegistryException, EntryNotFoundException, NotImplementedException, PasswordCheckFailedException

public class WSSecurityException
extends GeneralSecurityException
implements Serializable

This exception is a generic WebSphere Security exception. Most other WebSphere security exceptions extend this one.

See Also:

• Serialized Form

Constructor Summary

Constructors

Constructor	Description
WSSecurityException()	A default constructor.
WSSecurityException(String str)	A constructor that accepts an error message.
WSSecurityException(String str, Throwable t)	A constructor accepts an error message and original exception.
WSSecurityException(Throwable t)	A constructor that accepts a Throwable.

Method Summary

Modifier and Type	Method	Description
void	addException(Throwable t)	Add an exception that will be stored in an ArrayList.
Throwable	getCause()	Returns the root cause exception.
ArrayList	getExceptions()	Returns an ArrayList of exceptions that have been added to this exception.
void	printStackTrace()	Formats and prints all the exceptions added to the ArrayList using the addException API.

Methods inherited from class java.lang.Throwable

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

Methods inherited from class java.lang.Object

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

Constructor Details

WSSecurityException

public WSSecurityException()

A default constructor.

WSSecurityException

public WSSecurityException(String str)

A constructor that accepts an error message. The error message can be retrieved using the getMessage() API.

Parameters:

str - An error message.

WSSecurityException

public WSSecurityException(Throwable t)

A constructor that accepts a Throwable. The Throwable can be retrieved using the getExceptions() or getCause() API.

Parameters:

str - An error message.

WSSecurityException

public WSSecurityException(String str,
 Throwable t)

A constructor accepts an error message and original exception. The exception will be added to an ArrayList and other exceptions may be added along the way. The error message can be retrieved using the getMessage() API.

Parameters:

str - An error message.

t - Any exception type that extends Throwable.

Method Details

addException

public void addException(Throwable t)

Add an exception that will be stored in an ArrayList. The method getExceptions can return all the exceptions added via addException. You may also add an exception via the constructor. Use of this API allows exceptions to be propogated back to the originating caller.

Parameters:

t - Any exception type that extends Throwable

getCause

public Throwable getCause()

Returns the root cause exception.

Overrides:

getCause in class Throwable

Returns:

The Throwable root cause exception.

getExceptions

public ArrayList getExceptions()

Returns an ArrayList of exceptions that have been added to this exception.

Parameters:

t - Any exception type that extends Throwable

printStackTrace

public void printStackTrace()

Formats and prints all the exceptions added to the ArrayList using the addException API. The output will be printed to System error.

Overrides:

printStackTrace in class Throwable