com.adobe.repository
Class RepositoryException

java.lang.Object
  extended by java.lang.Throwable
      extended by java.lang.Exception
          extended by 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_CONTACT_ID_DOES_NOT_EXIST
          The supplied contactId value [contactId] was not found in the User Management database.
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 Adobe Experience Manager forms 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 Adobe Experience Manager forms 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.deleteResources() 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_CONTACT_ID_DOES_NOT_EXIST

public static final int E_CONTACT_ID_DOES_NOT_EXIST
The supplied contactId value [contactId] was not found in the User Management database.

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 -