nablarch.core.db.connection

Class DbConnectionContext

java.lang.Object

nablarch.core.db.connection.DbConnectionContext

public final class DbConnectionContext
extends java.lang.Object

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

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

Author:

Koichi Asano

Method Summary

Modifier and Type	Method and Description
static AppDbConnection	getConnection() 現在のスレッドに紐付けられたデフォルトのデータベース接続を取得する。 データベース接続の取得には、"transaction"という名前が使用される。
static AppDbConnection	getConnection(java.lang.String connectionName) 現在のスレッドに紐付けられた指定した名前のデータベース接続を取得する。
static TransactionManagerConnection	getTransactionManagerConnection() 現在のスレッドに紐付いたデフォルトのトランザクション制御を取得する。 トランザクション制御の取得には、"transaction"という名前が使用される。
static TransactionManagerConnection	getTransactionManagerConnection(java.lang.String connectionName) 現在のスレッドから指定した名前のトランザクション制御を取得する。
static void	removeConnection() 現在のスレッドに紐付いたデフォルトのデータベース接続を削除する。 データベース接続の取得には"transaction"という名前が使用される。
static void	removeConnection(java.lang.String connectionName) 現在のスレッドに紐付いた指定した名前のデータベース接続を削除する。
static void	setConnection(AppDbConnection con) データベース接続をデフォルトの名前でスレッドに設定する。 データベース接続の設定には、"transaction"という名前が使用される。 設定できるデフォルトのデータベース接続はカレントスレッドに対して一つまでである。
static void	setConnection(java.lang.String connectionName, AppDbConnection con) データベース接続を指定した名前でスレッドに設定する。 名前はスレッド内でユニークでなければならない。

Method Detail

setConnection

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

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

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

Parameters:

con - データベース接続

Throws:

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

setConnection

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

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

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

Parameters:

connectionName - データベース接続名

con - データベース接続

Throws:

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

getConnection

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

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

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

Returns:

データベース接続

getConnection

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

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

Parameters:

connectionName - データベース接続名

Returns:

データベース接続

Throws:

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

removeConnection

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

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

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

removeConnection

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

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

Parameters:

connectionName - データベース接続名

getTransactionManagerConnection

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

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

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

Returns:

トランザクション制御

Throws:

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

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

getTransactionManagerConnection

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

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

Parameters:

connectionName - データベース接続名

Returns:

トランザクション制御

Throws:

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

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