概要 | パッケージ | クラス | 階層ツリー | 非推奨 API | 索引 | ヘルプ
openGion 5.0.0.1
前のクラス 次のクラス | フレームあり フレームなし
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド

## org.opengion.fukurou.db
クラス DBUtil

    java.lang.Object
      org.opengion.fukurou.db.DBUtil

    public final class DBUtil

extends Object

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

機能階層
  ＤＢ/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 String[]` | `dbCallExecute(String stmt, String[] args, ApplicationInfo appInfo)` 初期データベースに接続して、CallableStatement(PL/SQL)を実行します。
`static String[]` | `dbCallExecute(String stmt, String[] args, ApplicationInfo appInfo, String dbid)` 検索するデータベースを指定して、CallableStatement(PL/SQL)を実行します。
`static String[][]` | `dbExecute(String stmt, String[] args, ApplicationInfo appInfo)` 移動対象 初期データベースに接続して、Queryを実行します。
`static String[][]` | `dbExecute(String stmt, String[] args, ApplicationInfo appInfo, String dbid)` 移動対象 検索するデータベースを指定して、Queryを実行します。
`static String[][]` | `dbExecute(String stmt, String[] args, ApplicationInfo appInfo, String dbid, boolean useHeader)` 移動対象 検索するデータベースを指定して、Queryを実行します。
`static int` | `dbExist(String stmt, String[] args, ApplicationInfo appInfo, String dbid)` SQL文の実行結果において、データの件数を取得します。
`static String[][]` | `resultToArray(ResultSet resultSet, boolean useHeader)` 移動したメソッドで使われているのでこれも移動 ResultSet より、結果の文字列配列を作成します。

クラス java.lang.Object から継承されたメソッド
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

メソッドの詳細

### dbExecute

    public static String[][] dbExecute(String stmt,
                                       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 String[][] dbExecute(String stmt,
                                       String[] args,
                                       ApplicationInfo appInfo,
                                       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 String[][] dbExecute(String stmt,
                                       String[] args,
                                       ApplicationInfo appInfo,
                                       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 String[] dbCallExecute(String stmt,
                                         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 String[] dbCallExecute(String stmt,
                                         String[] args,
                                         ApplicationInfo appInfo,
                                         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(String stmt,
                              String[] args,
                              ApplicationInfo appInfo,
                              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 String[][] resultToArray(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 , ヘッダー情報の取得有無フラグの追加

概要 | パッケージ | クラス | 階層ツリー | 非推奨 API | 索引 | ヘルプ
| openGion 5.0.0.1
前のクラス 次のクラス | フレームあり フレームなし
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド

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