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

クラスCommandAPDU

java.lang.Object
javax.smartcardio.CommandAPDU
すべての実装されたインタフェース:
Serializable
public final class CommandAPDU
extends Object
implements Serializable
ISO/IEC 7816-4に規定された構造に従うコマンドAPDUです。 これは、4バイトのヘッダーと、可変長の条件に依存する本体で構成されます。 このクラスは、APDUが意味的に有効なコマンドをエンコードするかどうかは確認しようとしません。

レスポンスAPDUの予想される長さがコンストラクタに指定されているときは、実際の長さ(Ne)は指定する必要がありますが、そのエンコードされた形式(Le)を指定する必要はありません。 同様に、getNe()は実際の値Neを返します。 つまり、値0は「最大長」ではなく「レスポンスAPDU内にデータがない」ことを意味します。

このクラスは、NeおよびNcに対する短形式と拡張形式の両方の長さのエンコードをサポートします。 ただし、すべての端末とスマート・カードが、拡張形式を使用するAPDUの受け入れが可能なわけではありません。

ヘッダー・バイトCLA、INS、P1、およびP2の場合、Javaの型intを使用して8ビット符号なしの値を表します。 コンストラクタでは、アプリケーションで指定されたint値の8つの最下位ビットだけに意味があります。 このアクセス用メソッドは、常に0から255の間の符号なしの値としてバイトを返します。

このクラスのインスタンスは不変です。 データがバイト配列を介して受け渡しされる場所では、保護されたクローニングが行われます。

導入されたバージョン:
1.6
関連項目:
ResponseAPDU, CardChannel.transmit, 直列化された形式

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

    コンストラクタ
    コンストラクタ 説明
    CommandAPDU​(byte[] apdu)
    APDUの内容全体(ヘッダーと本体)を含むバイト配列からCommandAPDUを構築します。
    CommandAPDU​(byte[] apdu, int apduOffset, int apduLength)
    APDUの内容全体(ヘッダーと本体)を含むバイト配列からCommandAPDUを構築します。
    CommandAPDU​(int cla, int ins, int p1, int p2)
    4つのヘッダー・バイトからCommandAPDUを構築します。
    CommandAPDU​(int cla, int ins, int p1, int p2, byte[] data)
    4つのヘッダー・バイトとコマンド・データからCommandAPDUを構築します。
    CommandAPDU​(int cla, int ins, int p1, int p2, byte[] data, int ne)
    4つのヘッダー・バイト、コマンド・データ、および予想される応答データ長からCommandAPDUを構築します。
    CommandAPDU​(int cla, int ins, int p1, int p2, byte[] data, int dataOffset, int dataLength)
    4つのヘッダー・バイトとコマンド・データからCommandAPDUを構築します。
    CommandAPDU​(int cla, int ins, int p1, int p2, byte[] data, int dataOffset, int dataLength, int ne)
    4つのヘッダー・バイト、コマンド・データ、および予想される応答データ長からCommandAPDUを構築します。
    CommandAPDU​(int cla, int ins, int p1, int p2, int ne)
    4つのヘッダー・バイトと予想される応答データ長からCommandAPDUを構築します。
    CommandAPDU​(ByteBuffer apdu)
    APDUの内容全体(ヘッダーと本体)を含むByteBufferからCommandAPDUを作成します。

  • メソッドのサマリー

    修飾子と型 メソッド 説明
    boolean equals​(Object obj)
    指定されたオブジェクトがこのコマンドAPDUと同じかどうかを比較します。
    byte[] getBytes()
    このAPDUのバイトのコピーを返します。
    int getCLA()
    クラス・バイトCLAの値を返します。
    byte[] getData()
    コマンド本体のデータ・バイトのコピーを返します。
    int getINS()
    命令バイトINSの値を返します。
    int getNc()
    コマンド本体(Nc)のデータ・バイト数を返します。このAPDUに本体がない場合は0を返します。
    int getNe()
    レスポンスAPDU (Ne)内の予想される最大データ・バイト数を返します。
    int getP1()
    パラメータ・バイトP1の値を返します。
    int getP2()
    パラメータ・バイトP2の値を返します。
    int hashCode()
    このコマンドAPDUのハッシュ・コード値を返します。
    String toString()
    このコマンドAPDUの文字列表現を返します。

    クラス java.lang.Objectで宣言されたメソッド

    clone, finalize, getClass, notify, notifyAll, wait, wait, wait

  • コンストラクタの詳細

    • CommandAPDU

      public CommandAPDU​(byte[] apdu)
      APDUの内容全体(ヘッダーと本体)を含むバイト配列からCommandAPDUを構築します。

      以後の変更から保護するために、apduバイトはコピーされます。

      パラメータ:
      apdu - コマンドAPDU全体
      例外:
      NullPointerException - apduがnullの場合
      IllegalArgumentException - apduに有効なコマンドAPDUが含まれない場合

    • CommandAPDU

      public CommandAPDU​(byte[] apdu, int apduOffset, int apduLength)
      APDUの内容全体(ヘッダーと本体)を含むバイト配列からCommandAPDUを構築します。 APDUは、バイト配列内のインデックスapduOffsetから始まり、長さはapduLengthバイトです。

      以後の変更から保護するために、apduバイトはコピーされます。

      パラメータ:
      apdu - コマンドAPDU全体
      apduOffset - apduデータの開始位置でのバイト配列内のオフセット
      apduLength - APDUの長さ
      例外:
      NullPointerException - apduがnullの場合
      IllegalArgumentException - apduOffsetまたはapduLengthが負の場合、またはapduOffset+apduLengthがapdu.lengthより大きい場合、または指定されたバイトが有効なAPDUではない場合

    • CommandAPDU

      public CommandAPDU​(ByteBuffer apdu)
      APDUの内容全体(ヘッダーと本体)を含むByteBufferからCommandAPDUを作成します。 バッファのpositionはAPDUの開始位置、そのlimitはAPDUの終了位置に設定する必要があります。 終了時に、バッファのpositionはlimitに等しくなりますが、limitは変更されません。

      以後の変更から保護するために、ByteBuffer内のデータはコピーされます。

      パラメータ:
      apdu - APDU全体を含むByteBuffer
      例外:
      NullPointerException - apduがnullの場合
      IllegalArgumentException - apduに有効なコマンドAPDUが含まれない場合

    • CommandAPDU

      public CommandAPDU​(int cla, int ins, int p1, int p2)
      4つのヘッダー・バイトからCommandAPDUを構築します。 これはISO 7816のケース1で、コマンド本体はありません。
      パラメータ:
      cla - クラス・バイトCLA
      ins - 命令バイトINS
      p1 - パラメータ・バイトP1
      p2 - パラメータ・バイトP2

    • CommandAPDU

      public CommandAPDU​(int cla, int ins, int p1, int p2, int ne)
      4つのヘッダー・バイトと予想される応答データ長からCommandAPDUを構築します。 これはISO 7816のケース2で、Neが指定された空のコマンド・データ・フィールドです。 Neが0の場合、APDUはISO 7816ケース1としてエンコードされます。
      パラメータ:
      cla - クラス・バイトCLA
      ins - 命令バイトINS
      p1 - パラメータ・バイトP1
      p2 - パラメータ・バイトP2
      ne - レスポンスAPDU内の予想される最大データ・バイト数
      例外:
      IllegalArgumentException - Neが負または65536より大きい場合

    • CommandAPDU

      public CommandAPDU​(int cla, int ins, int p1, int p2, byte[] data)
      4つのヘッダー・バイトとコマンド・データからCommandAPDUを構築します。 これはISO 7816のケース3で、コマンド・データは存在し、Neは存在しません。 値Ncはdata.lengthとみなされます。 dataがnullかその長さが0の場合、APDUはISO 7816ケース1としてエンコードされます。

      以後の変更から保護するために、データ・バイトはコピーされます。

      パラメータ:
      cla - クラス・バイトCLA
      ins - 命令バイトINS
      p1 - パラメータ・バイトP1
      p2 - パラメータ・バイトP2
      data - コマンド本体のデータ・バイトを含むバイト配列
      例外:
      IllegalArgumentException - data.lengthが65535より大きい場合

    • CommandAPDU

      public CommandAPDU​(int cla, int ins, int p1, int p2, byte[] data, int dataOffset, int dataLength)
      4つのヘッダー・バイトとコマンド・データからCommandAPDUを構築します。 これはISO 7816のケース3で、コマンド・データは存在し、Neは存在しません。 値NcはdataLengthとみなされます。 dataLengthが0の場合、APDUはISO 7816ケース1としてエンコードされます。

      以後の変更から保護するために、データ・バイトはコピーされます。

      パラメータ:
      cla - クラス・バイトCLA
      ins - 命令バイトINS
      p1 - パラメータ・バイトP1
      p2 - パラメータ・バイトP2
      data - コマンド本体のデータ・バイトを含むバイト配列
      dataOffset - コマンド本体のデータ・バイトの開始位置にあるバイト配列内のオフセット
      dataLength - コマンド本体のデータ・バイト数
      例外:
      NullPointerException - データがnullであり、かつdataLengthが0でない場合
      IllegalArgumentException - dataOffsetまたはdataLengthが負の場合、またはdataOffset+dataLengthがdata.lengthより大きい場合、またはdataLengthが65535より大きい場合

    • CommandAPDU

      public CommandAPDU​(int cla, int ins, int p1, int p2, byte[] data, int ne)
      4つのヘッダー・バイト、コマンド・データ、および予想される応答データ長からCommandAPDUを構築します。 これはISO 7816のケース4で、コマンド・データとNeが存在します。 値Ncは、dataがnull以外の場合はdata.lengthとみなされ、そうでない場合は0とみなされます。 NeまたはNcがゼロの場合、APDUはISO 7816に従ってケース1、2、または3としてエンコードされます。

      以後の変更から保護するために、データ・バイトはコピーされます。

      パラメータ:
      cla - クラス・バイトCLA
      ins - 命令バイトINS
      p1 - パラメータ・バイトP1
      p2 - パラメータ・バイトP2
      data - コマンド本体のデータ・バイトを含むバイト配列
      ne - レスポンスAPDU内の予想される最大データ・バイト数
      例外:
      IllegalArgumentException - data.lengthが65535より大きい場合、またはNeが負であるか65536より大きい場合

    • CommandAPDU

      public CommandAPDU​(int cla, int ins, int p1, int p2, byte[] data, int dataOffset, int dataLength, int ne)
      4つのヘッダー・バイト、コマンド・データ、および予想される応答データ長からCommandAPDUを構築します。 これはISO 7816のケース4で、コマンド・データとLeが存在します。 値NcはdataLengthとみなされます。 NeまたはNcがゼロの場合、APDUはISO 7816に従ってケース1、2、または3としてエンコードされます。

      以後の変更から保護するために、データ・バイトはコピーされます。

      パラメータ:
      cla - クラス・バイトCLA
      ins - 命令バイトINS
      p1 - パラメータ・バイトP1
      p2 - パラメータ・バイトP2
      data - コマンド本体のデータ・バイトを含むバイト配列
      dataOffset - コマンド本体のデータ・バイトの開始位置にあるバイト配列内のオフセット
      dataLength - コマンド本体のデータ・バイト数
      ne - レスポンスAPDU内の予想される最大データ・バイト数
      例外:
      NullPointerException - データがnullであり、かつdataLengthが0でない場合
      IllegalArgumentException - dataOffsetまたはdataLengthが負の場合、またはdataOffset+dataLengthがdata.lengthより大きい場合、またはNeが負であるか65536より大きい場合、またはdataLengthが65535より大きい場合

  • メソッドの詳細

    • getCLA

      public int getCLA()
      クラス・バイトCLAの値を返します。
      戻り値:
      クラス・バイトCLAの値。

    • getINS

      public int getINS()
      命令バイトINSの値を返します。
      戻り値:
      命令バイトINSの値。

    • getP1

      public int getP1()
      パラメータ・バイトP1の値を返します。
      戻り値:
      パラメータ・バイトP1の値。

    • getP2

      public int getP2()
      パラメータ・バイトP2の値を返します。
      戻り値:
      パラメータ・バイトP2の値。

    • getNc

      public int getNc()
      コマンド本体(Nc)のデータ・バイト数を返します。このAPDUに本体がない場合は0を返します。 この呼出しは、getData().lengthと同等です。
      戻り値:
      コマンド本体のデータ・バイト数。このAPDUに本体がない場合は0。

    • getData

      public byte[] getData()
      コマンド本体のデータ・バイトのコピーを返します。 このAPDUに本体がない場合、このメソッドは長さがゼロのバイト配列を返します。
      戻り値:
      コマンド本体のデータ・バイトのコピー。このAPDUに本体がない場合は、空のバイト配列。

    • getNe

      public int getNe()
      レスポンスAPDU (Ne)内の予想される最大データ・バイト数を返します。
      戻り値:
      レスポンスAPDU内の予想される最大データ・バイト数。

    • getBytes

      public byte[] getBytes()
      このAPDUのバイトのコピーを返します。
      戻り値:
      このAPDUのバイトのコピー。

    • toString

      public String toString()
      このコマンドAPDUの文字列表現を返します。
      オーバーライド:
      toString 、クラス:  Object
      戻り値:
      このコマンドAPDUの文字列表現。

    • equals

      public boolean equals​(Object obj)
      指定されたオブジェクトがこのコマンドAPDUと同じかどうかを比較します。 指定されたオブジェクトがCommandAPDUでもあり、そのバイトがこのCommandAPDUのバイトと同じ場合は、trueを返します。
      オーバーライド:
      equals 、クラス:  Object
      パラメータ:
      obj - このコマンドAPDUと等しいかどうかを比較するオブジェクト
      戻り値:
      指定されたオブジェクトがこのコマンドAPDUと等しい場合はtrue
      関連項目:
      Object.hashCode()、HashMap

    • hashCode

      public int hashCode()
      このコマンドAPDUのハッシュ・コード値を返します。
      オーバーライド:
      hashCode 、クラス:  Object
      戻り値:
      このコマンドAPDUのハッシュ・コード値。
      関連項目:
      Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)