Класс CardChannel

protected CardChannel()

Создаёт новый объект CardChannel.

Этот конструктор вызывается только подклассами. Приложение должно вызывать методы Card.getBasicChannel() и Card.openLogicalChannel(), чтобы получить объект CardChannel.

public abstract Card getCard()

Возвращает Card, с которым связан этот канал.

public abstract int getChannelNumber()

Возвращает номер канала этого CardChannel. Номер канала 0 указывает на базовый логический канал.

public abstract ResponseAPDU transmit(CommandAPDU command) throws CardException

Передаёт указанную команду APDU чипу смарт-карты и возвращает ответ APDU.

Байт CLA команды APDU автоматически корректируется для соответствия номеру канала этого CardChannel.

Обратите внимание, что этот метод нельзя использовать для передачи MANAGE CHANNEL APDUs. Логические каналы должны управляться с помощью методов Card.openLogicalChannel() и CardChannel.close().

Реализации должны прозрачно обрабатывать артефакты протокола передачи. Например, при использовании протокола T=0, должен выполняться обработчик, как описано в ISO/IEC 7816-4:

• если ответ APDU имеет SW1 61, реализация должна выполнить команду GET RESPONSE используя SW2 в качестве поля Le. Этот процесс повторяется до тех пор, пока не будет получен SW1 61. Тело ответа этих обменов конкатенируется, чтобы сформировать окончательное тело ответа.

• если ответ APDU 6C XX, реализация должна повторить команду используя XX в качестве поля Le.

ResponseAPDU, возвращаемый этим методом, является результатом после выполнения этой обработки.

public abstract int transmit(ByteBuffer command, ByteBuffer response) throws CardException

Передаёт команду APDU, хранящуюся в буфере command ByteBuffer, и получает ответ APDU в буфере response ByteBuffer.

Буфер command должен содержать данные команды APDU, начиная с command.position(), и APDU должна быть command.remaining() байтами в длину. По завершении, позиция буфера command будет равна его пределу; его предел не изменится. Буфер вывода получит байты ответа APDU. Его позиция будет продвинута на количество полученных байтов, которое также является возвращаемым значением этого метода.

Байт CLA команды APDU автоматически корректируется для соответствия номеру канала этого CardChannel.

Обратите внимание, что этот метод нельзя использовать для передачи MANAGE CHANNEL APDUs. Логические каналы должны управляться с помощью методов Card.openLogicalChannel() и CardChannel.close().

См. transmit() для обсуждения обработки ответов APDUs со значениями SW1 61 или 6C.

public abstract void close() throws CardException

Закрывает этот CardChannel. Логический канал закрывается путём выдачи команды MANAGE CHANNEL, которая должна использовать формат [xx 70 80 0n], где n - номер канала этого канала, а xx - байт CLA, который кодирует этот логический канал и имеет все остальные биты, установленные в 0. После того, как этот метод возвращает, вызов других методов в этом классе вызовет IllegalStateException.

Обратите внимание, что базовый логический канал не может быть закрыт с помощью этого метода. Он может быть закрыт путём вызова Card.disconnect(boolean).