Chapter 4. Managing JTA transactions declaratively using the annotations

Procedure

• Define the scope of the transaction with the @Transactional annotation on the entry method:

  Example src/main/java/org/acme/SantaClauseService.java

  import javax.inject.Inject;
  import javax.enterprise.context.ApplicationScoped;
  import javax.transaction.Transactional;
  
  @ApplicationScoped
  public class SantaClausService {
  
      @Inject ChildDAO childDAO;
      @Inject SantaClausDAO santaDAO;
  
      @Transactional 

  1

  
      public void getAGiftFromSanta(Child child, String giftDescription) {
          // some transaction work
          Gift gift = childDAO.addToGiftList(child, giftDescription);
          if (gift == null) {
              throw new OMGGiftNotRecognizedException(); 

  2

  
          }
          else {
              santaDAO.addToSantaTodoList(gift);
          }
      }
  }

  Copy to Clipboard Toggle word wrap

  1

  @Transactional annotation defines your transaction boundaries and wraps this call within a transaction.

  2

  When a RuntimeException crosses the transaction boundaries, the transaction manager rolls back the transaction.

Prerequisites

• Have a Quarkus Maven project.

Procedure

• Use the @Transactional(dontRollbackOn=SomeException.class) to specify an exception that does not roll back the transaction:

  Example src/main/java/org/acme/SantaClauseService.java

  import javax.inject.Inject;
  import javax.enterprise.context.ApplicationScoped;
  import javax.transaction.Transactional;
  
  @ApplicationScoped
  public class SantaClausService {
  
      @Inject ChildDAO childDAO;
      @Inject SantaClausDAO santaDAO;
  
      @Transactional(dontRollbackOn=NonCriticalRuntimeException.class)
      public void getAGiftFromSanta(Child child, String giftDescription) throws Exception {
          Gift gift = childDAO.addToGiftList(child);
  
          // might throw a NonCriticalRuntimeException
          gift.setDescription(giftDescription);
  
          santaDAO.addToSantaTodoList(gift);
      }
  }

  Copy to Clipboard Toggle word wrap

  In this example, the transaction context is propagated to all calls nested in the @Transactional method (childDAO.addToGiftList() and santaDAO.addToSantaTodoList()). The transaction commits unless a runtime exception crosses the method boundary.

Procedure

• Use the timeout property of the @TransactionConfiguration to set the timeout in seconds:

  import javax.transaction.Transactional;
  
  @Transactional
  @TransactionConfiguration(timeout=40)
  public void getAGiftFromSanta(Child child, String giftDescription) {...}

  Copy to Clipboard Toggle word wrap