モジュール java.smartcardio
パッケージ javax.smartcardio

クラスCardTerminal

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

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

    導入されたバージョン:
    1.6
    関連項目:
    CardTerminals, TerminalFactory

    • コンストラクタのサマリー

      コンストラクタ 
      修飾子 コンストラクタ 説明
      protected CardTerminal()
      新しいCardTerminalオブジェクトを構築します。

    • コンストラクタの詳細

      • 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 - 処理が失敗した場合