Класс CardTerminal

java.lang.Object

javax.smartcardio.CardTerminal

public abstract class CardTerminal extends Object

Терминал смарт-карты, иногда называемый считывателем смарт-карт. Объект CardTerminal можно получить, вызвав CardTerminals.list() или CardTerminals.getTerminal().

Обратите внимание, что физические считыватели карт с слотами для нескольких карт представлены одним объектом CardTerminal на каждый такой слот.

Since:

1.6

See Also:

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

CardTerminal()

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

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

Модификатор и тип	Метод	Описание
`abstract Card`	`connect(String protocol)`	Устанавливает соединение с картой.
`abstract String`	`getName()`	Возвращает уникальное имя этого терминала.
`abstract boolean`	`isCardPresent()`	Возвращает, присутствует ли карта в этом терминале.
`abstract boolean`	`waitForCardAbsent(long timeout)`	Ожидает, пока карта не будет отсутствовать в этом терминале или истечёт таймаут.
`abstract boolean`	`waitForCardPresent(long timeout)`	Ожидает, пока карта не появится в этом терминале или истечёт таймаут.

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

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

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

CardTerminal

protected CardTerminal()

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

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

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

getName

public abstract String getName()

Возвращает уникальное имя этого терминала.

Возвращает:: уникальное имя этого терминала.

connect

public abstract Card connect(String protocol) throws CardException

Устанавливает соединение с картой. Если соединение ранее было установлено с использованием указанного протокола, этот метод возвращает тот же объект Card, что и предыдущий вызов.

Параметры:: protocol - протокол для использования ("T=0", "T=1" или "T=CL"), или "*" для подключения с использованием любого доступного протокола.
Возвращает:: карта, с которой было установлено соединение
Исключения:: NullPointerException - если protocol равен null; IllegalArgumentException - если protocol — недопустимое спецификацией протокола; CardNotPresentException - если карта не присутствует в этом терминале; CardException - если соединение не может быть установлено с использованием указанного протокола или если соединение ранее было установлено с использованием другого протокола; SecurityException - если существует SecurityManager и у вызывающего объекта нет необходимых разрешений

isCardPresent

public abstract boolean isCardPresent() throws CardException

Возвращает, присутствует ли карта в этом терминале.

Возвращает:: присутствует ли карта в этом терминале.
Исключения:: CardException - если статус определить не удалось

waitForCardPresent

public abstract boolean waitForCardPresent(long timeout) throws CardException

Ожидает, пока карта не появится в этом терминале или истечёт таймаут. Если метод возвращается из-за истечения таймаута, он возвращает false. В противном случае возвращает true.

Если карта присутствует в этом терминале при вызове этого метода, он возвращается немедленно.

Параметры:: timeout - если положительное значение, ожидать до timeout миллисекунд; если ноль, ожидать неопределённо долго; не должно быть отрицательным
Возвращает:: false, если метод возвращается из-за истечения таймаута, true в противном случае.
Исключения:: IllegalArgumentException - если таймаут отрицательный; CardException - если операция не удалась

waitForCardAbsent

public abstract boolean waitForCardAbsent(long timeout) throws CardException

Ожидает, пока карта не исчезнет из этого терминала или истечёт таймаут. Если метод возвращается из-за истечения таймаута, он возвращает false. В противном случае возвращает true.

Если карта отсутствует в этом терминале при вызове этого метода, он возвращается немедленно.

Параметры:: timeout - если положительное значение, ожидать до timeout миллисекунд; если ноль, ожидать неопределённо долго; не должно быть отрицательным
Возвращает:: false, если метод возвращается из-за истечения таймаута, true в противном случае.
Исключения:: IllegalArgumentException - если таймаут отрицательный; CardException - если операция не удалась

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