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

Interface WriteTransactionManager<T extends WriteTransactionManager<T>>

Type Parameters:
T - The type of the lowest level child object.
All Superinterfaces:
TransactionManager<T>
All Known Subinterfaces:
AsyncTransactionCreatorManager
public interface WriteTransactionManager<T extends WriteTransactionManager<T>> extends TransactionManager<T>
Transaction manager dedicated to "WRITE" operations.
Since:
0.2.0

  • Method Summary

    Modifier and Type
    Method
    Description
    T
    prepareWriteCounterCeiling(int counterNumber, int ceilingValue)
    Schedules the execution of a "Write Ceilings" command to write a single counter ceiling.
    T
    prepareWriteCounterConfiguration(int counterNumber, int ceilingValue, CounterIncrementAccess counterIncrementAccess)
    Schedules the execution of a "Write Ceilings" command to write a counter ceiling and its free incrementation configuration.

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

    processCommands

  • Method Details

    • prepareWriteCounterCeiling

      T prepareWriteCounterCeiling(int counterNumber, int ceilingValue)
      Schedules the execution of a "Write Ceilings" command to write a single counter ceiling.

      Warning: in the case of an asynchronous transaction the content of the LegacySam object will not be updated.

      Parameters:
      counterNumber - The number of the counter whose ceiling is to be written (in range [0..26]).
      ceilingValue - The desired value for the ceiling. The ceiling value is defined as a positive integer less than or equal to 16777210 (in hexadecimal: FFFFFAh).
      Returns:
      The current instance.
      Throws:
      IllegalArgumentException - If one of the provided argument is out of range.
      Since:
      0.2.0

    • prepareWriteCounterConfiguration

      T prepareWriteCounterConfiguration(int counterNumber, int ceilingValue, CounterIncrementAccess counterIncrementAccess)
      Schedules the execution of a "Write Ceilings" command to write a counter ceiling and its free incrementation configuration.

      Note: as this command generates the writing of a full record corresponding to 9 counters, it is necessary either to have read the status of the counters beforehand, or to have called this method for each of the 8 other counters of the same record. Otherwise, an exception will be raised when processing the command.

      Warning: in the case of an asynchronous transaction the content of the LegacySam object will not be updated.

      Parameters:
      counterNumber - The number of the counter whose ceiling is to be written (in range [0..26]).
      ceilingValue - The desired value for the ceiling. The ceiling value is defined as a positive integer less than or equal to 16777210 (in hexadecimal: FFFFFAh).
      counterIncrementAccess - The counter increment access mode.
      Returns:
      The current instance.
      Throws:
      IllegalArgumentException - If one of the provided argument is out of range.
      Since:
      0.2.0