Seasar - DI Container with AOP -

Transaction Management

S2Tx provides the automatic transaction management by using Aspect for POJOs. You can use the transaction management that the EJB container offers without adding the code to POJOs. Showing as follows is a transaction attribute offered with S2tx.

Transaction Attributes

The column of the component is a name of Advice.

attribute	component	description
Required	j2ee.requiredTx	If the method's caller is already part of a transaction, it does not create a new transaction, but continues in the same transaction as its caller. If the caller is not in a transaction, a new transaction is created.
RequiresNew	j2ee.requiresNewTx	A new transaction is created always, regardless of the transactional state of the caller. If the caller was operating in a transaction, its transaction is suspended until the method completes.
Mandatory	j2ee.mandatoryTx	The method will not even start unless its caller is in a transaction. It will throw a Exception instead.

Example

Hoge.java

package examples.tx;

public interface Hoge {

    public void foo();
}

HogeImpl.java

package examples.tx;

public class HogeImpl implements Hoge {

    public void foo() {
        System.out.println("foo");
    }
}

HogeClient.dicon

<components>
    <include path="j2ee.dicon"/>
    <component class="examples.tx.HogeImpl">
        <aspect>j2ee.requiredTx</aspect>
    </component>
</components>

HogeClient.java

package examples.tx;

import org.seasar.framework.container.S2Container;
import org.seasar.framework.container.factory.S2ContainerFactory;

public class HogeClient {

    private static final String PATH =
        "examples/tx/HogeClient.dicon";

    public static void main(String[] args) {
        S2Container container = S2ContainerFactory.create(PATH);
        Hoge hoge = (Hoge) container.getComponent(Hoge.class);
        hoge.foo();
    }
}

Execution result

DEBUG 2004-03-14 18:05:18,402 [main] Transaction.begin()
foo
DEBUG 2004-03-14 18:05:18,432 [main] Transaction.commit()

J2ee.dicon file is in S2(under src directory). You only specify the component name of Advice for the body of the aspect tag. Thus, it is very easy to manage the transaction with POJO by using S2tx.