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 Detail

      • 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:
        java.lang.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:
        java.lang.IllegalArgumentException - If one of the provided argument is out of range.
        Since:
        0.2.0