Configuring a Type Conversion Converter

A type conversion converter is used to explicitly map a data source type to a Java type.

For more information about the type conversion converter, see "Type Conversion Converter".

Table 32-11 summarizes which mappings support this option.

Table 32-11 Mapping Support for Type Conversion Converter

Mapping	Using TopLink Workbench	Using Java
Relational Mappings
Direct-to-Field Mapping
Object-Relational Mappings
Object-Relational Array Mapping
EIS Mappings
EIS Direct Mapping
EIS Composite Direct Collection Mapping
XML Mappings
XML Direct Mapping
XML Composite Direct Collection Mapping

Using TopLink Workbench

To create an type conversion direct mapping, use this procedure:

Select the mapped attribute in the Navigator. Its properties appear in the Editor.
Click the Converter tab. The Converter tab appears.
Select the Type Conversion Converter option.

Figure 32-11 Converter Tab, Type Conversion Converter Option

Description of "Figure 32-11 Converter Tab, Type Conversion Converter Option"

Use the following information to complete the Type Conversion Converter fields on the Converter tab:

Field	Description
Data Type	Select the Java type of the data in the data source.
Attribute Type	Select the Java type of the attribute in the Java class.

Using Java

You can set an oracle.toplink.converters.TypeConversionConverter on any instance of oracle.toplink.mappings.foundation.AbstractCompositeDirectCollectionMapping using AbstractCompositeDirectCollectionMapping method setValueConverter as Example 32-12 shows.

Example 32-12 Configuring a TypeConversionConverter in Java

// Create TypeConversionConverter instance
TypeConversionConverter typeConversionConverter = new TypeConversionConverter();
typeConversionConverter.setDataClass();
typeConversionConverter.setObjectClass();

// Set TypeConversionConverter on ArrayMapping
ArrayMapping arrayMapping = new ArrayMapping();
arrayMapping.setValueConverter(typeConversionConverter);
arrayMapping.setAttributeName("responsibilities");
arrayMapping.setStructureName("Responsibilities_t");
arrayMapping.setFieldName("RESPONSIBILITIES");
orDescriptor.addMapping(arrayMapping);

Configure the TypeConversionConverter instance using the following API:

setDataClass(java.lang.Class dataClass)–to specify the data type class
setObjectClass(java.lang.Class objectClass)–to specify the object type class