Класс CommandAPDU

java.lang.Object

javax.smartcardio.CommandAPDU

Все реализуемые интерфейсы:: Serializable

public final class CommandAPDU extends Object implements Serializable

Командная APDU, соответствующая структуре, определённой в ISO/IEC 7816-4. Она состоит из четырёхбайтового заголовка и условного тела переменной длины. Этот класс не проверяет, кодирует ли APDU семантически допустимую команду.

Обратите внимание: если ожидаемая длина ответа APDU задаётся в конструкторах, необходимо указывать фактическую длину (Ne), а не её закодированную форму (Le). Аналогично, getNe() возвращает фактическое значение Ne. Иными словами, значение 0 означает «в ответе APDU нет данных», а не «максимальная длина».

Этот класс поддерживает как короткую, так и расширенную формы кодирования длины для Ne и Nc. Однако обратите внимание, что не все терминалы и смарт-карты способны принимать APDU, использующие расширенную форму.

Для байтов заголовка CLA, INS, P1 и P2 используется тип Java int для представления 8-битных беззнаковых значений. В конструкторах значимы только 8 младших бит значения int, указанного приложением. Методы доступа всегда возвращают байт как беззнаковое значение в диапазоне от 0 до 255.

Экземпляры этого класса неизменяемы. При передаче данных в виде массивов байтов и получении данных в виде массивов байтов выполняется защитное копирование.

Начиная с:

1.6

См. также:

Краткое описание конструкторов

Конструктор	Описание
`CommandAPDU(byte[] apdu)`	Создаёт CommandAPDU из массива байтов, содержащего полное содержимое APDU (заголовок и тело).
`CommandAPDU(byte[] apdu, int apduOffset, int apduLength)`	Создаёт CommandAPDU из массива байтов, содержащего полное содержимое APDU (заголовок и тело).
`CommandAPDU(int cla, int ins, int p1, int p2)`	Создаёт CommandAPDU из четырёх байтов заголовка.
`CommandAPDU(int cla, int ins, int p1, int p2, byte[] data)`	Создаёт CommandAPDU из четырёх байтов заголовка и данных команды.
`CommandAPDU(int cla, int ins, int p1, int p2, byte[] data, int ne)`	Создаёт CommandAPDU из четырёх байтов заголовка, данных команды и ожидаемой длины данных ответа.
`CommandAPDU(int cla, int ins, int p1, int p2, byte[] data, int dataOffset, int dataLength)`	Создаёт CommandAPDU из четырёх байтов заголовка и данных команды.
`CommandAPDU(int cla, int ins, int p1, int p2, byte[] data, int dataOffset, int dataLength, int ne)`	Создаёт CommandAPDU из четырёх байтов заголовка, данных команды и ожидаемой длины данных ответа.
`CommandAPDU(int cla, int ins, int p1, int p2, int ne)`	Создаёт CommandAPDU из четырёх байтов заголовка и ожидаемой длины данных ответа.
`CommandAPDU(ByteBuffer apdu)`	Создаёт CommandAPDU из ByteBuffer, содержащего полное содержимое APDU (заголовок и тело).

Краткое описание методов

Модификатор и тип	Метод	Описание
`boolean`	`equals(Object obj)`	Сравнивает указанный объект с этой командной APDU на равенство.
`byte[]`	`getBytes()`	Возвращает копию байтов этой APDU.
`int`	`getCLA()`	Возвращает значение байта класса CLA.
`byte[]`	`getData()`	Возвращает копию байтов данных в теле команды.
`int`	`getINS()`	Возвращает значение байта инструкции INS.
`int`	`getNc()`	Возвращает количество байтов данных в теле команды (Nc) или 0, если у этой APDU нет тела.
`int`	`getNe()`	Возвращает максимальное количество ожидаемых байтов данных в ответе APDU (Ne).
`int`	`getP1()`	Возвращает значение байта параметра P1.
`int`	`getP2()`	Возвращает значение байта параметра P2.
`int`	`hashCode()`	Возвращает хеш-код этой командной APDU.
`String`	`toString()`	Возвращает строковое представление этой командной APDU.

Методы, объявленные в классе Object

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

Подробное описание конструкторов

CommandAPDU

public CommandAPDU(byte[] apdu)

Создаёт CommandAPDU из массива байтов, содержащего полное содержимое APDU (заголовок и тело).

Обратите внимание: байты apdu копируются для защиты от последующего изменения.

Параметры:: apdu — полная командная APDU
Исключения:: NullPointerException — если apdu равен null; IllegalArgumentException — если apdu не содержит допустимую командную APDU

CommandAPDU

public CommandAPDU(byte[] apdu, int apduOffset, int apduLength)

Создаёт CommandAPDU из массива байтов, содержащего полное содержимое APDU (заголовок и тело). 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)

Создаёт CommandAPDU из ByteBuffer, содержащего полное содержимое APDU (заголовок и тело). position буфера должен указывать на начало APDU, а limit — на конец APDU. После возврата position буфера равен его limit; значение limit не изменяется.

Обратите внимание: данные в ByteBuffer копируются для защиты от последующего изменения.

Параметры:: apdu — ByteBuffer, содержащий полную APDU
Исключения:: NullPointerException — если apdu равен null; IllegalArgumentException — если apdu не содержит допустимую командную APDU

CommandAPDU

public CommandAPDU(int cla, int ins, int p1, int p2)

Создаёт CommandAPDU из четырёх байтов заголовка. Это случай 1 в ISO 7816, тело команды отсутствует.

Параметры:: cla — байт класса CLA; ins — байт инструкции INS; p1 — байт параметра P1; p2 — байт параметра P2

CommandAPDU

public CommandAPDU(int cla, int ins, int p1, int p2, int ne)

Создаёт CommandAPDU из четырёх байтов заголовка и ожидаемой длины данных ответа. Это случай 2 в ISO 7816: поле данных команды пустое, значение Ne задано. Если Ne равно 0, APDU кодируется как случай 1 в ISO 7816.

Параметры:: 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)

Создаёт CommandAPDU из четырёх байтов заголовка и данных команды. Это случай 3 в ISO 7816: данные команды присутствуют, Ne отсутствует. Значение Nc определяется как data.length. Если data равно null или его длина равна 0, APDU кодируется как случай 1 в ISO 7816.

Обратите внимание: байты данных копируются для защиты от последующего изменения.

Параметры:: 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)

Создаёт CommandAPDU из четырёх байтов заголовка и данных команды. Это случай 3 в ISO 7816: данные команды присутствуют, Ne отсутствует. Значение Nc определяется как dataLength. Если dataLength равно 0, APDU кодируется как случай 1 в ISO 7816.

Обратите внимание: байты данных копируются для защиты от последующего изменения.

Параметры:: cla — байт класса CLA; ins — байт инструкции INS; p1 — байт параметра P1; p2 — байт параметра P2; data — массив байтов, содержащий байты данных тела команды; dataOffset — смещение в массиве байтов, с которого начинаются байты данных тела команды; dataLength — количество байтов данных в теле команды
Исключения:: NullPointerException — если data равно 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)

Создаёт CommandAPDU из четырёх байтов заголовка, данных команды и ожидаемой длины данных ответа. Это случай 4 в ISO 7816: данные команды и Ne присутствуют. Значение Nc определяется как data.length, если data не равно null, и как 0 в противном случае. Если Ne или Nc равны нулю, APDU кодируется как случай 1, 2 или 3 согласно ISO 7816.

Обратите внимание: байты данных копируются для защиты от последующего изменения.

Параметры:: 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)

Создаёт CommandAPDU из четырёх байтов заголовка, данных команды и ожидаемой длины данных ответа. Это случай 4 в ISO 7816: данные команды и Le присутствуют. Значение Nc определяется как dataLength. Если Ne или Nc равны нулю, APDU кодируется как случай 1, 2 или 3 согласно ISO 7816.

Обратите внимание: байты данных копируются для защиты от последующего изменения.

Параметры:: cla — байт класса CLA; ins — байт инструкции INS; p1 — байт параметра P1; p2 — байт параметра P2; data — массив байтов, содержащий байты данных тела команды; dataOffset — смещение в массиве байтов, с которого начинаются байты данных тела команды; dataLength — количество байтов данных в теле команды; ne — максимальное количество ожидаемых байтов данных в ответе APDU
Исключения:: NullPointerException — если data равно 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) или 0, если у этой APDU нет тела. Этот вызов эквивалентен getData().length.

Возвращает:: количество байтов данных в теле команды или 0, если у этой APDU нет тела.

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 на равенство. Возвращает true, если переданный объект также является CommandAPDU и его байты идентичны байтам этой CommandAPDU.

Переопределяет:

equals в классе Object

Параметры:

obj — объект, который требуется сравнить на равенство с этой командной APDU

Возвращает:

true, если указанный объект равен этой командной APDU

См. также:

hashCode

public int hashCode()

Возвращает хеш-код этой командной APDU.

Переопределяет:

hashCode в классе Object

Возвращает:

хеш-код этой командной APDU.

См. также:

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/25/docs/api/java.smartcardio/javax/smartcardio/CommandAPDU.html