com.iplanet.am.sdk
Class AMException

java.lang.Object
  java.lang.Throwable
      java.lang.Exception
          com.iplanet.am.sdk.AMException

Direct Known Subclasses:

AMEntryExistsException, AMInvalidDNException, AMPostCallBackException, AMPreCallBackException

Deprecated. As of Sun Java System Access Manager 7.1.

public class AMException
extends Exception

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

See Also:

Serialized Form

Constructor Summary

AMException(SSOToken token, String errorCode)
Deprecated. Convenience method (protected)

AMException(SSOToken token, String errorCode, com.iplanet.ums.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, Object[] args)
Deprecated. Constructs a new AMException with detailed message.

AMException(String msg, String errorCode, Object[] args, com.iplanet.ums.UMSException ue)
Deprecated. Constructs a new AMException with detailed message.

AMException(String msg, String errorCode, com.iplanet.ums.UMSException ue)
Deprecated. Constructs a new AMException with detailed message.

Method Summary

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.
com.sun.identity.shared.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

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,
                   com.iplanet.ums.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,
                   com.iplanet.ums.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,
                   com.iplanet.ums.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.

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.

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.

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 com.sun.identity.shared.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.

Parameters:

locale - locale of the error message.

Returns:

Localized error message.

getResourceBundleName

public String getResourceBundleName()

Deprecated.

Returns ResourceBundle Name associated with this exception

Returns:

ResourceBundle Name associated with this exception.