Класс 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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создает и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Указывает, является ли другой объект «равным» этому объекту.
`protected void`	`finalize()`	Устарел и предназначен для удаления: этот элемент API может быть удален в будущей версии. Финализация устарела и может быть удалена в одном из следующих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString()`	Возвращает строковое представление объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного промежутка реального времени.

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

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 — если время ожидания отрицательное; 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.