The Seasar Project

Configインタフェースを直接実装する場合

Configインタフェースの実装クラスは、publicなデフォルトコンストラクタ（引数なしのコンストラクタ）を持たねばいけません。 また、どのメソッドも nullを返してはいけません。

ここでは、代表的な設定項目について説明します。

データソースの設定

javax.sql.DataSourceを、getDataSourceメソッドで返します。 学習等でごく簡易的なデータアクセスを行うだけであれば、 SimpleDataSource を使用できます。

データソース名の設定

データソース名をあらわすStringを、getDataSourceNameメソッドで返します。 データソース名は、複数のデータソースを利用する環境で重要です。 データソース名はデータソースごとに自動生成される識別子を認識するために使用されます。 複数データソースを利用する場合は、それぞれ異なる名前を返すようにしてください。

RDBMS方言の設定

org.seasar.doma.jdbc.dialect.Dialectを、getDialectメソッドで返します。 DialectはRDBMSの方言をあらわすインタフェースです。 実装クラスには次のものがあります。

接続先のRDBMSにあわせて、実装クラスを選んでください。

ロガーの設定

org.seasar.doma.jdbc.JdbcLoggerを、getJdbcLoggerメソッドで返します。 JdbcLoggerはデータベースアクセスに関するログを扱うインタフェースです。 実装クラスには次のものがあります。

• org.seasar.doma.jdbc.UtilLoggingJdbcLogger

UtilLoggingJdbcLoggerは、java.util.loggingのロガーを使用してログ出力する実装です。 多くの場合、アプリケーションで使用するcommons-loggingなどのロガーに出力する実装クラスを別途作ったほうがよいでしょう。

SQLファイルのリポジトリの設定

org.seasar.doma.jdbc.SqlFileRepositoryを、getSqlFileRepositoryメソッドで返します。 SqlFileRepositoryはSQLファイルのリポジトリを扱うインタフェースです。 実装クラスには次のものがあります。

• org.seasar.doma.jdbc.GreedyCacheSqlFileRepository
• org.seasar.doma.jdbc.NoCacheSqlFileRepository

GreedyCacheSqlFileRepositoryは、読み込んだSQLファイルの内容をパースし、その結果をメモリが許す限り最大限にキャッシュします。 NoCacheSqlFileRepositoryは、一切キャッシュを行いません。毎回、SQLファイルからSQLを読み取りパースします。

メモリの利用に厳しい制限がある環境や、扱うSQLファイルが膨大にある環境では、適切なキャッシュアルゴリズムをもった実装クラスを作成し使用してください。

REQUIRES_NEWの属性をもつトランザクションを制御するための設定

org.seasar.doma.jdbc.RequiresNewControllerを、getRequiresNewControllerメソッドで返します。 RequiresNewControllerはREQUIRES_NEW の属性をもつトランザクションを制御するインタフェースです。 実装クラスには次のものがあります。

• org.seasar.doma.jdbc.NullRequiresNewController

NullRequiresNewControllerは、実質的になにも行いません。

REQUIRES_NEWの属性をもつトランザクションの最適な制御方法は、環境ごとに異なるため、適切な実装クラスを作成し使用してください。 ただし、このインタフェースは、@TableGeneratorで、識別子を自動生成する際にしか使われません。 @TableGeneratorを利用しない場合は、NullRequiresNewControllerを使用してもかまいません。 また、@TableGeneratorを利用する場合であっても、識別子を採番するための更新ロックが問題にならない程度のトランザクション数であれば、NullRequiresNewControllerを使用してもかまいません。

クラスの扱いに関する設定

org.seasar.doma.jdbc.ClassHelperを、getClassHelperメソッドで返します。 ClassHelperはクラスの扱いに関してアプリケーションサーバやフレームワークの差異を抽象化するインタフェースです。 実装クラスには次のものがあります。

• org.seasar.doma.jdbc.DefaultClassHelper

DefaultClassHelperは、java.lang.Class.forName(name) を用いてクラスをロードします。

例外メッセージに含めるSQLのタイプの設定

例外メッセージに含めるSQLのタイプをあらわす、org.seasar.doma.jdbc.ExceptionSqlLogTypeをgetExceptionSqlLogTypeメソッドで返します。 この値は、UniqueConstraintExceptionなどの例外にどのような形式のSQLを含めるかを決定します。

クエリタイムアウト（秒）の設定

クエリタイムアウト（秒）をあらわす、intをgetQueryTimeoutメソッドで返します。 この値は、Daoインタフェースの@Delegate以外の問い合わせで使用されます。 クエリタイムアウト（秒）はjava.sql.Statement.setQueryTimeout(int)に渡されます。

SELECT時のフェッチサイズの設定

SELECT時のフェッチサイズをあらわす、intをgetFetchSizeメソッドで返します。 この値は、Daoインタフェースの@Selectが注釈されたメソッドの実行で使用されます。 フェッチサイズはjava.sql.Statement.setFetchSize(int)に渡されます。

SELECT時の最大行数の設定

SELECT時の最大行数をあらわす、intをgetMaxRowsメソッドで返します。 この値は、Daoインタフェースの@Selectが注釈されたメソッドの実行で使用されます。 最大行数はjava.sql.Statement.setMaxRows(int)に渡されます。

バッチ更新のバッチサイズの設定

バッチサイズをあらわす、intをgetBatchSizeメソッドで返します。 この値は、Daoインタフェースの@BatchUpdateなどが注釈されたバッチ系のメソッドの実行に使用されます。

Entityに定義が存在しないカラムが結果セットに含まれていた場合に無視するかどうか

無視するかどうかをあらわすbooleanをignoreUnknownColumnメソッドで返します。 trueを返すと、org.seasar.doma.jdbc.MappedPropertyNotFoundExceptionのスローを抑制できます。 この値は、Daoインタフェースの@Selectが注釈されたメソッドの実行に使用されます。

DomaAbstractConfigを継承する場合

Configインタフェースを直接実装してもかまいませんが、 いくつかのデフォルトの設定をもつ DomaAbstractConfigを継承するのが簡単です。 最初は、このクラスを使い、慣れてきたらConfigインタフェースを直接実装するのがよいでしょう。

public class AppConfig extends DomaAbstractConfig {
    ...
}

DomaAbstractConfigを利用する場合、必要な設定は次の3つです。

• データソースの設定
• データソース名の設定
• RDBMS方言の設定

上記以外の設定については、デフォルトの実装やデフォルトの値が使用されます。

JDBCドライバの設定

通常、クラスパスが通っていれば、JDBC 4.0 ドライバはサービスプロバイダメカニズムにより自動でロードされます。

しかし、たとえばTomcatでは、WEB-INF/libの下のJDBCドライバを自動でロードしません。 自動でロードされない条件下では、Class.forNameを使ってJDBCドライバをロードしてください。

Class.forNameを実行する場所は、設定クラスのstatic初期化子が1つの候補です。 たとえば、H2 DatabaseのJDBCドライバを明示的にロードする場合には次のようにします。

public class AppConfig extends DomaAbstractConfig {
    static {
        try {
            Class.forName("org.h2.Driver");
        } catch (ClassNotFoundException e) {
            throw new RuntimeException(e);
        }
    }
    ...
}

設定クラスのインスタンスのインジェクション

Daoの実装クラスのインスタンスに設定クラスのインスタンスをインジェクションするには、 @Daoのconfig要素に何も指定しないでください。 この場合、Config型のインスタンスを受け取るコンストラクタがDaoの実装クラスに生成されます。 コンストラクタインジェクションをサポートするDIコンテナであれば、設定ファイルなどによりインジェクションが可能です。

@Dao
public interface EmployeeDao {
    ...
}

上のインタフェースに対する実装クラスのソースコードは、aptにより次のように生成されます。

public class EmployeeDaoImpl extends org.seasar.doma.jdbc.DomaAbstractDao implements example.EmployeeDao {
    public EmployeeDaoImpl(org.seasar.doma.jdbc.Config config) {
        super(config);
    }
    ...
}

aptにより生成されるソースコードに対するアノテーションの注釈

@AnnotateWithを使用することで、インジェクションのためのアノテーションをDaoの実装クラスのソースコードに注釈できます。 これにより、DIコンテナがサポートしていれば、アノテーションによるインジェクションも可能になります。

たとえば、 Guiceのアノテーションを注釈するには次のように記述します。

@Dao
@AnnotateWith(annotations = {
        @Annotation(target = AnnotationTarget.CONSTRUCTOR, type = Inject.class),
        @Annotation(target = AnnotationTarget.CONSTRUCTOR_PARAMETER, type = Named.class, elements = "\"sales\"") })
public interface EmployeeDao {
    ...
}

上のインタフェースに対する実装クラスのソースコードは、aptにより次のように生成されます。 コンストラクタとコンストラクタのパラメータにアノテーションが注釈されていることに注目してください。

public class EmployeeDaoImpl extends org.seasar.doma.jdbc.DomaAbstractDao implements example.EmployeeDao {
    @com.google.inject.Inject()
    public EmployeeDaoImpl(@com.google.inject.name.Named("sales") org.seasar.doma.jdbc.Config config) {
        super(config);
    }
    ...
}

@AnnotateWithを任意のアノテーションに注釈し、そのアノテーションをDaoインタフェースに注釈することも可能です。 たとえば、@InjectConfigというアノテーションに@AnnotateWithを注釈するとします。

@AnnotateWith(annotations = {
        @Annotation(target = AnnotationTarget.CONSTRUCTOR, type = Inject.class),
        @Annotation(target = AnnotationTarget.CONSTRUCTOR_PARAMETER, type = Named.class, elements = "\"sales\"") })
public @interface InjectConfig {
    ...
}

@InjectConfigをDaoインタフェースに注釈すれば、@AnnotateWithを直接Daoインタフェースに注釈しているのと同じ効果が得られます。

@Dao
@InjectConfig
public interface EmployeeDao {
    ...
}