Package org.eclipse.keypop.calypso.crypto.legacysam.transaction

Interface ReadTransactionManager<T extends ReadTransactionManager<T>>

Type Parameters:
T - The type of the lowest level child object.
All Superinterfaces:
TransactionManager<T>
All Known Subinterfaces:
FreeTransactionManager
public interface ReadTransactionManager<T extends ReadTransactionManager<T>> extends TransactionManager<T>
Transaction manager dedicated to "READ" operations.
Since:
0.1.0

  • Method Summary

    Modifier and Type
    Method
    Description
    T
    prepareReadAllCountersStatus()
    Schedules the execution of a "Read Event Counter" and "Read Ceiling" commands to read the status of all counters.
    T
    prepareReadCounterStatus(int counterNumber)
    Schedules the execution of a "Read Event Counter" and "Read Ceiling" commands to read the status of a counter.
    T
    prepareReadSamParameters()
    Schedules the execution of a "Read Parameters" command for the SAM.
    T
    prepareReadSystemKeyParameters(SystemKeyType systemKeyType)
    Schedules the execution of a "Read Key Parameters" command for a system key.
    T
    prepareReadWorkKeyParameters(byte kif, byte kvc)
    Schedules the execution of a "Read Key Parameters" command for a work key referenced by its KIF and KVC.
    T
    prepareReadWorkKeyParameters(int recordNumber)
    Schedules the execution of a "Read Key Parameters" command for a work key referenced by its record number.

    Methods inherited from interface org.eclipse.keypop.calypso.crypto.legacysam.transaction.TransactionManager

    processCommands

  • Method Details

    • prepareReadSamParameters

      T prepareReadSamParameters()
      Schedules the execution of a "Read Parameters" command for the SAM.

      Once this command is processed, the result is accessible with LegacySam.getSamParameters().

      Returns:
      The current instance.
      Since:
      0.7.0

    • prepareReadSystemKeyParameters

      T prepareReadSystemKeyParameters(SystemKeyType systemKeyType)
      Schedules the execution of a "Read Key Parameters" command for a system key.

      Once this command is processed, the result is accessible with LegacySam.getSystemKeyParameter(SystemKeyType).

      Parameters:
      systemKeyType - The type of system key.
      Returns:
      The current instance.
      Throws:
      IllegalArgumentException - If the provided argument is null.
      Since:
      0.2.0

    • prepareReadWorkKeyParameters

      T prepareReadWorkKeyParameters(int recordNumber)
      Schedules the execution of a "Read Key Parameters" command for a work key referenced by its record number.

      Once this command is processed, the result is accessible with LegacySam.getWorkKeyParameter(int).

      Parameters:
      recordNumber - The key record number (in range [1..126]).
      Returns:
      The current instance.
      Throws:
      IllegalArgumentException - If the provided record number is out of range.
      Since:
      0.7.0

    • prepareReadWorkKeyParameters

      T prepareReadWorkKeyParameters(byte kif, byte kvc)
      Schedules the execution of a "Read Key Parameters" command for a work key referenced by its KIF and KVC.

      Once this command is processed, the result is accessible with LegacySam.getWorkKeyParameter(byte, byte).

      Parameters:
      kif - The key KIF.
      kvc - The key KVC.
      Returns:
      The current instance.
      Since:
      0.7.0

    • prepareReadCounterStatus

      T prepareReadCounterStatus(int counterNumber)
      Schedules the execution of a "Read Event Counter" and "Read Ceiling" commands to read the status of a counter.

      Note: the status of each counter of the record to which the targeted counter belongs will be read. The number of commands actually transmitted to the SAM will be optimized when the TransactionManager.processCommands() method is executed.

      Parameters:
      counterNumber - The number of the counter whose status is to be read (in range [0..26]).
      Returns:
      The current instance.
      Throws:
      IllegalArgumentException - If the provided argument is out of range.
      Since:
      0.2.0

    • prepareReadAllCountersStatus

      T prepareReadAllCountersStatus()
      Schedules the execution of a "Read Event Counter" and "Read Ceiling" commands to read the status of all counters.
      Returns:
      The current instance.
      Since:
      0.2.0