java.lang.Object
javax.smartcardio.CardTerminal
public abstract class CardTerminal extends Object
スマート・カード端末です。スマート・カード・リーダーと呼ばれることもあります。 CardTerminalオブジェクトは、CardTerminals.list()またはCardTerminals.getTerminal()を呼び出すことで取得できます。
複数のカード用のスロットがある物理カード・リーダーは、そのようなスロットごとに1つのCardTerminal
オブジェクトによって表されます。
- 導入されたバージョン:
- 1.6
- 関連項目:
-
コンストラクタのサマリー
コンストラクタ -
メソッドのサマリー
修飾子と型メソッド説明abstract Card
カードへの接続を確立します。abstract String
getName()
この端末の一意名を返します。abstract boolean
この端末にカードが存在するかどうかを返します。abstract boolean
waitForCardAbsent
(long timeout) カードがこの端末内に存在しなくなるか、タイム・アウトの期限が切れるまで待機します。abstract boolean
waitForCardPresent
(long timeout) カードがこの端末内に存在するようになるか、タイム・アウトの期限が切れるまで待機します。
-
コンストラクタの詳細
-
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
- 処理が失敗した場合
-