Package org.eclipse.keypop.reader.transaction.spi

Interface CardTransactionManager<T extends CardTransactionManager<T>>

Type Parameters:
T - The type of the lowest level child object.
public interface CardTransactionManager<T extends CardTransactionManager<T>>
Contains operations common to all card transactions.

To exchange data with the card, it is first necessary to prepare the commands to be transmitted to the card and then to process the prepared commands.

The card commands preparation step makes it possible to group commands together to minimize network data exchanges (especially useful in a distributed architecture).

The SmartCard object registered with the manager is updated during the transaction after each data exchange with the card.

Since:
2.1.0

  • Method Summary

    Modifier and Type
    Method
    Description
    T
    processCommands(ChannelControl channelControl)
    Processes all previously prepared commands and closes the physical channel if requested.

  • Method Details

    • processCommands

      T processCommands(ChannelControl channelControl)
      Processes all previously prepared commands and closes the physical channel if requested.

      All APDUs corresponding to the prepared commands are sent to the card, their responses are retrieved and used to update the SmartCard associated with the transaction.

      For write commands, the SmartCard is updated only when the command is successful.

      The process is interrupted at the first failed command.

      Parameters:
      channelControl - Policy for managing the physical channel after executing commands to the card.
      Returns:
      The current instance.
      Throws:
      ReaderCommunicationException - If a communication error with the card reader occurs.
      CardCommunicationException - If a communication error with the card occurs.
      InvalidCardResponseException - If a command returns an unexpected status.
      Since:
      2.1.0