Package org.eclipse.persistence.mappings.converters

Class ClassInstanceConverter

java.lang.Object

org.eclipse.persistence.mappings.converters.ClassInstanceConverter

All Implemented Interfaces:

java.io.Serializable, CoreConverter<DatabaseMapping,Session>, Converter

public class ClassInstanceConverter
extends java.lang.Object
implements Converter

Purpose: Allows a class name to be converted to and from a new instance of the class. When using a ClassInstanceConverter, the database will store the Class name and the java object model will contain an instance of that class initialized with its default constructor

See Also:

Serialized Form

Author:

James Sutherland

Since:

OracleAS TopLink 10g (10.0.3)

Field Summary

Fields

Modifier and Type	Field	Description
protected DatabaseMapping	mapping

Constructor Summary

Constructors

Constructor	Description
ClassInstanceConverter()	PUBLIC: Default constructor.

Method Summary

Modifier and Type	Method	Description
java.lang.Object	convertDataValueToObjectValue(java.lang.Object fieldValue, Session session)	INTERNAL: Convert the class name to a class, then create an instance of the class.
java.lang.Object	convertObjectValueToDataValue(java.lang.Object attributeValue, Session session)	INTERNAL: Convert to the field class.
protected DatabaseMapping	getMapping()	INTERNAL: Return the mapping.
void	initialize(DatabaseMapping mapping, Session session)	INTERNAL: Set the mapping.
boolean	isMutable()	INTERNAL: If the converter converts the value to a non-atomic value, i.e.

Methods inherited from class java.lang.Object

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

Field Detail

mapping

protected DatabaseMapping mapping

Constructor Detail

ClassInstanceConverter

public ClassInstanceConverter()

PUBLIC: Default constructor.

Method Detail

convertDataValueToObjectValue

public java.lang.Object convertDataValueToObjectValue(java.lang.Object fieldValue,
                                                      Session session)

INTERNAL: Convert the class name to a class, then create an instance of the class.

Specified by:

convertDataValueToObjectValue in interface Converter

Specified by:

convertDataValueToObjectValue in interface CoreConverter<DatabaseMapping,Session>

convertObjectValueToDataValue

public java.lang.Object convertObjectValueToDataValue(java.lang.Object attributeValue,
                                                      Session session)

INTERNAL: Convert to the field class.

Specified by:

convertObjectValueToDataValue in interface Converter

Specified by:

convertObjectValueToDataValue in interface CoreConverter<DatabaseMapping,Session>

initialize

public void initialize(DatabaseMapping mapping,
                       Session session)

INTERNAL: Set the mapping.

Specified by:

initialize in interface Converter

Specified by:

initialize in interface CoreConverter<DatabaseMapping,Session>

getMapping

protected DatabaseMapping getMapping()

INTERNAL: Return the mapping.

isMutable

public boolean isMutable()

INTERNAL: If the converter converts the value to a non-atomic value, i.e. a value that can have its' parts changed without being replaced, then it must return false, serialization can be non-atomic.

Specified by:

isMutable in interface Converter