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:
  • Field Details

    • NO_ID_SPECIFIED

      public static final int NO_ID_SPECIFIED
      See Also:
    • ERROR_PROCESSING_IMPORT

      public static final int ERROR_PROCESSING_IMPORT
      See Also:
    • ERROR_PROCESSING_INCLUDE

      public static final int ERROR_PROCESSING_INCLUDE
      See Also:
    • REFERENCED_PROPERTY_NOT_FOUND

      public static final int REFERENCED_PROPERTY_NOT_FOUND
      See Also:
    • OLD_SEQUENCE_NOT_FOUND

      public static final int OLD_SEQUENCE_NOT_FOUND
      See Also:
    • FOUND_SIMPLE_VALUE_FOR_FOR_NON_DATATYPE_PROPERTY

      public static final int FOUND_SIMPLE_VALUE_FOR_FOR_NON_DATATYPE_PROPERTY
      See Also:
    • SEQUENCE_NULL_ON_SEQUENCED_DATAOBJECT

      public static final int SEQUENCE_NULL_ON_SEQUENCED_DATAOBJECT
      See Also:
    • NO_TYPE_SPECIFIED_FOR_PROPERTY

      public static final int NO_TYPE_SPECIFIED_FOR_PROPERTY
      See Also:
    • IO_EXCEPTION_OCCURRED

      public static final int IO_EXCEPTION_OCCURRED
      See Also:
    • TYPE_NOT_FOUND

      public static final int TYPE_NOT_FOUND
      See Also:
    • TYPE_NOT_FOUND_FOR_INTERFACE

      public static final int TYPE_NOT_FOUND_FOR_INTERFACE
      See Also:
    • ERROR_CREATING_DATAOBJECT_FOR_TYPE

      public static final int ERROR_CREATING_DATAOBJECT_FOR_TYPE
      See Also:
    • ERROR_CREATING_DATAOBJECT_FOR_CLASS

      public static final int ERROR_CREATING_DATAOBJECT_FOR_CLASS
      See Also:
    • NO_APP_INFO_FOR_NULL

      public static final int NO_APP_INFO_FOR_NULL
      See Also:
    • ERROR_DEFINING_TYPE

      public static final int ERROR_DEFINING_TYPE
      See Also:
    • ERROR_DEFINING_TYPE_NO_NAME

      public static final int ERROR_DEFINING_TYPE_NO_NAME
      See Also:
    • MISSING_REF_ATTRIBUTE

      public static final int MISSING_REF_ATTRIBUTE
      See Also:
    • ERROR_PROCESSING_XPATH

      public static final int ERROR_PROCESSING_XPATH
      See Also:
    • SEQUENCE_DUPLICATE_ADD_NOT_SUPPORTED

      public static final int SEQUENCE_DUPLICATE_ADD_NOT_SUPPORTED
      See Also:
    • SEQUENCE_ERROR_PROPERTY_IS_ATTRIBUTE

      public static final int SEQUENCE_ERROR_PROPERTY_IS_ATTRIBUTE
      See Also:
    • SEQUENCE_ERROR_NO_PATH_FOUND

      public static final int SEQUENCE_ERROR_NO_PATH_FOUND
      See Also:
    • SEQUENCE_ERROR_DATAOBJECT_IS_NULL

      public static final int SEQUENCE_ERROR_DATAOBJECT_IS_NULL
      See Also:
    • SEQUENCE_NOT_SUPPORTED_FOR_PROPERTY

      public static final int SEQUENCE_NOT_SUPPORTED_FOR_PROPERTY
      See Also:
    • WRONG_VALUE_FOR_PROPERTY

      public static final int WRONG_VALUE_FOR_PROPERTY
      See Also:
    • CONVERSION_ERROR

      public static final int CONVERSION_ERROR
      See Also:
    • PROPERTY_NOT_FOUND_AT_INDEX

      public static final int PROPERTY_NOT_FOUND_AT_INDEX
      See Also:
    • CANNOT_PERFORM_OPERATION_ON_NULL_ARGUMENT

      public static final int CANNOT_PERFORM_OPERATION_ON_NULL_ARGUMENT
      See Also:
    • CLASS_NOT_FOUND

      public static final int CLASS_NOT_FOUND
      See Also:
    • TYPE_CANNOT_BE_OPEN_AND_DATATYPE

      public static final int TYPE_CANNOT_BE_OPEN_AND_DATATYPE
      See Also:
    • INVALID_INDEX

      public static final int INVALID_INDEX
      See Also:
    • JAVA_CLASS_INVOKING_ERROR

      public static final int JAVA_CLASS_INVOKING_ERROR
      See Also:
    • CANNOT_SET_PROPERTY_TYPE_ANNOTATION_IF_TARGET_DATATYPE_TRUE

      public static final int CANNOT_SET_PROPERTY_TYPE_ANNOTATION_IF_TARGET_DATATYPE_TRUE
      See Also:
    • XMLMARSHAL_EXCEPTION_OCCURRED

      public static final int XMLMARSHAL_EXCEPTION_OCCURRED
      See Also:
    • TYPE_REFERENCED_BUT_NEVER_DEFINED

      public static final int TYPE_REFERENCED_BUT_NEVER_DEFINED
      See Also:
    • OPTIONS_MUST_BE_A_DATAOBJECT

      public static final int OPTIONS_MUST_BE_A_DATAOBJECT
      See Also:
    • TYPE_PROPERTY_MUST_BE_A_TYPE

      public static final int TYPE_PROPERTY_MUST_BE_A_TYPE
      See Also:
    • GLOBAL_PROPERTY_NOT_FOUND

      public static final int GLOBAL_PROPERTY_NOT_FOUND
      See Also:
    • PREFIX_USED_BUT_NOT_DEFINED

      public static final int PREFIX_USED_BUT_NOT_DEFINED
      See Also:
    • CANNOT_PERFORM_OPERATION_ON_PROPERTY

      public static final int CANNOT_PERFORM_OPERATION_ON_PROPERTY
      See Also:
    • ERROR_ACCESSING_EXTERNALIZABLEDELEGATOR

      public static final int ERROR_ACCESSING_EXTERNALIZABLEDELEGATOR
      See Also:
    • CANNOT_PERFORM_OP_WITH_NULL_PARAM

      public static final int CANNOT_PERFORM_OP_WITH_NULL_PARAM
      See Also:
    • INVALID_PROPERTY_VALUE

      public static final int INVALID_PROPERTY_VALUE
      See Also:
    • ERROR_PERFORMING_WLS_LOOKUP

      public static final int ERROR_PERFORMING_WLS_LOOKUP
      See Also:
    • ERROR_MAKING_WLS_REFLECTIVE_CALL

      public static final int ERROR_MAKING_WLS_REFLECTIVE_CALL
      See Also:
    • ERROR_GETTING_OBJECTNAME

      public static final int ERROR_GETTING_OBJECTNAME
      See Also:
    • ERROR_CREATING_INITIAL_CONTEXT

      public static final int ERROR_CREATING_INITIAL_CONTEXT
      See Also:
    • SDO_JAXB_NO_DESCRIPTOR_FOR_TYPE

      public static final int SDO_JAXB_NO_DESCRIPTOR_FOR_TYPE
      See Also:
    • SDO_JAXB_NO_MAPPING_FOR_PROPERTY

      public static final int SDO_JAXB_NO_MAPPING_FOR_PROPERTY
      See Also:
    • SDO_JAXB_NO_TYPE_FOR_CLASS

      public static final int SDO_JAXB_NO_TYPE_FOR_CLASS
      See Also:
    • SDO_JAXB_NO_SCHEMA_REFERENCE

      public static final int SDO_JAXB_NO_SCHEMA_REFERENCE
      See Also:
    • SDO_JAXB_NO_SCHEMA_CONTEXT

      public static final int SDO_JAXB_NO_SCHEMA_CONTEXT
      See Also:
    • SDO_JAXB_NO_TYPE_FOR_CLASS_BY_SCHEMA_CONTEXT

      public static final int SDO_JAXB_NO_TYPE_FOR_CLASS_BY_SCHEMA_CONTEXT
      See Also:
    • SDO_JAXB_ERROR_CREATING_JAXB_UNMARSHALLER

      public static final int SDO_JAXB_ERROR_CREATING_JAXB_UNMARSHALLER
      See Also:
    • ERROR_RESOLVING_ENTITY

      public static final int ERROR_RESOLVING_ENTITY
      See Also:
    • MISSING_DEPENDENCY_FOR_BINARY_MAPPING

      public static final int MISSING_DEPENDENCY_FOR_BINARY_MAPPING
      See Also:
    • ATTEMPT_TO_RESET_APP_RESOLVER

      public static final int ATTEMPT_TO_RESET_APP_RESOLVER
      See Also:
    • DATAOBJECT_FROM_DIFFERENT_HELPERCONTEXT

      public static final int DATAOBJECT_FROM_DIFFERENT_HELPERCONTEXT
      See Also:
    • ERROR_DEFINING_TYPE_INVALID_NAME

      public static final int ERROR_DEFINING_TYPE_INVALID_NAME
      See Also:
    • ERROR_DEFINING_PROPERTY_INVALID_NAME

      public static final int ERROR_DEFINING_PROPERTY_INVALID_NAME
      See Also:
  • Constructor Details

    • SDOException

      protected SDOException(String message)
    • SDOException

      protected SDOException(String message, Exception internalException)
  • Method Details

    • 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
    • invalidPropertyValue

      public static SDOException invalidPropertyValue(String property, String type, String valueType, String value, ConversionException coe)
      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
    • invalidIndex

      public static SDOException invalidIndex(IndexOutOfBoundsException nestedException, int index)
      INTERNAL: Exception trying to pass an invalid index to a method
    • 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)
    • errorResolvingSchema

      public static SDOException errorResolvingSchema(Exception nestedException)
    • 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