Generic Exception Rules
Important
Connectors continue to be released outside the IDM release. For the latest documentation, refer to the ICF documentation.
The generic exception rules are common to all API or SPI level operations and are described in the following sections.
Framework (API Level) Exception Rules
- IllegalArgumentException or NullPointerException
Thrown when the ObjectClass is null or the name is blank.
- OperationTimeoutException
Thrown when the operation timed out.
- ConnectionFailedException
Thrown if any problem occurs with the connector server connection.
- UnsupportedOperationException
Thrown if the connector does not implement the required interface.
- ConnectorIOException
Thrown if the connector failed to initialize a remote connection due to a SocketException.
- ConnectorException
Thrown in the following situations:
The connector failed to initiate the remote connection due to a
SocketExceptionAn unexpected request was sent to the remote connector server
An unexpected response was received from the remote connector server
- InvalidCredentialException
Thrown if the remote framework key is invalid
The following exceptions are thrown specifically in the context of a poolable connector.
- ConnectorException
Thrown if the pool has no available connectors after the
maxWaittime has elapsed.- IllegalStateException
Thrown if the object pool has already shut down.
Connector (SPI Level) Exception Rules
- InvalidAttributeValueException
Thrown when single-valued attribute has multiple values.
- IllegalArgumentException
Thrown when the value of the
__PASSWORD__or the__CURRENT_PASSWORD__attribute is not aGuardedString.- IllegalStateException
Thrown when the
Attributename is blank.- PermissionDeniedException
Thrown when the target resource will not allow a specific operation to be performed. An instance of the
PermissionDeniedExceptiongenerally describes a native error that is returned by (or wraps a native exception that is thrown by) the target resource.- ConnectorIOException, ConnectionBrokenException, ConnectionFailedException
Thrown when any problem occurs with the connection to the target resource.
- PreconditionFailedException
Thrown when the current version of the resource object does not match the version provided by the connector.
- PreconditionRequiredException
Thrown when a resource object requires a version, but no version was supplied in the
getRevisionoperation.