# Jakarta Transactions

Jakarta Transactions (JTA), precedentemente nota come Java Transaction API), è una delle API offerte dalla Jakarta EE (Java Enterprise Edition), ed ha lo scopo di abilitare delle transazioni distribuite, eseguite attraverso risorse X/Open XA multiple in un ambiente Java. JTA è una specifica sviluppata sotto le direttive del Java Community Process come JSR 907. La JTA mette a disposizione:
* una demarcazione dei confini delle transazioni.
* delle X/Open XA API che permettono alle risorse di partecipare alle transazioni.

## Architettura X/Open XA

In questa architettura, un Transaction Manager o un Transaction Processing monitor (TP monitor) coordina le transazioni attraverso le risorse multiple come database o code di messaggi. Ogni risorsa ha il suo Resource Manager. Il Resource Manager, tipicamente, utilizza le proprie API per manipolare le risorse, ad esempio far lavorare le API JDBC con i database relazionali. Il Resource Manager permette, inoltre, che un TP monitor coordini una transazione distribuita tra se stesso e altri Resource Manager. Finalmente, entra in azione l'applicazione che comunica con il TP monitor per eseguire le tipiche operazioni sulle transazioni, come l'avvio (begin), il commit e il rollback. L'applicazione comunica anche con le risorse individuali per modificarle, usando le proprie API.

## Implementazione della JTA nell'architettura X/Open XA

La JTA API consiste in una serie di classi suddivise nei due seguenti package Java:
* javax.transaction
* javax.transaction.xa
La JTA è fabbricata sul modello dell'architettura X/Open XA, ma definisce due differenti API per il demarcamento dei confini delle transazioni. Si distingue tra un application server come un server EJB e un application component. Fornisce un'interfaccia javax.transaction.TransactionManager, che è usato dall'application server vero e proprio per fare dei begin, dei commit e dei rollback delle transazioni. Fornisce inoltre un'interfaccia differente, la javax.transaction.UserTransaction, che è usata dal codice generico di un client, come una servlet o un EJB, per gestire le transazioni.
L'architettura JTA richiede che ogni Resource Manager implementi l'interfaccia javax.transaction.xa.XAResource in modo da essere gestita dal TP monitor. Come spiegato in precedenza, ogni risorsa avrà la propria API specifica, per esempio:
* I database relazionali usano JDBC
* I servizi di messaggistica usano JMS
* Le risorse EIS (Enterprise Information System) generalizzate usano la Java EE Connector Architecture.

## Java Transaction API

La Java Transaction API consiste di tre elementi: un'interfaccia di demarcamento delle transazioni ad alto livello nell'applicazione, un'interfaccia Transaction Manager sempre ad alto livello, e una mappatura Java standard del protocollo X/Open XA destinato ad un Resource Manager transazionale.

### Interfaccia UserTransaction

L'interfaccia javax.transaction.UserTransaction fornisce all'applicazione l'abilità di controllare i limiti delle transazioni in modo programmatico. Questa interfaccia può essere usata dai programmi Java lato client o dai bean EJB.
Il metodo begin inizia una transazione globale e la associa con il thread in chiamata. L'associazione transaction-to-thread è gestita in modo trasparente dal Transaction Manager.
Non è richiesto un supporto per le transazioni annidate. Il metodo begin lancia l'eccezione NotSupportedException quando il thread è già associato con una transazione e l'implementazione del transaction manager non supporta le transazioni annidate.
Il contesto in cui si propaga la transazione tra applicazioni è assegnato dalle implementazioni in background dei transaction manager sulle macchine client e server. Il formato del contesto usato per la propagazione è dipendente dal protocollo e deve essere negoziato tra gli host client e server. Per esempio, se il transaction manager è un'implementazione della specifica JTS, userà quello specificato in CORBA OTS 1.1. La propagazione delle transazioni è trasparente all'applicazione.

### Annotazione @Transactional

L'annotazione javax.transaction.Transactional fornisce all'applicazione l'abilità di controllare i limiti delle transazioni in modo dichiarativo. Questa annotazione può essere applicata ad ogni classe che la Java EE definisce come managed bean (che include i CDI managed bean).
L'esempio di codice sottostante illustra l'uso di @Transactional in un ambito dove si richiedono i CDI managed bean:
Il comportamento della transazione può essere configurato con un attributo nell'annotazione.

### Annotazione @TransactionScoped

L'annotazione javax.transaction.TransactionScoped fornisce all'applicazione la possibilità di dichiarare che, l'ambito durante il quale un Bean vive, è legato al tempo in cui una certa transazione è attiva.
L'esempio di codice sottostante mostra l'uso di @TransactionScoped in un ambito dove si richiedono i CDI managed bean:
Se il metodo foo è chiamato per primo su un'istanza gestita di ExampleBean e successivamente viene chiamato il metodo bar, il numero stampato a video sarà 0 e non 1. Questo perché ogni metodo ha la propria transazione e perciò anche la propria istanza di TxScopedBean. Il numero 1 che viene assegnato durante la chiamato a foo non sarà quindi visibile durante la chiamata a bar.

## Supporto di UserTransaction nei server EJB

I server EJB sono richiesti per supportare l'interfaccia UserTransaction per l'uso dagli EJB Bean con il valore BEAN nell'annotazione javax.ejb.TransactionManagement (questa è chiamata bean-managed transaction o BMT). L'interfaccia UserTransaction è esposta ai componenti EJB attraverso sia con l'interfaccia EJBContext che usa il metodo getUserTransaction, sia direttamente usando la generica annotazione @Resource. Pertanto, un'applicazione EJB non si interfaccia direttamente con il Transaction Manager per la demarcazione delle transazioni; invece, gli EJB Bean contano sul server EJB per fornire supporto per tutto il suo lavoro transazionale, come definito nell'Enterprise JavaBeans Specification. (L'interazione sottostante tra EJB Server e TM è trasparente all'applicazione; l'onere di implementare la gestione delle transazioni è sul EJB container e sul server provider.)
Il codice di esempio sottostante mostra l'uso di UserTransaction attraverso le transazioni bean-managed in una session EJB Bean:
In alternativa, la UserTransaction può essere ottenuta dal SessionContext:
Bisogna notare che nell'esempio se l'annotazione @TransactionManagement(BEAN) fosse stata omessa, una transazione JTA sarebbe iniziata automaticamente ogni volta che viene chiamato foo e, sempre automaticamente, avverrebbe un commit e un rollback quando si esce da foo. L'uso di una UserTransaction non è quindi necessario nella programmazione EJB, ma può essere richiesto nel codice più specializzato.

## Supporto di UserTransaction in JNDI

UserTransaction è disponibile sotto java:comp/UserTransaction, se nell'ambiente è installata un'implementazione della JTA.

## Implementazioni Open source per la JTA

Alcune implementazioni open source per la JTA sono elencate qui di seguito (aggiornato a settembre 2010):
* Narayana
* Atomikos TransactionsEssentials
* Bitronix JTA