ch.emf.dao.transactions

Class Transaction

java.lang.Object

ch.emf.dao.transactions.Transaction

public class Transaction
extends Object

Gestion des transactions. Cette classe est instanciée automatiquement au moment de la connexion JPA.

Le mode par défaut est le mode "autocommit" où chaque modification de type CRUD sera validée automatiquement et immédiatement dans la BD.
Exemple d'utilisation interne pour un "create" :

   try {
     em.persist(p);
     tr.commit();
   } catch (Exception ex1) {
     try {
       tr.rollback();
     } catch (Exception ex2) {
       ...
     }
   }
 

Il est possible de lancer des transactions manuelles comme suit :

   Transaction tr = JpaConnection.getInstance().getTransaction();
   ...
   ...
   try {
      tr.beginManualTransaction();
      for ... {
        // operation CRUD
      }
      tr.commitManualTransaction();
   } catch (Exception ex1) {
       try {
         tr.rollbackManualTransaction();
       } catch (Exception ex2) {
         Logger.error(clazz, ex2.getMessage());
       }
   } finally {
     tr.finishManualTransaction();
   }
 

Author:

P.-A. mettraux / J.-C. Stritt

Opt:

nodefillcolor LemonChiffon, all

Constructor Summary

Constructors

Constructor and Description
Transaction(javax.persistence.EntityTransaction et)
Transaction(UserTransaction ut)

Method Summary

Modifier and Type	Method and Description
void	begin() Débute une transaction.
void	beginManualTransaction() Débute une transaction manuelle en mettant l'auto-commit à false.
void	commit() Validation automatique d'une transaction dans JpaDao si l'autocommit est à true.
void	commitManualTransaction() Validation manuelle d'une transaction si l'autocommit est à false.
void	finishManualTransaction() Termine une transaction manuelle en remettant l'auto-commit à true.
boolean	isActive() Permet de connaitre l'état d'une transaction.
boolean	isAutoCommit() Retourne vrai si on est en mode "autocommit".
void	rollback() Annulation automatique d'une transaction dans JpaDao si l'autocommit est à true.
void	rollbackManualTransaction() Annulation manuelle d'une transaction si l'autocommit est à false.
void	setAutoCommit(boolean on) Activation ou désactivation de la validation automatique de chaque modification de donnée.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Transaction

public Transaction(javax.persistence.EntityTransaction et)

Transaction

public Transaction(UserTransaction ut)

Method Detail

isActive

public boolean isActive()

Permet de connaitre l'état d'une transaction.

Returns:

true si une transaction est engagée

setAutoCommit

public void setAutoCommit(boolean on)

Activation ou désactivation de la validation automatique de chaque modification de donnée.

Parameters:

on - : indique par une valeur true ou false si l'on désire l'autocommit

isAutoCommit

public boolean isAutoCommit()

Retourne vrai si on est en mode "autocommit".

Returns:

TRUE si autocommit = VRAI

begin

public void begin()
           throws Exception

Débute une transaction. Utile seulement en mode autocommmit=false ce qui est le cas pour un serveur d'applications tel que GlassFish qui ne supporte pas qu'une transaction soit commencée sans être terminée (ce qui exclue le mode autocommit=true).

Throws:

Exception - l'exception remontée au niveau supérieur

commit

public void commit()
            throws Exception

Validation automatique d'une transaction dans JpaDao si l'autocommit est à true.

Throws:

Exception - l'exception remontée au niveau supérieur

rollback

public void rollback()
              throws Exception

Annulation automatique d'une transaction dans JpaDao si l'autocommit est à true.

Throws:

Exception - l'exception remontée au niveau supérieur

beginManualTransaction

public void beginManualTransaction()

Débute une transaction manuelle en mettant l'auto-commit à false.

finishManualTransaction

public void finishManualTransaction()

Termine une transaction manuelle en remettant l'auto-commit à true.

commitManualTransaction

public void commitManualTransaction()
                             throws Exception

Validation manuelle d'une transaction si l'autocommit est à false.

Throws:

Exception - l'exception remontée au niveau supérieur

rollbackManualTransaction

public void rollbackManualTransaction()
                               throws Exception

Annulation manuelle d'une transaction si l'autocommit est à false.

Throws:

Exception - l'exception remontée au niveau supérieur