org.eclipse.persistence.internal.jaxb

Class XMLJavaTypeConverter

java.lang.Object

org.eclipse.persistence.oxm.mappings.converters.XMLConverterAdapter

org.eclipse.persistence.internal.jaxb.XMLJavaTypeConverter

public class XMLJavaTypeConverter
extends org.eclipse.persistence.oxm.mappings.converters.XMLConverterAdapter

Converter that wraps an XmlAdapter.

See Also:

XmlAdapter

Field Summary

Fields

Modifier and Type	Field and Description
protected java.lang.Class<?>	boundType
protected DatabaseMapping	mapping
protected <any>	nestedConverter
protected javax.xml.namespace.QName	schemaType
protected java.lang.Class<?>	valueType
protected javax.xml.bind.annotation.adapters.XmlAdapter<?,?>	xmlAdapter
protected java.lang.Class<? extends javax.xml.bind.annotation.adapters.XmlAdapter<?,?>>	xmlAdapterClass
protected java.lang.String	xmlAdapterClassName

Constructor Summary

Constructors

Constructor and Description
XMLJavaTypeConverter() The default constructor.
XMLJavaTypeConverter(java.lang.Class<?> xmlAdapterClass) This constructor takes the XmlAdapter class to be used with this converter.
XMLJavaTypeConverter(java.lang.Class<?> xmlAdapterClass, javax.xml.namespace.QName schemaType) This constructor takes the XmlAdapter class to be used with this converter, as well as a schema type to be used during the conversion operation.
XMLJavaTypeConverter(java.lang.String xmlAdapterClassName) This constructor takes an adapter class name.
XMLJavaTypeConverter(java.lang.String xmlAdapterClassName, javax.xml.namespace.QName schemaType) This constructor takes the XmlAdapter class name to be used with this converter (loaded during initialization), as well as a schema type to be used during the conversion operation.

Method Summary

Modifier and Type	Method and Description
java.lang.Object	convertDataValueToObjectValue(java.lang.Object dataValue, Session session, XMLUnmarshaller unmarshaller) Wraps the XmlAdapter unmarshal method.
java.lang.Object	convertObjectValueToDataValue(java.lang.Object objectValue, Session session, XMLMarshaller marshaller) Wraps the XmlAdapter marshal method.
<any>	getNestedConverter() Get the nested converter to that is used in conjunction with the adapter.
javax.xml.namespace.QName	getSchemaType() Get the schema type to be used during conversion.
java.lang.Class<? extends javax.xml.bind.annotation.adapters.XmlAdapter<?,?>>	getXmlAdapterClass() Return the XmlAdapter class for this converter.
java.lang.String	getXmlAdapterClassName() Return the XmlAdapter class name for this converter.
void	initialize(DatabaseMapping mapping, Session session) Figure out the BoundType and ValueType for the XmlAdapter class, then either create an instance of the XmlAdapter, or if an instance is set on the marshaller, use it.
boolean	isMutable() Satisfy the interface.
void	setNestedConverter(<any> nestedConverter) Set a nested converter to be used in conjunction with the adapter.
void	setSchemaType(javax.xml.namespace.QName qname) Set the schema type to be used during conversion - if one is required.
void	setXmlAdapterClass(java.lang.Class<? extends javax.xml.bind.annotation.adapters.XmlAdapter<?,?>> xmlAdapterClass) Set the XmlAdapter class to be used with this converter.
void	setXmlAdapterClassName(java.lang.String xmlAdapterClassName) Set the XmlAdapter class to be used with this converter.

Methods inherited from class java.lang.Object

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

Field Detail

boundType

protected java.lang.Class<?> boundType

valueType

protected java.lang.Class<?> valueType

xmlAdapterClass

protected java.lang.Class<? extends javax.xml.bind.annotation.adapters.XmlAdapter<?,?>> xmlAdapterClass

xmlAdapterClassName

protected java.lang.String xmlAdapterClassName

xmlAdapter

protected javax.xml.bind.annotation.adapters.XmlAdapter<?,?> xmlAdapter

schemaType

protected javax.xml.namespace.QName schemaType

mapping

protected DatabaseMapping mapping

nestedConverter

protected <any> nestedConverter

Constructor Detail

XMLJavaTypeConverter

public XMLJavaTypeConverter()

The default constructor. This constructor should be used in conjunction with the setXmlAdapterClass method or setXmlAdapterClassName method.

XMLJavaTypeConverter

public XMLJavaTypeConverter(java.lang.Class<?> xmlAdapterClass)

This constructor takes the XmlAdapter class to be used with this converter.

Parameters:

xmlAdapterClass -

XMLJavaTypeConverter

public XMLJavaTypeConverter(java.lang.String xmlAdapterClassName)

This constructor takes an adapter class name. The adapter class will be loaded during initialization.

Parameters:

xmlAdapterClassName -

XMLJavaTypeConverter

public XMLJavaTypeConverter(java.lang.Class<?> xmlAdapterClass,
                            javax.xml.namespace.QName schemaType)

This constructor takes the XmlAdapter class to be used with this converter, as well as a schema type to be used during the conversion operation. During unmarshal, the value type will be converted to the schema type, then from that type to the bound type. The opposite will occur during marshal.

Parameters:

xmlAdapterClass -

schemaType -

XMLJavaTypeConverter

public XMLJavaTypeConverter(java.lang.String xmlAdapterClassName,
                            javax.xml.namespace.QName schemaType)

This constructor takes the XmlAdapter class name to be used with this converter (loaded during initialization), as well as a schema type to be used during the conversion operation. During unmarshal, the value type will be converted to the schema type, then from that type to the bound type. The opposite will occur during marshal.

Parameters:

xmlAdapterClassName -

schemaType -

Method Detail

convertDataValueToObjectValue

public java.lang.Object convertDataValueToObjectValue(java.lang.Object dataValue,
                                                      Session session,
                                                      XMLUnmarshaller unmarshaller)

Wraps the XmlAdapter unmarshal method.

convertObjectValueToDataValue

public java.lang.Object convertObjectValueToDataValue(java.lang.Object objectValue,
                                                      Session session,
                                                      XMLMarshaller marshaller)

Wraps the XmlAdapter marshal method.

getSchemaType

public javax.xml.namespace.QName getSchemaType()

Get the schema type to be used during conversion.

getXmlAdapterClass

public java.lang.Class<? extends javax.xml.bind.annotation.adapters.XmlAdapter<?,?>> getXmlAdapterClass()

Return the XmlAdapter class for this converter.

Returns:

xmlAdapterClass

getXmlAdapterClassName

public java.lang.String getXmlAdapterClassName()

Return the XmlAdapter class name for this converter. If null, the name will be set to "".

Returns:

xmlAdapterClassName

initialize

public void initialize(DatabaseMapping mapping,
                       Session session)

Figure out the BoundType and ValueType for the XmlAdapter class, then either create an instance of the XmlAdapter, or if an instance is set on the marshaller, use it.

Parameters:

mapping -

session -

isMutable

public boolean isMutable()

Satisfy the interface.

setSchemaType

public void setSchemaType(javax.xml.namespace.QName qname)

Set the schema type to be used during conversion - if one is required.

setXmlAdapterClass

public void setXmlAdapterClass(java.lang.Class<? extends javax.xml.bind.annotation.adapters.XmlAdapter<?,?>> xmlAdapterClass)

Set the XmlAdapter class to be used with this converter.

Parameters:

xmlAdapterClass -

setXmlAdapterClassName

public void setXmlAdapterClassName(java.lang.String xmlAdapterClassName)

Set the XmlAdapter class to be used with this converter.

Parameters:

xmlAdapterClassName -

getNestedConverter

public <any> getNestedConverter()

Get the nested converter to that is used in conjunction with the adapter.

setNestedConverter

public void setNestedConverter(<any> nestedConverter)

Set a nested converter to be used in conjunction with the adapter. On marshal, the nested converter is invoked after the adapter. On umarshal it is invoked before. Primarily used to support enumerations with adapters.