Package org.eclipse.persistence.exceptions

Class SDOException

  • All Implemented Interfaces:
    Serializable
    public class SDOException
extends EclipseLinkException
    Purpose:
    • This class provides an implementation of EclipseLinkException specific to the EclipseLink SDO (Service Data Objects) API.

    Responsibilities:

    • Return an SDOException that can be thrown around input parameters.
    • Return an SDOException that wraps an existing exception with additional input parameters.
    See Also:
    Serialized Form
    Since:
    Oracle TopLink 11.1.1.0.0

    • Field Detail

      • ERROR_PROCESSING_IMPORT

        public static final int ERROR_PROCESSING_IMPORT
        See Also:
        Constant Field Values

      • ERROR_PROCESSING_INCLUDE

        public static final int ERROR_PROCESSING_INCLUDE
        See Also:
        Constant Field Values

      • REFERENCED_PROPERTY_NOT_FOUND

        public static final int REFERENCED_PROPERTY_NOT_FOUND
        See Also:
        Constant Field Values

      • FOUND_SIMPLE_VALUE_FOR_FOR_NON_DATATYPE_PROPERTY

        public static final int FOUND_SIMPLE_VALUE_FOR_FOR_NON_DATATYPE_PROPERTY
        See Also:
        Constant Field Values

      • SEQUENCE_NULL_ON_SEQUENCED_DATAOBJECT

        public static final int SEQUENCE_NULL_ON_SEQUENCED_DATAOBJECT
        See Also:
        Constant Field Values

      • NO_TYPE_SPECIFIED_FOR_PROPERTY

        public static final int NO_TYPE_SPECIFIED_FOR_PROPERTY
        See Also:
        Constant Field Values

      • TYPE_NOT_FOUND_FOR_INTERFACE

        public static final int TYPE_NOT_FOUND_FOR_INTERFACE
        See Also:
        Constant Field Values

      • ERROR_CREATING_DATAOBJECT_FOR_TYPE

        public static final int ERROR_CREATING_DATAOBJECT_FOR_TYPE
        See Also:
        Constant Field Values

      • ERROR_CREATING_DATAOBJECT_FOR_CLASS

        public static final int ERROR_CREATING_DATAOBJECT_FOR_CLASS
        See Also:
        Constant Field Values

      • ERROR_DEFINING_TYPE_NO_NAME

        public static final int ERROR_DEFINING_TYPE_NO_NAME
        See Also:
        Constant Field Values

      • SEQUENCE_DUPLICATE_ADD_NOT_SUPPORTED

        public static final int SEQUENCE_DUPLICATE_ADD_NOT_SUPPORTED
        See Also:
        Constant Field Values

      • SEQUENCE_ERROR_PROPERTY_IS_ATTRIBUTE

        public static final int SEQUENCE_ERROR_PROPERTY_IS_ATTRIBUTE
        See Also:
        Constant Field Values

      • SEQUENCE_ERROR_NO_PATH_FOUND

        public static final int SEQUENCE_ERROR_NO_PATH_FOUND
        See Also:
        Constant Field Values

      • SEQUENCE_ERROR_DATAOBJECT_IS_NULL

        public static final int SEQUENCE_ERROR_DATAOBJECT_IS_NULL
        See Also:
        Constant Field Values

      • SEQUENCE_NOT_SUPPORTED_FOR_PROPERTY

        public static final int SEQUENCE_NOT_SUPPORTED_FOR_PROPERTY
        See Also:
        Constant Field Values

      • WRONG_VALUE_FOR_PROPERTY

        public static final int WRONG_VALUE_FOR_PROPERTY
        See Also:
        Constant Field Values

      • PROPERTY_NOT_FOUND_AT_INDEX

        public static final int PROPERTY_NOT_FOUND_AT_INDEX
        See Also:
        Constant Field Values

      • CANNOT_PERFORM_OPERATION_ON_NULL_ARGUMENT

        public static final int CANNOT_PERFORM_OPERATION_ON_NULL_ARGUMENT
        See Also:
        Constant Field Values

      • TYPE_CANNOT_BE_OPEN_AND_DATATYPE

        public static final int TYPE_CANNOT_BE_OPEN_AND_DATATYPE
        See Also:
        Constant Field Values

      • JAVA_CLASS_INVOKING_ERROR

        public static final int JAVA_CLASS_INVOKING_ERROR
        See Also:
        Constant Field Values

      • CANNOT_SET_PROPERTY_TYPE_ANNOTATION_IF_TARGET_DATATYPE_TRUE

        public static final int CANNOT_SET_PROPERTY_TYPE_ANNOTATION_IF_TARGET_DATATYPE_TRUE
        See Also:
        Constant Field Values

      • XMLMARSHAL_EXCEPTION_OCCURRED

        public static final int XMLMARSHAL_EXCEPTION_OCCURRED
        See Also:
        Constant Field Values

      • TYPE_REFERENCED_BUT_NEVER_DEFINED

        public static final int TYPE_REFERENCED_BUT_NEVER_DEFINED
        See Also:
        Constant Field Values

      • OPTIONS_MUST_BE_A_DATAOBJECT

        public static final int OPTIONS_MUST_BE_A_DATAOBJECT
        See Also:
        Constant Field Values

      • TYPE_PROPERTY_MUST_BE_A_TYPE

        public static final int TYPE_PROPERTY_MUST_BE_A_TYPE
        See Also:
        Constant Field Values

      • GLOBAL_PROPERTY_NOT_FOUND

        public static final int GLOBAL_PROPERTY_NOT_FOUND
        See Also:
        Constant Field Values

      • PREFIX_USED_BUT_NOT_DEFINED

        public static final int PREFIX_USED_BUT_NOT_DEFINED
        See Also:
        Constant Field Values

      • CANNOT_PERFORM_OPERATION_ON_PROPERTY

        public static final int CANNOT_PERFORM_OPERATION_ON_PROPERTY
        See Also:
        Constant Field Values

      • ERROR_ACCESSING_EXTERNALIZABLEDELEGATOR

        public static final int ERROR_ACCESSING_EXTERNALIZABLEDELEGATOR
        See Also:
        Constant Field Values

      • CANNOT_PERFORM_OP_WITH_NULL_PARAM

        public static final int CANNOT_PERFORM_OP_WITH_NULL_PARAM
        See Also:
        Constant Field Values

      • ERROR_PERFORMING_WLS_LOOKUP

        public static final int ERROR_PERFORMING_WLS_LOOKUP
        See Also:
        Constant Field Values

      • ERROR_MAKING_WLS_REFLECTIVE_CALL

        public static final int ERROR_MAKING_WLS_REFLECTIVE_CALL
        See Also:
        Constant Field Values

      • ERROR_GETTING_OBJECTNAME

        public static final int ERROR_GETTING_OBJECTNAME
        See Also:
        Constant Field Values

      • ERROR_CREATING_INITIAL_CONTEXT

        public static final int ERROR_CREATING_INITIAL_CONTEXT
        See Also:
        Constant Field Values

      • SDO_JAXB_NO_DESCRIPTOR_FOR_TYPE

        public static final int SDO_JAXB_NO_DESCRIPTOR_FOR_TYPE
        See Also:
        Constant Field Values

      • SDO_JAXB_NO_MAPPING_FOR_PROPERTY

        public static final int SDO_JAXB_NO_MAPPING_FOR_PROPERTY
        See Also:
        Constant Field Values

      • SDO_JAXB_NO_TYPE_FOR_CLASS

        public static final int SDO_JAXB_NO_TYPE_FOR_CLASS
        See Also:
        Constant Field Values

      • SDO_JAXB_NO_SCHEMA_REFERENCE

        public static final int SDO_JAXB_NO_SCHEMA_REFERENCE
        See Also:
        Constant Field Values

      • SDO_JAXB_NO_SCHEMA_CONTEXT

        public static final int SDO_JAXB_NO_SCHEMA_CONTEXT
        See Also:
        Constant Field Values

      • SDO_JAXB_NO_TYPE_FOR_CLASS_BY_SCHEMA_CONTEXT

        public static final int SDO_JAXB_NO_TYPE_FOR_CLASS_BY_SCHEMA_CONTEXT
        See Also:
        Constant Field Values

      • SDO_JAXB_ERROR_CREATING_JAXB_UNMARSHALLER

        public static final int SDO_JAXB_ERROR_CREATING_JAXB_UNMARSHALLER
        See Also:
        Constant Field Values

      • MISSING_DEPENDENCY_FOR_BINARY_MAPPING

        public static final int MISSING_DEPENDENCY_FOR_BINARY_MAPPING
        See Also:
        Constant Field Values

      • ATTEMPT_TO_RESET_APP_RESOLVER

        public static final int ATTEMPT_TO_RESET_APP_RESOLVER
        See Also:
        Constant Field Values

      • DATAOBJECT_FROM_DIFFERENT_HELPERCONTEXT

        public static final int DATAOBJECT_FROM_DIFFERENT_HELPERCONTEXT
        See Also:
        Constant Field Values

      • ERROR_DEFINING_TYPE_INVALID_NAME

        public static final int ERROR_DEFINING_TYPE_INVALID_NAME
        See Also:
        Constant Field Values

      • ERROR_DEFINING_PROPERTY_INVALID_NAME

        public static final int ERROR_DEFINING_PROPERTY_INVALID_NAME
        See Also:
        Constant Field Values

    • Constructor Detail

      • SDOException

        protected SDOException​(String message)

      • SDOException

        protected SDOException​(String message,
                       Exception internalException)

    • Method Detail

      • errorPerformingWLSLookup

        public static SDOException errorPerformingWLSLookup​(String failedLookup,
                                                    Exception nestedException)
        INTERNAL: Exception when acquiring the SDOHelperContext cache key for WLS. This method should be used when a lookup fails. The lookup strings would typically be: - "java:comp/jmx/runtime" - "java:comp/env/jmx/runtime"

      • errorInvokingWLSMethodReflectively

        public static SDOException errorInvokingWLSMethodReflectively​(String methodName,
                                                              String theClass,
                                                              Exception nestedException)
        INTERNAL: Exception when acquiring the SDOHelperContext cache key for WLS. This method should be used when a reflective call fails. The method names would typically be: - "getExecuteThread" - "getApplicationName"

      • errorGettingWLSObjectName

        public static SDOException errorGettingWLSObjectName​(String objectName,
                                                     Exception nestedException)
        INTERNAL: Exception when acquiring the SDOHelperContext cache key for WLS. This method should be used when an attempt to get an ObjectName fails. The object names would typically be: - "com.bea:Name=RuntimeService,Type=weblogic.management.mbeanservers.runtime.RuntimeServiceMBean" - "ServerRuntime" - "ThreadPoolRuntime"

      • errorCreatingWLSInitialContext

        public static SDOException errorCreatingWLSInitialContext​(Exception nestedException)
        INTERNAL: Exception when acquiring the SDOHelperContext cache key for WLS. This method should be used when an attempt to create an InitialContext fails.

      • noTargetIdSpecified

        public static SDOException noTargetIdSpecified​(String uri,
                                               String name)
        INTERNAL: Exception when building an ObjectReferenceMapping and referenced object does not have an id property

      • errorProcessingImport

        public static SDOException errorProcessingImport​(String schemaLocation,
                                                 String namespace,
                                                 Exception nestedException)
        INTERNAL: Exception when processing an import during xsdhelper.define

      • errorProcessingInclude

        public static SDOException errorProcessingInclude​(String schemaLocation,
                                                  Exception nestedException)
        INTERNAL: Exception when processing an include during xsdhelper.define

      • referencedPropertyNotFound

        public static SDOException referencedPropertyNotFound​(String uri,
                                                      String localName)
        INTERNAL: Exception when trying to find a referenced property during xsdhelper.define

      • globalPropertyNotFound

        public static SDOException globalPropertyNotFound()
        INTERNAL: Exception when trying to find a global property during an unmarshal

      • oldSequenceNotFound

        public static SDOException oldSequenceNotFound()
        INTERNAL: Exception when old sequence is not found in the changesummary

      • foundSimpleValueForNonDataTypeProperty

        public static SDOException foundSimpleValueForNonDataTypeProperty​(String propertyName)
        INTERNAL: Exception when the value should be a dataObject and it's not

      • sequenceNullOnSequencedDataObject

        public static SDOException sequenceNullOnSequencedDataObject()
        INTERNAL: Exception when sequence is null on a dataObject with sequenced set to true

      • noTypeSpecifiedForProperty

        public static SDOException noTypeSpecifiedForProperty​(String propertyName)
        INTERNAL: Exception when a property does not have a type specified

      • ioExceptionOccurred

        public static SDOException ioExceptionOccurred​(IOException nestedException)
        INTERNAL: Exception when an ioException happens

      • xmlMarshalExceptionOccurred

        public static SDOException xmlMarshalExceptionOccurred​(XMLMarshalException nestedException,
                                                       String rootElementURI,
                                                       String rootElementName)
        INTERNAL: Exception when an XMLMarshalException happens

      • typeNotFound

        public static SDOException typeNotFound​(String uri,
                                        String name)
        INTERNAL: Exception trying to lookup a type with the given uri and name

      • typeNotFoundForInterface

        public static SDOException typeNotFoundForInterface​(String className,
                                                    boolean loadersAreRelated)
        INTERNAL: Exception trying to lookup a type with the given interface

      • errorCreatingDataObjectForType

        public static SDOException errorCreatingDataObjectForType​(String uri,
                                                          String name)
        INTERNAL: Exception trying to create a dataObject with a type with the given uri and name

      • cannotPerformOperationWithNullInputParameter

        public static SDOException cannotPerformOperationWithNullInputParameter​(String operation,
                                                                        String parameter)
        INTERNAL: Exception trying to call a method with a null input parameter

      • errorCreatingDataObjectForClass

        public static SDOException errorCreatingDataObjectForClass​(Exception nestedException,
                                                           String className,
                                                           String uri,
                                                           String name)
        INTERNAL: Exception trying to create a dataObject with a type with the given interface

      • noAppInfoForNull

        public static SDOException noAppInfoForNull()
        INTERNAL: Exception trying to lookup an appinfo with a null property or type

      • errorDefiningType

        public static SDOException errorDefiningType()
        INTERNAL: Exception trying to define a type

      • errorDefiningTypeNoName

        public static SDOException errorDefiningTypeNoName()
        INTERNAL: Exception trying to create a type without a name

      • errorDefiningTypeInvalidName

        public static SDOException errorDefiningTypeInvalidName​(String name)
        INTERNAL: Exception trying to create a type with invalid name.
        Parameters:
        name - type name
        Returns:
        SDOException

      • errorDefiningPropertyInvalidName

        public static SDOException errorDefiningPropertyInvalidName​(String name)
        INTERNAL: Exception trying to create a type with property of invalid name.
        Parameters:
        name - property name
        Returns:
        SDOException

      • missingRefAttribute

        public static SDOException missingRefAttribute()
        INTERNAL: Exception when an sdo:ref attribute is missing during xmlhelper.load

      • errorProcessingXPath

        public static SDOException errorProcessingXPath​(String xpath)
        INTERNAL: Exception processing an xpath during xmlhelper.load

      • sequenceDuplicateSettingNotSupportedForComplexSingleObject

        public static SDOException sequenceDuplicateSettingNotSupportedForComplexSingleObject​(int index,
                                                                                      String settingPropertyName)
        INTERNAL: Return an exception when attempting to add a setting to a sequene that already has an existing entry. The existing entry will not be updated or moved to the end of the sequence. This exception occurs only for complex single types.

      • sequenceAttributePropertyNotSupported

        public static SDOException sequenceAttributePropertyNotSupported​(String settingPropertyName)
        INTERNAL: Error when we attempt to add an attribute property to a sequence

      • sequenceNotFoundForPath

        public static SDOException sequenceNotFoundForPath​(String path)
        INTERNAL: Error when we attempt find a sequence by path

      • sequenceDataObjectInstanceFieldIsNull

        public static SDOException sequenceDataObjectInstanceFieldIsNull()
        INTERNAL: Error passing in a null dataObject into the sequence constructor

      • sequenceNotSupportedForProperty

        public static SDOException sequenceNotSupportedForProperty​(String propertyName)
        INTERNAL: Error passing in a null dataObject into the sequence constructor

      • wrongValueForProperty

        public static SDOException wrongValueForProperty​(String typeUri,
                                                 String typeName,
                                                 Class valueClass)
        INTERNAL: Exception when trying to set a property to value that is an unsupported conversion

      • conversionError

        public static SDOException conversionError​(Exception e)
        INTERNAL: Exception when trying to set a property to value that is an unsupported conversion

      • propertyNotFoundAtIndex

        public static SDOException propertyNotFoundAtIndex​(Exception e,
                                                   int propIndex)
        INTERNAL: Exception when trying to find a property at an invalid index

      • cannotPerformOperationOnNullArgument

        public static SDOException cannotPerformOperationOnNullArgument​(String methodName)
        INTERNAL: Exception when trying to perform an operation with a null argument

      • cannotPerformOperationOnProperty

        public static SDOException cannotPerformOperationOnProperty​(String propertyName,
                                                            String path)
        INTERNAL: Exception when trying to set a property via path based access.

      • classNotFound

        public static SDOException classNotFound​(Exception nestedException,
                                         String uri,
                                         String name)
        INTERNAL: Exception trying to load the instance class for a given type

      • typeCannotBeOpenAndDataType

        public static SDOException typeCannotBeOpenAndDataType​(String uri,
                                                       String name)
        INTERNAL: Exception trying to set a type to be both open and dataType

      • noConstructorWithString

        public static SDOException noConstructorWithString​(Exception nestedException,
                                                   String className)
        INTERNAL: thrown from InstanceClassConverter

      • propertyTypeAnnotationTargetCannotBeDataTypeTrue

        public static SDOException propertyTypeAnnotationTargetCannotBeDataTypeTrue​(String targetTypeName,
                                                                            String sourcePropertyName)
        INTERNAL: Exception when trying to resolve an sdo xml [propertyType] annotation on a target Type of dataType==true.
        See Sect 9.2 (1) of the SDO Specification. thrown from SDOTypesGenerator.postProcessing()

      • typeReferencedButNotDefined

        public static SDOException typeReferencedButNotDefined​(String namespaceUri,
                                                       String typeName)

      • optionsMustBeADataObject

        public static SDOException optionsMustBeADataObject​(Exception nestedException,
                                                    String uri,
                                                    String name)
        INTERNAL: thrown from SDOXMLHelperDelegate

      • typePropertyMustBeAType

        public static SDOException typePropertyMustBeAType​(Exception nestedException)
        INTERNAL: thrown from SDOXMLHelperDelegate

      • prefixUsedButNotDefined

        public static SDOException prefixUsedButNotDefined​(String prefix)
        INTERNAL: thrown from SDOTypesGenerator

      • errorAccessingExternalizableDelegator

        public static SDOException errorAccessingExternalizableDelegator​(String fieldName,
                                                                 Exception nestedException)
        INTERNAL:

      • sdoJaxbNoDescriptorForType

        public static SDOException sdoJaxbNoDescriptorForType​(QName sdoQName,
                                                      QName xmlQName)

      • sdoJaxbNoMappingForProperty

        public static SDOException sdoJaxbNoMappingForProperty​(String propertyName,
                                                       String xPath)

      • sdoJaxbNoTypeForClass

        public static SDOException sdoJaxbNoTypeForClass​(Class clazz)

      • sdoJaxbNoSchemaReference

        public static SDOException sdoJaxbNoSchemaReference​(Class clazz)

      • sdoJaxbNoSchemaContext

        public static SDOException sdoJaxbNoSchemaContext​(Class clazz)

      • sdoJaxbNoTypeForClassBySchemaContext

        public static SDOException sdoJaxbNoTypeForClassBySchemaContext​(Class clazz,
                                                                QName schemaContext)

      • sdoJaxbErrorCreatingJAXBUnmarshaller

        public static SDOException sdoJaxbErrorCreatingJAXBUnmarshaller​(Exception jaxbException)

      • unableToMapDataHandlerDueToMissingDependency

        public static SDOException unableToMapDataHandlerDueToMissingDependency​(String propertyName,
                                                                        String typeName)

      • attemptToResetApplicationResolver

        public static SDOException attemptToResetApplicationResolver()

      • dataObjectNotFromHelperContext

        public static SDOException dataObjectNotFromHelperContext()
        INTERNAL: Exception trying to marshal a dataobject from a different HelperContext