Interface SerializedObjectPolicy
-
- All Superinterfaces:
java.lang.Cloneable,java.io.Serializable
public interface SerializedObjectPolicy extends java.lang.Cloneable, java.io.SerializableSerializedObjectPolicy (SOP) could be set on a non-aggregate descriptor. If SerializedObjectPolicy is specified Eclipselink writes out the whole entity object with its privately owned (and nested privately owned) entities and element collections into an additional (likely BLOB) field in the database. If SerializedObjectPolicy is set on an entity then SerializedObjectPolicies with the same field are set on all inheriting entities. The goal is to make reads from the database faster. The draw back is slower writes into the database. So SerializedObjectPolicy may make sense for read-only / read-mostly application for Entity, which always loads all its dependent entities and / or ElementCollections. To use SerializedObjectPolicy, ObjectLevelReadQuery should set a boolean flag- See Also:
In case the serialized object column contains null or obsolete version of the object the query using SerializedObjectPolicy would either throw exception or - if all other fields have been read, too - would build the object using these fields (exactly as in case SerializedObjectPolicy is not used). Note that currently no default implementation of SerializedObjectPolicy is available and this class should be provided by the user.,SerializedObject- Author:
- ailitche
- Since:
- EclipseLink 2.5.1
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description SerializedObjectPolicyclone()java.util.List<org.eclipse.persistence.internal.helper.DatabaseField>getAllSelectionFields()Lists the database fields that should be read by the query using the policy, in case all inherited objects are read using outer joining.ClassDescriptorgetDescriptor()get owning descriptororg.eclipse.persistence.internal.helper.DatabaseFieldgetField()get the field that stores sopObject in the database (sopField)java.lang.ObjectgetObjectFromRow(org.eclipse.persistence.internal.sessions.AbstractRecord databaseRow, org.eclipse.persistence.internal.sessions.AbstractSession session, ObjectLevelReadQuery query)Deserialize the object from the value corresponding to the policy field, nullify that value, set the object into the row using setSopObject, also return it.java.util.List<org.eclipse.persistence.internal.helper.DatabaseField>getSelectionFields()Lists the database fields that should be read by the query using the policy.voidinitialize(org.eclipse.persistence.internal.sessions.AbstractSession session)initialize the policyvoidinitializeField(org.eclipse.persistence.internal.sessions.AbstractSession session)unless the field is already initialized by parent descriptor, add the field to the owning descriptor and set field's typeSerializedObjectPolicyinstantiateChild()instantiate policy for child descriptorvoidpostInitialize(org.eclipse.persistence.internal.sessions.AbstractSession session)postinitialize the policy: determine which mappings are included, which fields should be selectedvoidputObjectIntoRow(org.eclipse.persistence.internal.sessions.AbstractRecord databaseRow, java.lang.Object object, org.eclipse.persistence.internal.sessions.AbstractSession session)Serialize the object and put the result into the row as a value corresponding to the policy fieldvoidsetDescriptor(ClassDescriptor descriptor)set owning descriptorvoidsetField(org.eclipse.persistence.internal.helper.DatabaseField field)set the field that stores sopObject in the database (sopField)
-
-
-
Method Detail
-
getDescriptor
ClassDescriptor getDescriptor()
get owning descriptor
-
setDescriptor
void setDescriptor(ClassDescriptor descriptor)
set owning descriptor
-
getField
org.eclipse.persistence.internal.helper.DatabaseField getField()
get the field that stores sopObject in the database (sopField)
-
setField
void setField(org.eclipse.persistence.internal.helper.DatabaseField field)
set the field that stores sopObject in the database (sopField)
-
clone
SerializedObjectPolicy clone()
-
instantiateChild
SerializedObjectPolicy instantiateChild()
instantiate policy for child descriptor
-
initializeField
void initializeField(org.eclipse.persistence.internal.sessions.AbstractSession session)
unless the field is already initialized by parent descriptor, add the field to the owning descriptor and set field's type
-
initialize
void initialize(org.eclipse.persistence.internal.sessions.AbstractSession session)
initialize the policy
-
postInitialize
void postInitialize(org.eclipse.persistence.internal.sessions.AbstractSession session)
postinitialize the policy: determine which mappings are included, which fields should be selected
-
getSelectionFields
java.util.List<org.eclipse.persistence.internal.helper.DatabaseField> getSelectionFields()
Lists the database fields that should be read by the query using the policy. To allow recovery in case of null or invalid sopObject, then this method should return all the fields define by descriptor (descriptor.getFields()).
-
getAllSelectionFields
java.util.List<org.eclipse.persistence.internal.helper.DatabaseField> getAllSelectionFields()
Lists the database fields that should be read by the query using the policy, in case all inherited objects are read using outer joining. To allow recovery in case of null or invalid sopObject, then this method should return all the fields define by descriptor (descriptor.getAllFields()).
-
putObjectIntoRow
void putObjectIntoRow(org.eclipse.persistence.internal.sessions.AbstractRecord databaseRow, java.lang.Object object, org.eclipse.persistence.internal.sessions.AbstractSession session)Serialize the object and put the result into the row as a value corresponding to the policy field
-
getObjectFromRow
java.lang.Object getObjectFromRow(org.eclipse.persistence.internal.sessions.AbstractRecord databaseRow, org.eclipse.persistence.internal.sessions.AbstractSession session, ObjectLevelReadQuery query)Deserialize the object from the value corresponding to the policy field, nullify that value, set the object into the row using setSopObject, also return it. If the object is null or invalid, behaviour depend on whether the policy allows the query to recover or not (see comments to getFieldsToSelect and getAllFieldsToSelect methods): if recovery is possible then the method should return null, otherwise throw QueryException (query is a parameter of this method only because it's required by QueryException).
-
-