Класс Card

java.lang.Object

javax.smartcardio.Card

public abstract class Card extends Object

Умная карта, с которой установлено соединение. Объекты Card получаются при вызове CardTerminal.connect().

С тех пор:

1.6

См. также:

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

Card()

Модификатор	Конструктор	Описание
`protected`	Создаёт новый объект Card.

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

Модификатор и тип	Метод	Описание
`abstract void`	`beginExclusive()`	Запрашивает эксклюзивный доступ к этой карте.
`abstract void`	`disconnect(boolean reset)`	Отключает соединение с этой картой.
`abstract void`	`endExclusive()`	Освобождает эксклюзивный доступ, ранее установленный с помощью `beginExclusive`.
`abstract ATR`	`getATR()`	Возвращает ATR этой карты.
`abstract CardChannel`	`getBasicChannel()`	Возвращает CardChannel для основного логического канала.
`abstract String`	`getProtocol()`	Возвращает используемый протокол для этой карты.
`abstract CardChannel`	`openLogicalChannel()`	Открывает новый логический канал к карте и возвращает его.
`abstract byte[]`	`transmitControlCommand(int controlCode, byte[] command)`	Пересылает команду управления устройству терминала.

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

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

Card

protected Card()

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

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

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

getATR

public abstract ATR getATR()

Возвращает ATR этой карты.

Возвращает:: ATR этой карты.

getProtocol

public abstract String getProtocol()

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

Возвращает:: используемый протокол для этой карты, например "T=0" или "T=1"

getBasicChannel

public abstract CardChannel getBasicChannel()

Возвращает CardChannel для основного логического канала. У основного логического канала номер канала равен 0.

Возвращает:: CardChannel для основного логического канала
Использует:: SecurityException - если существует SecurityManager и вызывающий поток не имеет требуемого разрешения; IllegalStateException - если этот объект карты был удалён с помощью метода disconnect()

openLogicalChannel

public abstract CardChannel openLogicalChannel() throws CardException

Открывает новый логический канал к карте и возвращает его. Канал открывается путём выдачи команды MANAGE CHANNEL, которая должна использовать формат [00 70 00 00 01].

Возвращает:: открытый логический канал
Использует:: SecurityException - если существует SecurityManager и вызывающий поток не имеет требуемого разрешения; CardException - если новый логический канал не может быть открыт; IllegalStateException - если этот объект карты был удалён с помощью метода disconnect()

beginExclusive

public abstract void beginExclusive() throws CardException

Запрашивает эксклюзивный доступ к этой карте.

После того, как поток вызвал beginExclusive, только этот поток может взаимодействовать с этой картой до тех пор, пока не вызовет endExclusive. Другие потоки, пытающиеся взаимодействовать, получат исключение CardException.

Приложения должны гарантировать, что эксклюзивный доступ правильно освобождается. Это можно сделать, выполнив вызовы beginExclusive() и endExclusive в блоке try ... finally.

Использует:: SecurityException - если существует SecurityManager и вызывающий поток не имеет требуемого разрешения; CardException - если эксклюзивный доступ уже установлен или если эксклюзивный доступ не может быть установлен; IllegalStateException - если этот объект карты был удалён с помощью метода disconnect()

endExclusive

public abstract void endExclusive() throws CardException

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

Использует:: SecurityException - если существует SecurityManager и вызывающий поток не имеет требуемого разрешения; IllegalStateException - если активный поток не имеет в данный момент эксклюзивного доступа к этой карте или если этот объект карты был удалён с помощью метода disconnect(); CardException - если операция не удалась

transmitControlCommand

public abstract byte[] transmitControlCommand(int controlCode, byte[] command) throws CardException

Пересылает команду управления устройству терминала.

Это может быть использовано, например, для управления функциями терминала, такими как встроенный ПИН-пад или биометрия.

Параметры:: controlCode - код команды управления; command - данные команды
Возвращает:: ответ от устройства терминала
Использует:: SecurityException - если существует SecurityManager и вызывающий поток не имеет требуемого разрешения; NullPointerException - если команда равна null; CardException - если операция с картой не удалась; IllegalStateException - если этот объект карты был удалён с помощью метода disconnect()

disconnect

public abstract void disconnect(boolean reset) throws CardException

Отключает соединение с этой картой. После возврата этого метода, вызов методов этого объекта или в CardChannels, связанных с этим объектом, требующих взаимодействия с картой, вызовет IllegalStateException.

Параметры:: reset - следует ли сбросить карту после отключения.
Использует:: CardException - если операция с картой не удалась; SecurityException - если существует SecurityManager и вызывающий поток не имеет требуемого разрешения

© 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/Card.html