CardTerminal (Java Smart Card I/O)

クラス

使用

ヘルプ

Java Smart Card I/O

前のクラス 次のクラス

フレームあり フレームなし

概要: 入れ子 | フィールド | コンストラクタ | メソッド

詳細: フィールド | コンストラクタ | メソッド

javax.smartcardio
クラス CardTerminal

java.lang.Object
  javax.smartcardio.CardTerminal

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

複数のカード用のスロットがある物理カードリーダーは、そのようなスロットごとに 1 つの CardTerminal オブジェクトによって表されます。

コンストラクタの概要
`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`

コンストラクタの詳細

protected CardTerminal()

新しい CardTerminal オブジェクトを構築します。

このコンストラクタはサブクラスのみから呼び出されます。アプリケーションでは、list() または getTerminal() を呼び出して CardTerminal オブジェクトを取得する必要があります。

メソッドの詳細

public abstract String getName()

この端末の一意名を返します。

public abstract Card connect(String protocol)
                      throws CardException

カードへの接続を確立します。指定されたプロトコルを使用して以前に接続が確立されていた場合、このメソッドは前の呼び出しと同じ Card オブジェクトを返します。

パラメータ:: protocol - 使用するプロトコル (「T=0」、「T=1」、または「T=CL」)。使用可能なプロトコルを使用して接続する場合は「*」
例外:: NullPointerException - プロトコルが null の場合; IllegalArgumentException - プロトコルが無効なプロトコル仕様の場合; CardNotPresentException - この端末にカードが存在しない場合; CardException - 指定されたプロトコルを使用して接続を確立できなかった場合、または以前に別のプロトコルを使用して接続が確立されていた場合; SecurityException - SecurityManager が存在し、呼び出し側に必要なアクセス権がない場合

public abstract boolean isCardPresent()
                               throws CardException

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

public abstract boolean waitForCardPresent(long timeout)
                                    throws CardException

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

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

パラメータ:: timeout - 正の場合は、最大 timeout ミリ秒間ブロックする。ゼロの場合は、無期限にブロックする。負にすることはできない
戻り値:: タイムアウトの期限が切れたためにメソッドが復帰した場合は false、そうでない場合は true
例外:: IllegalArgumentException - timeout が負の値の場合; CardException - 処理が失敗した場合

public abstract boolean waitForCardAbsent(long timeout)
                                   throws CardException

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

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

パラメータ:: timeout - 正の場合は、最大 timeout ミリ秒間ブロックする。ゼロの場合は、無期限にブロックする。負にすることはできない
戻り値:: タイムアウトの期限が切れたためにメソッドが復帰した場合は false、そうでない場合は true
例外:: IllegalArgumentException - timeout が負の値の場合; CardException - 処理が失敗した場合