• S2Unit
• Example

S2Unit

S2では、コンテナを使った開発のテストを楽しくおこなえるようにテスティングフレームワークが組み込まれています。JUnitを拡張しています。主な機能は以下のとおりです。

• テストメソッド(testXxx)ごとに自動的にS2Containerを作成します。
• S2Containerに対するregister(),getComponent(),include()が用意されています。
• TestCaseのstaticでもないfinalでもないフィールドがあり、その名前からアンダースコア(_)を除いた名前のコンポーネントがコンテナに存在すれば自動的にセットされます。
• TestCaseのフィールドにインターフェース型の変数が定義されていればS2Containerから取り出して自動的にセットされます。
• テストメソッドが終わると自動セットされた値は自動的にクリア(nullをセット)されます。
• テストメソッド(testXxx)に対応するsetUpXxx(),tearDownXxx()を定義しておくと、setUp()の後、tearDown()の前に自動的に呼び出されます。個別のテストメソッドごとの初期化・終了処理を簡単に行えるようになります。
• setUpAfterInit()を定義することでコンテナの初期化が終わった後に、コンポーネントをフィールドに設定する処理を手動で行うこともできます。フィールドに値が既にセットされている場合は、フィールドの自動バインド処理はスキップされます。
• テストメソッド(testXxx)に対応するsetUpAfterInitXxx()を定義しておくと、setUpAfterInit()の後に自動的に呼び出されます。個別のテストメソッドごとのフィールドセットを簡単に行えるようになります。

Example

ここでは、トランザクションの自動制御をテストするRequiredAdviceTestを見てみましょう。

TxBean.java

package test.org.seasar.extension.tx;

import javax.transaction.SystemException;

public interface TxBean {

    public boolean hasTransaction() throws SystemException;
}

TxBeanImpl.java

package test.org.seasar.extension.tx;

import javax.transaction.Status;
import javax.transaction.SystemException;
import javax.transaction.TransactionManager;

public class TxBeanImpl implements TxBean {

    private TransactionManager tm_;

    public TxBeanImpl(TransactionManager tm) {
        tm_ = tm;
    }

    public boolean hasTransaction() throws SystemException {
        System.out.println(tm_.getTransaction());
        return tm_.getStatus() != Status.STATUS_NO_TRANSACTION;
    }
}

RequiredAdviceTest-config.xml

<components>
    <component class="org.seasar.extension.jta.TransactionManagerImpl"/>
    <component name="tx/required"
        class="org.seasar.extension.tx.RequiredAdvice"/>
    <component class="test.org.seasar.extension.tx.TxBeanImpl">
        <aspect>tx/required</aspect>
    </component>
</components>

RequiredAdviceTest.java

package test.org.seasar.extension.tx;

import javax.transaction.Status;
import javax.transaction.TransactionManager;

import junit.framework.Test;
import junit.framework.TestSuite;

import org.seasar.extension.unit.S2TestCase;

public class RequiredAdviceTest extends S2TestCase {

    private static final String PATH =
        "test/org/seasar/extension/tx/RequiredAdviceTest-config.xml";
    private TxBean txBean_;
    private TransactionManager tm_;

    public RequiredAdviceTest(String name) {
        super(name);
    }

    public void testInvoke() throws Exception {
        assertEquals("1", true, txBean_.hasTransaction());
        assertEquals("2", Status.STATUS_NO_TRANSACTION, tm_.getStatus());
    }
    
    public void testInvoke2() throws Exception {
        tm_.begin();
        assertEquals("1", true, txBean_.hasTransaction());
        assertEquals("2", Status.STATUS_ACTIVE, tm_.getStatus());
        tm_.commit();
    }

    protected void setUp() throws Exception {
        include(PATH);
    }

    protected void tearDown() throws Exception {
    }

    public static Test suite() {
        return new TestSuite(RequiredAdviceTest.class);
    }

    public static void main(String[] args) {
        junit.textui.TestRunner.main(
            new String[] { RequiredAdviceTest.class.getName()});
    }
}