openGionopenGion
5.0.0.3

org.opengion.fukurou.db
クラス DBUtil

java.lang.Object
  上位を拡張 org.opengion.fukurou.db.DBUtil

public final class DBUtil
extends java.lang.Object

データベース関連の便利なメソッドを集めた簡易ユーティリティークラスです。 全てのメソッドは、static メソッドになっています。

機能階層
DB/Shell制御
変更履歴:
2.1.1.1 (2002/11/15) Serializable インターフェースを削除する。
4.0.0.0 (2007/10/16) DBアクセス関係のメソッドのみをパッケージ移動(hayabusa/db > fukurou/db)
バージョン
4.0
作成者
Kazuhiko Hasegawa
導入されたバージョン:
JDK5.0,

メソッドの概要
static java.lang.String[] dbCallExecute(java.lang.String stmt, java.lang.String[] args, ApplicationInfo appInfo)
          初期データベースに接続して、CallableStatement(PL/SQL)を実行します。
static java.lang.String[] dbCallExecute(java.lang.String stmt, java.lang.String[] args, ApplicationInfo appInfo, java.lang.String dbid)
          検索するデータベースを指定して、CallableStatement(PL/SQL)を実行します。
static java.lang.String[][] dbExecute(java.lang.String stmt, java.lang.String[] args, ApplicationInfo appInfo)
          移動対象 初期データベースに接続して、Queryを実行します。
static java.lang.String[][] dbExecute(java.lang.String stmt, java.lang.String[] args, ApplicationInfo appInfo, java.lang.String dbid)
          移動対象 検索するデータベースを指定して、Queryを実行します。
static java.lang.String[][] dbExecute(java.lang.String stmt, java.lang.String[] args, ApplicationInfo appInfo, java.lang.String dbid, boolean useHeader)
          移動対象 検索するデータベースを指定して、Queryを実行します。
static int dbExist(java.lang.String stmt, java.lang.String[] args, ApplicationInfo appInfo, java.lang.String dbid)
          SQL文の実行結果において、データの件数を取得します。
static java.lang.String[][] resultToArray(java.sql.ResultSet resultSet, boolean useHeader)
          移動したメソッドで使われているのでこれも移動 ResultSet より、結果の文字列配列を作成します。
 
クラス java.lang.Object から継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

メソッドの詳細

dbExecute

public static java.lang.String[][] dbExecute(java.lang.String stmt,
                                             java.lang.String[] args,
                                             ApplicationInfo appInfo)
移動対象 初期データベースに接続して、Queryを実行します。 ステートメントと引数により、Prepared クエリーの検索のみ実行します。 結果は,すべて文字列に変換されて格納されます。 検索するデータベースは、DEFAULT です。

パラメータ:
stmt - ステートメント文字列
args - オブジェクトの引数配列
appInfo - ApplicationInfo
戻り値:
検索結果の配列
変更履歴:
3.8.7.0 (2006/12/15) アクセスログ取得の為,ApplicationInfo オブジェクトを設定
4.0.0.0 (2007/10/10) dbid の初期値を、"DEFAULT" から null に変更

dbExecute

public static java.lang.String[][] dbExecute(java.lang.String stmt,
                                             java.lang.String[] args,
                                             ApplicationInfo appInfo,
                                             java.lang.String dbid)
移動対象 検索するデータベースを指定して、Queryを実行します。 ステートメントと引数により、Prepared クエリーの検索のみ実行します。 結果は,すべて文字列に変換されて格納されます。 追加:検索以外のSQLも実行できます。結果は、null を返します。

パラメータ:
stmt - ステートメント文字列
args - オブジェクトの引数配列
appInfo - ApplicationInfo
dbid - 接続先ID
戻り値:
検索結果の配列
変更履歴:
3.0.0.0 (2002/12/25) 検索のみのクエリーから、何でもありのクエリーに変更
2.3.1.3 (2003/01/28) Open Cursor が、大量に残る件の対応。ResultSet を close()
3.8.0.8 (2005/10/03) エラーメッセージの出力順をメッセージ+Queryに変更します。
3.8.7.0 (2006/12/15) アクセスログ取得の為,ApplicationInfo オブジェクトを設定
4.0.0.1 (2007/12/03) try ~ catch ~ finally をきちんと行う。

dbExecute

public static java.lang.String[][] dbExecute(java.lang.String stmt,
                                             java.lang.String[] args,
                                             ApplicationInfo appInfo,
                                             java.lang.String dbid,
                                             boolean useHeader)
移動対象 検索するデータベースを指定して、Queryを実行します。 ステートメントと引数により、Prepared クエリーの検索のみ実行します。 結果は,すべて文字列に変換されて格納されます。 追加:検索以外のSQLも実行できます。結果は、null を返します。

パラメータ:
stmt - ステートメント文字列
args - オブジェクトの引数配列
appInfo - ApplicationInfo
dbid - 接続先ID
useHeader - 1行目にヘッダーを含めるか
戻り値:
検索結果の配列
変更履歴:
4.3.7.0 (2009/06/01) 新規作成

dbCallExecute

public static java.lang.String[] dbCallExecute(java.lang.String stmt,
                                               java.lang.String[] args,
                                               ApplicationInfo appInfo)
初期データベースに接続して、CallableStatement(PL/SQL)を実行します。 ステートメントと引数により、CallableStatement クエリーを実行します。 結果は,ステータスとエラーメッセージを返します。便宜的に、String配列に 設定して返します。 ステートメント文字列には、 { call PLSQL( ?,?,?・・・ ) } となります。 第一引数、第二引数は、OUT属性で、結果(STATUS)とエラー時の内容(ERR_CODE)を返します。 第三引数以降の ? には、オブジェクトの引数配列 が順に割り当てられます。 検索するデータベースは、DEFAULT です。

パラメータ:
stmt - ステートメント文字列
args - オブジェクトの引数配列
appInfo - ApplicationInfo
戻り値:
実行結果([0]=ステータス、[1]=エラーメッセージ
変更履歴:
3.8.0.0 (2005/06/07) 新規追加
3.8.7.0 (2006/12/15) アクセスログ取得の為,ApplicationInfo オブジェクトを設定
4.0.0.0 (2007/10/10) dbid の初期値を、"DEFAULT" から null に変更

dbCallExecute

public static java.lang.String[] dbCallExecute(java.lang.String stmt,
                                               java.lang.String[] args,
                                               ApplicationInfo appInfo,
                                               java.lang.String dbid)
検索するデータベースを指定して、CallableStatement(PL/SQL)を実行します。 ステートメントと引数により、CallableStatement クエリーを実行します。 結果は,ステータスとエラーメッセージを返します。便宜的に、String配列に 設定して返します。 ステートメント文字列には、 { call PLSQL( ?,?,?・・・ ) } となります。 第一引数、第二引数は、OUT属性で、結果(STATUS)とエラー時の内容(ERR_CODE)を返します。 第三引数以降の ? には、オブジェクトの引数配列 が順に割り当てられます。 検索するデータベースは、DEFAULT です。

パラメータ:
stmt - ステートメント文字列
args - オブジェクトの引数配列
appInfo - ApplicationInfo
dbid - 接続先ID
戻り値:
実行結果([0]=ステータス、[1]=エラーメッセージ
変更履歴:
3.8.0.0 (2005/06/07) 新規追加
3.8.7.0 (2006/12/15) アクセスログ取得の為,ApplicationInfo オブジェクトを設定
4.0.0.1 (2007/12/03) try ~ catch ~ finally をきちんと行う。

dbExist

public static int dbExist(java.lang.String stmt,
                          java.lang.String[] args,
                          ApplicationInfo appInfo,
                          java.lang.String dbid)
SQL文の実行結果において、データの件数を取得します。 ステートメントと引数により、Prepared クエリーの検索を実行します。 結果は、件数を数値で返します。 あくまで、存在チェックに必要な処理のみ行っているため、通常の検索より高速です。

パラメータ:
stmt - ステートメント文字列
args - オブジェクトの引数配列
appInfo - ApplicationInfo
dbid - 接続先ID
戻り値:
検索結果(データの件数)
変更履歴:
3.5.0.0 (2003/09/17) 新規作成
3.8.0.8 (2005/10/03) エラーメッセージの出力順をメッセージ+Queryに変更します。
3.8.7.0 (2006/12/15) アクセスログ取得の為,ApplicationInfo オブジェクトを設定
4.0.0.1 (2007/12/03) try ~ catch ~ finally をきちんと行う。

resultToArray

public static java.lang.String[][] resultToArray(java.sql.ResultSet resultSet,
                                                 boolean useHeader)
移動したメソッドで使われているのでこれも移動 ResultSet より、結果の文字列配列を作成します。 結果は,すべて文字列に変換されて格納されます。

パラメータ:
resultSet - ResultSet
useHeader - boolean true:ヘッダーを第一行に含める/false:含めない
戻り値:
ResultSet の検索結果配列
変更履歴:
3.1.0.0 (2003/03/20) Vector を使用している箇所で、非同期でも構わない箇所を、ArrayList に置換え。
3.8.0.8 (2005/10/03) エラーメッセージの出力順をメッセージ+Queryに変更します。
4.0.0 (2005/01/31) private ⇒ public , ヘッダー情報の取得有無フラグの追加

openGion 5.0.0.3

Webアプリケーションフレームワーク openGion
SourceForge.JPCopyright (c) 2009 The openGion Project.