nablarch.core.db.statement

クラス SqlRow

java.lang.Object

java.util.AbstractMap<K,V>

nablarch.core.util.map.MapWrapper<V>

nablarch.core.util.map.MultipleKeyCaseMap

nablarch.core.db.statement.SqlRow

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

Map

@Published
public class SqlRow
extends MultipleKeyCaseMap

簡易取得結果1行分のデータを保持するクラス。

各カラムの内容は、そのデータ型に対応したgetメソッドにより取得できる。 この際、カラム名の大文字/小文字の違い、アンダースコアの有無は区別せず、 同一のカラム名とみなされる。

例:

• USER_NAMEとuser_nameは同一のカラム名とみなされる。(大文字小文字の区別はしないため)
• USER_NAMEとuserNameは同一のカラム名とみなされる。(アンダースコアの有無は区別しないため)

作成者:

Hisaaki Sioiri

コンストラクタのサマリー

コンストラクタ

修飾子	コンストラクタと説明
	SqlRow(Map row, Map colType) 指定されたMapを元にオブジェクトを構築する。
	SqlRow(Map row, Map colType, nablarch.core.db.dialect.Dialect dialect) 指定されたMapを元にオブジェクトを構築する。
	SqlRow(Map row, Map colType, Map ignored) 指定されたMapを元にオブジェクトを構築する。
protected	SqlRow(SqlRow orig) コピー元となるSqlRowからオブジェクトを構築する。

メソッドのサマリー

修飾子とタイプ	メソッドと説明
BigDecimal	getBigDecimal(String colName) 指定されたカラムの情報をBigDecimalとして取得する。
Boolean	getBoolean(String colName) 指定されたカラムの情報をBooleanとして取得する。
byte[]	getBytes(String colName) 指定されたカラムの情報をbyte配列として取得する。
protected int	getColType(String colName) 指定されたカラム名のカラムタイプ(Types)を取得する。
Date	getDate(String colName) 指定されたカラムの情報をDateとして取得する。
Integer	getInteger(String colName) 指定されたカラムの情報をIntegerとして取得する。
Long	getLong(String colName) 指定されたカラムの情報をLongとして取得する。
<T> T	getObject(String colName, Class<T> javaType) 指定されたカラムの情報を指定された型として取得する。
String	getString(String colName) 指定されたカラムの情報を文字列で取得する。
Timestamp	getTimestamp(String colName) 指定されたカラムの情報をTimestampとして取得する。

クラスから継承されたメソッド nablarch.core.util.map.MultipleKeyCaseMap

containsKey, get, put, putAll

クラスから継承されたメソッド nablarch.core.util.map.MapWrapper

clear, containsValue, entrySet, isEmpty, keySet, remove, size, values

コンストラクタの詳細

SqlRow

public SqlRow(Map row,
              Map colType)

指定されたMapを元にオブジェクトを構築する。

パラメータ:

row - 1行分のデータを持つMap

colType - カラムタイプ

SqlRow

public SqlRow(Map row,
              Map colType,
              Map ignored)

指定されたMapを元にオブジェクトを構築する。

パラメータ:

row - 1行分のデータを持つMap

colType - カラムタイプ

ignored - カラム名の紐付け情報(本引数は使用しない)

SqlRow

protected SqlRow(SqlRow orig)

コピー元となるSqlRowからオブジェクトを構築する。

パラメータ:

orig - コピー元となるインスタンス

SqlRow

public SqlRow(Map row,
              Map colType,
              nablarch.core.db.dialect.Dialect dialect)

指定されたMapを元にオブジェクトを構築する。

パラメータ:

row - 1行分のデータを持つMap

colType - カラムタイプ

dialect - データベースの方言

メソッドの詳細

getString

public final String getString(String colName)

指定されたカラムの情報を文字列で取得する。

パラメータ:

colName - カラム名

戻り値:

指定されたカラム名に対応するString型データ データベースの検索結果がnullの場合には、nullを返却する

例外:

IllegalArgumentException - 指定されたカラム名が存在しない場合

関連項目:

Dialect#convertFromDatabase(Object, Class)

getInteger

public final Integer getInteger(String colName)

指定されたカラムの情報をIntegerとして取得する。

パラメータ:

colName - カラム名

戻り値:

指定されたカラム名に対応するInteger型データ。 データベースの検索結果がnullの場合には、nullを返却する

例外:

IllegalStateException - データベースから取得したデータの文字列表現が、Integer型として解釈できない場合

IllegalArgumentException - 指定されたカラム名が存在しない場合

関連項目:

DefaultDialect#convertFromDatabase(Object, Class)

getLong

public final Long getLong(String colName)

指定されたカラムの情報をLongとして取得する。

パラメータ:

colName - カラム名

戻り値:

指定されたカラム名に対応するLong型データ。 データベースの検索結果がnullの場合には、nullを返却する

例外:

IllegalStateException - データベースから取得したデータの文字列表現が、Long型として解釈できない場合

IllegalArgumentException - 指定されたカラム名が存在しない場合

関連項目:

Dialect#convertFromDatabase(Object, Class)

getBoolean

public Boolean getBoolean(String colName)

指定されたカラムの情報をBooleanとして取得する。

パラメータ:

colName - カラム名

戻り値:

true or falseを返却する。 データベースの検索結果がnullの場合には、nullを返却する

例外:

IllegalArgumentException - 指定されたカラム名が存在しない場合

IllegalStateException - データベースから取得したデータがBoolean型として解釈できない場合

関連項目:

Dialect#convertFromDatabase(Object, Class)

getBigDecimal

public final BigDecimal getBigDecimal(String colName)

指定されたカラムの情報をBigDecimalとして取得する。

パラメータ:

colName - カラム名

戻り値:

指定されたカラム名に対応するBigDecimal型データ。 データベースの検索結果がnullの場合には、nullを返却する

例外:

IllegalStateException - データベースから取得したデータが、BigDecimalとして解釈できない場合

IllegalArgumentException - 指定されたカラム名が存在しない場合

関連項目:

Dialect#convertFromDatabase(Object, Class)

getDate

public Date getDate(String colName)

指定されたカラムの情報をDateとして取得する。

パラメータ:

colName - カラム名

戻り値:

指定されたカラム名に対応するjava.util.Date型データ。 データベースの検索結果がnullの場合には、nullを返却する

例外:

IllegalArgumentException - 指定されたカラム名が存在しない場合

IllegalStateException - データベースから取得したデータがjava.util.Date型として解釈できない場合

関連項目:

Dialect#convertFromDatabase(Object, Class)

getTimestamp

public Timestamp getTimestamp(String colName)

指定されたカラムの情報をTimestampとして取得する。

パラメータ:

colName - カラム名

戻り値:

指定されたカラム名に対応するjava.sql.Timestamp型データ

例外:

IllegalArgumentException - 指定されたカラム名が存在しない場合

IllegalStateException - データベースから取得したデータがjava.sql.Timestamp型として解釈できない場合

関連項目:

Dialect#convertFromDatabase(Object, Class)

getBytes

public byte[] getBytes(String colName)

指定されたカラムの情報をbyte配列として取得する。

パラメータ:

colName - カラム名

戻り値:

指定されたカラム名に対応するbyte配列データ。 データベースの検索結果がnullの場合には、nullを返却する

例外:

IllegalArgumentException - 指定されたカラム名が存在しない場合

DbAccessException - データタイプがBLOB型である場合で、データの読み込みに失敗した場合

IllegalStateException - データベースから取得したデータがbyte配列として解釈できない場合

関連項目:

Dialect#convertFromDatabase(Object, Class)

getObject

public <T> T getObject(String colName,
                       Class<T> javaType)

指定されたカラムの情報を指定された型として取得する。

型パラメータ:

T - 取得する型

パラメータ:

colName - カラム名

javaType - 取得するクラス

戻り値:

指定されたカラムを指定のクラスに変換した値

例外:

IllegalArgumentException - 指定されたカラム名が存在しない場合

DbAccessException - データタイプがBLOB型である場合で、データの読み込みに失敗した場合

IllegalStateException - データベースから取得したデータが指定の型として解釈できない場合

関連項目:

Dialect#convertFromDatabase(Object, Class)

getColType

protected int getColType(String colName)

指定されたカラム名のカラムタイプ(Types)を取得する。

パラメータ:

colName - カラム名

戻り値:

カラムタイプ