Package org.eclipse.persistence.exceptions

Class SDOException

  • All Implemented Interfaces:
    java.io.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​(java.lang.String message)

      • SDOException

        protected SDOException​(java.lang.String message,
                       java.lang.Exception internalException)

    • Method Detail

      • errorPerformingWLSLookup

        public static SDOException errorPerformingWLSLookup​(java.lang.String failedLookup,
                                                    java.lang.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​(java.lang.String methodName,
                                                              java.lang.String theClass,
                                                              java.lang.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​(java.lang.String objectName,
                                                     java.lang.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​(java.lang.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​(java.lang.String uri,
                                               java.lang.String name)
        INTERNAL: Exception when building an ObjectReferenceMapping and referenced object does not have an id property

      • errorProcessingImport

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

      • errorProcessingInclude

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

      • referencedPropertyNotFound

        public static SDOException referencedPropertyNotFound​(java.lang.String uri,
                                                      java.lang.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​(java.lang.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​(java.lang.String propertyName)
        INTERNAL: Exception when a property does not have a type specified

      • ioExceptionOccurred

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

      • xmlMarshalExceptionOccurred

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

      • typeNotFound

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

      • typeNotFoundForInterface

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

      • errorCreatingDataObjectForType

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

      • cannotPerformOperationWithNullInputParameter

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

      • invalidPropertyValue

        public static SDOException invalidPropertyValue​(java.lang.String property,
                                                java.lang.String type,
                                                java.lang.String valueType,
                                                java.lang.String value,
                                                ConversionException coe)
        INTERNAL: Exception trying to call a method with a null input parameter

      • errorCreatingDataObjectForClass

        public static SDOException errorCreatingDataObjectForClass​(java.lang.Exception nestedException,
                                                           java.lang.String className,
                                                           java.lang.String uri,
                                                           java.lang.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​(java.lang.String name)
        INTERNAL: Exception trying to create a type with invalid name.
        Parameters:
        name - type name
        Returns:
        SDOException

      • errorDefiningPropertyInvalidName

        public static SDOException errorDefiningPropertyInvalidName​(java.lang.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​(java.lang.String xpath)
        INTERNAL: Exception processing an xpath during xmlhelper.load

      • sequenceDuplicateSettingNotSupportedForComplexSingleObject

        public static SDOException sequenceDuplicateSettingNotSupportedForComplexSingleObject​(int index,
                                                                                      java.lang.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​(java.lang.String settingPropertyName)
        INTERNAL: Error when we attempt to add an attribute property to a sequence

      • sequenceNotFoundForPath

        public static SDOException sequenceNotFoundForPath​(java.lang.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​(java.lang.String propertyName)
        INTERNAL: Error passing in a null dataObject into the sequence constructor

      • wrongValueForProperty

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

      • conversionError

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

      • propertyNotFoundAtIndex

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

      • cannotPerformOperationOnNullArgument

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

      • cannotPerformOperationOnProperty

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

      • classNotFound

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

      • typeCannotBeOpenAndDataType

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

      • invalidIndex

        public static SDOException invalidIndex​(java.lang.IndexOutOfBoundsException nestedException,
                                        int index)
        INTERNAL: Exception trying to pass an invalid index to a method

      • noConstructorWithString

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

      • propertyTypeAnnotationTargetCannotBeDataTypeTrue

        public static SDOException propertyTypeAnnotationTargetCannotBeDataTypeTrue​(java.lang.String targetTypeName,
                                                                            java.lang.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​(java.lang.String namespaceUri,
                                                       java.lang.String typeName)

      • optionsMustBeADataObject

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

      • typePropertyMustBeAType

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

      • prefixUsedButNotDefined

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

      • errorAccessingExternalizableDelegator

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

      • sdoJaxbNoDescriptorForType

        public static SDOException sdoJaxbNoDescriptorForType​(javax.xml.namespace.QName sdoQName,
                                                      javax.xml.namespace.QName xmlQName)

      • sdoJaxbNoMappingForProperty

        public static SDOException sdoJaxbNoMappingForProperty​(java.lang.String propertyName,
                                                       java.lang.String xPath)

      • sdoJaxbNoTypeForClass

        public static SDOException sdoJaxbNoTypeForClass​(java.lang.Class clazz)

      • sdoJaxbNoSchemaReference

        public static SDOException sdoJaxbNoSchemaReference​(java.lang.Class clazz)

      • sdoJaxbNoSchemaContext

        public static SDOException sdoJaxbNoSchemaContext​(java.lang.Class clazz)

      • sdoJaxbNoTypeForClassBySchemaContext

        public static SDOException sdoJaxbNoTypeForClassBySchemaContext​(java.lang.Class clazz,
                                                                javax.xml.namespace.QName schemaContext)

      • sdoJaxbErrorCreatingJAXBUnmarshaller

        public static SDOException sdoJaxbErrorCreatingJAXBUnmarshaller​(java.lang.Exception jaxbException)

      • errorResolvingSchema

        public static SDOException errorResolvingSchema​(java.lang.Exception nestedException)

      • unableToMapDataHandlerDueToMissingDependency

        public static SDOException unableToMapDataHandlerDueToMissingDependency​(java.lang.String propertyName,
                                                                        java.lang.String typeName)

      • attemptToResetApplicationResolver

        public static SDOException attemptToResetApplicationResolver()

      • dataObjectNotFromHelperContext

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