モジュール 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 - 処理が失敗した場合