oracle.toplink.mappings
Class ObjectReferenceMapping

java.lang.Object
  |
  +--oracle.toplink.mappings.DatabaseMapping
        |
        +--oracle.toplink.mappings.ForeignReferenceMapping
              |
              +--oracle.toplink.mappings.ObjectReferenceMapping

All Implemented Interfaces:

java.lang.Cloneable, java.io.Serializable

Direct Known Subclasses:

OneToOneMapping, ReferenceMapping, VariableOneToOneMapping

public abstract class ObjectReferenceMapping

extends ForeignReferenceMapping

Purpose: Abstract class for 1:1, varibale 1:1 and reference mappings

See Also:

Serialized Form

Method Summary

Type	Method
void	useProxyIndirection() PUBLIC: Set this mapping to use Proxy Indirection.
void	useProxyIndirection(java.lang.Class targetInterface) PUBLIC: Set this mapping to use Proxy Indirection.
void	useProxyIndirection(java.lang.Class[] targetInterfaces) PUBLIC: Set this mapping to use Proxy Indirection.

Methods inherited from class oracle.toplink.mappings.ForeignReferenceMapping

dontUseBatchReading, dontUseIndirection, getReferenceClass, getRelationshipPartnerAttributeName, privateOwnedRelationship, setCustomSelectionQuery, setIndirectionPolicy, setReferenceClass, setRelationshipPartnerAttributeName, setSelectionCriteria, setSelectionSQLString, setUsesBatchReading, setUsesIndirection, shouldUseBatchReading, useBasicIndirection, useBatchReading, useContainerIndirection, useIndirection, usesIndirection

Methods inherited from class oracle.toplink.mappings.DatabaseMapping

getAttributeClassification, getAttributeName, getGetMethodName, getSetMethodName, readOnly, readWrite, setAttributeName, setGetMethodName, setIsReadOnly, setSetMethodName, setWeight

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Method Detail

useProxyIndirection

public void useProxyIndirection()

PUBLIC: Set this mapping to use Proxy Indirection. Proxy Indirection uses the Proxy and InvocationHandler features of JDK 1.3 to provide "transparent indirection" for 1:1 relationships. In order to use Proxy Indirection:

• The target class must implement at least one public interface
• The attribute on the source class must be typed as that public interface
• get() and set() methods for the atttribute must use the interface

With this policy, proxy objects are returned during object creation. When a message other than toString is called on the proxy the real object data is retrieved from the database. By default, use the target class' full list of interfaces for the proxy.

useProxyIndirection

public void useProxyIndirection(java.lang.Class[] targetInterfaces)

PUBLIC: Set this mapping to use Proxy Indirection. Proxy Indirection uses the Proxy and InvocationHandler features of JDK 1.3 to provide "transparent indirection" for 1:1 relationships. In order to use Proxy Indirection:

• The target class must implement at least one public interface
• The attribute on the source class must be typed as that public interface
• get() and set() methods for the atttribute must use the interface

With this policy, proxy objects are returned during object creation. When a message other than toString is called on the proxy the real object data is retrieved from the database.

Parameters:

proxyInterfaces - The interfaces that the target class implements. The attribute must be typed as one of these interfaces.

useProxyIndirection

public void useProxyIndirection(java.lang.Class targetInterface)

PUBLIC: Set this mapping to use Proxy Indirection. Proxy Indirection uses the Proxy and InvocationHandler features of JDK 1.3 to provide "transparent indirection" for 1:1 relationships. In order to use Proxy Indirection:

• The target class must implement at least one public interface
• The attribute on the source class must be typed as that public interface
• get() and set() methods for the atttribute must use the interface

With this policy, proxy objects are returned during object creation. When a message other than toString is called on the proxy the real object data is retrieved from the database.

Parameters:

proxyInterface - The interface that the target class implements. The attribute must be typed as this interface.