org.eclipse.persistence.internal.jpa.metadata.converters

Class ConvertMetadata

java.lang.Object

org.eclipse.persistence.internal.jpa.metadata.ORMetadata

org.eclipse.persistence.internal.jpa.metadata.converters.ConvertMetadata

public class ConvertMetadata
extends ORMetadata

Object to hold onto convert metadata. Key notes: - any metadata mapped from XML to this class must be compared in the equals method. - any metadata mapped from XML to this class must be initialized in the initXMLObject method. - when loading from annotations, the constructor accepts the metadata accessor this metadata was loaded from. Used it to look up any 'companion' annotation needed for processing. - methods should be preserved in alphabetical order.

Since:

EclipseLink 2.5

Author:

Guy Pelletier

Field Summary

Fields

Modifier and Type	Field and Description
static String	KEY

Constructor Summary

Constructors

Constructor and Description
ConvertMetadata() INTERNAL: Used for XML loading.
ConvertMetadata(MetadataAnnotation convert, MetadataAccessor accessor) INTERNAL: Used for annotation loading.

Method Summary

Modifier and Type	Method and Description
boolean	disableConversion() INTERNAL: Return true if any auto apply converter should be disabled.
boolean	equals(Object objectToCompare) INTERNAL:
String	getAttributeName() INTERNAL: Used for OX mapping.
MetadataClass	getConverterClass() INTERNAL:
String	getConverterClassName() INTERNAL: Used for OX mapping.
Boolean	getDisableConversion() INTERNAL: Used for OX mapping.
boolean	hasAttributeName() INTERNAL:
boolean	hasConverterClass() INTERNAL:
void	initXMLObject(MetadataAccessibleObject accessibleObject, XMLEntityMappings entityMappings) INTERNAL:
boolean	isForMapKey() INTERNAL: Return true if this convert metadata is for a map key.
void	process(DatabaseMapping mapping, MetadataClass referenceClass, ClassAccessor accessor, boolean isForMapKey) INTERNAL: By the time we get here, we have the mapping that needs to have the convert applied to.
void	setAttributeName(String attributeName) INTERNAL: Used for OX mapping.
void	setConverterClassName(String converterClassName) INTERNAL: Used for OX mapping.
void	setDisableConversion(Boolean disableConversion) INTERNAL: Used for OX mapping.
void	setText(String text) INTERNAL: Used for OX mapping.

Methods inherited from class org.eclipse.persistence.internal.jpa.metadata.ORMetadata

getAccessibleObjectName, getAnnotation, getEntityMappings, getJavaClassName, getLoader, getLocation, getLogger, getMetadataClass, getMetadataClass, getMetadataClass, getMetadataFactory, getProject, loadedFromAnnotation, loadedFromEclipseLinkXML, loadedFromXML, setAccessibleObject, setEntityMappings, setProject, shouldOverride

Methods inherited from class java.lang.Object

getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

KEY

public static final String KEY

See Also:

Constant Field Values

Constructor Detail

ConvertMetadata

public ConvertMetadata()

INTERNAL: Used for XML loading.

ConvertMetadata

public ConvertMetadata(MetadataAnnotation convert,
                       MetadataAccessor accessor)

INTERNAL: Used for annotation loading.

Method Detail

disableConversion

public boolean disableConversion()

INTERNAL: Return true if any auto apply converter should be disabled.

equals

public boolean equals(Object objectToCompare)

INTERNAL:

Specified by:

equals in class ORMetadata

getAttributeName

public String getAttributeName()

INTERNAL: Used for OX mapping.

getConverterClass

public MetadataClass getConverterClass()

INTERNAL:

getConverterClassName

public String getConverterClassName()

INTERNAL: Used for OX mapping.

getDisableConversion

public Boolean getDisableConversion()

INTERNAL: Used for OX mapping.

hasAttributeName

public boolean hasAttributeName()

INTERNAL:

hasConverterClass

public boolean hasConverterClass()

INTERNAL:

initXMLObject

public void initXMLObject(MetadataAccessibleObject accessibleObject,
                          XMLEntityMappings entityMappings)

INTERNAL:

Overrides:

initXMLObject in class ORMetadata

isForMapKey

public boolean isForMapKey()

INTERNAL: Return true if this convert metadata is for a map key. Way to tell is if there is an attribute name that begins with "key". Calling this method will also update the attribute name on the first call to it. This call is made when sorting convert annotations. Unlike XML, where the user can sort through and elements, there is only a single Convert annotation that uses a "key" prefix on the attribute name to signify a map key convert. An unforunate decision by the JPA spec committee, but we can make it work of course.

process

public void process(DatabaseMapping mapping,
                    MetadataClass referenceClass,
                    ClassAccessor accessor,
                    boolean isForMapKey)

INTERNAL: By the time we get here, we have the mapping that needs to have the convert applied to. Do some validatation checks along with some embedded mapping traversing if need be and apply the converter. Will look an auto-apply converter as well if one is not explicitely specified.

setAttributeName

public void setAttributeName(String attributeName)

INTERNAL: Used for OX mapping.

setConverterClassName

public void setConverterClassName(String converterClassName)

INTERNAL: Used for OX mapping.

setDisableConversion

public void setDisableConversion(Boolean disableConversion)

INTERNAL: Used for OX mapping.

setText

public void setText(String text)

INTERNAL: Used for OX mapping.