javax.smartcardio

Класс CardTerminals

java.lang. Объект

javax.smartcardio. CardTerminals

public abstract class CardTerminals
extends Object

Набор терминалов поддерживается TerminalFactory. Этот класс позволяет приложениям перечислять доступный CardTerminals, получать определенный CardTerminal, или ожидать вставки или удаления карт.

Этот класс является безопасной многопоточностью и может использоваться многократными потоками одновременно. Однако, этот объект отслеживает состояние присутствия карты каждого из его терминалов. Многократные объекты должны использоваться, если независимые звонки waitForChange () требуются.

Приложения могут получить экземпляры этого класса, вызывая TerminalFactory.terminals ().

С тех пор:

1.6

См. Также:

TerminalFactory, CardTerminal

Вложенная Сводка Класса

Вложенные Классы

Модификатор и Тип	Класс и Описание
static class	CardTerminals. Государство Перечисление атрибутов CardTerminal.

Сводка конструктора

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

Модификатор	Конструктор и Описание
protected	CardTerminals() Создает новый объект CardTerminals.

Сводка метода

Методы

Модификатор и Тип	Метод и Описание
CardTerminal	getTerminal(String name) Возвращает терминал с указанным именем или нулем, если никакой такой терминал не существует.
List<CardTerminal>	list() Возвращает неподдающийся изменению список всех доступных терминалов.
abstract List<CardTerminal>	list(CardTerminals.State state) Возвращает неподдающийся изменению список всех терминалов, соответствующих указанное состояние.
void	waitForChange() Ожидает вставки карты или удаления в любом из терминалов этого объекта.
abstract boolean	waitForChange(long timeout) Ожидает вставки карты или удаления в любом из терминалов этого объекта или пока тайм-аут истекает.

Методы java.lang унаследованный от класса. Объект

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

Деталь конструктора

CardTerminals

protected CardTerminals()

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

Этого конструктора вызывают подклассы только. Приложение должно вызвать TerminalFactory.terminals (), чтобы получить объект CardTerminals.

Деталь метода

список

public List<CardTerminal> list()
                        throws CardException

Возвращает неподдающийся изменению список всех доступных терминалов.

Возвраты:

неподдающийся изменению список всех доступных терминалов.

Броски:

CardException - если работа карты перестала работать

список

public abstract List<CardTerminal> list(CardTerminals.State state)
                                 throws CardException

Возвращает неподдающийся изменению список всех терминалов, соответствующих указанное состояние.

Если состояние State.ALL, этот метод возвращает весь CardTerminals, инкапсулировавший этим объектом. Если состояние State.CARD_PRESENT или State.CARD_ABSENT, это возвращает весь CardTerminals, где карта в настоящий момент присутствует или отсутствует, соответственно.

Если состояние State.CARD_INSERTION или State.CARD_REMOVAL, это возвращает весь CardTerminals, для которого вставка (или удаление, соответственно) была обнаружена во время последней возможности к waitForChange (). Если waitForChange() не был вызван на этом объекте, CARD_INSERTION эквивалентно CARD_PRESENT и CARD_REMOVAL эквивалентно CARD_ABSENT. Для примера использования CARD_INSERTION, см. waitForChange().

Параметры:

state - государство

Возвраты:

неподдающийся изменению список всех терминалов, соответствующих указанный атрибут.

Броски:

NullPointerException - если attr является нулем

CardException - если работа карты перестала работать

getTerminal

public CardTerminal getTerminal(String name)

Возвращает терминал с указанным именем или нулем, если никакой такой терминал не существует.

Возвраты:

терминал с указанным именем или нулем, если никакой такой терминал не существует.

Броски:

NullPointerException - если имя является нулем

waitForChange

public void waitForChange()
                   throws CardException

Ожидает вставки карты или удаления в любом из терминалов этого объекта.

Этот вызов эквивалентен вызову waitForChange (0).

Броски:

IllegalStateException - если это CardTerminals объект не содержит терминалов

CardException - если работа карты перестала работать

waitForChange

public abstract boolean waitForChange(long timeout)
                               throws CardException

Ожидает вставки карты или удаления в любом из терминалов этого объекта или пока тайм-аут истекает.

Этот метод исследует каждый CardTerminal этого объекта. Если карта была вставлена в или удалена из CardTerminal начиная с предыдущего звонка waitForChange(), это сразу возвращается. Иначе, или если это - первый звонок waitForChange() на этом объекте это блокирует, пока карта не вставляется в или удаляется из CardTerminal.

Если timeout больше чем 0, возвраты метода после timeout миллисекунды, даже если нет никакого изменения в состоянии. В этом случае, этот метод возвраты false; иначе это возвращается true.

Этот метод часто используется в цикле в комбинации с list(State.CARD_INSERTION), например:

  TerminalFactory factory = ...;
  CardTerminals terminals = factory.terminals();
  while (true) {
      for (CardTerminal terminal : terminals.list(CARD_INSERTION)) {
          // examine Card in terminal, return if it matches
      }
      terminals.waitForChange();
  }

Параметры:

timeout - если положительный, блок для до timeout миллисекунды; если нуль, блок неопределенно; не должно быть отрицательным

Возвраты:

ложь, если метод возвращается из-за тайм-аута с истекшим сроком, истина иначе.

Броски:

IllegalStateException - если это CardTerminals объект не содержит терминалов

IllegalArgumentException - если тайм-аут отрицателен

CardException - если работа карты перестала работать