Класс Card

java.lang.Object

javax.smartcardio.Card

public abstract class Card extends Object

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

С момента:

1.6

См. также:

CardTerminal

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

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, 2021, 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/17/docs/api/java.smartcardio/javax/smartcardio/Card.html