Module io.helidon.transaction
Package io.helidon.transaction.spi

Interface TxLifeCycle

public interface TxLifeCycle
Transaction event listener service. Notifications from the transactions implemented in TxSupport interface. Implementation of this interface must be a service in service registry.

Each transaction method life-cycle contains exactly two events:

  • start when transaction method was started
  • end when transaction method was finished
Each new transaction life-cycle contains exactly two events:
  • begin when transaction was started
  • commit/rollback when transaction was finished
Each transaction must handle suspend and resume events to modify it's internal state appropriately. Supplied txIdentity values are managed by TxSupport implementation class and serve as unique transaction identifiers.

  • Method Summary

    Modifier and Type
    Method
    Description
    void
    begin(String txIdentity)
    New transaction was created.
    void
    commit(String txIdentity)
    Current transaction was completed.
    void
    end()
    Transaction method was finished.
    void
    resume(String txIdentity)
    Current transaction was resumed.
    void
    rollback(String txIdentity)
    Current transaction was rolled back.
    void
    start(String type)
    Transaction method was started.
    void
    suspend(String txIdentity)
    Current transaction was suspended.

  • Method Details

    • start

      void start(String type)
      Transaction method was started.
      Parameters:
      type - the type of the transaction API support, TxSupport.type(), passed from TxSupport implementation to the TxLifeCycle implementation

    • end

      void end()
      Transaction method was finished.

    • begin

      void begin(String txIdentity)
      New transaction was created.
      Parameters:
      txIdentity - transaction identifier

    • commit

      void commit(String txIdentity)
      Current transaction was completed.
      Parameters:
      txIdentity - transaction identifier

    • rollback

      void rollback(String txIdentity)
      Current transaction was rolled back.
      Parameters:
      txIdentity - transaction identifier

    • suspend

      void suspend(String txIdentity)
      Current transaction was suspended.
      Parameters:
      txIdentity - transaction identifier

    • resume

      void resume(String txIdentity)
      Current transaction was resumed.
      Parameters:
      txIdentity - transaction identifier