|
JSR 177 | ||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface RemoteRef
The interface RemoteRef
represents the handle for
a remote object. Each stub contains an instance of
RemoteRef
. RemoteRef
contains the concrete
representation
of a reference. This remote reference is used to carry out remote
calls on the remote object for which it is a reference.
Method Summary | |
---|---|
java.lang.Object |
invoke(java.lang.String method,
java.lang.Object[] params)
Invokes a remote method. |
boolean |
remoteEquals(RemoteRef obj)
Compares two remote references. |
int |
remoteHashCode()
Returns a hashcode for a remote object. |
Method Detail |
---|
java.lang.Object invoke(java.lang.String method, java.lang.Object[] params) throws java.lang.Exception
A remote method invocation consists of three steps:
If the exception thrown on the card is an exception defined in
the Java Card 2.2 API, then the same exception is thrown to the
stub method. The client can access the reason code associated
with Java Card-specific exceptions using the standard
getReason()
method.
If the exception thrown on the card is a subclass of an exception defined in the Java Card 2.2 API, then the closest exception defined in the API (along with the reason code, if applicable) is thrown to the stub method. The detail message string of the exception object may indicate that exception subclass was thrown on the card.
Apart from the exceptions thrown by the remote method itself,
errors during communication, marshalling, protocol handling,
unmarshalling, stub object instantiation, and so on, related
to the JCRMI method invocation, results in a
RemoteException
being thrown to the stub method.
method
- simple (not fully qualified) name of the method
followed by the method descriptor. Representation of a
method descriptor is the same as that described in The
Java Virtual Machine Specification (section 4.3.3)params
- the parameter list
java.lang.Exception
- if any exception occurs during
the remote method invocationboolean remoteEquals(RemoteRef obj)
obj
- the Object to compare with
int remoteHashCode()
|
JSR 177 | ||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |