public abstract class CardTerminal extends Object
Note that physical card readers with slots for multiple cards are represented by one CardTerminal
object per such slot.
Modifier | Constructor | Description |
---|---|---|
protected |
Constructs a new CardTerminal object. |
Modifier and Type | Method | Description |
---|---|---|
abstract Card |
connect |
Establishes a connection to the card. |
abstract String |
getName() |
Returns the unique name of this terminal. |
abstract boolean |
isCardPresent() |
Returns whether a card is present in this terminal. |
abstract boolean |
waitForCardAbsent |
Waits until a card is absent in this terminal or the timeout expires. |
abstract boolean |
waitForCardPresent |
Waits until a card is present in this terminal or the timeout expires. |
protected CardTerminal()
This constructor is called by subclasses only. Application should call list() or getTerminal() to obtain a CardTerminal object.
public abstract String getName()
public abstract Card connect(String protocol) throws CardException
protocol
- the protocol to use ("T=0", "T=1", or "T=CL"), or "*" to connect using any available protocol.NullPointerException
- if protocol is nullIllegalArgumentException
- if protocol is an invalid protocol specificationCardNotPresentException
- if no card is present in this terminalCardException
- if a connection could not be established using the specified protocol or if a connection has previously been established using a different protocolSecurityException
- if a SecurityManager exists and the caller does not have the required permission
public abstract boolean isCardPresent() throws CardException
CardException
- if the status could not be determinedpublic abstract boolean waitForCardPresent(long timeout) throws CardException
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 negativeIllegalArgumentException
- if timeout is negativeCardException
- if the operation failedpublic abstract boolean waitForCardAbsent(long timeout) throws CardException
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 negativeIllegalArgumentException
- if timeout is negativeCardException
- if the operation failed
© 1993, 2023, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/21/docs/api/java.smartcardio/javax/smartcardio/CardTerminal.html