jp.co.intra_mart.framework.base.data

クラス DataAccessController

java.lang.Object

jp.co.intra_mart.framework.base.data.DataAccessController

直系の既知のサブクラス:

S2DataAccessController

public class DataAccessController
extends Object

データアクセスを制御します。 DAOの取得、コネクタの管理等を行います。 このクラスを利用して簡易トランザクションを実現することも可能ですが、この方法は推奨されません。 トランザクションはできる限りJava Transaction API(JTA)のUserTransactionを利用して行ってください。

バージョン:

1.0

コンストラクタのサマリー

コンストラクタ

コンストラクタと説明
DataAccessController(DataPropertyHandler handler) データアクセスコントローラを生成します。

メソッドのサマリー

修飾子とタイプ	メソッドと説明
void	commit() すべてのデータコネクタをコミットします。
Object	getDAO(String application, String key, String connect) DAOを取得します。
protected Map<String,DataConnector>	getDataConnectors() DataAccessControllerがキャッシュしているDataConnectorの一覧を取得します。
DataPropertyHandler	getDataPropertyHandler() データプロパティハンドラを取得します。
void	release() すべてのデータストアの資源を解放します。
void	rollback() すべてのデータコネクタをロールバックします。

クラスから継承されたメソッド java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

コンストラクタの詳細

DataAccessController

public DataAccessController(DataPropertyHandler handler)

データアクセスコントローラを生成します。

パラメータ:

handler - データプロパティハンドラ

メソッドの詳細

getDataConnectors

protected Map<String,DataConnector> getDataConnectors()

DataAccessControllerがキャッシュしているDataConnectorの一覧を取得します。

戻り値:

DataConnector

getDataPropertyHandler

public DataPropertyHandler getDataPropertyHandler()

データプロパティハンドラを取得します。

戻り値:

データプロパティハンドラ

導入されたバージョン:

6.0

getDAO

public Object getDAO(String application,
                     String key,
                     String connect)
              throws DataPropertyException,
                     DataConnectorException,
                     DAOException,
                     DataConnectException

DAOを取得します。 キーと接続情報で指定されたDAOを取得します。

パラメータ:

application - アプリケーションID

key - DAOのキー

connect - 接続情報

戻り値:

DAO

例外:

DataPropertyException - プロパティの取得に失敗

DataConnectorException - データコネクタの取得に失敗

DAOException - DAOの取得に失敗

DataConnectException - データリソースとの接続に失敗

commit

public void commit()
            throws DataConnectException

すべてのデータコネクタをコミットします。 このメソッドはこのクラスのgetDAO(String, String, String)で取得されたDAOに関連するデータコネクタの DataConnector.commit()を順に呼び出すことで簡易的なトランザクションを実現しています。 そのため、複数のデータベースにアクセスしたトランザクションの場合は2-Phaseコミットほど堅牢なトランザクションにはならない場合があります。

例外:

DataConnectException - コミットに失敗

rollback

public void rollback()
              throws DataConnectException

すべてのデータコネクタをロールバックします。 このメソッドはこのクラスのgetDAO(String, String, String)で取得されたDAOに関連するデータコネクタの DataConnector.rollback()を順に呼び出すことで簡易的なトランザクションを実現しています。 そのため、複数のデータベースにアクセスしたトランザクションの場合は2-Phaseコミットほど堅牢なトランザクションにはならない場合があります。

例外:

DataConnectException - ロールバックに失敗

release

public void release()
             throws DataConnectException

すべてのデータストアの資源を解放します。 このメソッドはこのクラスのgetDAO(String, String, String)で取得されたDAOに関連するデータコネクタの DataConnector.release()を順に呼び出しています。

例外:

DataConnectException - 資源開放に失敗