| java.lang.Object | |
| ↳ | javax.smartcardio.Card |
Class Overview
A Smart Card with which a connection has been established. Card objects
are obtained by calling CardTerminal.connect().
See Also
Summary
| Protected Constructors | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
Constructs a new Card object.
| |||||||||||
| Public Methods | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
Requests exclusive access to this card.
| |||||||||||
Disconnects the connection with this card.
| |||||||||||
Releases the exclusive access previously established using
beginExclusive. | |||||||||||
Returns the ATR of this card.
| |||||||||||
Returns the CardChannel for the basic logical channel.
| |||||||||||
Returns the protocol in use for this card.
| |||||||||||
Opens a new logical channel to the card and returns it.
| |||||||||||
Transmits a control command to the terminal device.
| |||||||||||
|
[Expand]
Inherited Methods | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
From class
java.lang.Object
| |||||||||||
Protected Constructors
protected Card ()
Constructs a new Card object.
This constructor is called by subclasses only. Application should
call the CardTerminal.connect()
method to obtain a Card
object.
Public Methods
public abstract void beginExclusive ()
Requests exclusive access to this card.
Once a thread has invoked beginExclusive, only this
thread is allowed to communicate with this card until it calls
endExclusive. Other threads attempting communication
will receive a CardException.
Applications have to ensure that exclusive access is correctly
released. This can be achieved by executing
the beginExclusive() and endExclusive calls
in a try ... finally block.
Throws
| SecurityException | if a SecurityManager exists and the
caller does not have the required
permission |
|---|---|
| CardException | if exclusive access has already been set or if exclusive access could not be established |
| IllegalStateException | if this card object has been disposed of
via the disconnect() method
|
public abstract void disconnect (boolean reset)
Disconnects the connection with this card. After this method returns, calling methods on this object or in CardChannels associated with this object that require interaction with the card will raise an IllegalStateException.
Parameters
| reset | whether to reset the card after disconnecting. |
|---|
Throws
| CardException | if the card operation failed |
|---|---|
| SecurityException | if a SecurityManager exists and the
caller does not have the required
permission
|
public abstract void endExclusive ()
Releases the exclusive access previously established using
beginExclusive.
Throws
| SecurityException | if a SecurityManager exists and the
caller does not have the required
permission |
|---|---|
| IllegalStateException | if the active Thread does not currently have
exclusive access to this card or
if this card object has been disposed of
via the disconnect() method |
| CardException | if the operation failed |
public abstract CardChannel getBasicChannel ()
Returns the CardChannel for the basic logical channel. The basic logical channel has a channel number of 0.
Throws
| SecurityException | if a SecurityManager exists and the
caller does not have the required
permission |
|---|---|
| IllegalStateException | if this card object has been disposed of
via the disconnect() method
|
public abstract String getProtocol ()
Returns the protocol in use for this card.
Returns
- the protocol in use for this card, for example "T=0" or "T=1"
public abstract CardChannel openLogicalChannel ()
Opens a new logical channel to the card and returns it. The channel is
opened by issuing a MANAGE CHANNEL command that should use
the format [00 70 00 00 01].
Throws
| SecurityException | if a SecurityManager exists and the
caller does not have the required
permission |
|---|---|
| CardException | is a new logical channel could not be opened |
| IllegalStateException | if this card object has been disposed of
via the disconnect() method
|
public abstract byte[] transmitControlCommand (int controlCode, byte[] command)
Transmits a control command to the terminal device.
This can be used to, for example, control terminal functions like a built-in PIN pad or biometrics.
Parameters
| controlCode | the control code of the command |
|---|---|
| command | the command data |
Throws
| SecurityException | if a SecurityManager exists and the
caller does not have the required
permission |
|---|---|
| NullPointerException | if command is null |
| CardException | if the card operation failed |
| IllegalStateException | if this card object has been disposed of
via the disconnect() method
|