Quillでは複数データソースに接続することが可能です。
以下、設定方法、注意点、仕組みについて記載します。

• 設定ファイル
• S2Dao属性、Dao設定クラス
• トランザクション属性、Transaction設定クラス
• 注意点
• 補足
• DBFlute.NET（dfnet-multipledb-quill-example）
• 例外発生時のロールバックについて
• 関連クラスとその役割

使用するデータソースの設定を記述します。

下記のように設定した場合、二つのデータソースが
それぞれ「FrontDB」「MasterDB」というキーで
QuillContainerインスタンス生成時にQuillに登録されます。

設定ファイルの書き方についてはこちらをご覧下さい。

例

<quill>
  (中略)
  <dataSources>
    <dataSource name="FrontDB">
      <provider>SqlServer</provider>
      <connectionString>"Server=localhost;database=front;"</connectionString>
      <class>Seasar.Extension.Tx.Impl.TxDataSource</class>
    </dataSource>
  </dataSources>
  <dataSources>
    <dataSource name="MasterDB">
      <provider>SqlServer</provider>
      <connectionString>"Server=localhost;database=master;"</connectionString>
      <class>Seasar.Extension.Tx.Impl.TxDataSource</class>
    </dataSource>
  </dataSources>
</quill>

使用するデータソースの分だけDao設定クラスを用意します。

（Dao設定クラスの作成方法についてはこちらをご覧下さい。）

Dao設定クラスのプロパティ「DataSourceName」が設定ファイルに書いた
データソース名を返すようにします。

例

/// <summary>
/// 「FrontDB」に接続するDao設定
/// </summary>
public class FrontDaoSetting : TypicalDaoSetting {
  public override string DataSourceName {
    get { return "FrontDB"; }
  }
}

/// <summary>
/// 「MasterDB」に接続するDao設定
/// </summary>
public class MasterDaoSetting : TypicalDaoSetting {
  public override string DataSourceName {
    get { return "MasterDB"; }
  }
}

S2Dao属性の引数に上記で作成したDao設定クラスの型情報を渡します。

（S2Dao属性の使い方についてはこちらをご覧下さい。）

例

/// <summary>
/// 「FrontDB」のHogeテーブルに接続するDao
/// </summary>
[Implementation]
[Bean(typeof(HogeEntity))]
[S2Dao(typeof(FrontDaoSetting))]
public interface IFrontHogeDao  {
  HogeEntity Select(int? hogeId);
  int Update(HogeEntity entity);
}

/// <summary>
/// 「MasterDB」のItemテーブルに接続するDao
/// </summary>
[Implementation]
[Bean(typeof(ItemEntity))]
[S2Dao(typeof(MasterDaoSetting))]
public interface IMasterItemDao  {
  ItemEntity Select(int? itemId);
  int Update(ItemEntity entity);
}

S2Dao属性、Dao設定クラスと同様に
使用するデータソースの分だけトランザクション設定クラスを用意します。

（トランザクション設定クラスの作成方法についてはこちらをご覧下さい。）

トランザクション設定クラスのプロパティ「DataSourceName」が設定ファイルに書いた
データソース名を返すようにします。

例

/// <summary>
/// 「FrontDB」に接続するトランザクション設定
/// </summary>
public class FrontTxSetting : TypicalTransactionSetting {
  public override string DataSourceName {
    get { return "FrontDB"; }
  }
}

/// <summary>
/// 「MasterDB」に接続するトランザクション設定
/// </summary>
public class MasterTxSetting : TypicalTransactionSetting {
  public override string DataSourceName {
    get { return "MasterDB"; }
  }
}

Transaction属性の引数に上記で作成したトランザクション設定クラスの型情報を渡します。

（Transaction属性の使い方についてはこちらをご覧下さい。）

例

[Implementation]
public class HogeFacade  {
  protected IFrontHogeDao _frontHogeDao;
  protected IMasterItemDao _masterItemDao;
  
  /// <summary>
  /// 「FrontDB」にトランザクションをかける
  /// </summary>
  [Transaction(typeof(FrontTxSetting))]
  public int ExecuteUpdateHoge(HogeEntity entity) {
    (中略)
    return _frontHogeDao.Update(entity);
  }

  /// <summary>
  /// 「MasterDB」にトランザクションをかける
  /// </summary>
  [Transaction(typeof(MasterTxSetting))]
  public int ExecuteUpdateItem(ItemEntity entity) {
    (中略)
    return _masterItemDao.Update(entity);
  }
}

下記例のようにDaoの接続先とトランザクションをかける先がずれている場合、
Transaction属性に渡した設定のデータソースに対してトランザクション制御を行います。
Daoの接続先に対してはトランザクション制御は行われません。

[Implementation]
public class HogeFacade  {
  /// <summary>
  /// 「FrontDB」に接続するDao
  /// </summary>
  protected IFrontHogeDao _frontHogeDao;
  
  /// <summary>
  /// 「MasterDB」にトランザクションをかける
  /// </summary>
  [Transaction(typeof(MasterTxSetting))]
  public int ExecuteUpdateItem(HogeEntity entity) {
    (中略)
    return _frontHogeDao.Update(entity);
  }
}

DBFlute.NETでは複数データソース接続で使用する設定クラスも
自動生成します。

また、サンプルプロジェクト「dfnet-multipledb-quill-example」では
DBFlute.NET+Quill+複数データソース接続でのサンプルコードが実装されています。

try {
  object obj = invocation.Proceed();
  // ※currentはトランザクションを制御するオブジェクト
  current.Commit();
  return obj;
} catch {
  current.Rollback();
  throw;
} finally {
  (略)
}

[Transaction(typeof(FrontTxSetting))]
[Transaction(typeof(MasterTxSetting))]
public void Update(HogeEntity hoge, ItemEntity item) {
  _frontHogeDao.Update(hoge);
  _masterItemDao.Update(item);
}