org.apache.struts.util
クラス GenericConnection

java.lang.Object
  org.apache.struts.util.GenericConnection

すべての実装インタフェース:

java.sql.Connection

public class GenericConnection

extends java.lang.Object

implements java.sql.Connection

汎用的な Connection のラッパー実装です。 GenericDataSource と共に動作し、任意の JDBC ドライバーを対象とします。

バージョン:

$Revision: 1.2 $ $Date: 2003/03/22 07:55:10 $

作成者:

Craig R. McClanahan, Ted Husted

翻訳者:

日置 聡 [日本語訳のコメントは、report@jajakarta.orgに送ってください。]

フィールドの概要

protected boolean	autoCommit 解放後に返す、初期化時の自動コミットステータス
protected java.lang.String	catalog 解放後に返す、初期化時のカタログ名
private boolean	closed ラップしているコネクションがクローズしているかのフラグ
protected java.sql.Connection	conn ラップしているコネクション
protected int	level 解放後に返す、初期化時のトランザクションの遮断レベル
protected java.util.Map	map 解放後に返す、初期化時の型マップ
protected boolean	readOnly 解放後に返す、初期化時の読み込み専用ステータス
protected GenericDataSource	source この接続を保持する GenericDataSource
private static java.lang.String	SQLEXCEPTION_CLOSED

インタフェース java.sql.Connection から継承したフィールド

TRANSACTION_NONE, TRANSACTION_READ_COMMITTED, TRANSACTION_READ_UNCOMMITTED, TRANSACTION_REPEATABLE_READ, TRANSACTION_SERIALIZABLE

コンストラクタの概要

GenericConnection(GenericDataSource source, java.sql.Connection conn, boolean autoCommit, boolean readOnly)
指定されたコネクションをラップした新たな GenericConnection を生成します。

メソッドの概要

void	clearWarnings() この Connection の持つ全ての警告情報をクリアします。
void	close() データソースのコネクションプールに、ラップしているコネクションを返します。
void	commit() 前回のコミットかロールバック処理からの全ての変更内容を反映し、 現在保持しているデータベースのロックを開放します。
java.sql.Statement	createStatement() SQL文をデータベースに送るための Statement を生成します。
java.sql.Statement	createStatement(int resultSetType, int resultSetConcurrency) (JDBC 2.0) 指定されたタイプと並行処理で ResultSet オブジェクトを生成する Statement を生成します。
boolean	getAutoCommit() 現在の自動コミットステータスを返します。
java.lang.String	getCatalog() 保持する Connection の現在のカタログ名を返します。
(パッケージプライベート) java.sql.Connection	getConnection() ラップしている実際の接続(オブジェクト)を返します。
(パッケージプライベート) javax.sql.DataSource	getDataSource() この接続を保持するデータソースを返します。
java.sql.DatabaseMetaData	getMetaData() 接続しているデータベースに関するメタデータを取得します。
int	getTransactionIsolation() 保持する Connection の現在のトランザクションの遮断レベルを返します。
java.util.Map	getTypeMap() (JDBC 2.0) この接続時の型マップを返します。
java.sql.SQLWarning	getWarnings() 保持する Connection からレポートされた最初の警告を返します。
boolean	isClosed() 保持する Connection がクローズされていた場合に true を返します。
boolean	isReadOnly() Connection が読み込み専用モードの時に true を返します。
java.lang.String	nativeSQL(java.lang.String sql) 指定された SQL 文をシステムの本来の SQL 文法に変換します。
java.sql.CallableStatement	prepareCall(java.lang.String sql) データベースのストアードプロシージャをコールするための CallableStatement オブジェクトを生成します。
java.sql.CallableStatement	prepareCall(java.lang.String sql, int resultSetType, int resultSetConcurrency) (JDBC 2.0) 指定されたタイプと並行処理で ResultSet オブジェクトを生成する CallableStatement オブジェクトを生成します。
java.sql.PreparedStatement	prepareStatement(java.lang.String sql) パラメータを持つ SQL文をデータベースに対して送るための PreparedStatement オブジェクトを生成します。
java.sql.PreparedStatement	prepareStatement(java.lang.String sql, int resultSetType, int resultSetConcurrency) (JDBC 2.0) 指定されたタイプと並行処理で ResultSet オブジェクトを生成する PreparedStatement を生成します。
void	rollback() 前回のコミットかロールバック後の全ての変更内容を破棄します。
void	setAutoCommit(boolean autoCommit) 現在の接続に対する自動コミットモードを設定します。
void	setCatalog(java.lang.String catalog) 保持する Connection のカタログ名を設定します。
(パッケージプライベート) void	setClosed(boolean closed) この接続のラッパーに対してコネクションがクローズしているかのステータスを設定します。
void	setReadOnly(boolean readOnly) 現在の接続に対する読取専用モードを設定します。
void	setTransactionIsolation(int level) 保持する Connection のトランザクションの遮断レベルを設定します。
void	setTypeMap(java.util.Map map) (JDBC 2.0) 現在の接続に対する型マップを設定します。

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

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

インタフェース java.sql.Connection から継承したメソッド

createStatement, getHoldability, prepareCall, prepareStatement, prepareStatement, prepareStatement, prepareStatement, releaseSavepoint, rollback, setHoldability, setSavepoint, setSavepoint

フィールドの詳細

SQLEXCEPTION_CLOSED

private static final java.lang.String SQLEXCEPTION_CLOSED

関連項目:

定数フィールド値

autoCommit

protected boolean autoCommit

解放後に返す、初期化時の自動コミットステータス

catalog

protected java.lang.String catalog

解放後に返す、初期化時のカタログ名

closed

private boolean closed

ラップしているコネクションがクローズしているかのフラグ

conn

protected java.sql.Connection conn

ラップしているコネクション

level

protected int level

解放後に返す、初期化時のトランザクションの遮断レベル

map

protected java.util.Map map

解放後に返す、初期化時の型マップ

readOnly

protected boolean readOnly

解放後に返す、初期化時の読み込み専用ステータス

source

protected GenericDataSource source

この接続を保持する GenericDataSource

コンストラクタの詳細

GenericConnection

public GenericConnection(GenericDataSource source,
                         java.sql.Connection conn,
                         boolean autoCommit,
                         boolean readOnly)
                  throws java.sql.SQLException

指定されたコネクションをラップした新たな GenericConnection を生成します。

パラメータ:

source - このコネクションを保持するデータソース

conn - ラップするコネクション

autoCommit - このコネクションに適用する自動コミットのステータス

readOnly - このコネクションに適用する読み込み専用モードのステータス

例外:

java.sql.SQLException - SQL実行時にエラーが発生した場合

メソッドの詳細

clearWarnings

public void clearWarnings()
                   throws java.sql.SQLException

この Connection の持つ全ての警告情報をクリアします。

定義:

インタフェース java.sql.Connection 内の clearWarnings

例外:

java.sql.SQLException - データベースアクセスエラーが発生した場合

close

public void close()
           throws java.sql.SQLException

データソースのコネクションプールに、ラップしているコネクションを返します。

定義:

インタフェース java.sql.Connection 内の close

例外:

java.sql.SQLException - データベースアクセスエラーが発生した場合

commit

public void commit()
            throws java.sql.SQLException

前回のコミットかロールバック処理からの全ての変更内容を反映し、 現在保持しているデータベースのロックを開放します。

定義:

インタフェース java.sql.Connection 内の commit

例外:

java.sql.SQLException - データベースアクセスエラーが発生した場合

createStatement

public java.sql.Statement createStatement()
                                   throws java.sql.SQLException

SQL文をデータベースに送るための Statement を生成します。

定義:

インタフェース java.sql.Connection 内の createStatement

例外:

java.sql.SQLException - データベースアクセスエラーが発生した場合

createStatement

public java.sql.Statement createStatement(int resultSetType,
                                          int resultSetConcurrency)
                                   throws java.sql.SQLException

(JDBC 2.0) 指定されたタイプと並行処理で ResultSet オブジェクトを生成する Statement を生成します。

定義:

インタフェース java.sql.Connection 内の createStatement

パラメータ:

resultSetType - 結果セットのタイプ

resultSetConcurrency - 結果セットの並行処理の種類

例外:

java.sql.SQLException - データベースアクセスエラーが発生した場合

getAutoCommit

public boolean getAutoCommit()
                      throws java.sql.SQLException

現在の自動コミットステータスを返します。

定義:

インタフェース java.sql.Connection 内の getAutoCommit

例外:

java.sql.SQLException - データベースアクセスエラーが発生した場合

getCatalog

public java.lang.String getCatalog()
                            throws java.sql.SQLException

保持する Connection の現在のカタログ名を返します。

定義:

インタフェース java.sql.Connection 内の getCatalog

例外:

java.sql.SQLException - データベースアクセスエラーが発生した場合

getMetaData

public java.sql.DatabaseMetaData getMetaData()
                                      throws java.sql.SQLException

接続しているデータベースに関するメタデータを取得します。

定義:

インタフェース java.sql.Connection 内の getMetaData

例外:

java.sql.SQLException - データベースアクセスエラーが発生した場合

getTransactionIsolation

public int getTransactionIsolation()
                            throws java.sql.SQLException

保持する Connection の現在のトランザクションの遮断レベルを返します。

定義:

インタフェース java.sql.Connection 内の getTransactionIsolation

例外:

java.sql.SQLException - データベースアクセスエラーが発生した場合

getTypeMap

public java.util.Map getTypeMap()
                         throws java.sql.SQLException

(JDBC 2.0) この接続時の型マップを返します。

定義:

インタフェース java.sql.Connection 内の getTypeMap

例外:

java.sql.SQLException - データベースアクセスエラーが発生した場合

getWarnings

public java.sql.SQLWarning getWarnings()
                                throws java.sql.SQLException

保持する Connection からレポートされた最初の警告を返します。

定義:

インタフェース java.sql.Connection 内の getWarnings

例外:

java.sql.SQLException - データベースアクセスエラーが発生した場合

isClosed

public boolean isClosed()
                 throws java.sql.SQLException

保持する Connection がクローズされていた場合に true を返します。 GenericConnection.isClosed() メソッドは GenericConnection.closed() が呼ばれた後でのみ trueを返すことが保証されます。 このメソッドは通常、データベースへの接続が有効か無効かを判定するために呼び出すことはできません。 典型的な JDBC クライアントは 接続が無効であるかどうかを JDBC の処理を実施したときに発生する 例外によって判断することが出来ます。

定義:

インタフェース java.sql.Connection 内の isClosed

例外:

java.sql.SQLException - データベースアクセスエラーが発生した場合

isReadOnly

public boolean isReadOnly()
                   throws java.sql.SQLException

Connection が読み込み専用モードの時に true を返します。

定義:

インタフェース java.sql.Connection 内の isReadOnly

例外:

java.sql.SQLException - データベースアクセスエラーが発生した場合

nativeSQL

public java.lang.String nativeSQL(java.lang.String sql)
                           throws java.sql.SQLException

指定された SQL 文をシステムの本来の SQL 文法に変換します。

定義:

インタフェース java.sql.Connection 内の nativeSQL

パラメータ:

sql - 処理される記述 (SQL文)

例外:

java.sql.SQLException

prepareCall

public java.sql.CallableStatement prepareCall(java.lang.String sql)
                                       throws java.sql.SQLException

データベースのストアードプロシージャをコールするための CallableStatement オブジェクトを生成します。

定義:

インタフェース java.sql.Connection 内の prepareCall

パラメータ:

sql - 処理される記述 (SQL文)

例外:

java.sql.SQLException - データベースアクセスエラーが発生した場合

prepareCall

public java.sql.CallableStatement prepareCall(java.lang.String sql,
                                              int resultSetType,
                                              int resultSetConcurrency)
                                       throws java.sql.SQLException

(JDBC 2.0) 指定されたタイプと並行処理で ResultSet オブジェクトを生成する CallableStatement オブジェクトを生成します。

定義:

インタフェース java.sql.Connection 内の prepareCall

パラメータ:

sql - 処理される記述 (SQL文)

resultSetType - 結果セットのタイプ。

resultSetConcurrency - 結果セットの並行処理の種類

例外:

java.sql.SQLException - データベースアクセスエラーが発生した場合

prepareStatement

public java.sql.PreparedStatement prepareStatement(java.lang.String sql)
                                            throws java.sql.SQLException

パラメータを持つ SQL文をデータベースに対して送るための PreparedStatement オブジェクトを生成します。

定義:

インタフェース java.sql.Connection 内の prepareStatement

パラメータ:

sql - 処理される記述 (SQL文)

例外:

java.sql.SQLException - データベースアクセスエラーが発生した場合

prepareStatement

public java.sql.PreparedStatement prepareStatement(java.lang.String sql,
                                                   int resultSetType,
                                                   int resultSetConcurrency)
                                            throws java.sql.SQLException

(JDBC 2.0) 指定されたタイプと並行処理で ResultSet オブジェクトを生成する PreparedStatement を生成します。

定義:

インタフェース java.sql.Connection 内の prepareStatement

パラメータ:

sql - 処理される記述 (SQL文)

resultSetType - 結果セットのタイプ

resultSetConcurrency - 結果セットの並行処理の種類

例外:

java.sql.SQLException - データベースアクセスエラーが発生した場合

rollback

public void rollback()
              throws java.sql.SQLException

前回のコミットかロールバック後の全ての変更内容を破棄します。

定義:

インタフェース java.sql.Connection 内の rollback

例外:

java.sql.SQLException - データベースアクセスエラーが発生した場合

setAutoCommit

public void setAutoCommit(boolean autoCommit)
                   throws java.sql.SQLException

現在の接続に対する自動コミットモードを設定します。

定義:

インタフェース java.sql.Connection 内の setAutoCommit

パラメータ:

autoCommit - 新しい自動コミットモード

例外:

java.sql.SQLException - データベースアクセスエラーが発生した場合

setCatalog

public void setCatalog(java.lang.String catalog)
                throws java.sql.SQLException

保持する Connection のカタログ名を設定します。

定義:

インタフェース java.sql.Connection 内の setCatalog

パラメータ:

catalog - 新しいカタログ名

例外:

java.sql.SQLException - データベースアクセスエラーが発生した場合

setReadOnly

public void setReadOnly(boolean readOnly)
                 throws java.sql.SQLException

現在の接続に対する読取専用モードを設定します。

定義:

インタフェース java.sql.Connection 内の setReadOnly

パラメータ:

readOnly - 新しい読取専用モード

例外:

java.sql.SQLException - データベースアクセスエラーが発生した場合

setTransactionIsolation

public void setTransactionIsolation(int level)
                             throws java.sql.SQLException

保持する Connection のトランザクションの遮断レベルを設定します。

定義:

インタフェース java.sql.Connection 内の setTransactionIsolation

パラメータ:

level - 新しいトランザクションの遮断レベル

例外:

java.sql.SQLException - データベースアクセスエラーが発生した場合

setTypeMap

public void setTypeMap(java.util.Map map)
                throws java.sql.SQLException

(JDBC 2.0) 現在の接続に対する型マップを設定します。

定義:

インタフェース java.sql.Connection 内の setTypeMap

パラメータ:

map - 新しい型マップ

例外:

java.sql.SQLException - データベースアクセスエラーが発生した場合

getConnection

java.sql.Connection getConnection()

ラップしている実際の接続(オブジェクト)を返します。

getDataSource

javax.sql.DataSource getDataSource()

この接続を保持するデータソースを返します。

setClosed

void setClosed(boolean closed)

この接続のラッパーに対してコネクションがクローズしているかのステータスを設定します。 通常このメソッドは、この接続を保持している DataSource (ソース) が プールしている接続を再利用する際に setClosed(false) とコールするときのみ使用されます。