Класс CardTerminal

java.lang.Object
- javax.smartcardio.CardTerminal

public abstract class CardTerminal
extends Object

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

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

Since:: 1.6
См. также:: CardTerminals, TerminalFactory

Конструкторы

Модификатор	Конструктор	Описание
`protected`	`CardTerminal()`	Создаёт новый объект 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 - если операция завершилась неудачно