Requests exclusive access to this card.

  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 {@linkplain CardPermission 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 {@linkplain #disconnect disconnect()} method

  Disconnects the connection with this card.

  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 {@linkplain CardPermission permission}

  Releases the exclusive access previously established using beginExclusive.

  Releases the exclusive access previously established using
beginExclusive.
Throws:
- SecurityException - if a SecurityManager exists and the caller does not have the required {@linkplain CardPermission 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 {@linkplain #disconnect disconnect()} method
- CardException - if the operation failed

  Returns the ATR of this card.

  Returns the ATR of this card.
Returns: the ATR of this card.

  Returns the CardChannel for the basic logical channel.

  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 {@linkplain CardPermission permission}
- IllegalStateException - if this card object has been disposed of via the {@linkplain #disconnect disconnect()} method

  Returns the protocol in use for this card.

  Returns the protocol in use for this card.
Returns: the protocol in use for this card, for example "T=0" or "T=1"

  Opens a new logical channel to the card and returns it.

  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 {@linkplain CardPermission permission}
- CardException - is a new logical channel could not be opened
- IllegalStateException - if this card object has been disposed of via the {@linkplain #disconnect disconnect()} method

  Transmits a control command to the terminal device.

  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 {@linkplain CardPermission permission}
- NullPointerException - if command is null
- CardException - if the card operation failed
- IllegalStateException - if this card object has been disposed of via the {@linkplain #disconnect disconnect()} method