Package org.eclipse.keyple.core.plugin.spi.reader.observable.state.insertion

Interface CardInsertionWaiterBlockingSpi

public interface CardInsertionWaiterBlockingSpi

This SPI is specifically designed for plugins that handle card insertion synchronously. The plugin waits autonomously and indefinitely for the insertion of a card by implementing a waiting mechanism.

A typical example of readers conforming to this mode of operation are PC/SC type readers capable of performing RF polling without waiting for a command from the application.

Since:

2.2.0

Method Summary

Modifier and Type	Method	Description
void	stopWaitForCardInsertion()	Interrupts the waiting of a card insertion.
void	waitForCardInsertion()	Waits indefinitely for a card to be inserted.

Method Detail

waitForCardInsertion

void waitForCardInsertion()
                   throws ReaderIOException,
                          TaskCanceledException

Waits indefinitely for a card to be inserted.

This wait can be cancelled for an internal (for example timeout) or external reason (for example invocation of stopWaitForCardInsertion()) from an independent thread, in this case an exception is raised.

Throws:

ReaderIOException - If the communication with the reader has failed.

TaskCanceledException - If the task has been canceled and is no longer active

Since:

2.2.0

stopWaitForCardInsertion

void stopWaitForCardInsertion()

Interrupts the waiting of a card insertion.

Since:

2.2.0