Класс CardTerminal

java.lang.Object

javax.smartcardio.CardTerminal

public abstract class CardTerminal extends Object

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

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

Since:

1.6

См. также:

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

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 - если протокол равен null; IllegalArgumentException - если протокол является недопустимым спецификацией протокола; 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, 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/CardTerminal.html