PCSC4Java
0.2
Library PCSC for Java language.
|
Public Member Functions | |
abstract String | getName () |
abstract Card | connect (String protocol) throws CardException |
abstract boolean | isCardPresent () throws CardException |
abstract boolean | waitForCardPresent (long timeout) throws CardException |
abstract boolean | waitForCardAbsent (long timeout) throws CardException |
abstract void | cancelOperation () throws CardException |
abstract byte[][] | getCardStatus () throws CardException |
Protected Member Functions | |
CardTerminal () |
A Smart Card terminal, sometimes refered to as a Smart Card Reader. A CardTerminal object can be obtained by calling CardTerminals::list} or CardTerminals::getTerminal CardTerminals.getTerminal()}.
Note that physical card readers with slots for multiple cards are represented by one CardTerminal
object per such slot.
Definition at line 46 of file CardTerminal.java.
fr.redbilled.pcscforjava.CardTerminal.CardTerminal | ( | ) | [protected] |
Constructs a new CardTerminal object.
This constructor is called by subclasses only. Application should call CardTerminals::list list()} or CardTerminals::getTerminal getTerminal()} to obtain a CardTerminal object.
Definition at line 56 of file CardTerminal.java.
abstract void fr.redbilled.pcscforjava.CardTerminal.cancelOperation | ( | ) | throws CardException [pure virtual] |
Terminates all outstanding actions with this terminal. The only requests that you can cancel are those that require waiting for external action by the smart card or user. Any such outstanding action requests will terminate with a status indication that the action was canceled.
CardException | if the card operation failed |
abstract Card fr.redbilled.pcscforjava.CardTerminal.connect | ( | String | protocol | ) | throws CardException [pure virtual] |
Establishes a connection to the card. If a connection has previously established using the specified protocol, this method returns the same Card object as the previous call.
protocol | the protocol to use ("T=0", "T=1", or "T=CL"), or "*" to connect using any available protocol. |
NullPointerException | if protocol is null |
IllegalArgumentException | if protocol is an invalid protocol specification |
CardNotPresentException | if no card is present in this terminal |
CardException | if a connection could not be established using the specified protocol or if a connection has previously been established using a different protocol |
SecurityException | if a SecurityManager exists and the caller does not have the required CardPermission permission} |
abstract byte [][] fr.redbilled.pcscforjava.CardTerminal.getCardStatus | ( | ) | throws CardException [pure virtual] |
Gets the status of the card in this card terminal.
has not been moved into position for use.
for use. The card is not powered.
reader driver is unaware of the mode of the card.
PTS negotiation.
communication protocols have been established. The third one is just a byte and contains the current protocol of the card it must be:
CardException | if the card operation failed |
abstract String fr.redbilled.pcscforjava.CardTerminal.getName | ( | ) | [pure virtual] |
Returns the unique name of this terminal.
abstract boolean fr.redbilled.pcscforjava.CardTerminal.isCardPresent | ( | ) | throws CardException [pure virtual] |
Returns whether a card is present in this terminal.
CardException | if the status could not be determined |
abstract boolean fr.redbilled.pcscforjava.CardTerminal.waitForCardAbsent | ( | long | timeout | ) | throws CardException [pure virtual] |
Waits until a card is absent in this terminal or the timeout expires. If the method returns due to an expired timeout, it returns false. Otherwise it return true.
If no card is present in this terminal when this method is called, it returns immediately.
timeout | if positive, block for up to timeout milliseconds; if zero, block indefinitely; must not be negative |
IllegalArgumentException | if timeout is negative |
CardException | if the operation failed |
abstract boolean fr.redbilled.pcscforjava.CardTerminal.waitForCardPresent | ( | long | timeout | ) | throws CardException [pure virtual] |
Waits until a card is present in this terminal or the timeout expires. If the method returns due to an expired timeout, it returns false. Otherwise it return true.
If a card is present in this terminal when this method is called, it returns immediately.
timeout | if positive, block for up to timeout milliseconds; if zero, block indefinitely; must not be negative |
IllegalArgumentException | if timeout is negative |
CardException | if the operation failed |