jp.co.pwv.estore.util
クラス EDbUtils

java.lang.Object
  |
  +--jp.co.pwv.estore.util.EDbUtils

public class EDbUtils

extends java.lang.Object

EDbUtils
DbUtils を使いやすくするためのラッパーユーティリティ
内部的にEDbHelperを使用する

バージョン:

1.0 2004/08/13

作成者:

Hiroshi TAKEMOTO

コンストラクタの概要

EDbUtils()

メソッドの概要

static void	addHelper(java.lang.Object obj) オブジェクトobjのDbHelperをヘルパーマップmapに追加する。
static javax.sql.DataSource	createDatasource(java.lang.String driver, java.lang.String url, java.lang.String user, java.lang.String password) データソースを作成する
static java.util.HashMap	createHelperMap(java.lang.Object[] objs) オブジェクトの配列から各オブジェクトのEDbHelperインスタンスを ヘルパーマップmapに登録し、そのマップを返す。
static void	createTables() createDatasourceで作成された、もしくは呼び出し前にセットされたdataSource、 createHelperMapで作成されたhelperMapを使用して、データベースのテーブルを作成する。
static void	createTables(java.sql.Connection conn, java.util.HashMap helperMap) 与えられたデータソース、ヘルパーマップを使ってデータベースのテーブルを作成する。
static int	deleteObject(java.sql.Connection conn, java.util.HashMap helperMap, java.lang.Object obj) トランザクション処理を行うためにconn, helperMapを指定してオブエジェクとを削除 する。
static int	deleteObject(java.lang.Object obj) createDatasourceで作成された、もしくは呼び出し前にセットされたdataSource、 createHelperMapで作成されたhelperMapを使用して、オブジェクトを削除する。
static int	dropTable(java.lang.Class cls) クラスclsに対応するテーブルを削除する。
static int	dropTable(java.sql.Connection conn, java.lang.Class cls) コネクションconnを使ってクラスclsに対応するテーブルを削除する。
static void	dropTables()
static void	dropTables(java.sql.Connection conn, java.util.HashMap helperMap)
static int	executeSql(java.sql.Connection conn, java.lang.String sql) SQL文sqlを実行し、その結果を返す。
static int	executeSql(java.lang.String sql) SQL文sqlを実行し、その結果を返す。
static java.util.HashMap	getMap() 現在のヘルパーマップを返す。
static java.lang.Integer	getNewOwnerId() ENodeMapperで使用するシステムで一意のownerIdを返す。
static java.lang.String	getTableName(java.lang.Class cls) クラスclsに対応するデータベーステーブル名を返す
static void	insertMappedList(java.lang.Object owner, java.lang.Integer ownerId, java.util.List list) リストをENODEMAPPERにマップし、挿入する
static int	insertMappedObject(java.lang.Object owner, java.lang.Integer ownerId, java.lang.Object obj) オブジェクトをENODEMAPPERにマップし、挿入する
static int	insertObject(java.sql.Connection conn, java.util.HashMap helperMap, java.lang.Object obj) トランザクション処理を行うためにconn, helperMapを指定してオブエジェクとを挿入 する。
static int	insertObject(java.lang.Object obj) createDatasourceで作成された、もしくは呼び出し前にセットされたdataSource、 createHelperMapで作成されたhelperMapを使用して、オブジェクトを挿入する。
static java.util.List	loadMappedList(java.lang.Object owner, java.lang.Integer ownerId) 識別子ownerIdを持つオーナーオブジェクトのENODEMAPPERにマップ されたリストをロードする
static java.lang.Object	loadMappedObject(java.lang.Integer nodeId) ENODEMAPPERにマップされたオブジェクトをロードする
static java.lang.Object	loadObject(java.lang.Class cls, java.lang.Integer id) クラスclsに対応するテーブルから、識別子idのオブジェクトを返す
static java.lang.Object	loadObject(java.sql.Connection conn, java.lang.Class cls, java.lang.Integer id) コネクションconnを使ってクラスclsに対応するテーブルから、識別子 idのオブジェクトを返す
static java.util.List	selectAll(java.lang.Class cls) クラスclsに対応するテーブルのすべてのレコードを返す
static java.util.List	selectAll(java.sql.Connection conn, java.lang.Class cls) /** コネクションconnを使ってクラスclsに対応するテーブルの すべてのレコードを返す。
static java.util.List	selectObjects(java.lang.Class cls, java.lang.String where) クラスclsに対応するテーブルの条件whereに該当するレコードを返す。
static java.util.List	selectObjects(java.sql.Connection conn, java.lang.Class cls, java.lang.String where) コネクションconnを使ってクラスclsに対応するテーブルの条件whereに該当するレコードを返す。
static java.lang.Object	selectScalar(java.sql.Connection conn, java.lang.String sql) コネクションconnを使ってSQL文sqlを実行し、スカラー値を返す。
static java.lang.Object	selectScalar(java.lang.String sql) SQL文sqlを実行し、スカラー値を返す。
static void	setDataSource(javax.sql.DataSource source) データソースをセットする strutsで定義されたデータソースを利用するときに使用する。
static void	setTransaction(java.sql.Connection conn) コネクションconnに関する以降の処理をトランザクション処理として 扱えるようにする（AutoCommitをfalseにする）
static java.lang.String	toString(java.lang.Object obj) ヘルパーマップに登録されているクラスのオブジェクトを文字列で表示する。
static int	updateObject(java.sql.Connection conn, java.util.HashMap helperMap, java.lang.Object obj) トランザクション処理を行うためにconn, helperMapを指定してオブエジェクとを更新 する。
static int	updateObject(java.lang.Object obj) createDatasourceで作成された、もしくは呼び出し前にセットされたdataSource、 createHelperMapで作成されたhelperMapを使用して、オブジェクトを更新する。

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

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

コンストラクタの詳細

EDbUtils

public EDbUtils()

メソッドの詳細

getNewOwnerId

public static java.lang.Integer getNewOwnerId()

ENodeMapperで使用するシステムで一意のownerIdを返す。

戻り値:

ownerId

addHelper

public static void addHelper(java.lang.Object obj)

オブジェクトobjのDbHelperをヘルパーマップmapに追加する。
mapは、getMap, setMapで再定義可能である。

パラメータ:

obj -

getTableName

public static java.lang.String getTableName(java.lang.Class cls)

クラスclsに対応するデータベーステーブル名を返す

パラメータ:

cls - クラス

戻り値:

データベーステーブル名

createHelperMap

public static java.util.HashMap createHelperMap(java.lang.Object[] objs)

オブジェクトの配列から各オブジェクトのEDbHelperインスタンスを ヘルパーマップmapに登録し、そのマップを返す。

パラメータ:

objs - オブジェクトの配列

戻り値:

ヘルパーマップ

setTransaction

public static void setTransaction(java.sql.Connection conn)
                           throws java.sql.SQLException

コネクションconnに関する以降の処理をトランザクション処理として 扱えるようにする（AutoCommitをfalseにする）

パラメータ:

conn - コネクション

例外:

java.sql.SQLException - SQL例外

insertMappedList

public static void insertMappedList(java.lang.Object owner,
                                    java.lang.Integer ownerId,
                                    java.util.List list)

リストをENODEMAPPERにマップし、挿入する

パラメータ:

owner - リストを保持するオブジェクト

ownerId - リストのオーナー識別子

list - リスト

loadMappedList

public static java.util.List loadMappedList(java.lang.Object owner,
                                            java.lang.Integer ownerId)

識別子ownerIdを持つオーナーオブジェクトのENODEMAPPERにマップ されたリストをロードする

パラメータ:

owner - リストを保持するオブジェクト

ownerId - リストのオーナー識別子

戻り値:

元のリスト

loadMappedObject

public static java.lang.Object loadMappedObject(java.lang.Integer nodeId)

ENODEMAPPERにマップされたオブジェクトをロードする

パラメータ:

nodeId - ノードマップ識別子

戻り値:

マップされたオブジェクト

insertMappedObject

public static int insertMappedObject(java.lang.Object owner,
                                     java.lang.Integer ownerId,
                                     java.lang.Object obj)

オブジェクトをENODEMAPPERにマップし、挿入する

パラメータ:

owner - オブジェクトを保持するオブジェクト

ownerId - オブジェクトのオーナー識別子

obj - 挿入するオブジェクト

戻り値:

ノードマップ識別子

loadObject

public static java.lang.Object loadObject(java.lang.Class cls,
                                          java.lang.Integer id)

クラスclsに対応するテーブルから、識別子idのオブジェクトを返す

パラメータ:

cls - クラス

id - 識別子

戻り値:

識別子idのオブジェクト

loadObject

public static java.lang.Object loadObject(java.sql.Connection conn,
                                          java.lang.Class cls,
                                          java.lang.Integer id)
                                   throws java.sql.SQLException

コネクションconnを使ってクラスclsに対応するテーブルから、識別子 idのオブジェクトを返す

パラメータ:

conn - コネクション

cls - クラス

id - 識別子

戻り値:

識別子idのオブジェクト

例外:

java.sql.SQLException - SQL例外

selectAll

public static java.util.List selectAll(java.lang.Class cls)

クラスclsに対応するテーブルのすべてのレコードを返す

パラメータ:

cls - クラス

戻り値:

レコードのリスト（要素は、clsのインスタンス）

selectAll

public static java.util.List selectAll(java.sql.Connection conn,
                                       java.lang.Class cls)
                                throws java.sql.SQLException

/** コネクションconnを使ってクラスclsに対応するテーブルの すべてのレコードを返す。

パラメータ:

conn - コネクション

cls - クラス

戻り値:

レコードのリスト（要素は、clsのインスタンス）

例外:

java.sql.SQLException - SQL例外

selectObjects

public static java.util.List selectObjects(java.lang.Class cls,
                                           java.lang.String where)

クラスclsに対応するテーブルの条件whereに該当するレコードを返す。

パラメータ:

cls - クラス

where - WHERE句以降のSQL文

戻り値:

レコードのリスト（要素は、clsのインスタンス）

selectObjects

public static java.util.List selectObjects(java.sql.Connection conn,
                                           java.lang.Class cls,
                                           java.lang.String where)
                                    throws java.sql.SQLException

コネクションconnを使ってクラスclsに対応するテーブルの条件whereに該当するレコードを返す。

パラメータ:

conn - コネクション

cls - クラス

where - WHERE句以降のSQL文

戻り値:

レコードのリスト（要素は、clsのインスタンス）

例外:

java.sql.SQLException - SQL例外

dropTable

public static int dropTable(java.lang.Class cls)

クラスclsに対応するテーブルを削除する。

パラメータ:

cls - クラス

戻り値:

実行結果

dropTable

public static int dropTable(java.sql.Connection conn,
                            java.lang.Class cls)
                     throws java.sql.SQLException

コネクションconnを使ってクラスclsに対応するテーブルを削除する。

パラメータ:

conn - コネクション

cls - クラス

戻り値:

実行結果

例外:

java.sql.SQLException - SQL例外

executeSql

public static int executeSql(java.lang.String sql)

SQL文sqlを実行し、その結果を返す。

パラメータ:

sql - SQL文

戻り値:

実行結果

executeSql

public static int executeSql(java.sql.Connection conn,
                             java.lang.String sql)
                      throws java.sql.SQLException

SQL文sqlを実行し、その結果を返す。

パラメータ:

conn - コネクション

sql - SQL文

戻り値:

実行結果

例外:

java.sql.SQLException - SQL例外

selectScalar

public static java.lang.Object selectScalar(java.lang.String sql)

SQL文sqlを実行し、スカラー値を返す。

パラメータ:

sql - SQL文

戻り値:

スカラー値

selectScalar

public static java.lang.Object selectScalar(java.sql.Connection conn,
                                            java.lang.String sql)
                                     throws java.sql.SQLException

コネクションconnを使ってSQL文sqlを実行し、スカラー値を返す。

パラメータ:

conn - コネクション

sql - SQL文

戻り値:

スカラー値

例外:

java.sql.SQLException - SQL例外

deleteObject

public static int deleteObject(java.lang.Object obj)

createDatasourceで作成された、もしくは呼び出し前にセットされたdataSource、 createHelperMapで作成されたhelperMapを使用して、オブジェクトを削除する。 削除後コミットを自動的に実行する

パラメータ:

obj - 削除するオブジェクト

戻り値:

削除オブジェクト数（通常１）または、エラーコード

deleteObject

public static int deleteObject(java.sql.Connection conn,
                               java.util.HashMap helperMap,
                               java.lang.Object obj)
                        throws java.sql.SQLException

トランザクション処理を行うためにconn, helperMapを指定してオブエジェクとを削除 する。commitは呼び出し元で実行する必要がある。

パラメータ:

conn - コネクション

helperMap - ヘルパーマップ

obj - 削除するオブジェクト

戻り値:

削除オブジェクト数（通常１）または、エラーコード

java.sql.SQLException

updateObject

public static int updateObject(java.lang.Object obj)

createDatasourceで作成された、もしくは呼び出し前にセットされたdataSource、 createHelperMapで作成されたhelperMapを使用して、オブジェクトを更新する。 更新後コミットを自動的に実行する

パラメータ:

obj - 更新するオブジェクト

戻り値:

更新オブジェクト数（通常１）または、エラーコード

updateObject

public static int updateObject(java.sql.Connection conn,
                               java.util.HashMap helperMap,
                               java.lang.Object obj)
                        throws java.sql.SQLException

トランザクション処理を行うためにconn, helperMapを指定してオブエジェクとを更新 する。commitは呼び出し元で実行する必要がある。

パラメータ:

conn - コネクション

helperMap - ヘルパーマップ

obj - 更新するオブジェクト

戻り値:

更新オブジェクト数（通常１）または、エラーコード

java.sql.SQLException

insertObject

public static int insertObject(java.lang.Object obj)

createDatasourceで作成された、もしくは呼び出し前にセットされたdataSource、 createHelperMapで作成されたhelperMapを使用して、オブジェクトを挿入する。 挿入後コミットを自動的に実行する

パラメータ:

obj - 挿入するオブジェクト

戻り値:

オブジェクトのID

insertObject

public static int insertObject(java.sql.Connection conn,
                               java.util.HashMap helperMap,
                               java.lang.Object obj)
                        throws java.sql.SQLException

トランザクション処理を行うためにconn, helperMapを指定してオブエジェクとを挿入 する。commitは呼び出し元で実行する必要がある。

パラメータ:

conn - コネクション

helperMap - ヘルパーマップ

obj - 挿入するオブジェクト

戻り値:

オブジェクトのID

java.sql.SQLException

createTables

public static void createTables()

createDatasourceで作成された、もしくは呼び出し前にセットされたdataSource、 createHelperMapで作成されたhelperMapを使用して、データベースのテーブルを作成する。

createTables

public static void createTables(java.sql.Connection conn,
                                java.util.HashMap helperMap)

与えられたデータソース、ヘルパーマップを使ってデータベースのテーブルを作成する。

パラメータ:

conn - コネクション

helperMap - ヘルパーマップ

dropTables

public static void dropTables()

dropTables

public static void dropTables(java.sql.Connection conn,
                              java.util.HashMap helperMap)

createDatasource

public static javax.sql.DataSource createDatasource(java.lang.String driver,
                                                    java.lang.String url,
                                                    java.lang.String user,
                                                    java.lang.String password)

データソースを作成する

パラメータ:

driver - ドライバー名

url - 接続URL

user - ユーザ名

password - パスワード

戻り値:

データソース

toString

public static java.lang.String toString(java.lang.Object obj)

ヘルパーマップに登録されているクラスのオブジェクトを文字列で表示する。
表示形式は、クラス名：　メンバー名=値, ... すべてのメンバーに対し繰り返す。
単体テストのオブジェクトの比較に利用すると便利である。

パラメータ:

obj - オブジェクト

戻り値:

文字列表現

setDataSource

public static void setDataSource(javax.sql.DataSource source)

データソースをセットする
strutsで定義されたデータソースを利用するときに使用する。

パラメータ:

source -

getMap

public static java.util.HashMap getMap()

現在のヘルパーマップを返す。

戻り値:

ヘルパーマップ