Класс CardTerminals

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

Если state — State.ALL, этот метод возвращает все CardTerminals, содержащиеся в данном объекте. Если state — State.CARD_PRESENT или State.CARD_ABSENT, он возвращает все CardTerminals, в которых карта присутствует или отсутствует соответственно.

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

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

Этот метод проверяет каждый CardTerminal данного объекта. Если после предыдущего вызова waitForChange() в CardTerminal была вставлена или из него была извлечена карта, метод немедленно возвращает управление. В противном случае, а также при первом вызове 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();
 }