nablarch.core.db.connection

クラス DbConnectionContext

java.lang.Object

nablarch.core.db.connection.DbConnectionContext

public final class DbConnectionContext
extends java.lang.Object

データベース接続(AppDbConnection)をスレッド単位に管理するクラス。

設定されたデータベース接続をスレッドに紐付けて管理する。
データベース接続の取得要求があった場合は、スレッドに紐付いているデータベース接続を返す。

メソッドのサマリー

修飾子とタイプ	メソッドと説明
static boolean	containConnection(java.lang.String connectionName) 現在のスレッドに指定した名前のデータベース接続が保持されているか判定する。
static AppDbConnection	getConnection() 現在のスレッドに紐付けられたデフォルトのデータベース接続を取得する。
static AppDbConnection	getConnection(java.lang.String connectionName) 現在のスレッドに紐付けられた指定した名前のデータベース接続を取得する。
static TransactionManagerConnection	getTransactionManagerConnection() 現在のスレッドに紐付いたデフォルトのトランザクション制御を取得する。
static TransactionManagerConnection	getTransactionManagerConnection(java.lang.String connectionName) 現在のスレッドから指定した名前のトランザクション制御を取得する。
static void	removeConnection() 現在のスレッドに紐付いたデフォルトのデータベース接続を削除する。
static void	removeConnection(java.lang.String connectionName) 現在のスレッドに紐付いた指定した名前のデータベース接続を削除する。
static void	setConnection(AppDbConnection con) データベース接続をデフォルトの名前でスレッドに設定する。
static void	setConnection(java.lang.String connectionName, AppDbConnection con) データベース接続を指定した名前でスレッドに設定する。

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

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

メソッドの詳細

setConnection

@Published(tag="architect")
public static void setConnection(AppDbConnection con)

データベース接続をデフォルトの名前でスレッドに設定する。

データベース接続の設定には、"transaction"という名前が使用される。 設定できるデフォルトのデータベース接続はカレントスレッドに対して一つまでである。

パラメータ:

con - データベース接続

例外:

java.lang.IllegalArgumentException - カレントスレッドに対してデフォルトのデータベース接続を複数設定した場合

setConnection

@Published(tag="architect")
public static void setConnection(java.lang.String connectionName,
                                                             AppDbConnection con)

データベース接続を指定した名前でスレッドに設定する。

名前はスレッド内でユニークでなければならない。

パラメータ:

connectionName - データベース接続名

con - データベース接続

例外:

java.lang.IllegalArgumentException - カレントスレッドに対して同じ名前のデータベース接続が設定されている場合

getConnection

@Published(tag="architect")
public static AppDbConnection getConnection()

現在のスレッドに紐付けられたデフォルトのデータベース接続を取得する。

データベース接続の取得には、"transaction"という名前が使用される。

戻り値:

データベース接続

getConnection

@Published(tag="architect")
public static AppDbConnection getConnection(java.lang.String connectionName)

現在のスレッドに紐付けられた指定した名前のデータベース接続を取得する。

パラメータ:

connectionName - データベース接続名

戻り値:

データベース接続

例外:

java.lang.IllegalArgumentException - データベース接続が見つからなかった場合

containConnection

public static boolean containConnection(java.lang.String connectionName)

現在のスレッドに指定した名前のデータベース接続が保持されているか判定する。

パラメータ:

connectionName - データベース接続名

戻り値:

データベース接続が保持されていればtrue

removeConnection

@Published(tag="architect")
public static void removeConnection()

現在のスレッドに紐付いたデフォルトのデータベース接続を削除する。

データベース接続の取得には"transaction"という名前が使用される。

removeConnection

@Published(tag="architect")
public static void removeConnection(java.lang.String connectionName)

現在のスレッドに紐付いた指定した名前のデータベース接続を削除する。

パラメータ:

connectionName - データベース接続名

getTransactionManagerConnection

@Published(tag="architect")
public static TransactionManagerConnection getTransactionManagerConnection()

現在のスレッドに紐付いたデフォルトのトランザクション制御を取得する。

トランザクション制御の取得には、"transaction"という名前が使用される。

戻り値:

トランザクション制御

例外:

java.lang.ClassCastException - データベース接続の実体がTransactionManagerConnectionを実装していない場合

java.lang.IllegalArgumentException - データベース接続が見つからなかった場合

getTransactionManagerConnection

@Published(tag="architect")
public static TransactionManagerConnection getTransactionManagerConnection(java.lang.String connectionName)

現在のスレッドから指定した名前のトランザクション制御を取得する。

パラメータ:

connectionName - データベース接続名

戻り値:

トランザクション制御

例外:

java.lang.ClassCastException - データベース接続の実体がTransactionManagerConnectionを実装していない場合

java.lang.IllegalArgumentException - データベース接続が見つからなかった場合