selectableDatasource

• 冗長化複数DB
• selectableDatasourceの使い方
  • Dicon構造
  • ベタな実装方法
  • 現実的な実装方法
  • トランザクションは独立
  • 更新処理の混在に注意
• よりシンプルにコールバックで
• デフォルトのDBの設定
• 更新処理フックでMasterDBに
• Exampleのススメ

冗長化複数DB

冗長化複数DBの構成の際に利用する機能です。DBアクセスの処理の際に、接続する Datasource を動的に切り替えて負荷分散などを実現する仕組みが seasar(s2Container) には備わっています。DBFluteで冗長化複数DBを実現する場合も、その機能を活用すると良いでしょう。

典型的な例として、MasterDB と slaveDB と二つ以上のDBを用意し、更新処理は全て MasterDB で行い、検索処理の一部を(更新内容が同期された) slaveDB で行うというパターンがあります。 MasterDB に障害が発生した場合は slaveDB が MasterDB となってサービスが継続できます。

ここでは、Master, slave を想定した構成を前提に説明を行いますが、他のパターンでも応用できます。

selectableDatasourceの使い方

MasterDB を masterDatasource、slaveDB を slaveDatasource という名前で定義すると仮定します(以降、全ての例において同様)。

Dicon構造

jdbc.dicon で定義している datasource コンポーネントの実体を、selectableDatasourceProxy クラスに変更し、二つ(もしくは三つ以上)の DB に対する jdbc-xxx.dicon を作成して include します。

jdbc.dicon には、selectableDatasourceProxy の datasource コンポーネントだけを定義し、それぞれの jdbc-xxx.dicon では、それぞれの DB に対応した "もともとの jdbc.dicon の構成" を定義します。

jdbc.dicon

selectableDatasourceProxy の datasource コンポーネント

jdbc-master.dicon, jdbc-slave.dicon への include

jta.dicon, jdbc-extension.dicon への include

jdbc-master.dicon

MasterDB のための xaDatasource, connectionPool

DatasourceImpl の masterDatasource コンポーネント

jta.dicon, jdbc-extension.dicon への include

jdbc-slave.dicon

slaveDB のための xaDatasource, connectionPool

DatasourceImpl の slaveDatasource コンポーネント

jta.dicon, jdbc-extension.dicon への include

xxxDatasource の xxx 部分が切り替え先DBを識別する DatasourceName となります。

図 : selectableDatasourceのDicon構造

ベタな実装方法

非常に単純でベタな実装方法は以下のようになります。

e.g. selectableDatasource のベタな実装方法 @Java
protected MemberBhv memberBhv;
protected DatasourceFactory datasourceFactory; // injected

public void fooAndBar() {
    datasourceFactory.setselectableDatasourceName("master");
    Member member = ...
    ... 
    memberBhv.update(member); // master の会員を更新

    datasourceFactory.setselectableDatasourceName("slave");
    MemberCB cb = ...
    ...
    ... = memberBhv.select(cb); // slave の会員を検索
}

DatasourceFactory は、seasar に組み込まれている jdbc-extension.dicon にて定義されています。 デフォルトでは何の Datasource とも関連付いていないため、DBアクセスする前は必ず何かしらの DB を指定する必要があります。

通常、このように利用することはあり得ません。 仕組みをわかりやすく理解するための Example です。

現実的な実装方法

現実的には、DBアクセスのたびに指定するのはあり得ない感じなので、Interceptor などの共通処理で切り替えます。デフォルトのDBの設定と切り替えのロジックを実装します。

例えば、通常は MasterDB の方にDBアクセスし、slaveDB を示すアノテーションがメソッドに定義されていたら、そのメソッド内だけ slaveDB にDBアクセスするというやり方が考えられます。

e.g. selectableDatasource の現実的な実装方法 (Interceptor) @Java
protected DatasourceFactory datasourceFactory; // injected

public Object invoke(MethodInvocation invocation) throws Throwable {
    string current = datasourceFactory.getselectableDatasourceName();
    try {
        string selectableName = getselectableDatasourceName();
        datasourceFactory.setselectableDatasourceName(selectableName);
        return invocation.proceed();
    } finally {
        datasourceFactory.setselectableDatasourceName(current);
    }
}

protected string getselectableDatasourceName(MethodInvocation invocation) {
    if (hasslaveAnnotation(invocation)) {
        return "slave";
    } else {
        return "master"; // MasterDB as default
    }
}

protected boolean hasslaveAnnotation(MethodInvocation invocation) {
    // メソッドに slaveDB を示すアノテーションが付いていたら true
    // (そのアノテーションは自作)
    return ...
}

e.g. selectableDatasource の現実的な実装方法 (Logic) @Java
protected MemberBhv memberBhv;
protected PurchaseBhv purchaseBhv;

@slaveDB
public void selectHeavy() { // このメソッド内のDBアクセスは全て slaveDB へ
    MemberCB cb = ...
    ... = memberBhv.selectList(cb);
    PurchaseCB cb = ...
    ... = purchaseBhv.selectList(cb);
}

この Interceptor は、DBアクセスをする可能性のあるプロセスの入り口となるコンポーネント、 および、DBアクセス先を切り替える可能性のあるコンポーネントに関連付けます。例えば、Page, Action, service, Logicクラスなどです。 バリデーションやバリデーションエラーなどの処理の中でDBアクセスをする場合は、それらメソッドにも関連付ける必要があります。

この(独自の) Interceptor は、例えば s2ClassBuilder で aop.dicon にコンポーネントを追加できる aop++.dicon に定義し、customizer.dicon にてどのコンポーネントに定義するか関連付けます。

また、Interceptor は通常 public メソッドにのみ動作しますので、間違えて protected メソッドに付けないようにディベロッパーに通知しておく必要があります。

トランザクションは独立

Master と slave のようなレプリケーション構成の場合は、そもそも更新処理を Master に集中させないといけないためあまり気にする必要はありませんが、トランザクションはそれぞれのDBごとに独立したものになります。 そのことだけはしっかり理解しておいた方が良いでしょう。

更新処理の混在に注意

Master と slave のようなレプリケーション構成の場合は、slave の方で更新処理が走らないように注意する必要があります。ここでの例で言えば、slaveDB アノテーションが付与されているメソッド内で insert() や upadte() を呼び出してはいけません。

slave への接続を ReadOnly にしておけばエラーで検知することができますが、 できるだけ更新処理の混在が発生しないようにしたい場合は、シンプルなコールバック方式や更新処理フックなどを利用すると良いでしょう。

よりシンプルにコールバックで

Master と slave のようなレプリケーション構成の場合は、slave の方で更新処理が走らないように注意する必要があります。ここでの例で言えば、slaveDB アノテーションが付与されているメソッド内で insert() や upadte() を呼び出してはいけません。 また、トランザクションはそれぞれ独立したものになります。

もし、アノテーション方式だとちょっと更新処理の紛れが怖いというのであれば、先ほどの Interceptor に加えて、コールバック処理でピンポイントで指定できるようにするのも一つの選択肢です。 このとき、Interceptor でアノテーション方式を有効にするか否かは実際に利用するかどうかと相談ですが、 やり方が何通りもあると混乱しがちなので、この場合はアノテーション方式は適用しない方が良いでしょう。 (ちなみに、その場合でもデフォルトのDBを設定するために Interceptor 自体は必要です)

e.g. slaveDBへアクセスするユーテリィティの導入 @Java
@Resource
protected slaveDBAccessor slaveDBAccessor;

public void foo() {
    final MemberCB cb = new MemberCB();
    cb.setupselect...
    cb.query().set...
    List<Member> memberList = slaveDBAccessor.accessFixedly(new slaveDBCallback() {
        public List<Member> callback() {
            return memberBhv.selectList(cb);
        }
    });
}

この例では、slaveDBAccessor を jdbc.dicon で slaveDBAccessor という名前でコンポーネントとして登録し、access() メソッドの中で datasourceFactory に対して slaveDB に設定をする実装を想定しています。(コールバックが終わったら元のDBへ戻します)

デフォルトのDBの設定

先ほどの slaveDBAccessor を利用してアノテーション方式を適用しない場合でも、デフォルトのDBを指定するために Interceptor は必要です。ただそれだけのための Interceptor を作成して定義するのに少々ためらうのであれば、selectableDatasourceProxy を継承してデフォルトのDB(通常は MasterDB)を指定すれば、その Interceptor なしで実現できます。

selectableDatasourceProxy の getDatasource() をオーバーライドし、datasourceFactory から DatasourceName が取得できなかったときに、デフォルトの DatasourceName を利用して Datasource を戻すように修正します。このクラスを jdbc.dicon に代わりに定義します。

e.g. selectableDatasourceProxy を継承してデフォルトのDBを設定 @Java
public class AppselectableDatasourceProxy extends selectableDatasourceProxy {

    @Override
    public Datasource getDatasource() {
        string datasourceName = datasourceFactory.getselectableDatasourceName();
        if (datasourceName == null) {
            datasourceName = "masterDatasource"; // as default
        }
        return datasourceFactory.getDatasource(datasourceName);
    }
}

更新処理フックでMasterDBに

アノテーション方式、コールバック方式に限らず、とにかく紛れた更新処理が万が一でも slaveDB に向かないような "すべり止め" 的な仕組みを施すと良いでしょう。

CallbackContext の BehaviorCommandHook を利用することで、DBFluteの更新処理に対して強制的に MasterDB に変更する処理をフックさせることができます。

e.g. BehaviorCommandHook を使って更新処理を強制的に MasterDB に @Java
...
// BehaviorCommandHook を設定
CallbackContext.setBehaviorCommandHookOnThread(new BehaviorCommandHook() {
    protected string currentName;
    protected boolean forcedset;

    public void hookBefore(BehaviorCommandMeta meta) {
        if (needsForcedMasterCommand(meta)) {
            final string masterDB = "master";
            currentName = datasourceFactory.getselectableDatasourceName();
            if (!masterDB.equals(currentName)) {
                if (_log.isDebugEnabled()) {
                    _log.debug("...Accessing to MasterDB forcedly: " + masterDB);
                }
                datasourceFactory.setselectableDatasourceName(masterDB);
                forcedset = true;
            }
        }
    }

    protected boolean needsForcedMasterCommand(BehaviorCommandMeta meta) {
        return !meta.isselect();
    }

    public void hookFinally(BehaviorCommandMeta meta, RuntimeException cause) {
        if (forcedset) {
            datasourceFactory.setselectableDatasourceName(currentName);
        }
    }
});

...

// 最後は必ずどこかでクリアすること
CallbackContext.clearBehaviorCommandHookOnThread

BehaviorCommandMeta の meta.isselect() は、全てのプロシージャコールにおいて false と判定されます。つまり、検索だけで別に slaveDB に実行してもよいプロシージャも MasterDB に向いてしまいます。あくまで更新処理が slaveDB に向かないようにするための "すべり止め" であることが前提です。その辺、どこまで厳密に判定するかはプロジェクトの要件と BehaviorCommandMeta の仕様(JavaDocコメント)と相談して実装すると良いでしょう。

Exampleのススメ

dbflute-flexserver-example にて、selectableDatasource を利用しています。Example のための無理矢理なレリプケーションですが、実装は参考にできるでしょう。