|
| |
|
| java.lang.Object
 com.sun.io.j2me.jcrmi.Protocol
| Method Summary | |
| public short | changePin(int pinID)
A call to changePin method pops up a UI that requests
the user for an old or existing PIN value and the new PIN value to
to change the value of the PIN. | | public void | close()
Closes the connection. | | public short | disablePin(int pinID)
A call to disablePin method pops up a UI that requests
the user to enter the value for the PIN that is to be disabled.
The pinID field
indicates which PIN is to be disabled. | | public short | enablePin(int pinID)
A call to enablePin method pops up a UI that requests
the user to enter the value for the PIN that is to be enabled.
The pinID field
indicates which PIN is to be enabled. | | public short | enterPin(int pinID)
A call to enterPin method pops up a UI that requests the PIN
from the user. | | int | getCardSessionId()
Returns the card session identifier for this connection. | | public java.rmi.Remote | getInitialReference()
Returns the stub object for an initial remote reference. | | Object | invoke(Reference ref, String method, Object[] params)
Invokes a remote method.
The remote method invoked on the card can throw an exception to
signal that an unexpected condition has been detected.
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. | | boolean | isOpened()
Returns the flag that indicates if connection is open. | | public DataInputStream | openDataInputStream()
Open and return a data input stream for a connection. | | public DataOutputStream | openDataOutputStream()
Open and return a data output stream for a connection. | | public InputStream | openInputStream()
Open and return an input stream for a connection. | | public OutputStream | openOutputStream()
Open and return an output stream for a connection. | | public Connection | openPrim(String name, int mode, boolean timeouts)
Connector uses this method to initialize the connection object.
This method establishes APDU connection with card application,
obtains FCI information and creates stub for initial remote
reference.
Parameters:
name - the URL for the connection without protocol name
Parameters:
mode - the access mode (Ignored)
Parameters:
timeouts - a flag to indicate that the caller wants timeoutexceptions. | | public short | unblockPin(int blockedPinID, int unblockingPinId)
This is a high-level method that lets the J2ME application
ask the user to enter the value for an unblocking PIN,
and the new value for the blocked PIN and send
these to the card.
A call to unblockPin method pops up a UI that requests
the user to enter the value for the unblocking PIN and the
new value for the blocked PIN.
The unblockingPinID field indicates which unblocking
PIN is to be
used to unblock the blocked PIN which is indicated by the field
blockedPinId.
The unblockingPinID field indicates which PIN is to be unblocked.
The user can either cancel the request
or continue. |
| changePin | | public short changePin(int pinID) throws RemoteException(Code) | | A call to changePin method pops up a UI that requests
the user for an old or existing PIN value and the new PIN value to
to change the value of the PIN. The pinID field indicates which PIN is
to be changed. The user can either cancel the request
or continue. If the user enters the PIN values and chooses to continue
the implementation is responsible for presenting the
the old and new values of the PIN to the card.
Parameters:
pinID - the type of PIN the implementation is suppose to promptthe user to change. PINENTRY_CANCELLED if the user cancelled the PIN entryrequest or the value returned by the remote method.
exception:
java.rmi.RemoteException - is thrown if the PIN couldnot be communicated to the card or an exception is thrownby the card in response to the PIN entry.
exception:
SecurityException - is thrown if the J2ME application doesnot have appropriate rights to ask for changing the PIN value. |
| disablePin | | public short disablePin(int pinID) throws RemoteException(Code) | | A call to disablePin method pops up a UI that requests
the user to enter the value for the PIN that is to be disabled.
The pinID field
indicates which PIN is to be disabled. The user can
either cancel the request
or continue. If the user enters the PIN and chooses to continue the
implementation is responsible
for presenting the PIN value to the card to disable PIN.
Parameters:
pinID - the type of PIN the implementation is required to promptthe user to enter. PINENTRY_CANCELLED if the user cancelled the PIN entryrequest or the value returned by the remote method.
exception:
java.rmi.RemoteException - is thrown if the PIN couldnot be communicated to the card or an exception is thrownby the card in response to the PIN entry.
exception:
SecurityException - is thrown if the J2ME application doesnot have appropriate rights to ask for disabling the PIN. |
| enablePin | | public short enablePin(int pinID) throws RemoteException(Code) | | A call to enablePin method pops up a UI that requests
the user to enter the value for the PIN that is to be enabled.
The pinID field
indicates which PIN is to be enabled. The user can
either cancel the request
or continue. If the user enters the PIN and chooses to continue the
implementation is responsible
for presenting the PIN value to the card for enabling the PIN.
Parameters:
pinID - the type of PIN the implementation is required to promptthe user to enter. PINENTRY_CANCELLED if the user cancelled the PIN entryrequest or the value returned by the remote method.
exception:
java.rmi.RemoteException - is thrown if the PIN couldnot be communicated to the card or an exception is thrownby the card in response to the PIN entry.
exception:
SecurityException - is thrown if the J2ME application doesnot have appropriate rights to ask for enabling the PIN. |
| enterPin | | public short enterPin(int pinID) throws java.rmi.RemoteException(Code) | | A call to enterPin method pops up a UI that requests the PIN
from the user. The pinID field indicates which PIN must be
requested from the user. The user can either cancel the request
or continue. If the user enters the PIN and chooses to continue,
The implementation is responsible for
presenting the PIN entered by the user to the card for verification.
Parameters:
pinID - the type of PIN the implementation is suppose to promptthe user to enter. PINENTRY_CANCELLED if the user cancelled the PIN entryrequest or the value returned by the remote method.
exception:
java.rmi.RemoteException - is thrown if the PIN couldnot be communicated to the card or an exception is thrownby the card in response to the PIN entry.
exception:
SecurityException - is thrown if the J2ME application doesnot have appropriate rights to ask for PIN verification. |
| getCardSessionId | | int getCardSessionId()(Code) | | Returns the card session identifier for this connection.
the card session identifier |
| getInitialReference | | public java.rmi.Remote getInitialReference()(Code) | | Returns the stub object for an initial remote reference.
the initial remote reference |
| invoke | | Object invoke(Reference ref, String method, Object[] params) throws Exception(Code) | | Invokes a remote method.
The remote method invoked on the card can throw an exception to
signal that an unexpected condition has been detected.
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.
Parameters:
ref - handle for remote object
Parameters:
method - simple (not fully qualified) name of the methodfollowed by the method descriptor. Representation of amethod descriptor is the same as that described in TheJava Virtual Machine Specification (§ 4.3.3)
Parameters:
params - the parameter list result of remote method invocation
exception:
java.lang.Exception - if any exception occurs duringthe remote method invocation |
| isOpened | | boolean isOpened()(Code) | | Returns the flag that indicates if connection is open.
true if the connection is open |
| openDataInputStream | | public DataInputStream openDataInputStream()(Code) | | Open and return a data input stream for a connection.
This method always throw
IllegalArgumentException.
An input stream
exception:
IllegalArgumentException - is thrown for all requests |
| openDataOutputStream | | public DataOutputStream openDataOutputStream()(Code) | | Open and return a data output stream for a connection.
This method always throw
IllegalArgumentException.
An output stream
exception:
IllegalArgumentException - is thrown for all requests |
| openInputStream | | public InputStream openInputStream()(Code) | | Open and return an input stream for a connection.
This method always throw
IllegalArgumentException.
An input stream
exception:
IllegalArgumentException - is thrown for all requests |
| openOutputStream | | public OutputStream openOutputStream()(Code) | | Open and return an output stream for a connection.
This method always throw
IllegalArgumentException.
An output stream
exception:
IllegalArgumentException - is thrown for all requests |
| openPrim | | public Connection openPrim(String name, int mode, boolean timeouts) throws IOException(Code) | | Connector uses this method to initialize the connection object.
This method establishes APDU connection with card application,
obtains FCI information and creates stub for initial remote
reference.
Parameters:
name - the URL for the connection without protocol name
Parameters:
mode - the access mode (Ignored)
Parameters:
timeouts - a flag to indicate that the caller wants timeoutexceptions. Ignored this connection
throws:
IOException - if the connection can not be initialized
throws:
RemoteException - if initial remote reference object can not becreated
throws:
SecurityException - if access is restricted by ACL |
| unblockPin | | public short unblockPin(int blockedPinID, int unblockingPinId) throws RemoteException(Code) | | This is a high-level method that lets the J2ME application
ask the user to enter the value for an unblocking PIN,
and the new value for the blocked PIN and send
these to the card.
A call to unblockPin method pops up a UI that requests
the user to enter the value for the unblocking PIN and the
new value for the blocked PIN.
The unblockingPinID field indicates which unblocking
PIN is to be
used to unblock the blocked PIN which is indicated by the field
blockedPinId.
The unblockingPinID field indicates which PIN is to be unblocked.
The user can either cancel the request
or continue. If the user enters the PIN values and chooses to continue,
the implementation is responsible
for presenting the PIN values to the card for unblocking the
blocked PIN.
If padding is required for either of the PIN values, the
implementation is responsible for providing appropriate padding.
Parameters:
blockedPinID - the Id of PIN that is to be unblocked.
Parameters:
unblockingPinId - the Id of unblocking PIN. PINENTRY_CANCELLED if the user cancelled the PIN entryrequest or the value returned by the remote method.
exception:
java.rmi.RemoteException - is thrown if the PIN couldnot be communicated to the card or an exception is thrownby the card in response to the PIN entry.
exception:
SecurityException - is thrown if the J2ME application doesnot have appropriate rights to ask for unblocking the PIN. |
|
|
|