org.eclipse.persistence.mappings.ForeignReferenceMapping (or TransformationMapping) to
directly use domain objects, as opposed to ValueHolders.
| Access | Constructor and Description |
|---|---|
| public |
| Modifier and Type | Method and Description |
|---|---|
| public Object | buildIndirectObject(ValueHolderInterface<T> valueHolder)
Implements abstract org. |
| public Object | cloneAttribute(Object attributeValue, Object original, CacheKey cacheKey, Object clone, Integer refreshCascade, AbstractSession cloningSession, boolean
indicates that we are building the clone directly
from a row as opposed to building the original from the row, putting it in
the shared cache, and then cloning the original. buildDirectlyFromRow)Implements abstract org. |
| protected boolean | collectionTypeIsValid(Class<?> collectionType)
INTERNAL: Return whether the collection type is appropriate for the indirection policy. |
| public AbstractRecord | extractReferenceRow(Object referenceObject)
Implements abstract org. |
| public void | fixObjectReferences(Object object, Map<Object, ObjectDescriptor> objectDescriptors, Map<Object, Object> processedObjects, ObjectLevelReadQuery query, DistributedSession session)
Implements abstract org. |
| public Object | getOriginalIndirectionObject(Object unitOfWorkIndirectionObject, AbstractSession session)
Implements abstract org. |
| public Object | getOriginalValueHolder(Object unitOfWorkIndirectionObject, AbstractSession session)
Implements abstract org. |
| public Object | getRealAttributeValueFromObject(Object object, Object attribute)
Implements abstract org. |
| public Object | getValueFromRemoteValueHolder(RemoteValueHolder<?> remoteValueHolder)
Implements abstract org. |
| public void | mergeRemoteValueHolder(Object clientSideDomainObject, Object serverSideDomainObject, MergeManager mergeManager)
Implements abstract org. |
| public Object | nullValueFromRow()
Implements abstract org. |
| public boolean | objectIsEasilyInstantiated(Object object)
Implements abstract org. |
| public boolean | objectIsInstantiated(Object object)
Implements abstract org. |
| public void | setRealAttributeValueInObject(Object target, Object attributeValue, boolean trackChanges)
Overrides org. |
| protected boolean | typeIsValid(Class<?> attributeType)
INTERNAL: Return whether the type is appropriate for the indirection policy. |
| public boolean | usesIndirection()
Overrides org. |
| public void | validateDeclaredAttributeType(Class<?> attributeType, IntegrityChecker checker)
Overrides org. |
| public void | validateDeclaredAttributeTypeForCollection(Class<?> attributeType, IntegrityChecker checker)
INTERNAL:
Verify that attributeType is an appropriate collection type for the
indirection policy.
|
| public void | validateGetMethodReturnType(Class<?> returnType, IntegrityChecker checker)
Overrides org. |
| public void | validateGetMethodReturnTypeForCollection(Class<?> returnType, IntegrityChecker checker)
INTERNAL:
Verify that getter returnType is an appropriate collection type for the
indirection policy.
|
| public void | validateSetMethodParameterType(Class<?> parameterType, IntegrityChecker checker)
Overrides org. |
| public void | validateSetMethodParameterTypeForCollection(Class<?> parameterType, IntegrityChecker checker)
INTERNAL:
Verify that setter parameterType is an appropriate collection type for the
indirection policy.
|
| public Object | valueFromBatchQuery(ReadQuery batchQuery, AbstractRecord row, ObjectLevelReadQuery originalQuery, CacheKey parentCacheKey)
Implements abstract org. |
| public Object | valueFromMethod(Object object, AbstractRecord row, AbstractSession session)
Implements abstract org. |
| public Object | valueFromQuery(ReadQuery query, AbstractRecord row, Object sourceObject, AbstractSession session)
Implements abstract org. |
| public Object | valueFromQuery(ReadQuery query, AbstractRecord row, AbstractSession session)
Implements abstract org. |
| public Object | valueFromRow(Object object)
Implements abstract org. |
| NoIndirectionPolicy | back to summary |
|---|---|
| public NoIndirectionPolicy() INTERNAL: Construct a new indirection policy. | |
| buildIndirectObject | back to summary |
|---|---|
| public Object buildIndirectObject(ValueHolderInterface<T> valueHolder) Implements abstract org. INTERNAL: This method can be used when an Indirection Object is required to be built from a provided ValueHolderInterface object. This may be used for custom value holder types. Certain policies like the TransparentIndirectionPolicy may wrap the valueholder in another object.
| |
| cloneAttribute | back to summary |
|---|---|
| public Object cloneAttribute(Object attributeValue, Object original, CacheKey cacheKey, Object clone, Integer refreshCascade, AbstractSession cloningSession, boolean buildDirectlyFromRow) Implements abstract org. INTERNAL: Return a clone of the attribute.
| |
| collectionTypeIsValid | back to summary |
|---|---|
| protected boolean collectionTypeIsValid(Class<?> collectionType) INTERNAL: Return whether the collection type is appropriate for the indirection policy. In this case, the type MUST be a Vector (or, in the case of jdk1.2, Collection or Map). | |
| extractReferenceRow | back to summary |
|---|---|
| public AbstractRecord extractReferenceRow(Object referenceObject) Implements abstract org. INTERNAL: Return the reference row for the reference object. This allows the new row to be built without instantiating the reference object. Return null if the object has already been instantiated.
| |
| fixObjectReferences | back to summary |
|---|---|
| public void fixObjectReferences(Object object, Map<Object, ObjectDescriptor> objectDescriptors, Map<Object, Object> processedObjects, ObjectLevelReadQuery query, DistributedSession session) Implements abstract org. INTERNAL: An object has been serialized from the server to the client. Replace the transient attributes of the remote value holders with client-side objects.
| |
| getOriginalIndirectionObject | back to summary |
|---|---|
| public Object getOriginalIndirectionObject(Object unitOfWorkIndirectionObject, AbstractSession session) Implements abstract org. INTERNAL: Return the original indirection object for a unit of work indirection object.
| |
| getOriginalValueHolder | back to summary |
|---|---|
| public Object getOriginalValueHolder(Object unitOfWorkIndirectionObject, AbstractSession session) Implements abstract org. INTERNAL: Return the original valueHolder object. Access to the underlying valueholder may be required when serializing the valueholder or converting the valueHolder to another type.
| |
| getRealAttributeValueFromObject | back to summary |
|---|---|
| public Object getRealAttributeValueFromObject(Object object, Object attribute) Implements abstract org. INTERNAL: Return the "real" attribute value, as opposed to any wrapper. This will trigger the wrapper to instantiate the value.
| |
| getValueFromRemoteValueHolder | back to summary |
|---|---|
| public Object getValueFromRemoteValueHolder(RemoteValueHolder<?> remoteValueHolder) Implements abstract org. INTERNAL: Extract and return the appropriate value from the specified remote value holder.
| |
| mergeRemoteValueHolder | back to summary |
|---|---|
| public void mergeRemoteValueHolder(Object clientSideDomainObject, Object serverSideDomainObject, MergeManager mergeManager) Implements abstract org. INTERNAL Replace the client value holder with the server value holder, after copying some of the settings from the client value holder.
| |
| nullValueFromRow | back to summary |
|---|---|
| public Object nullValueFromRow() Implements abstract org. INTERNAL: Return the null value of the appropriate attribute. That is, the field from the database is NULL, return what should be placed in the object's attribute as a result.
| |
| objectIsEasilyInstantiated | back to summary |
|---|---|
| public boolean objectIsEasilyInstantiated(Object object) Implements abstract org. INTERNAL: Return whether the specified object can be instantiated without database access.
| |
| objectIsInstantiated | back to summary |
|---|---|
| public boolean objectIsInstantiated(Object object) Implements abstract org. INTERNAL: Return whether the specified object is instantiated.
| |
| setRealAttributeValueInObject | back to summary |
|---|---|
| public void setRealAttributeValueInObject(Object target, Object attributeValue, boolean trackChanges) Overrides org. Set the value of the appropriate attribute of target to attributeValue. In this case, place the value inside the target's ValueHolder. if trackChanges is true, set the value in the object as if the user was setting it. Allow change tracking to pick up the change.
| |
| typeIsValid | back to summary |
|---|---|
| protected boolean typeIsValid(Class<?> attributeType) INTERNAL: Return whether the type is appropriate for the indirection policy. In this case, the attribute type CANNOT be ValueHolderInterface. | |
| usesIndirection | back to summary |
|---|---|
| public boolean usesIndirection() Overrides org. INTERNAL: Return whether the indirection policy actually uses indirection. Here, we must reply false.
| |
| validateDeclaredAttributeType | back to summary |
|---|---|
| public void validateDeclaredAttributeType(Class<?> attributeType, IntegrityChecker checker) throws DescriptorException Overrides org. INTERNAL: Verify that attributeType is correct for the indirection policy. If it is incorrect, add an exception to the integrity checker. In this case, the attribute type CANNOT be ValueHolderInterface.
| |
| validateDeclaredAttributeTypeForCollection | back to summary |
|---|---|
| public void validateDeclaredAttributeTypeForCollection(Class<?> attributeType, IntegrityChecker checker) throws DescriptorException INTERNAL: Verify that attributeType is an appropriate collection type for the indirection policy. If it is incorrect, add an exception to the integrity checker. In this case, the type MUST be a Vector (or, in the case of jdk1.2, Collection or Map).
| |
| validateGetMethodReturnType | back to summary |
|---|---|
| public void validateGetMethodReturnType(Class<?> returnType, IntegrityChecker checker) throws DescriptorException Overrides org. INTERNAL: Verify that getter returnType is correct for the indirection policy. If it is incorrect, add an exception to the integrity checker. In this case, the return type CANNOT be ValueHolderInterface.
| |
| validateGetMethodReturnTypeForCollection | back to summary |
|---|---|
| public void validateGetMethodReturnTypeForCollection(Class<?> returnType, IntegrityChecker checker) throws DescriptorException INTERNAL: Verify that getter returnType is an appropriate collection type for the indirection policy. If it is incorrect, add an exception to the integrity checker. In this case, the type MUST be a Vector (or, in the case of jdk1.2, Collection or Map).
| |
| validateSetMethodParameterType | back to summary |
|---|---|
| public void validateSetMethodParameterType(Class<?> parameterType, IntegrityChecker checker) throws DescriptorException Overrides org. INTERNAL: Verify that setter parameterType is correct for the indirection policy. If it is incorrect, add an exception to the integrity checker. In this case, the parameter type CANNOT be ValueHolderInterface.
| |
| validateSetMethodParameterTypeForCollection | back to summary |
|---|---|
| public void validateSetMethodParameterTypeForCollection(Class<?> parameterType, IntegrityChecker checker) throws DescriptorException INTERNAL: Verify that setter parameterType is an appropriate collection type for the indirection policy. If it is incorrect, add an exception to the integrity checker. In this case, the type MUST be a Vector (or, in the case of jdk1.2, Collection or Map).
| |
| valueFromBatchQuery | back to summary |
|---|---|
| public Object valueFromBatchQuery(ReadQuery batchQuery, AbstractRecord row, ObjectLevelReadQuery originalQuery, CacheKey parentCacheKey) Implements abstract org. INTERNAL: Return the value to be stored in the object's attribute. This value is determined by the batchQuery. In this case, extract the result from the query.
| |
| valueFromMethod | back to summary |
|---|---|
| public Object valueFromMethod(Object object, AbstractRecord row, AbstractSession session) Implements abstract org. INTERNAL: Return the value to be stored in the object's attribute. This value is determined by invoking the mapping's AttributeTransformer
| |
| valueFromQuery | back to summary |
|---|---|
| public Object valueFromQuery(ReadQuery query, AbstractRecord row, Object sourceObject, AbstractSession session) Implements abstract org. INTERNAL: Return the value to be stored in the object's attribute. This value is determined by the query. In this case, wrap the query in a ValueHolder for later invocation.
| |
| valueFromQuery | back to summary |
|---|---|
| public Object valueFromQuery(ReadQuery query, AbstractRecord row, AbstractSession session) Implements abstract org. INTERNAL: Return the value to be stored in the object's attribute. This value is determined by the query. In this case, simply execute the query and return its results.
| |
| valueFromRow | back to summary |
|---|---|
| public Object valueFromRow(Object object) Implements abstract org. INTERNAL: Return the value to be stored in the object's attribute. This value is determined by the row. In this case, simply return the object.
| |