Класс 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, хранящуюся в буфере команд ByteBuffer, и получает ответ APDU в буфере ответа response ByteBuffer.

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

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

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

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

public abstract void close() throws CardException

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

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