public interface RemoteRef
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.Modifier and Type | Method and Description |
---|---|
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.
|
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 listjava.lang.Exception
- if any exception occurs during
the remote method invocationboolean remoteEquals(RemoteRef obj)
obj
- the Object to compare withint remoteHashCode()
Copyright © 2013, Oracle and/or its affiliates. All rights reserved.
Use is subject to License Terms. Your use of this web site or any of its contents or software indicates your agreement to be bound by these License Terms.