com.adobe.repository
Class RepositoryException

java.lang.Object
  java.lang.Throwable
      java.lang.Exception
          com.adobe.repository.RepositoryException

All Implemented Interfaces:

java.io.Serializable

Direct Known Subclasses:

ResourceRepositoryClientException

public class RepositoryException
extends java.lang.Exception

Contains the shared behavior of all Repository exception classes. Each RepositoryException contains an error code that determines the cause and location of the exception.

Since:

7.0 RegistryException, 8.0 RepositoryException (renamed)

See Also:

Serialized Form

Field Summary

static int	E_BAD_CALL_MEMBER_OF Bad call using a member of relation.
static int	E_BAD_MAJOR_MINOR_COMBO Bad major/minor version combination [[major].[minor]].
static int	E_BAD_RESOURCE_NAME The supplied resource name contains the following invalid characters: [string of invalid characters].
static int	E_BAD_STATUS_LATEST_TO_UPDATED The user attempted to change the status of a resource from latest to updated when it is the latest version of the logical resource.
static int	E_BAD_STATUS_OTHERLATEST_TO_UPDATED The user attempted to change the status of a resource from other to updated when the resource is the latest version of the logical resource.
static int	E_BAD_STATUS_OTHERUPDATED_TO_LATEST The object status was changed from other updated to latest when it is not the latest version of the logical resource.
static int	E_BAD_STATUS_UPDATED_TO_LATEST The user attempted to change the status of a resource from updated to latest when it is not the latest version of the logical resource.
static int	E_CACHE_EXCEPTION Cache exception
static int	E_COULD_NOT_EXTRACT_METADATA Could not extract metadata.
static int	E_COULD_NOT_INSTANTIATE_METADATA_EXTRACTOR Could not instantiate a metadata extractor for [mimeType].
static int	E_DSC_EXCEPTION DSC exception.
static int	E_EXCEPTION Wraps a generic java.lang.Exception.
static int	E_EXCLUSIVE_LOCK_EXISTS The resource [resourceUri] is exclusive-locked by user [userId].
static int	E_FAILED_TO_DESRIALIZE_USER_CONTEXT Context deserialization failed and returned a null user context.
static int	E_FILE_NOT_FOUND_OR_NO_ACCESS Resource [resourceUri] does not exist or you do not have sufficient rights to access it.
static int	E_IMMUTABLE_ATTRIBUTE Attribute [attributeName] is immutable.
static int	E_IMMUTABLE_PROPERTY The resource property [propertyName] in namespace [propertyNamespace] is immutable.
static int	E_INCORRECT_VERSION_FORMAT The format of the value of the URL parameter [rv|cv] is incorrect.
static int	E_INVALID_DEPTH Invalid depth value [value].
static int	E_INVALID_LOCK_DEPTH Invalid lock depth.
static int	E_INVALID_LOCK_SCOPE Invalid lock scope.
static int	E_INVALID_VALUE Value [paramValue] is not valid for parameter [paramName].
static int	E_INVALID_XML_NCNAME Value [paramValue] is not a valid XML NCName.
static int	E_IO_EXCEPTION I/O exception.
static int	E_LOCK_NOT_FOUND A lock could not be found for resource [resourceUri].
static int	E_LOCKED_BY_OTHER Resource [resourceUri] is locked by user [userName].
static int	E_MAJORVER_IN_USE Unable to increment major version because version [[major].0] already exists.
static int	E_MINORVER_IN_USE Unable to increment minor version because version [[major].[minor]] already exists.
static int	E_MUST_BE_A_PATH The resource URI [resourceUri] must be a path.
static int	E_NO_ACCESS Deprecated. use E_FILE_NOT_FOUND_OR_NO_ACCESS instead
static int	E_NO_LOCK_TOKEN Deprecated.
static int	E_NO_METADATA_EXTRACTOR_REGISTERED There is no metadata extractor registered for [mimeType].
static int	E_NOT_A_PATH When writing a new Relation, a path-based identifier must be specified to identify the parent ResourceCollection.
static int	E_NOT_A_RESOURCE_COLLECTION The destination [resourceCollectionPath] is not a resource collection.
static int	E_NOT_A_RESOURCE_OR_RESOURCE_COLLECTION The path [targetResourceCollectionPath] does not identify a resource or resource collection.
static int	E_NOT_A_VERION_OF_THIS_RESOURCE The specified resource identifier ([resourceId]) is not a version of the resource you wish to update.
static int	E_NOT_AN_APPLICATION Resource [applicationUri] is not a LiveCycle application.
static int	E_NULL_ELEMENT Array elements of parameter [paramName] cannot be null.
static int	E_NULL_PARAM Parameter [paramName] cannot be null.
static int	E_PERM_EXCEPTION The User Manager permissions were not loaded.
static int	E_POF_EXCEPTION Wraps a POFException
static int	E_PROPERTY_NOT_NULLABLE The resource property [propertyName] in namespace [propertyNamespace] cannot be assigned a null value or be removed.
static int	E_RELATION_NOT_FOUND The relation with the source URI [sourceUri], the target URI [targetUri], and type of [typeValue] does not exist or you do not have sufficient rights to access it.
static int	E_REMOTE_EXCEPTION Wraps a java.rmi.RemoteException.
static int	E_RESERVED_NAMESPACE Property [name] cannot be added to reserved namespace [namespace].
static int	E_RESERVED_VALUE Value [value] is reserved for future use for attribute [attributeName].
static int	E_RESERVED_VALUE_RANGE Values [startValue]-[endValue] (inclusive) are reserved for future use for attribute [attributeName].
static int	E_RESOURCE_EXISTS A resource exists at URI [targetResourceUri].
static int	E_RESOURCE_IS_A_SYSTEM_PATH The specified source URI is a system resource collection, and cannot be moved or copied.
static int	E_RESOURCE_IS_A_VERSION Two versions of the same resource cannot be made to relate in this manner.
static int	E_RESOURCE_MANAGER_EXCEPTION Wraps a ResourceManagerException
static int	E_SHARED_LOCK_EXISTS The resource [resourceUri] is share-locked by user [userId].
static int	E_SYSTEM_PATH_MAY_NOT_BE_DELETED [path] is a system object and cannot be deleted.
static int	E_SYSTEM_PATH_MAY_NOT_BE_UPDATED [resourceUri] is a system object and cannot be updated.
static int	E_TYPE_MISMATCH Type mismatch: A Resource must be updated with a Resource of the same type.
static int	E_UM_EXCEPTION Wraps a UMException.
static int	E_UNABLE_TO_PARSE_FILE Unable to parse the XMP metadata in the data stream.

Constructor Summary

RepositoryException(int moduleCode)
A constructor that uses a module code, which is used to determine the failure type associated with this exception.

RepositoryException(int moduleCode, java.lang.Object[] messageArgs)
A constructor that uses a module code, which is used to determine the failure type associated with this exception.

RepositoryException(int moduleCode, java.lang.String message)
A constructor that uses a module code, which is used to determine the failure type associated with this exception.

RepositoryException(int moduleCode, java.lang.String message, java.lang.Throwable cause)

RepositoryException(int moduleCode, java.lang.Throwable cause)
A constructor that uses the module code, which is used to determine the failure type associated with this exception, and the cause.

RepositoryException(int moduleCode, java.lang.Throwable cause, java.lang.Object[] messageArgs)
A constructor that uses the module code, which is used to determine the failure type associated with this exception, the cause, and the messageArgs that are applied to the substitution variables in the message bundle string.

Method Summary

java.lang.Throwable	getCause() Retrieves the cause of this exception.
java.lang.String	getErrorCode() Retrieves the Repository error code for this exception.
int	getLocalCode() Retrieves the local code for this exception.
java.lang.String	getMessage() Retrieves the detailed message of this Throwable instance.
int	getModuleCode() Retrieves the module code for this exception.
void	printStackTrace(java.io.PrintStream printStream) If the exception was serialized, and the cause was lost append the stored messages to the trace.
void	printStackTrace(java.io.PrintWriter printWriter) If the exception was serialized, and the cause was lost append the stored messages to the trace.
void	setLocalCode(int localCode) Sets the local code for this exception.
void	setMessageArgs(java.lang.Object[] args) Sets the arguments that will be applied to the message string.
void	setModuleCode(int moduleCode) Sets the module code for this exception.

Methods inherited from class java.lang.Throwable

fillInStackTrace, getLocalizedMessage, getStackTrace, initCause, printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

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

Field Detail

E_NULL_PARAM

public static final int E_NULL_PARAM

Parameter [paramName] cannot be null.

See Also:

Constant Field Values

E_NULL_ELEMENT

public static final int E_NULL_ELEMENT

Array elements of parameter [paramName] cannot be null.

See Also:

Constant Field Values

E_RESERVED_VALUE

public static final int E_RESERVED_VALUE

Value [value] is reserved for future use for attribute [attributeName].

See Also:

Constant Field Values

E_INVALID_VALUE

public static final int E_INVALID_VALUE

Value [paramValue] is not valid for parameter [paramName].

See Also:

Constant Field Values

E_RESOURCE_EXISTS

public static final int E_RESOURCE_EXISTS

A resource exists at URI [targetResourceUri].

See Also:

Constant Field Values

E_LOCKED_BY_OTHER

public static final int E_LOCKED_BY_OTHER

Resource [resourceUri] is locked by user [userName].

See Also:

Constant Field Values

E_NO_LOCK_TOKEN

public static final int E_NO_LOCK_TOKEN

Deprecated.

No lock token submitted for locked resource [resourceUri].

See Also:

Constant Field Values

E_FILE_NOT_FOUND_OR_NO_ACCESS

public static final int E_FILE_NOT_FOUND_OR_NO_ACCESS

Resource [resourceUri] does not exist or you do not have sufficient rights to access it.

See Also:

Constant Field Values

E_IMMUTABLE_ATTRIBUTE

public static final int E_IMMUTABLE_ATTRIBUTE

Attribute [attributeName] is immutable.

See Also:

Constant Field Values

E_MAJORVER_IN_USE

public static final int E_MAJORVER_IN_USE

Unable to increment major version because version [[major].0] already exists.

See Also:

Constant Field Values

E_MINORVER_IN_USE

public static final int E_MINORVER_IN_USE

Unable to increment minor version because version [[major].[minor]] already exists.

See Also:

Constant Field Values

E_NOT_AN_APPLICATION

public static final int E_NOT_AN_APPLICATION

Resource [applicationUri] is not a LiveCycle application.

See Also:

Constant Field Values

E_BAD_CALL_MEMBER_OF

public static final int E_BAD_CALL_MEMBER_OF

Bad call using a member of relation. Relationships of type Relation.TYPE_MEMBER_OF must be manipulated through calls to ResourceRepository.deleteResource() and ResourceRepository.writeResource().

See Also:

Constant Field Values

E_BAD_MAJOR_MINOR_COMBO

public static final int E_BAD_MAJOR_MINOR_COMBO

Bad major/minor version combination [[major].[minor]].

See Also:

Constant Field Values

E_NOT_A_PATH

public static final int E_NOT_A_PATH

When writing a new Relation, a path-based identifier must be specified to identify the parent ResourceCollection. Since resource collections (libraries, applications) may have more than one path, path-based identifiers are required to select the correct path. (It would not be possible to determine which path to choose if there were two or more paths for a ResourceCollection.)

See Also:

Constant Field Values

E_RESERVED_VALUE_RANGE

public static final int E_RESERVED_VALUE_RANGE

Values [startValue]-[endValue] (inclusive) are reserved for future use for attribute [attributeName].

See Also:

Constant Field Values

E_INVALID_LOCK_SCOPE

public static final int E_INVALID_LOCK_SCOPE

Invalid lock scope. Lock scope may only be Lock.SCOPE_EXCLUSIVE or Lock.SCOPE_SHARED.

See Also:

Constant Field Values

E_INVALID_LOCK_DEPTH

public static final int E_INVALID_LOCK_DEPTH

Invalid lock depth. Lock depth may only be Lock.DEPTH_ZERO, Lock.DEPTH_ONE, or Lock.DEPTH_INFINITE.

See Also:

Constant Field Values

E_LOCK_NOT_FOUND

public static final int E_LOCK_NOT_FOUND

A lock could not be found for resource [resourceUri]. You do not own the lock, do not have the proper lock token, or are not unlocking the top level resource for the lock.

See Also:

Constant Field Values

E_BAD_STATUS_LATEST_TO_UPDATED

public static final int E_BAD_STATUS_LATEST_TO_UPDATED

The user attempted to change the status of a resource from latest to updated when it is the latest version of the logical resource.

See Also:

Constant Field Values

E_BAD_STATUS_OTHERLATEST_TO_UPDATED

public static final int E_BAD_STATUS_OTHERLATEST_TO_UPDATED

The user attempted to change the status of a resource from other to updated when the resource is the latest version of the logical resource.

See Also:

Constant Field Values

E_BAD_STATUS_UPDATED_TO_LATEST

public static final int E_BAD_STATUS_UPDATED_TO_LATEST

The user attempted to change the status of a resource from updated to latest when it is not the latest version of the logical resource.

See Also:

Constant Field Values

E_BAD_STATUS_OTHERUPDATED_TO_LATEST

public static final int E_BAD_STATUS_OTHERUPDATED_TO_LATEST

The object status was changed from other updated to latest when it is not the latest version of the logical resource.

See Also:

Constant Field Values

E_RELATION_NOT_FOUND

public static final int E_RELATION_NOT_FOUND

The relation with the source URI [sourceUri], the target URI [targetUri], and type of [typeValue] does not exist or you do not have sufficient rights to access it.

See Also:

Constant Field Values

E_SHARED_LOCK_EXISTS

public static final int E_SHARED_LOCK_EXISTS

The resource [resourceUri] is share-locked by user [userId].

See Also:

Constant Field Values

E_EXCLUSIVE_LOCK_EXISTS

public static final int E_EXCLUSIVE_LOCK_EXISTS

The resource [resourceUri] is exclusive-locked by user [userId].

See Also:

Constant Field Values

E_RESOURCE_IS_A_VERSION

public static final int E_RESOURCE_IS_A_VERSION

Two versions of the same resource cannot be made to relate in this manner.

See Also:

Constant Field Values

E_BAD_RESOURCE_NAME

public static final int E_BAD_RESOURCE_NAME

The supplied resource name contains the following invalid characters: [string of invalid characters].

See Also:

Constant Field Values

E_IMMUTABLE_PROPERTY

public static final int E_IMMUTABLE_PROPERTY

The resource property [propertyName] in namespace [propertyNamespace] is immutable.

See Also:

Constant Field Values

E_PROPERTY_NOT_NULLABLE

public static final int E_PROPERTY_NOT_NULLABLE

The resource property [propertyName] in namespace [propertyNamespace] cannot be assigned a null value or be removed.

See Also:

Constant Field Values

E_MUST_BE_A_PATH

public static final int E_MUST_BE_A_PATH

The resource URI [resourceUri] must be a path.

See Also:

Constant Field Values

E_SYSTEM_PATH_MAY_NOT_BE_DELETED

public static final int E_SYSTEM_PATH_MAY_NOT_BE_DELETED

[path] is a system object and cannot be deleted.

See Also:

Constant Field Values

E_RESERVED_NAMESPACE

public static final int E_RESERVED_NAMESPACE

Property [name] cannot be added to reserved namespace [namespace].

See Also:

Constant Field Values

E_NOT_A_RESOURCE_OR_RESOURCE_COLLECTION

public static final int E_NOT_A_RESOURCE_OR_RESOURCE_COLLECTION

The path [targetResourceCollectionPath] does not identify a resource or resource collection.

See Also:

Constant Field Values

E_INVALID_DEPTH

public static final int E_INVALID_DEPTH

Invalid depth value [value]. The depth may only be Lock.DEPTH_ZERO, Lock.DEPTH_ONE, or Lock.DEPTH_INFINITE.

See Also:

Constant Field Values

E_NOT_A_RESOURCE_COLLECTION

public static final int E_NOT_A_RESOURCE_COLLECTION

The destination [resourceCollectionPath] is not a resource collection. Resources may only be moved or copied into resource collections.

See Also:

Constant Field Values

E_SYSTEM_PATH_MAY_NOT_BE_UPDATED

public static final int E_SYSTEM_PATH_MAY_NOT_BE_UPDATED

[resourceUri] is a system object and cannot be updated.

See Also:

Constant Field Values

E_TYPE_MISMATCH

public static final int E_TYPE_MISMATCH

Type mismatch: A Resource must be updated with a Resource of the same type.

See Also:

Constant Field Values

E_PERM_EXCEPTION

public static final int E_PERM_EXCEPTION

The User Manager permissions were not loaded.

See Also:

Constant Field Values

E_NO_ACCESS

public static final int E_NO_ACCESS

Deprecated. use E_FILE_NOT_FOUND_OR_NO_ACCESS instead

User access to the resource is not allowed for the permission request.

See Also:

Constant Field Values

E_INCORRECT_VERSION_FORMAT

public static final int E_INCORRECT_VERSION_FORMAT

The format of the value of the URL parameter [rv|cv] is incorrect. The supplied value is [versionString]; "major.minor" was expected.

See Also:

Constant Field Values

E_FAILED_TO_DESRIALIZE_USER_CONTEXT

public static final int E_FAILED_TO_DESRIALIZE_USER_CONTEXT

Context deserialization failed and returned a null user context.

See Also:

Constant Field Values

E_RESOURCE_IS_A_SYSTEM_PATH

public static final int E_RESOURCE_IS_A_SYSTEM_PATH

The specified source URI is a system resource collection, and cannot be moved or copied.

See Also:

Constant Field Values

E_NOT_A_VERION_OF_THIS_RESOURCE

public static final int E_NOT_A_VERION_OF_THIS_RESOURCE

The specified resource identifier ([resourceId]) is not a version of the resource you wish to update.

See Also:

Constant Field Values

E_INVALID_XML_NCNAME

public static final int E_INVALID_XML_NCNAME

Value [paramValue] is not a valid XML NCName.

See Also:

Constant Field Values

E_POF_EXCEPTION

public static final int E_POF_EXCEPTION

Wraps a POFException

See Also:

Constant Field Values

E_UM_EXCEPTION

public static final int E_UM_EXCEPTION

Wraps a UMException.

See Also:

Constant Field Values

E_REMOTE_EXCEPTION

public static final int E_REMOTE_EXCEPTION

Wraps a java.rmi.RemoteException.

See Also:

Constant Field Values

E_EXCEPTION

public static final int E_EXCEPTION

Wraps a generic java.lang.Exception.

See Also:

Constant Field Values

E_RESOURCE_MANAGER_EXCEPTION

public static final int E_RESOURCE_MANAGER_EXCEPTION

Wraps a ResourceManagerException

See Also:

Constant Field Values

E_IO_EXCEPTION

public static final int E_IO_EXCEPTION

I/O exception.

See Also:

Constant Field Values

E_DSC_EXCEPTION

public static final int E_DSC_EXCEPTION

DSC exception.

See Also:

Constant Field Values

E_CACHE_EXCEPTION

public static final int E_CACHE_EXCEPTION

Cache exception

See Also:

Constant Field Values

E_NO_METADATA_EXTRACTOR_REGISTERED

public static final int E_NO_METADATA_EXTRACTOR_REGISTERED

There is no metadata extractor registered for [mimeType].

See Also:

Constant Field Values

E_COULD_NOT_INSTANTIATE_METADATA_EXTRACTOR

public static final int E_COULD_NOT_INSTANTIATE_METADATA_EXTRACTOR

Could not instantiate a metadata extractor for [mimeType].

See Also:

Constant Field Values

E_COULD_NOT_EXTRACT_METADATA

public static final int E_COULD_NOT_EXTRACT_METADATA

Could not extract metadata.

See Also:

Constant Field Values

E_UNABLE_TO_PARSE_FILE

public static final int E_UNABLE_TO_PARSE_FILE

Unable to parse the XMP metadata in the data stream.

See Also:

Constant Field Values

Constructor Detail

RepositoryException

public RepositoryException(int moduleCode,
                           java.lang.String message)

A constructor that uses a module code, which is used to determine the failure type associated with this exception.

Parameters:

moduleCode - The module code used to determine the failure type associated with this exception.

message - The message that describes the exception being thrown

RepositoryException

public RepositoryException(int moduleCode,
                           java.lang.String message,
                           java.lang.Throwable cause)

Parameters:

moduleCode - The module code used to determine the failure type associated with this exception.

message - The message that describes the exception being thrown

cause - The root cause of the exception

RepositoryException

public RepositoryException(int moduleCode)

A constructor that uses a module code, which is used to determine the failure type associated with this exception.

Parameters:

moduleCode - The module code used to determine the failure type associated with this exception.

RepositoryException

public RepositoryException(int moduleCode,
                           java.lang.Object[] messageArgs)

A constructor that uses a module code, which is used to determine the failure type associated with this exception. messageArgs are applied to the substitution variables in the message bundle string.

Parameters:

moduleCode - The module code used to determine the failure type associated with this exception.

messageArgs - The arguments for the message.

RepositoryException

public RepositoryException(int moduleCode,
                           java.lang.Throwable cause)

A constructor that uses the module code, which is used to determine the failure type associated with this exception, and the cause.

Parameters:

moduleCode - The module code associated with this excpetion.

cause - The cause of this exception.

RepositoryException

public RepositoryException(int moduleCode,
                           java.lang.Throwable cause,
                           java.lang.Object[] messageArgs)

A constructor that uses the module code, which is used to determine the failure type associated with this exception, the cause, and the messageArgs that are applied to the substitution variables in the message bundle string.

Parameters:

moduleCode - The module code associated with this exception.

cause - The cause of this exception.

messageArgs - The arguments for the message.

Method Detail

getCause

public java.lang.Throwable getCause()

Retrieves the cause of this exception.

Overrides:

getCause in class java.lang.Throwable

Returns:

The cause of the exception.

getModuleCode

public int getModuleCode()

Retrieves the module code for this exception.

For example, this method would return 18 if the error code was ALC-REP-018-000.

Returns:

The module code associated with this exception.

setModuleCode

public void setModuleCode(int moduleCode)

Sets the module code for this exception.

Parameters:

moduleCode - The module code associated with this exception.

setLocalCode

public void setLocalCode(int localCode)

Sets the local code for this exception. The local code provides additional information about the nature of the failure that caused the exception.

Parameters:

localCode - The local code for this exception.

getLocalCode

public int getLocalCode()

Retrieves the local code for this exception. The local code provides additional information about the nature of the failure that caused the exception.

For example, this method would return 1 if the error code was ALC-REP-018-001.

Returns:

The local code for this exception.

setMessageArgs

public void setMessageArgs(java.lang.Object[] args)

Sets the arguments that will be applied to the message string.

Parameters:

args - The arguments that will be applied to the message string.

getErrorCode

public java.lang.String getErrorCode()

Retrieves the Repository error code for this exception.

Returns:

The Repository error code for this exception.

getMessage

public java.lang.String getMessage()

Retrieves the detailed message of this Throwable instance.

Overrides:

getMessage in class java.lang.Throwable

Returns:

The detailed message string of this Throwable instance. It may be null.

printStackTrace

public void printStackTrace(java.io.PrintStream printStream)

If the exception was serialized, and the cause was lost append the stored messages to the trace.

Overrides:

printStackTrace in class java.lang.Throwable

Parameters:

printStream -

printStackTrace

public void printStackTrace(java.io.PrintWriter printWriter)

If the exception was serialized, and the cause was lost append the stored messages to the trace.

Overrides:

printStackTrace in class java.lang.Throwable

Parameters:

printWriter -