SqlRow (NablarchApi)

java.lang.Object
- java.util.AbstractMap<K,V>
- - nablarch.core.util.map.MapWrapper<V>
  - - nablarch.core.util.map.MultipleKeyCaseMap
    - - nablarch.core.db.statement.SqlRow

All Implemented Interfaces:

java.util.Map
```
@Published
public class SqlRow
extends MultipleKeyCaseMap
```
簡易取得結果1行分のデータを保持するクラス。
各カラムの内容は、そのデータ型に対応したgetメソッドにより取得できる。この際、カラム名の大文字/小文字の違い、アンダースコアの有無は区別せず、同一のカラム名とみなされる。
例:
- USER_NAMEとuser_nameは同一のカラム名とみなされる。(大文字小文字の区別はしないため)
- USER_NAMEとuserNameは同一のカラム名とみなされる。(アンダースコアの有無は区別しないため)
Author:

Hisaaki Sioiri

Constructor Summary

Constructors
Modifier	Constructor and Description
	`SqlRow(java.util.Map row, java.util.Map colType)` 指定されたMapを元にオブジェクトを構築する。
	`SqlRow(java.util.Map row, java.util.Map colType, java.util.Map ignored)` 指定されたMapを元にオブジェクトを構築する。
`protected`	`SqlRow(SqlRow orig)` コピー元となる`SqlRow`からオブジェクトを構築する。

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`java.math.BigDecimal`	`getBigDecimal(java.lang.String colName)` 指定されたカラムの情報を`BigDecimal`として取得する。
`java.lang.Boolean`	`getBoolean(java.lang.String colName)` 指定されたカラムの情報を`Boolean`として取得する。以下の値の場合、`Boolean.TRUE`を返却し、それ以外は全て`Boolean.FALSE`を返却する。 booleanの`true`の場合 `String`の場合で"1" or "on" or "true"の場合(大文字、小文字の区別はしない) 数値型で0以外の場合データベースから取得したデータのデータタイプが下記に該当しない場合は、`IllegalStateException`を送出する。 `Boolean` `String` `Number`のサブクラス
`byte[]`	`getBytes(java.lang.String colName)` 指定されたカラムの情報をbyte配列として取得する。データベースから取得したデータのデータタイプが下記のデータの場合、byte配列として取得する。下記に該当しない場合は、`IllegalStateException`を送出する。 `Types.BLOB` `Types.BINARY` `Types.VARBINARY` `Types.LONGVARBINARY`
`protected int`	`getColType(java.lang.String colName)` 指定されたカラム名のカラムタイプ(`Types`)を取得する。
`java.util.Date`	`getDate(java.lang.String colName)` 指定されたカラムの情報を`Date`として取得する。データベースから取得したデータのデータタイプが下記のデータの場合、java.util.Dateとして取得する下記に該当しない場合は、`IllegalStateException`を送出する。 `Date` `Timestamp`
`java.lang.Integer`	`getInteger(java.lang.String colName)` 指定されたカラムの情報を`Integer`として取得する。データベースから取得したデータがInteger型である場合、その値をそのまま返却する。それ以外の型の場合、そのデータの文字列表現(toString()した結果)を、 `Integer.valueOf(String)`を使用してInteger型に変換し返却する。データベースから取得したデータがどのような文字列表現を返却するかは、使用するRDBMSのJDBCドライバに依存する。以下に例を示す。
`java.lang.Long`	`getLong(java.lang.String colName)` 指定されたカラムの情報を`Long`として取得する。データベースから取得したデータがLong型である場合、その値をそのまま返却する。それ以外の型の場合、そのデータの文字列表現(toString()した結果)を、 `Long.valueOf(String)`を使用してLong型に変換し返却する。データベースから取得したデータがどのような文字列表現を返却するかは、使用するRDBMSのJDBCドライバに依存する。
`java.lang.String`	`getString(java.lang.String colName)` 指定されたカラムの情報を文字列で取得する。
`java.sql.Timestamp`	`getTimestamp(java.lang.String colName)` 指定されたカラムの情報を`Timestamp`として取得する。データベースから取得したデータのデータタイプが下記のデータの場合、`Timestamp`として取得する。下記に該当しない場合は、`IllegalStateException`を送出する。 `Timestamp`

Methods inherited from class nablarch.core.util.map.MultipleKeyCaseMap
containsKey, get, put, putAll

Methods inherited from class nablarch.core.util.map.MapWrapper
clear, containsValue, entrySet, isEmpty, keySet, remove, size, values

- Constructor Detail
  - SqlRow
```
public SqlRow(java.util.Map row,
              java.util.Map colType)
```
    指定されたMapを元にオブジェクトを構築する。
    
    Parameters:
    
    row - 1行分のデータを持つMap
    
    colType - カラムタイプ
  - SqlRow
```
public SqlRow(java.util.Map row,
              java.util.Map colType,
              java.util.Map ignored)
```
    指定されたMapを元にオブジェクトを構築する。
    
    Parameters:
    
    row - 1行分のデータを持つMap
    
    colType - カラムタイプ
    
    ignored - カラム名の紐付け情報(本引数は使用しない)
  - SqlRow
```
protected SqlRow(SqlRow orig)
```
    コピー元となるSqlRowからオブジェクトを構築する。
    
    Parameters:
    
    orig - コピー元となるインスタンス
- Method Detail
  - getString
```
public final java.lang.String getString(java.lang.String colName)
```
    指定されたカラムの情報を文字列で取得する。
    
    Parameters:
    
    colName - カラム名
    
    Returns:
    
    指定されたカラム名に対応するString型データ(toString()した結果を返却する)。データベースの検索結果がnullの場合には、nullを返却する
    
    Throws:
    
    java.lang.IllegalArgumentException - 指定されたカラム名が存在しない場合
  - getInteger
```
public final java.lang.Integer getInteger(java.lang.String colName)
```
    指定されたカラムの情報をIntegerとして取得する。
    データベースから取得したデータがInteger型である場合、その値をそのまま返却する。
    それ以外の型の場合、そのデータの文字列表現(toString()した結果)を、 Integer.valueOf(String)を使用してInteger型に変換し返却する。
    データベースから取得したデータがどのような文字列表現を返却するかは、使用するRDBMSのJDBCドライバに依存する。
    以下に例を示す。
```
 | 文字列表現 | 結果                  |
 |------------+-----------------------|
 | "1"        |                     1 |
 | "-1"       |                    -1 |
 |"2147483648"| NumberFormatException |
 | "1.0"      | NumberFormatException |
 | "ABC"      | NumberFormatException |
 
```
    Parameters:
    
    colName - カラム名
    
    Returns:
    
    指定されたカラム名に対応するInteger型データ。データベースの検索結果がnullの場合には、nullを返却する
    
    Throws:
    
    java.lang.NumberFormatException - データベースから取得したデータの文字列表現が、Integer型として解釈できない場合
    
    java.lang.IllegalArgumentException - 指定されたカラム名が存在しない場合
  - getLong
```
public final java.lang.Long getLong(java.lang.String colName)
```
    指定されたカラムの情報をLongとして取得する。
    データベースから取得したデータがLong型である場合、その値をそのまま返却する。
    それ以外の型の場合、そのデータの文字列表現(toString()した結果)を、 Long.valueOf(String)を使用してLong型に変換し返却する。
    データベースから取得したデータがどのような文字列表現を返却するかは、使用するRDBMSのJDBCドライバに依存する。
    以下に例を示す。
```
 | 文字列表現 | 結果                  |
 |------------+-----------------------|
 | "1"        |                     1 |
 | "-1"       |                    -1 |
 |"2147483648"|            2147483648 |
 | "1.0"      | NumberFormatException |
 | "ABC"      | NumberFormatException |
 
```
    Parameters:
    
    colName - カラム名
    
    Returns:
    
    指定されたカラム名に対応するLong型データ。データベースの検索結果がnullの場合には、nullを返却する
    
    Throws:
    
    java.lang.NumberFormatException - データベースから取得したデータの文字列表現が、Long型として解釈できない場合
    
    java.lang.IllegalArgumentException - 指定されたカラム名が存在しない場合
  - getBoolean
```
public java.lang.Boolean getBoolean(java.lang.String colName)
```
    指定されたカラムの情報をBooleanとして取得する。
    以下の値の場合、Boolean.TRUEを返却し、それ以外は全てBoolean.FALSEを返却する。
    - booleanのtrueの場合
    - Stringの場合で"1" or "on" or "true"の場合(大文字、小文字の区別はしない)
    - 数値型で0以外の場合
    データベースから取得したデータのデータタイプが下記に該当しない場合は、IllegalStateExceptionを送出する。
    - Boolean
    - String
    - Numberのサブクラス
    Parameters:
    
    colName - カラム名
    
    Returns:
    
    true or falseを返却する。データベースの検索結果がnullの場合には、nullを返却する
    
    Throws:
    
    java.lang.IllegalArgumentException - 指定されたカラム名が存在しない場合
  - getBigDecimal
```
public final java.math.BigDecimal getBigDecimal(java.lang.String colName)
```
    指定されたカラムの情報をBigDecimalとして取得する。
    
    Parameters:
    
    colName - カラム名
    
    Returns:
    
    指定されたカラム名に対応するBigDecimal型データ。データベースの検索結果がnullの場合には、nullを返却する
    
    Throws:
    
    java.lang.NumberFormatException - データベースから取得したデータの文字列表現(toString()した結果)が、BigDecimal型として解釈できない場合
    
    java.lang.IllegalArgumentException - 指定されたカラム名が存在しない場合
  - getDate
```
public java.util.Date getDate(java.lang.String colName)
```
    指定されたカラムの情報をDateとして取得する。
    データベースから取得したデータのデータタイプが下記のデータの場合、java.util.Dateとして取得する下記に該当しない場合は、IllegalStateExceptionを送出する。
    - Date
    - Timestamp
    Parameters:
    
    colName - カラム名
    
    Returns:
    
    指定されたカラム名に対応するjava.util.Date型データ。データベースの検索結果がnullの場合には、nullを返却する
    
    Throws:
    
    java.lang.IllegalArgumentException - 指定されたカラム名が存在しない場合
  - getTimestamp
```
public java.sql.Timestamp getTimestamp(java.lang.String colName)
```
    指定されたカラムの情報をTimestampとして取得する。
    データベースから取得したデータのデータタイプが下記のデータの場合、Timestampとして取得する。下記に該当しない場合は、IllegalStateExceptionを送出する。
    - Timestamp
    Parameters:
    
    colName - カラム名
    
    Returns:
    
    指定されたカラム名に対応するjava.sql.Timestamp型データ
    
    Throws:
    
    java.lang.IllegalArgumentException - 指定されたカラム名が存在しない場合
  - getBytes
```
public byte[] getBytes(java.lang.String colName)
```
    指定されたカラムの情報をbyte配列として取得する。
    データベースから取得したデータのデータタイプが下記のデータの場合、byte配列として取得する。
    下記に該当しない場合は、IllegalStateExceptionを送出する。
    - Types.BLOB
    - Types.BINARY
    - Types.VARBINARY
    - Types.LONGVARBINARY
    Parameters:
    
    colName - カラム名
    
    Returns:
    
    指定されたカラム名に対応するbyte配列データ。データベースの検索結果がnullの場合には、nullを返却する
    
    Throws:
    
    java.lang.IllegalArgumentException - 指定されたカラム名が存在しない場合
    
    DbAccessException - データタイプがBLOB型である場合で、データの読み込みに失敗した場合
  - getColType
```
protected int getColType(java.lang.String colName)
```
    指定されたカラム名のカラムタイプ(Types)を取得する。
    
    Parameters:
    
    colName - カラム名
    
    Returns:
    
    カラムタイプ

Class SqlRow

Constructor Summary

Method Summary

Methods inherited from class nablarch.core.util.map.MultipleKeyCaseMap

Methods inherited from class nablarch.core.util.map.MapWrapper

Constructor Detail

SqlRow

SqlRow

SqlRow

Method Detail

getString

getInteger

getLong

getBoolean

getBigDecimal

getDate

getTimestamp

getBytes

getColType