compact3

javax.smartcardio

Класс CommandAPDU

java.lang. Объект

javax.smartcardio. CommandAPDU

Все Реализованные Интерфейсы:

Сериализуемый

public final class CommandAPDU
extends Object
implements Serializable

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

Отметьте, что, когда ожидаемая длина APDU ответа определяется в конструкторах, фактическая длина (неон) должна быть определена, не его закодированная форма (Le). Точно так же getNe () возвращает неон фактического значения. Другими словами значение 0 не означает "данных в APDU ответа", а не "максимальной длине."

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

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

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

С тех пор:

1.6

См. Также:

ResponseAPDU, CardChannel.transmit, Сериализированная Форма

Сводка конструктора

Конструкторы

Конструктор и Описание
CommandAPDU(byte[] apdu) Создает CommandAPDU из байтового массива, содержащего полное содержание APDU (заголовок и тело).
CommandAPDU(byte[] apdu, int apduOffset, int apduLength) Создает CommandAPDU из байтового массива, содержащего полное содержание APDU (заголовок и тело).
CommandAPDU(ByteBuffer apdu) Создает CommandAPDU из ByteBuffer, содержащего полное содержание 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 из четырех байтов заголовка и ожидаемой длины данных ответа.

Сводка метода

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

Методы, наследованные от class java.lang. Объект

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

Деталь конструктора

CommandAPDU

public CommandAPDU(byte[] apdu)

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

Отметьте, что apdu байты копируются, чтобы защитить от последующей модификации.

Параметры:

apdu - полный APDU команды

Броски:

NullPointerException - если apdu является нулем

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 является нулем

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 является нулем

IllegalArgumentException - если apdu не содержит допустимый APDU команды

CommandAPDU

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

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

Параметры:

cla - CLA байта class

ins - INS байта инструкции

p1 - байт параметра P1

p2 - байт параметра P2

CommandAPDU

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

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

Параметры:

cla - CLA байта class

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, существующие данные команды и отсутствующий неон. Значение Nc принимается как data.length. Если data нуль, или его длина 0, APDU кодируется как случай ISO 7816 1.

Отметьте, что байты данных копируются, чтобы защитить от последующей модификации.

Параметры:

cla - CLA байта class

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, существующие данные команды и отсутствующий неон. Значение Nc принимается как dataLength. Если dataLength 0, APDU кодируется как случай ISO 7816 1.

Отметьте, что байты данных копируются, чтобы защитить от последующей модификации.

Параметры:

cla - CLA байта class

ins - INS байта инструкции

p1 - байт параметра P1

p2 - байт параметра P2

data - байтовый массив, содержащий байты данных тела команды

dataOffset - смещение в байтовом массиве, в котором начинаются байты данных тела команды

dataLength - число байтов данных в теле команды

Броски:

NullPointerException - если данные являются нулем, и 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, данных команды и существующем неоне. Значение Nc принимается как data.length если data ненуль и как 0 иначе. Если неон или Nc являются нулем, APDU кодируется как случай 1, 2, или 3 на ISO 7816.

Отметьте, что байты данных копируются, чтобы защитить от последующей модификации.

Параметры:

cla - CLA байта class

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. Если неон или Nc являются нулем, APDU кодируется как случай 1, 2, или 3 на ISO 7816.

Отметьте, что байты данных копируются, чтобы защитить от последующей модификации.

Параметры:

cla - CLA байта class

ins - INS байта инструкции

p1 - байт параметра P1

p2 - байт параметра P2

data - байтовый массив, содержащий байты данных тела команды

dataOffset - смещение в байтовом массиве, в котором начинаются байты данных тела команды

dataLength - число байтов данных в теле команды

ne - максимальное количество ожидаемых байтов данных в APDU ответа

Броски:

NullPointerException - если данные являются нулем, и dataLength не 0

IllegalArgumentException - если dataOffset или dataLength отрицательны или если dataOffset + dataLength больше чем data.length, или если ne отрицателен или больше чем 65536, или если dataLength больше чем 65535

Деталь метода

getCLA

public int getCLA()

Возвращает значение CLA байта class.

Возвраты:

значение CLA байта class.

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 ответа (неон).

Возвраты:

максимальное количество ожидаемых байтов данных в APDU ответа.

getBytes

public byte[] getBytes()

Возвращает копию байтов в этом APDU.

Возвраты:

копия байтов в этом APDU.

toString

public String toString()

Возвращает строковое представление этого APDU команды.

Переопределения:

toString в class Object

Возвраты:

Строковое представление этого APDU команды.

равняется

public boolean equals(Object obj)

Сравнивает указанный объект с этим APDU команды для равенства. Возвращает true, если данным объектом является также CommandAPDU, и его байты идентичны байтам в этом CommandAPDU.

Переопределения:

equals в class Object

Параметры:

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

Возвраты:

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

См. Также:

Object.hashCode(), HashMap

хэш-код

public int hashCode()

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

Переопределения:

hashCode в class Object

Возвраты:

значение хэш-кода для этого APDU команды.

См. Также:

Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)