Класс 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.

Методы, объявленные в классе java.lang.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 равен его пределу; его предел остается неизменным.

Обратите внимание, что данные в объекте 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.

Overrides:

equals в классе Object

Параметры:

obj - объект, подлежащий сравнению на равенство с этой командой APDU

Возвращает:

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

См. также:

hashCode

public int hashCode()

Возвращает значение кода хеширования для этой команды APDU.

Overrides:

hashCode в классе Object

Возвращает:

значение кода хеширования для этой команды APDU.

См. также:

© 1993, 2023, 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/21/docs/api/java.smartcardio/javax/smartcardio/CommandAPDU.html