org.eclipse.persistence.exceptions
Class JAXBException

java.lang.Object
  java.lang.Throwable
      java.lang.Exception
          java.lang.RuntimeException
              org.eclipse.persistence.exceptions.EclipseLinkException
                  org.eclipse.persistence.exceptions.JAXBException

All Implemented Interfaces:

java.io.Serializable

public class JAXBException
extends EclipseLinkException

Purpose:

• This class provides an implementation of EclipseLinkException specific to the EclipseLink JAXB implementation

Responsibilities:

• Return a JAXBException that can be thrown around input parameters.
• Return a JAXBException that wraps an existing exception with additional input parameters.

See Also:

Serialized Form

Since:

Oracle EclipseLink 1.0

Field Summary

static int	ANY_ATTRIBUTE_ON_NON_MAP_PROPERTY
static int	COULD_NOT_CREATE_CONTEXT_FOR_XML_MODEL
static int	COULD_NOT_CREATE_CUSTOMIZER_INSTANCE
static int	COULD_NOT_INITIALIZE_DOM_HANDLER_CONVERTER
static int	COULD_NOT_LOAD_CLASS_FROM_METADATA
static int	COULD_NOT_UNMARSHAL_METADATA
static int	FACTORY_CLASS_WITHOUT_FACTORY_METHOD
static int	FACTORY_METHOD_NOT_DECLARED
static int	FACTORY_METHOD_OR_ZERO_ARG_CONST_REQ
static int	ID_ALREADY_SET
static int	INVALID_CUSTOMIZER_CLASS
static int	INVALID_ID
static int	INVALID_IDREF
static int	INVALID_LIST
static int	INVALID_TYPE_FOR_XMLATTRIBUTEREF_PROPERTY
static int	INVALID_TYPE_FOR_XMLVALUE_PROPERTY
static int	INVALID_XML_ELEMENT_REF
static int	INVALID_XML_ELEMENT_WRAPPER
static int	KEY_PARAMETER_TYPE_INCORRECT
static int	MISSING_PROPERTY_IN_PROP_ORDER
static int	MULTIPLE_ANY_ATTRIBUTE_MAPPING
static int	NAME_COLLISION
static int	NO_OBJECT_FACTORY_OR_JAXB_INDEX_IN_PATH
static int	NON_EXISTENT_PROPERTY_IN_PROP_ORDER
static int	NULL_MAP_KEY
static int	NULL_METADATA_SOURCE
static int	SUBCLASS_CANNOT_HAVE_XMLVALUE
static int	TRANSIENT_IN_PROP_ORDER
static int	UNSUPPORTED_NODE_CLASS
static int	VALUE_PARAMETER_TYPE_INCORRECT
static int	VALUE_PARAMETER_TYPE_INCORRECT_FOR_OXM_XML
static int	XMLANYELEMENT_ALREADY_SET
static int	XMLVALUE_ALREADY_SET
static int	XMLVALUE_ATTRIBUTE_CONFLICT

Fields inherited from class org.eclipse.persistence.exceptions.EclipseLinkException

CR, errorCode, hasBeenLogged, indentationString, internalException, session, shouldPrintInternalException

Constructor Summary

protected	JAXBException(java.lang.String message)
protected	JAXBException(java.lang.String message, java.lang.Exception internalException)

Method Summary

static JAXBException	anyAttributeOnNonMap(java.lang.String propertyName)
static JAXBException	couldNotCreateContextForXmlModel() This exception would typically be used by JAXBContextFactory during externalized metadata processing (i.e.
static JAXBException	couldNotCreateContextForXmlModel(java.lang.Exception ex) This exception would typically be used by JAXBContextFactory during externalized metadata processing (i.e.
static JAXBException	couldNotCreateCustomizerInstance(java.lang.Exception e, java.lang.String customizerClassName) This exception should be used when a descriptor customizer instance cannot be created.
static JAXBException	couldNotInitializeDomHandlerConverter(java.lang.Exception nestedException, java.lang.String domHandlerClassName, java.lang.String propertyName) This exception should be used when DomHandlerConverter initialization fails.
static JAXBException	couldNotLoadClassFromMetadata(java.lang.String classname) This exception would typically be used by JAXBContextFactory during externalized metadata processing (i.e.
static JAXBException	couldNotUnmarshalMetadata(java.lang.Exception e) This exception would typically be used by JAXBContextFactory during externalized metadata processing (i.e.
static JAXBException	factoryClassWithoutFactoryMethod(java.lang.String className)
static JAXBException	factoryMethodNotDeclared(java.lang.String methodName, java.lang.String className)
static JAXBException	factoryMethodOrConstructorRequired(java.lang.String className)
static JAXBException	idAlreadySet(java.lang.String propertyName, java.lang.String idPropertyName, java.lang.String className) This exception should be used when an attempt is made to set an ID property when one has already been set.
static JAXBException	incorrectKeyParameterType() This exception would typically be used by JAXBContextFactory during externalized metadata processing (i.e.
static JAXBException	incorrectValueParameterType() This exception would typically be used by JAXBContextFactory during externalized metadata processing (i.e.
static JAXBException	incorrectValueParameterTypeForOxmXmlKey() This exception would typically be used by JAXBContextFactory during externalized metadata processing (i.e.
static JAXBException	invalidAttributeRef(java.lang.String propertyName, java.lang.String className) This exception should be used when an @XmlAttributeRef or xml-attribute-ref appears on a non-DataHandler property.
static JAXBException	invalidCustomizerClass(java.lang.Exception e, java.lang.String customizerClassName) This exception would typically be thrown when a customizer class is set that is not an instance of DescriptorCustomizer.
static JAXBException	invalidElementRef(java.lang.String propertyName, java.lang.String className)
static JAXBException	invalidElementWrapper(java.lang.String propertyName)
static JAXBException	invalidId(java.lang.String propertyName)
static JAXBException	invalidIdRef(java.lang.String propertyName, java.lang.String className)
static JAXBException	invalidList(java.lang.String propertyName)
static JAXBException	invalidTypeForXmlValueField(java.lang.String fieldName)
static JAXBException	missingPropertyInPropOrder(java.lang.String fieldName)
static JAXBException	multipleAnyAttributeMapping(java.lang.String className)
static JAXBException	nameCollision(java.lang.String uri, java.lang.String name)
static JAXBException	nonExistentPropertyInPropOrder(java.lang.String fieldName)
static JAXBException	noObjectFactoryOrJaxbIndexInPath(java.lang.String path)
static JAXBException	nullMapKey() This exception would typically be used by JAXBContextFactory during externalized metadata processing (i.e.
static JAXBException	nullMetadataSource(java.lang.String key) This exception would typically be used by JAXBContextFactory during externalized metadata processing (i.e.
static JAXBException	propertyOrFieldCannotBeXmlValue(java.lang.String fieldName)
static JAXBException	propertyOrFieldShouldBeAnAttribute(java.lang.String fieldName)
static JAXBException	transientInProporder(java.lang.String fieldName)
static JAXBException	unsupportedNodeClass(java.lang.String className)
static JAXBException	xmlAnyElementAlreadySet(java.lang.String propertyName, java.lang.String xmlAnyElementPropertyName, java.lang.String className) This exception should be used when an attempt is made to set an XmlAnyElement property when one has already been set.
static JAXBException	xmlValueAlreadySet(java.lang.String propertyName, java.lang.String xmlValuePropertyName, java.lang.String className) This exception should be used when an attempt is made to set an XmlValue property when one has already been set.

Methods inherited from class org.eclipse.persistence.exceptions.EclipseLinkException

cr, getErrorCode, getIndentationString, getInternalException, getMessage, getSession, hasBeenLogged, printStackTrace, printStackTrace, printStackTrace, setErrorCode, setHasBeenLogged, setIndentationString, setInternalException, setSession, setShouldPrintInternalException, shouldPrintInternalException, toString

Methods inherited from class java.lang.Throwable

fillInStackTrace, getCause, getLocalizedMessage, getStackTrace, initCause, setStackTrace

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

NO_OBJECT_FACTORY_OR_JAXB_INDEX_IN_PATH

public static final int NO_OBJECT_FACTORY_OR_JAXB_INDEX_IN_PATH

See Also:

Constant Field Values

FACTORY_METHOD_OR_ZERO_ARG_CONST_REQ

public static final int FACTORY_METHOD_OR_ZERO_ARG_CONST_REQ

See Also:

Constant Field Values

FACTORY_CLASS_WITHOUT_FACTORY_METHOD

public static final int FACTORY_CLASS_WITHOUT_FACTORY_METHOD

See Also:

Constant Field Values

FACTORY_METHOD_NOT_DECLARED

public static final int FACTORY_METHOD_NOT_DECLARED

See Also:

Constant Field Values

ANY_ATTRIBUTE_ON_NON_MAP_PROPERTY

public static final int ANY_ATTRIBUTE_ON_NON_MAP_PROPERTY

See Also:

Constant Field Values

MULTIPLE_ANY_ATTRIBUTE_MAPPING

public static final int MULTIPLE_ANY_ATTRIBUTE_MAPPING

See Also:

Constant Field Values

INVALID_XML_ELEMENT_REF

public static final int INVALID_XML_ELEMENT_REF

See Also:

Constant Field Values

NAME_COLLISION

public static final int NAME_COLLISION

See Also:

Constant Field Values

UNSUPPORTED_NODE_CLASS

public static final int UNSUPPORTED_NODE_CLASS

See Also:

Constant Field Values

TRANSIENT_IN_PROP_ORDER

public static final int TRANSIENT_IN_PROP_ORDER

See Also:

Constant Field Values

XMLVALUE_ATTRIBUTE_CONFLICT

public static final int XMLVALUE_ATTRIBUTE_CONFLICT

See Also:

Constant Field Values

SUBCLASS_CANNOT_HAVE_XMLVALUE

public static final int SUBCLASS_CANNOT_HAVE_XMLVALUE

See Also:

Constant Field Values

NON_EXISTENT_PROPERTY_IN_PROP_ORDER

public static final int NON_EXISTENT_PROPERTY_IN_PROP_ORDER

See Also:

Constant Field Values

MISSING_PROPERTY_IN_PROP_ORDER

public static final int MISSING_PROPERTY_IN_PROP_ORDER

See Also:

Constant Field Values

INVALID_TYPE_FOR_XMLVALUE_PROPERTY

public static final int INVALID_TYPE_FOR_XMLVALUE_PROPERTY

See Also:

Constant Field Values

INVALID_XML_ELEMENT_WRAPPER

public static final int INVALID_XML_ELEMENT_WRAPPER

See Also:

Constant Field Values

INVALID_ID

public static final int INVALID_ID

See Also:

Constant Field Values

INVALID_IDREF

public static final int INVALID_IDREF

See Also:

Constant Field Values

INVALID_LIST

public static final int INVALID_LIST

See Also:

Constant Field Values

VALUE_PARAMETER_TYPE_INCORRECT_FOR_OXM_XML

public static final int VALUE_PARAMETER_TYPE_INCORRECT_FOR_OXM_XML

See Also:

Constant Field Values

KEY_PARAMETER_TYPE_INCORRECT

public static final int KEY_PARAMETER_TYPE_INCORRECT

See Also:

Constant Field Values

VALUE_PARAMETER_TYPE_INCORRECT

public static final int VALUE_PARAMETER_TYPE_INCORRECT

See Also:

Constant Field Values

NULL_METADATA_SOURCE

public static final int NULL_METADATA_SOURCE

See Also:

Constant Field Values

NULL_MAP_KEY

public static final int NULL_MAP_KEY

See Also:

Constant Field Values

COULD_NOT_LOAD_CLASS_FROM_METADATA

public static final int COULD_NOT_LOAD_CLASS_FROM_METADATA

See Also:

Constant Field Values

COULD_NOT_CREATE_CONTEXT_FOR_XML_MODEL

public static final int COULD_NOT_CREATE_CONTEXT_FOR_XML_MODEL

See Also:

Constant Field Values

COULD_NOT_UNMARSHAL_METADATA

public static final int COULD_NOT_UNMARSHAL_METADATA

See Also:

Constant Field Values

COULD_NOT_CREATE_CUSTOMIZER_INSTANCE

public static final int COULD_NOT_CREATE_CUSTOMIZER_INSTANCE

See Also:

Constant Field Values

INVALID_CUSTOMIZER_CLASS

public static final int INVALID_CUSTOMIZER_CLASS

See Also:

Constant Field Values

ID_ALREADY_SET

public static final int ID_ALREADY_SET

See Also:

Constant Field Values

XMLVALUE_ALREADY_SET

public static final int XMLVALUE_ALREADY_SET

See Also:

Constant Field Values

XMLANYELEMENT_ALREADY_SET

public static final int XMLANYELEMENT_ALREADY_SET

See Also:

Constant Field Values

COULD_NOT_INITIALIZE_DOM_HANDLER_CONVERTER

public static final int COULD_NOT_INITIALIZE_DOM_HANDLER_CONVERTER

See Also:

Constant Field Values

INVALID_TYPE_FOR_XMLATTRIBUTEREF_PROPERTY

public static final int INVALID_TYPE_FOR_XMLATTRIBUTEREF_PROPERTY

See Also:

Constant Field Values

Constructor Detail

JAXBException

protected JAXBException(java.lang.String message)

JAXBException

protected JAXBException(java.lang.String message,
                        java.lang.Exception internalException)

Method Detail

noObjectFactoryOrJaxbIndexInPath

public static JAXBException noObjectFactoryOrJaxbIndexInPath(java.lang.String path)

factoryMethodOrConstructorRequired

public static JAXBException factoryMethodOrConstructorRequired(java.lang.String className)

factoryClassWithoutFactoryMethod

public static JAXBException factoryClassWithoutFactoryMethod(java.lang.String className)

factoryMethodNotDeclared

public static JAXBException factoryMethodNotDeclared(java.lang.String methodName,
                                                     java.lang.String className)

multipleAnyAttributeMapping

public static JAXBException multipleAnyAttributeMapping(java.lang.String className)

anyAttributeOnNonMap

public static JAXBException anyAttributeOnNonMap(java.lang.String propertyName)

invalidElementRef

public static JAXBException invalidElementRef(java.lang.String propertyName,
                                              java.lang.String className)

invalidElementWrapper

public static JAXBException invalidElementWrapper(java.lang.String propertyName)

invalidId

public static JAXBException invalidId(java.lang.String propertyName)

invalidIdRef

public static JAXBException invalidIdRef(java.lang.String propertyName,
                                         java.lang.String className)

invalidList

public static JAXBException invalidList(java.lang.String propertyName)

nameCollision

public static JAXBException nameCollision(java.lang.String uri,
                                          java.lang.String name)

unsupportedNodeClass

public static JAXBException unsupportedNodeClass(java.lang.String className)

transientInProporder

public static JAXBException transientInProporder(java.lang.String fieldName)

nonExistentPropertyInPropOrder

public static JAXBException nonExistentPropertyInPropOrder(java.lang.String fieldName)

missingPropertyInPropOrder

public static JAXBException missingPropertyInPropOrder(java.lang.String fieldName)

propertyOrFieldShouldBeAnAttribute

public static JAXBException propertyOrFieldShouldBeAnAttribute(java.lang.String fieldName)

propertyOrFieldCannotBeXmlValue

public static JAXBException propertyOrFieldCannotBeXmlValue(java.lang.String fieldName)

invalidTypeForXmlValueField

public static JAXBException invalidTypeForXmlValueField(java.lang.String fieldName)

incorrectKeyParameterType

public static JAXBException incorrectKeyParameterType()

This exception would typically be used by JAXBContextFactory during externalized metadata processing (i.e. eclipselink-oxm.xml). This exception applies to the case where the Key parameter type of the package name to metadata source map is something other than String. We require Map.

Returns:

incorrectValueParameterType

public static JAXBException incorrectValueParameterType()

This exception would typically be used by JAXBContextFactory during externalized metadata processing (i.e. eclipselink-oxm.xml). This exception applies to the case where the Value parameter type (of the package name to metadata source map) is something other than Source. We require Map.

Returns:

incorrectValueParameterTypeForOxmXmlKey

public static JAXBException incorrectValueParameterTypeForOxmXmlKey()

This exception would typically be used by JAXBContextFactory during externalized metadata processing (i.e. eclipselink-oxm.xml). This exception applies to the case where the Value parameter type associated with the 'eclipselink-oxm-xml' Key (in the properties map) is something other than Map.

Returns:

nullMetadataSource

public static JAXBException nullMetadataSource(java.lang.String key)

This exception would typically be used by JAXBContextFactory during externalized metadata processing (i.e. eclipselink-oxm.xml). This exception applies to the case where the Value (in the package name to metadata source map) is null.

Parameters:

key -

Returns:

nullMapKey

public static JAXBException nullMapKey()

This exception would typically be used by JAXBContextFactory during externalized metadata processing (i.e. eclipselink-oxm.xml). This exception applies to the case where the Key (in the package name to metadata source map) is null.

Returns:

couldNotLoadClassFromMetadata

public static JAXBException couldNotLoadClassFromMetadata(java.lang.String classname)

This exception would typically be used by JAXBContextFactory during externalized metadata processing (i.e. eclipselink-oxm.xml). This exception applies to the case where a class that is declared in the metadata file cannot be loaded by the classloader.

Parameters:

classname -

Returns:

couldNotCreateContextForXmlModel

public static JAXBException couldNotCreateContextForXmlModel()

This exception would typically be used by JAXBContextFactory during externalized metadata processing (i.e. eclipselink-oxm.xml). This exception applies to the case where JAXBContext creation fails for our XmlModel.

Returns:

couldNotCreateContextForXmlModel

public static JAXBException couldNotCreateContextForXmlModel(java.lang.Exception ex)

This exception would typically be used by JAXBContextFactory during externalized metadata processing (i.e. eclipselink-oxm.xml). This exception applies to the case where JAXBContext creation fails for our XmlModel.

Parameters:

ex -

Returns:

couldNotUnmarshalMetadata

public static JAXBException couldNotUnmarshalMetadata(java.lang.Exception e)

This exception would typically be used by JAXBContextFactory during externalized metadata processing (i.e. eclipselink-oxm.xml). This exception applies to the case where an exception occurs while unmarshalling the eclipselink metadata file.

Parameters:

e -

Returns:

couldNotCreateCustomizerInstance

public static JAXBException couldNotCreateCustomizerInstance(java.lang.Exception e,
                                                             java.lang.String customizerClassName)

This exception should be used when a descriptor customizer instance cannot be created.

Parameters:

e -

javaClassName -

customizerClassName -

Returns:

invalidCustomizerClass

public static JAXBException invalidCustomizerClass(java.lang.Exception e,
                                                   java.lang.String customizerClassName)

This exception would typically be thrown when a customizer class is set that is not an instance of DescriptorCustomizer.

Parameters:

e -

customizerClassName -

Returns:

idAlreadySet

public static JAXBException idAlreadySet(java.lang.String propertyName,
                                         java.lang.String idPropertyName,
                                         java.lang.String className)

This exception should be used when an attempt is made to set an ID property when one has already been set.

Parameters:

propertyName - attempting to set this property as ID

idPropertyName - existing ID property

className - class in question

Returns:

xmlValueAlreadySet

public static JAXBException xmlValueAlreadySet(java.lang.String propertyName,
                                               java.lang.String xmlValuePropertyName,
                                               java.lang.String className)

This exception should be used when an attempt is made to set an XmlValue property when one has already been set.

Parameters:

propertyName - attempting to set this property as XmlValue

xmlValuePropertyName - existing XmlValue property

className - class in question

Returns:

xmlAnyElementAlreadySet

public static JAXBException xmlAnyElementAlreadySet(java.lang.String propertyName,
                                                    java.lang.String xmlAnyElementPropertyName,
                                                    java.lang.String className)

This exception should be used when an attempt is made to set an XmlAnyElement property when one has already been set.

Parameters:

propertyName - attempting to set this property as XmlAnyElement

xmlAnyElementPropertyName - existing XmlAnyElement property

className - class in question

Returns:

couldNotInitializeDomHandlerConverter

public static JAXBException couldNotInitializeDomHandlerConverter(java.lang.Exception nestedException,
                                                                  java.lang.String domHandlerClassName,
                                                                  java.lang.String propertyName)

This exception should be used when DomHandlerConverter initialization fails.

Parameters:

nestedException -

domHandlerClassName -

propertyName -

Returns:

invalidAttributeRef

public static JAXBException invalidAttributeRef(java.lang.String propertyName,
                                                java.lang.String className)

This exception should be used when an @XmlAttributeRef or xml-attribute-ref appears on a non-DataHandler property.

Parameters:

propertyName -

className -

Returns: