ClassInstanceConverter (EclipseLink 2.6.8, API Reference)

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 and Description

protected DatabaseMapping mapping

Fields
Modifier and Type	Field and Description
`protected DatabaseMapping`	`mapping`

Constructor Summary

Constructors
Constructor and Description

ClassInstanceConverter()
PUBLIC: Default constructor.

Constructors
Constructor and Description
`ClassInstanceConverter()` PUBLIC: Default constructor.

Method Summary

Methods
Modifier and Type	Method and 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 CoreConverter<DatabaseMapping,Session>
    
    Specified by:
    
    convertDataValueToObjectValue in interface Converter
  - convertObjectValueToDataValue
```
public java.lang.Object convertObjectValueToDataValue(java.lang.Object attributeValue,
                                             Session session)
```
    INTERNAL: Convert to the field class.
    
    Specified by:
    
    convertObjectValueToDataValue in interface CoreConverter<DatabaseMapping,Session>
    
    Specified by:
    
    convertObjectValueToDataValue in interface Converter
  - initialize
```
public void initialize(DatabaseMapping mapping,
              Session session)
```
    INTERNAL: Set the mapping.
    
    Specified by:
    
    initialize in interface CoreConverter<DatabaseMapping,Session>
    
    Specified by:
    
    initialize in interface Converter
  - 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

Class ClassInstanceConverter

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

mapping

Constructor Detail

ClassInstanceConverter

Method Detail

convertDataValueToObjectValue

convertObjectValueToDataValue

initialize

getMapping

isMutable