模块 java.smartcardio

软件包 javax.smartcardio

Class CardTerminal

java.lang.Object

javax.smartcardio.CardTerminal

public abstract class CardTerminal
extends Object

智能卡终端，有时也称为智能卡读卡器。 可以通过致电CardTerminals.list()或CardTerminals.getTerminal()获得CardTerminal对象。

请注意，具有多个卡插槽的物理读卡器每个插槽由一个CardTerminal对象表示。

从以下版本开始：

1.6

另请参见：

CardTerminals ， TerminalFactory

构造方法摘要

构造方法

变量	构造器	描述
protected	CardTerminal()	构造一个新的CardTerminal对象。

方法摘要

变量和类型	方法	描述
abstract Card	connect(String protocol)	建立与卡的连接。
abstract String	getName()	返回此终端的唯一名称。
abstract boolean	isCardPresent()	返回此终端中是否存在卡。
abstract boolean	waitForCardAbsent(long timeout)	等待此终端中没有卡或超时到期。
abstract boolean	waitForCardPresent(long timeout)	等待此终端中存在卡或超时到期。

声明方法的类 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造方法详细信息

CardTerminal

protected CardTerminal()

构造一个新的CardTerminal对象。

此构造函数仅由子类调用。 应用程序应致电list()或getTerminal()以获取CardTerminal对象。

方法详细信息

getName

public abstract String getName()

返回此终端的唯一名称。

结果

这个终端的唯一名称。

connect

public abstract Card connect(String protocol)
                      throws CardException

建立与卡的连接。 如果先前使用指定的协议建立了连接，则此方法返回与上一次调用相同的Card对象。

参数

protocol - 使用任何可用协议连接的协议（“T = 0”，“T = 1”或“T = CL”）或“*”。

结果

已建立连接的卡

异常

NullPointerException - 如果协议为空

IllegalArgumentException - 如果协议是无效的协议规范

CardNotPresentException - 如果此终端中没有卡

CardException - 如果使用指定的协议无法建立连接，或者先前已使用其他协议建立连接

SecurityException - 如果存在SecurityManager且调用者没有所需的permission

isCardPresent

public abstract boolean isCardPresent()
                               throws CardException

返回此终端中是否存在卡。

结果

该终端是否存在卡。

异常

CardException - 如果无法确定状态

waitForCardPresent

public abstract boolean waitForCardPresent(long timeout)
                                    throws CardException

等待此终端中存在卡或超时到期。 如果方法由于超时过期而返回，则返回false。 否则返回true。

如果调用此方法时此终端中存在卡，则立即返回。

参数

timeout - 如果为正，则阻止最多timeout毫秒; 如果为零，则无限期阻止; 一定不要消极

结果

如果方法由于过期超时而返回，则返回false，否则返回true。

异常

IllegalArgumentException - 如果超时为负

CardException - 如果操作失败

waitForCardAbsent

public abstract boolean waitForCardAbsent(long timeout)
                                   throws CardException

等待此终端中没有卡或超时到期。 如果方法由于超时过期而返回，则返回false。 否则返回true。

如果调用此方法时此终端中没有卡，则立即返回。

参数

timeout - 如果为正，则阻止最多timeout毫秒; 如果为零，则无限期阻止; 一定不要消极

结果

如果方法由于过期超时而返回，则返回false，否则返回true。

异常

IllegalArgumentException - 如果超时为负

CardException - 如果操作失败