モジュール java.smartcardio

パッケージ javax.smartcardio

クラスCardTerminal

java.lang.Object

javax.smartcardio.CardTerminal

public abstract class CardTerminal extends Object

スマート・カード端末です。スマート・カード・リーダーと呼ばれることもあります。 CardTerminalオブジェクトは、CardTerminals.list()またはCardTerminals.getTerminal()を呼び出すことで取得できます。

複数のカード用のスロットがある物理カード・リーダーは、そのようなスロットごとに1つの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 - プロトコルがnullの場合

IllegalArgumentException - プロトコルが無効なプロトコル仕様の場合

CardNotPresentException - この端末にカードが存在しない場合

CardException - 指定されたプロトコルを使用して接続を確立できなかった場合、または以前に別のプロトコルを使用して接続が確立されていた場合

SecurityException - SecurityManagerが存在し、呼出し側に必要なアクセス権がない場合

isCardPresent

public abstract boolean isCardPresent() throws CardException

この端末にカードが存在するかどうかを返します。

戻り値:

この端末にカードが存在するかどうか

例外:

CardException - ステータスを確認できなかった場合

waitForCardPresent

public abstract boolean waitForCardPresent(long timeout) throws CardException

カードがこの端末内に存在するようになるか、タイム・アウトの期限が切れるまで待機します。 タイム・アウトの期限が切れたためにメソッドが復帰した場合は、falseを返します。 それ以外の場合はtrueを返します。

このメソッドが呼び出されたときにカードがこの端末に存在する場合は、すぐに復帰します。

パラメータ:

timeout - 正の場合は、最大timeoutミリ秒間ブロックする。ゼロの場合は、無期限にブロックする。負にすることはできない

戻り値:

タイム・アウトの期限が切れたためにメソッドが復帰した場合はfalse、そうでない場合はtrue

例外:

IllegalArgumentException - timeoutが負の値の場合

CardException - 処理が失敗した場合

waitForCardAbsent

public abstract boolean waitForCardAbsent(long timeout) throws CardException

カードがこの端末内に存在しなくなるか、タイム・アウトの期限が切れるまで待機します。 タイム・アウトの期限が切れたためにメソッドが復帰した場合は、falseを返します。 それ以外の場合はtrueを返します。

このメソッドが呼び出されたときにカードがこの端末に存在しない場合は、すぐに復帰します。

パラメータ:

timeout - 正の場合は、最大timeoutミリ秒間ブロックする。ゼロの場合は、無期限にブロックする。負にすることはできない

戻り値:

タイム・アウトの期限が切れたためにメソッドが復帰した場合はfalse、そうでない場合はtrue

例外:

IllegalArgumentException - timeoutが負の値の場合

CardException - 処理が失敗した場合