Package com.iplanet.am.sdk

Class AMException

java.lang.Object

java.lang.Throwable

java.lang.Exception

com.iplanet.am.sdk.AMException

All Implemented Interfaces:

L10NMessage, Serializable

Direct Known Subclasses:

AMEntryExistsException, AMEventManagerException, AMInvalidDNException, AMPostCallBackException, AMPreCallBackException

public class AMException
extends Exception
implements L10NMessage

Deprecated.

As of Sun Java System Access Manager 7.1.

The AMException is thrown whenever an error is is encountered while performing an operation on the data store.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor	Description
AMException(SSOToken token, String errorCode)	Deprecated. Convenience method (protected)
AMException(SSOToken token, String errorCode, UMSException ue)	Deprecated. Constructs a new AMException with detailed message.
AMException(String msg, String errorCode)	Deprecated. Constructs a new AMException with detailed message.
AMException(String msg, String errorCode, UMSException ue)	Deprecated. Constructs a new AMException with detailed message.
AMException(String msg, String errorCode, Object[] args)	Deprecated. Constructs a new AMException with detailed message.
AMException(String msg, String errorCode, Object[] args, UMSException ue)	Deprecated. Constructs a new AMException with detailed message.

Method Summary

Modifier and Type	Method	Description
String	getErrorCode()	Deprecated. Returns the error code.
String	getL10NMessage(Locale locale)	Deprecated. Returns localized error message.
String	getLDAPErrorCode()	Deprecated. Method to obtain the LDAP error code.
org.forgerock.opendj.ldap.LdapException	getLDAPException()	Deprecated. Returns the root LDAPException of this AMException, if any.
String	getMessage()	Deprecated. Overrides the default getMessage() method of super class Exception.
Object[]	getMessageArgs()	Deprecated. Returns the arguments corresponding to the error code.
String	getResourceBundleName()	Deprecated. Returns ResourceBundle Name associated with this exception

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, 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 Detail

AMException

public AMException(String msg,
                   String errorCode)

Deprecated.

Constructs a new AMException with detailed message.

Parameters:

msg - The detailed message

errorCode - Matches the appropriate entry in amProfile.properties.

AMException

public AMException(SSOToken token,
                   String errorCode)

Deprecated.

Convenience method (protected)

AMException

public AMException(String msg,
                   String errorCode,
                   UMSException ue)

Deprecated.

Constructs a new AMException with detailed message.

Parameters:

msg - The detailed message.

errorCode - Matches the appropriate entry in amProfile.properties.

ue - if the root cause is a UMSException.

AMException

public AMException(SSOToken token,
                   String errorCode,
                   UMSException ue)

Deprecated.

Constructs a new AMException with detailed message.

Parameters:

token - a valid single sign on token of the user performing the operation.

errorCode - Matches the appropriate entry in amProfile.properties.

ue - if the root cause is a UMSException.

AMException

public AMException(String msg,
                   String errorCode,
                   Object[] args)

Deprecated.

Constructs a new AMException with detailed message.

Parameters:

msg - The detailed message.

errorCode - Matches the appropriate entry in amProfile.properties.

args - arguments if the error message needs specific values to be set.

AMException

public AMException(String msg,
                   String errorCode,
                   Object[] args,
                   UMSException ue)

Deprecated.

Constructs a new AMException with detailed message.

Parameters:

msg - The detailed message

errorCode - Matches the appropriate entry in amProfile.properties.

args - if the error message needs specific values to be set.

ue - if the root cause is a UMSException.

Method Detail

getErrorCode

public String getErrorCode()

Deprecated.

Returns the error code. This error code can be used with the arguments to construct a localized message.

Specified by:

getErrorCode in interface L10NMessage

Returns:

the error code which can be used to map the message to a user specific locale.

getMessageArgs

public Object[] getMessageArgs()

Deprecated.

Returns the arguments corresponding to the error code.

Specified by:

getMessageArgs in interface L10NMessage

Returns:

the arguments corresponding to the error code or null if no arguments are need to construct the message.

getMessage

public String getMessage()

Deprecated.

Overrides the default getMessage() method of super class Exception.

Specified by:

getMessage in interface L10NMessage

Overrides:

getMessage in class Throwable

Returns:

The error message string.

getLDAPErrorCode

public String getLDAPErrorCode()

Deprecated.

Method to obtain the LDAP error code.

Returns:

The error code, which can be used to map the message to a specific locale. Returns a null, if not an LDAP error.

getLDAPException

public org.forgerock.opendj.ldap.LdapException getLDAPException()

Deprecated.

Returns the root LDAPException of this AMException, if any.

Returns:

The LdapException that caused this AMException. If null, it means no root LDAPException has been set.

getL10NMessage

public String getL10NMessage(Locale locale)

Deprecated.

Returns localized error message.

Specified by:

getL10NMessage in interface L10NMessage

Parameters:

locale - locale of the error message.

Returns:

Localized error message.

getResourceBundleName

public String getResourceBundleName()

Deprecated.

Returns ResourceBundle Name associated with this exception

Specified by:

getResourceBundleName in interface L10NMessage

Returns:

ResourceBundle Name associated with this exception.