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.
CardTerminals
,
TerminalFactory
Modifier | Constructor and Description |
---|---|
protected |
CardTerminal()
Constructs a new CardTerminal object.
|
Modifier and Type | Method and Description |
---|---|
abstract Card |
connect(String protocol)
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(long timeout)
Waits until a card is absent in this terminal or the timeout
expires.
|
abstract boolean |
waitForCardPresent(long timeout)
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
permissionpublic 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
Copyright © 2005, 2015, Oracle and/or its affiliates. All rights reserved.