Класс 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 - если 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, 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://download.java.net/java/early_access/jdk24/docs/api/java.smartcardio/javax/smartcardio/CardTerminal.html