org.apache.openjpa.jdbc.meta.strats
Class UntypedPCValueHandler

java.lang.Object
  extended by org.apache.openjpa.jdbc.meta.strats.AbstractValueHandler
      extended by org.apache.openjpa.jdbc.meta.strats.UntypedPCValueHandler
All Implemented Interfaces:
Serializable, RelationId, ValueHandler

public class UntypedPCValueHandler
extends AbstractValueHandler
implements RelationId

Handler for unknown persistence-capable object fields that stores stringified oids.

See Also:
Serialized Form

Constructor Summary
UntypedPCValueHandler()
           
 
Method Summary
static UntypedPCValueHandler getInstance()
          Singleton instance.
 boolean isVersionable(ValueMapping vm)
          Return whether the values managed by this handler can be used in state image versioning.
 Column[] map(ValueMapping vm, String name, ColumnIO io, boolean adapt)
          Map the given value and return all mapped columns, or simply return an array of unmapped default columns.
 boolean objectValueRequiresLoad(ValueMapping vm)
          Return whether this handler potentially must load extra data to extract the object value from its datastore representation.
 Object toDataStoreValue(ValueMapping vm, Object val, JDBCStore store)
          Translate the given value to its datastore equivalent.
 Object toObjectValue(ValueMapping vm, Object val, OpenJPAStateManager sm, JDBCStore store, JDBCFetchConfiguration fetch)
          Translate the given datastore value into its Java equivalent.
 Object toRelationDataStoreValue(OpenJPAStateManager sm, Column col)
          Return the serialized value for the given related object, now that its id has been assigned.
 
Methods inherited from class org.apache.openjpa.jdbc.meta.strats.AbstractValueHandler
getResultArgument, toObjectValue
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

UntypedPCValueHandler

public UntypedPCValueHandler()
Method Detail

getInstance

public static UntypedPCValueHandler getInstance()
Singleton instance.


map

public Column[] map(ValueMapping vm,
                    String name,
                    ColumnIO io,
                    boolean adapt)
Description copied from interface: ValueHandler
Map the given value and return all mapped columns, or simply return an array of unmapped default columns. The columns should have at least their Name and JavaType properties set.

Specified by:
map in interface ValueHandler
name - use as a base to form column name(s); the column names of unmapped columns will automatically be made to fit database limitations
io - I/O information about mapped columns; you do not have to set this information if returning templates
adapt - whether to adapt the mapping or schema

isVersionable

public boolean isVersionable(ValueMapping vm)
Description copied from interface: ValueHandler
Return whether the values managed by this handler can be used in state image versioning.

Specified by:
isVersionable in interface ValueHandler
Overrides:
isVersionable in class AbstractValueHandler

objectValueRequiresLoad

public boolean objectValueRequiresLoad(ValueMapping vm)
Description copied from interface: ValueHandler
Return whether this handler potentially must load extra data to extract the object value from its datastore representation.

Specified by:
objectValueRequiresLoad in interface ValueHandler
Overrides:
objectValueRequiresLoad in class AbstractValueHandler

toDataStoreValue

public Object toDataStoreValue(ValueMapping vm,
                               Object val,
                               JDBCStore store)
Description copied from interface: ValueHandler
Translate the given value to its datastore equivalent. If this value occupies multiple columns, return an object array with one element per column. For relation id columns, return the state manager the column depends on.

Specified by:
toDataStoreValue in interface ValueHandler
Overrides:
toDataStoreValue in class AbstractValueHandler

toObjectValue

public Object toObjectValue(ValueMapping vm,
                            Object val,
                            OpenJPAStateManager sm,
                            JDBCStore store,
                            JDBCFetchConfiguration fetch)
                     throws SQLException
Description copied from interface: ValueHandler
Translate the given datastore value into its Java equivalent. If the value occupies multiple columns, the given object will be an object array with one entry per column. This method is only called if ValueHandler.objectValueRequiresLoad(org.apache.openjpa.jdbc.meta.ValueMapping) returns true.

Specified by:
toObjectValue in interface ValueHandler
Overrides:
toObjectValue in class AbstractValueHandler
sm - the state manager that owns the value; may be null if loading a projection
Throws:
SQLException

toRelationDataStoreValue

public Object toRelationDataStoreValue(OpenJPAStateManager sm,
                                       Column col)
Description copied from interface: RelationId
Return the serialized value for the given related object, now that its id has been assigned.

Specified by:
toRelationDataStoreValue in interface RelationId


Copyright © 2006-2008 Apache Software Foundation. All Rights Reserved.