org.apache.cayenne

Class HybridDataObject

java.lang.Object

org.apache.cayenne.PersistentObject

org.apache.cayenne.BaseDataObject

org.apache.cayenne.HybridDataObject

All Implemented Interfaces:

Serializable, DataObject, Persistent, Validating

public class HybridDataObject
extends BaseDataObject

This data object like CayenneDataObject uses Map to store generic attributes, only difference is that this Map will be created lazily at first write, thus reducing memory penalty if possible.

This class can be used as superclass for objects that have attributes created at runtime. If generic runtime attributes will be used always it may be a good idea to use CayenneDataObject instead. If you don't create attributes at runtime it is better to use BaseDataObject class.

Map creation is not thread safe, as DataObject in general not thread safe by it's own.

Since:

4.1

See Also:

BaseDataObject, CayenneDataObject, Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
protected Map<String,Object>	values

Fields inherited from class org.apache.cayenne.BaseDataObject

snapshotVersion

Fields inherited from class org.apache.cayenne.PersistentObject

objectContext, objectId, persistenceState

Fields inherited from interface org.apache.cayenne.DataObject

DEFAULT_VERSION

Constructor Summary

Constructors

Constructor and Description
HybridDataObject()

Method Summary

Modifier and Type	Method and Description
protected void	appendProperties(StringBuffer buffer)
Object	readPropertyDirectly(String propName) Returns mapped property value as curently stored in the DataObject.
protected void	readState(ObjectInputStream in)
void	writePropertyDirectly(String propName, Object val) Modifies a value of a named property without altering the object state in any way, and without triggering any database operations.
protected void	writeState(ObjectOutputStream out)

Methods inherited from class org.apache.cayenne.BaseDataObject

addToManyTarget, beforePropertyRead, beforePropertyWrite, getSnapshotVersion, readNestedProperty, readProperty, readSerialized, removeToManyTarget, setObjectContext, setPersistenceState, setReverseRelationship, setSnapshotVersion, setToManyTarget, setToOneTarget, toString, toStringBuffer, unsetReverseRelationship, validateForDelete, validateForInsert, validateForSave, validateForUpdate, willConnect, writeProperty, writeSerialized

Methods inherited from class org.apache.cayenne.PersistentObject

getMapKey, getObjectContext, getObjectId, getPersistenceState, setObjectId

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.apache.cayenne.Persistent

getObjectContext, getObjectId, getPersistenceState, setObjectId

Field Detail

values

protected Map<String,Object> values

Constructor Detail

HybridDataObject

public HybridDataObject()

Method Detail

readPropertyDirectly

public Object readPropertyDirectly(String propName)

Description copied from interface: DataObject

Returns mapped property value as curently stored in the DataObject. Returned value maybe a fault or a real value. This method will not attempt to resolve faults, or to read unmapped properties.

Specified by:

readPropertyDirectly in interface DataObject

Overrides:

readPropertyDirectly in class BaseDataObject

writePropertyDirectly

public void writePropertyDirectly(String propName,
                                  Object val)

Description copied from interface: DataObject

Modifies a value of a named property without altering the object state in any way, and without triggering any database operations. This method is intended mostly for internal use by Cayenne framework, and shouldn't be called from the application code.

Specified by:

writePropertyDirectly in interface DataObject

Overrides:

writePropertyDirectly in class BaseDataObject

appendProperties

protected void appendProperties(StringBuffer buffer)

Overrides:

appendProperties in class BaseDataObject

readState

protected void readState(ObjectInputStream in)
                  throws IOException,
                         ClassNotFoundException

Overrides:

readState in class BaseDataObject

Throws:

IOException

ClassNotFoundException

writeState

protected void writeState(ObjectOutputStream out)
                   throws IOException

Overrides:

writeState in class BaseDataObject

Throws:

IOException