|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
Base interface for indirection handlers used by OJB's proxies. Note that this interface needs JDK 1.3 or above.
Implemening classes are required to have a public constructor with the signature
(PBKey
, Identity
).
Implementing classes should use this interface to acquire a logger.
Method Summary | |
void |
addListener(MaterializationListener l)
Adds a materialization listener. |
boolean |
alreadyMaterialized()
Determines whether the real subject already has been materialized. |
PBKey |
getBrokerKey()
Returns the key of the persistence broker used by this indirection handler. |
Identity |
getIdentity()
Returns the identity of the subject. |
java.lang.Object |
getRealSubject()
Returns the proxies real subject. |
java.lang.Object |
invoke(java.lang.Object proxy,
java.lang.reflect.Method method,
java.lang.Object[] args)
[Copied from InvocationHandler ]:Processes a method invocation on a proxy instance and returns the result. |
void |
removeListener(MaterializationListener l)
Removes a materialization listener. |
void |
setRealSubject(java.lang.Object object)
Sets the real subject of this proxy. |
Method Detail |
public PBKey getBrokerKey()
public Identity getIdentity()
public java.lang.Object invoke(java.lang.Object proxy, java.lang.reflect.Method method, java.lang.Object[] args)
InvocationHandler
]:
proxy
- The proxy instance that the method was invoked onmethod
- The Method
instance corresponding to
the interface method invoked on the proxy instance. The declaring
class of the Method
object will be the interface that
the method was declared in, which may be a superinterface of the
proxy interface that the proxy class inherits the method through.args
- An array of objects containing the values of the
arguments passed in the method invocation on the proxy instance,
or null
if interface method takes no arguments.
Arguments of primitive types are wrapped in instances of the
appropriate primitive wrapper class, such as
java.lang.Integer
or java.lang.Boolean
.
null
and the interface method's return type is
primitive, then a NullPointerException
will be
thrown by the method invocation on the proxy instance. If the
value returned by this method is otherwise not compatible with
the interface method's declared return type as described above,
a ClassCastException
will be thrown by the method
invocation on the proxy instance.
PersistenceBrokerException
- The exception to throw from the method
invocation on the proxy instance. The exception's type must be
assignable either to any of the exception types declared in the
throws
clause of the interface method or to the
unchecked exception types java.lang.RuntimeException
or java.lang.Error
. If a checked exception is
thrown by this method that is not assignable to any of the
exception types declared in the throws
clause of
the interface method, then an
UndeclaredThrowableException
containing the
exception that was thrown by this method will be thrown by the
method invocation on the proxy instance.UndeclaredThrowableException
public java.lang.Object getRealSubject() throws PersistenceBrokerException
PersistenceBrokerException
public void setRealSubject(java.lang.Object object)
public boolean alreadyMaterialized()
true
if the real subject has already been loadedpublic void addListener(MaterializationListener l)
l
- The listener to addpublic void removeListener(MaterializationListener l)
l
- The listener to remove
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |