de.gematik.ti.cardreader.provider.api.card

Interface ICard

public interface ICard

Interface to a smartcard object which is obtained from a card reader object of a certain card reader provider

Method Summary

Modifier and Type	Method and Description
void	disconnect(boolean reset) Disconnects the connection with this card.
Atr	getATR() Returns the Atr of this card
CardProtocol	getProtocol() Returns the transport protocol used.
ICardChannel	openBasicChannel() Open the basic communication channel to the card. - Note: the basic channel assumes the channel number 0.
ICardChannel	openLogicalChannel() Open a new logical channel.

Method Detail

getATR

Atr getATR()

Returns the Atr of this card

Returns:

the Atr of this card.

getProtocol

CardProtocol getProtocol()

Returns the transport protocol used.

Returns:

the transport protocol used, for example T0 for "T=0" or T1 for "T=1"

openBasicChannel

ICardChannel openBasicChannel()
                       throws CardException

Open the basic communication channel to the card. - Note: the basic channel assumes the channel number 0.

Returns:

The (connected) basic card channel

Throws:

java.lang.SecurityException - if a SecurityManager exists and the caller does not have the required permission

java.lang.IllegalStateException - if this card object has been disposed of via the disconnect() method

CardException - if there is an communication error with underlying layers

openLogicalChannel

ICardChannel openLogicalChannel()
                         throws CardException

Open a new logical channel. The channel is opened issuing a <code>MANAGE CHANNEL</code> command that should use the format [0x0, 0x70, 0x0, 0x0, 0x1].

Returns:

The (connected) logical card channel

Throws:

java.lang.SecurityException - if a SecurityManager exists and the caller does not have the required permission

java.lang.IllegalStateException - if this card object has been disposed of via the disconnect() method

CardException - is a new logical channel could not be opened

disconnect

void disconnect(boolean reset)
         throws CardException

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:

java.lang.SecurityException - if a SecurityManager exists and the caller does not have the required permission

CardException - if the card operation failed