Класс CardTerminal

java.lang.Object

javax.smartcardio.CardTerminal

public abstract class CardTerminal extends Object

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

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

Начиная с:

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)`	Ожидает, пока карта не появится в этом терминале или не истечет время ожидания.

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

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

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

CardTerminal

protected CardTerminal()

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

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

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

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 — если значение timeout отрицательное; CardException — если операция завершилась неудачно

waitForCardAbsent

public abstract boolean waitForCardAbsent(long timeout) throws CardException

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

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

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

© 1993, 2025, 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/25/docs/api/java.smartcardio/javax/smartcardio/CardTerminal.html