Hitachi

ノンストップデータベース　HiRDB Version 10 UAP開発ガイド

17.4.6　ResultSetインタフェース

〈この項の構成〉

(1)　概要

ResultSetインタフェースでは，主に次の機能が提供されます。

ページの先頭へ

(2)　メソッド

ResultSetインタフェースのメソッド一覧を次の表に示します。なお，表に記載されていないメソッドはサポートしていません。サポートしていないメソッドを指定すると，SQLExceptionを投入します。

表17‒36　ResultSetインタフェースのメソッド一覧

メソッド

提供ドライバ

機能

JDBC2.0

JDBC4.0

absolute(int row)

○

○

カーソルを，このResultSetオブジェクト内の指定された行に移動します。

afterLast()

○

○

カーソルを，このResultSetオブジェクトの最終行の後ろに移動します。

beforeFirst()

○

○

カーソルを，このResultSetオブジェクトの先頭行の前に移動します。

clearWarnings()

○

○

このResultSetオブジェクトに関して報告された，すべての警告をクリアします。

close()

○

○

このResultSetオブジェクトでオープンしていたデータベースのカーソルをクローズし，JDBCリソースを解放します。

findColumn(String columnName)

○

○

指定された列名を列番号にマッピングします。

first()

○

○

カーソルを，このResultSetオブジェクト内の先頭行に移動します。

getArray(int i)

○

○

このResultSetオブジェクトの現在行にある，指定された列番号の繰返し列の要素を，Arrayオブジェクトとして取得します。

getArray(String colName)

○

○

ResultSetオブジェクトの現在行にある，指定された列名の繰返し列の要素を，Arrayオブジェクトとして取得します。

getAsciiStream(int columnIndex)

○

○

このResultSetオブジェクトの現在行にある指定された列の値を，PrdbDataStreamオブジェクトとして取得します。

getAsciiStream(String columnName)

○

○

このResultSetオブジェクトの現在行にある指定された列の値を，PrdbDataStreamオブジェクトとして取得します。

getBigDecimal(int columnIndex)

○

○

このResultSetオブジェクトの現在行にある指定された列の値を，java.math.BigDecimalオブジェクトとして取得します。

getBigDecimal(int columnIndex, int scale)

○

○

このResultSetオブジェクトの現在行にある指定された列の値を，scaleで指定された小数点以下のけた数を持つjava.math.BigDecimalオブジェクトとして取得します。

getBigDecimal(String columnName)

○

○

このResultSetオブジェクトの現在行にある指定された列の値を，java.math.BigDecimalオブジェクトとして取得します。

getBigDecimal(String columnName, int scale)

○

○

このResultSetオブジェクトの現在行にある指定された列の値を，scaleで指定された小数点以下のけた数を持つjava.math.BigDecimalオブジェクトとして取得します。

getBinaryStream(int columnIndex)

○

○

このResultSetオブジェクトの現在行にある，列番号で指定された列の値を，バイナリストリームとして取得します。

getBinaryStream(String columnName)

○

○

このResultSetオブジェクトの現在行にある，指定された列の値を，バイナリストリームとして取得します。

getBlob(int i)

○

○

このResultSetオブジェクトの現在行にある，列番号で指定された列の値を，java.sql.Blobオブジェクトとして取得します。

getBlob(String colName)

○

○

このResultSetオブジェクトの現在行にある，指定された列の値を，java.sql.Blobオブジェクトとして取得します。

getBoolean(int columnIndex)

○

○

このResultSetオブジェクトの現在行にある指定された列の値を，Javaプログラミング言語のbooleanとして取得します。

getBoolean(String columnName)

○

○

このResultSetオブジェクトの現在行にある指定された列の値を，Javaプログラミング言語のbooleanとして取得します。

getByte(int columnIndex)

○

○

このResultSetオブジェクトの現在行にある指定された列の値を，Javaプログラミング言語のbyteとして取得します。

getByte(String columnName)

○

○

このResultSetオブジェクトの現在行にある指定された列の値を，Javaプログラミング言語のbyteとして取得します。

getBytes(int columnIndex)

○

○

ResultSetオブジェクトの現在行にある指定された列の値を，Javaプログラミング言語のbyte配列として取得します。

getBytes(String columnName)

○

○

このResultSetオブジェクトの現在行にある指定された列の値を，Javaプログラミング言語のbyte配列として取得します。

getCharacterStream(int columnIndex)

○

○

このResultSetオブジェクトの現在行にある指定された列の値を，java.io.Readerオブジェクトとして取得します。

getCharacterStream(String columnName)

○

○

このResultSetオブジェクトの現在行にある指定された列の値を，java.io.Readerオブジェクトとして取得します。

getConcurrency()

○

○

このResultSetオブジェクトの並行処理モードを返します。

getCursorName()

○

○

このResultSetオブジェクトが使用するSQLカーソルの名前を取得します。

getDate(int columnIndex)

○

○

このResultSetオブジェクトの現在行にある指定された列の値を，java.sql.Dateオブジェクトとして取得します。

getDate(int columnIndex, Calendar cal)

○

○

このResultSetオブジェクトの現在行にある指定された列の値を，java.sql.Dateオブジェクトとして取得します。

getDate(String columnName)

○

○

このResultSetオブジェクトの現在行にある指定された列の値を，java.sql.Dateオブジェクトとして取得します。

getDate(String columnName, Calendar cal)

○

○

このResultSetオブジェクトの現在行にある指定された列の値を，java.sql.Dateオブジェクトとして取得します。

getDouble(int columnIndex)

○

○

このResultSetオブジェクトの現在行にある指定された列の値を，Javaプログラミング言語のdoubleとして取得します。

getDouble(String columnName)

○

○

このResultSetオブジェクトの現在行にある指定された列の値を，Javaプログラミング言語のdoubleとして取得します。

getFetchDirection()

○

○

このResultSetオブジェクトのフェッチ方向を取得します。

getFetchSize()

○

○

このResultSetオブジェクトのフェッチサイズを取得します。

getFloat(int columnIndex)

○

○

このResultSetオブジェクトの現在行にある指定された列の値を，Javaプログラミング言語のfloatとして取得します。

getFloat(String columnName)

○

○

このResultSetオブジェクトの現在行にある指定された列の値を，Javaプログラミング言語のfloatとして取得します。

getInt(int columnIndex)

○

○

このResultSetオブジェクトの現在行にある指定された列の値を，Javaプログラミング言語のintとして取得します。

getInt(String columnName)

○

○

このResultSetオブジェクトの現在行にある指定された列の値を，Javaプログラミング言語のintとして取得します。

getLong(int columnIndex)

○

○

このResultSetオブジェクトの現在行にある指定された列の値を，Javaプログラミング言語のlongとして取得します。

getLong(String columnName)

○

○

このResultSetオブジェクトの現在行にある指定された列の値を，Javaプログラミング言語のlongとして取得します。

getMetaData()

○

○

このResultSetオブジェクトのメタ情報を表すResultSetMetaDataを返します。

getObject(int columnIndex)

○

○

このResultSetオブジェクトの現在行にある指定された列の値を，Javaプログラミング言語のObjectとして取得します。

getObject(String columnName)

○

○

このResultSetオブジェクトの現在行にある指定された列の値を，Javaプログラミング言語のObjectとして取得します。

getRow()

○

○

現在の行の番号を取得します。

getShort(int columnIndex)

○

○

このResultSetオブジェクトの現在行にある指定された列の値を，Javaプログラミング言語のshortとして取得します。

getShort(String columnName)

○

○

このResultSetオブジェクトの現在行にある指定された列の値を，Javaプログラミング言語のshortとして取得します。

getStatement()

○

○

このResultSetオブジェクトを生成したStatementオブジェクトを取得します。

getString(int columnIndex)

○

○

このResultSetオブジェクトの現在行にある指定された列の値を，Javaプログラミング言語のStringとして取得します。

getString(String columnName)

○

○

このResultSetオブジェクトの現在行にある指定された列の値を，Javaプログラミング言語のStringとして取得します。

getTime(int columnIndex)

○

○

このResultSetオブジェクトの現在行にある指定された列の値を，java.sql.Timeとして取得します。

getTime(int columnIndex, Calendar cal)

○

○

このResultSetオブジェクトの現在行にある指定された列の値を，java.sql.Timeオブジェクトとして取得します。

getTime(String columnName)

○

○

このResultSetオブジェクトの現在行にある指定された列の値を，java.sql.Timeオブジェクトとして取得します。

getTime(String columnName, Calendar cal)

○

○

このResultSetオブジェクトの現在行にある指定された列の値を，java.sql.Timeオブジェクトとして取得します。

getTimestamp(int columnIndex)

○

○

このResultSetオブジェクトの現在行にある指定された列の値を，java.sql.Timestampオブジェクトとして取得します。

getTimestamp(int columnIndex, Calendar cal)

○

○

このResultSetオブジェクトの現在行にある指定された列の値を，java.sql.Timestampオブジェクトとして取得します。

getTimestamp(String columnName)

○

○

このResultSetオブジェクトの現在行にある指定された列の値を，java.sql.Timestampオブジェクトとして取得します。

getTimestamp(String columnName, Calendar cal)

○

○

このResultSetオブジェクトの現在行にある指定された列の値を，java.sql.Timestampオブジェクトとして取得します。

getType()

○

○

このResultSetオブジェクトの型を返します。

getWarnings()

○

○

このResultSetオブジェクトに関する呼び出しによって報告される，最初の警告を取得します。

isAfterLast()

○

○

カーソルが，このResultSetオブジェクト内の最終行の後ろにあるかどうかを取得します。

isBeforeFirst()

○

○

カーソルが，このResultSetオブジェクト内の先頭行の前にあるかどうかを取得します。

isFirst()

○

○

カーソルが，このResultSetオブジェクト内の先頭行にあるかどうかを取得します。

isLast()

○

○

カーソルが，このResultSetオブジェクトの最終行にあるかどうかを取得します。

last()

○

○

カーソルを，このResultSetオブジェクトの最終行に移動します。

next()

○

○

カーソルを，現在の位置から次の行に移動します。

previous()

○

○

カーソルを，このResultSetオブジェクト内の一つ前の行に移動します。

relative(int rows)

○

○

カーソルを，正又は負の相対行数だけ移動します。

setFetchDirection(int direction)

○

○

このStatementオブジェクトから生成される結果集合の，デフォルトのフェッチ方向を指定します。

setFetchSize(int rows)

○

○

このResultSetオブジェクトのフェッチサイズを設定します。

wasNull()

○

○

最後に取得した列の値が，NULL値であるかどうかを通知します。

getHoldability()

×

○

ResultSetオブジェクトの保持機能についての状態を示す値を取得します。

isClosed()

×

○

ResultSetオブジェクトがクローズされているかどうかの情報を取得します。
（凡例）

○：提供されます。

×：提供されません。

(a)　absolute(int row)

【機能】

カーソルを，このResultSetオブジェクト内の指定された行に移動します。

【形式】
public synchronized boolean absolute(int row) throws SQLException
【引数】
int row：

カーソルの移動先の行番号。正の番号は行番号が結果セットの先頭からカウントされることを示し，負の番号は終端からカウントされることを示します。

【戻り値】

このメソッド呼び出し後のカーソル位置が，先頭行の前又は最終行の後ろの場合はfalse，そうでない場合はtrueを返します。

【機能詳細】

カーソルを，このResultSetオブジェクト内の指定された行に移動します。

このメソッド呼び出し後のカーソル移動位置と戻り値を次の表に示します。

表17‒37　absoluteの移動先と戻り値

結果集合の行数※

rowの指定値

移動先

戻り値

0

0以外

先頭行の前のまま

false

n

n＜row

最終行の後ろ

false

1≦row≦n

row

true

-n≦row≦-1

(n+1)＋row

true

row＜-n

先頭行の前

false
注※

setMaxRowsの値より実際の行数の方が多い場合は，setMaxRowsの値です。

【発生する例外】

次の場合，SQLExceptionを投入します。

  • このResultSetオブジェクトがcloseされている場合

    このResultSetオブジェクトを生成したStatementをcloseしたことによって，このドライバがResultSetをcloseした場合を含みます。

  • このResultSetオブジェクトを生成したStatementを作成したConnectionがcloseされている場合

  • このResultSetオブジェクトの型がTYPE_FORWARD_ONLYの場合

  • row=0が指定された場合

  • トランザクションの決着によってResultSetが無効になった場合

  • データベースアクセスでエラーが発生した場合

(b)　afterLast()

【機能】

カーソルを，このResultSetオブジェクトの最終行の後ろに移動します。

【形式】
public synchronized void afterLast() throws SQLException
【引数】

なし。

【戻り値】

なし。

【機能詳細】

カーソルを，このResultSetオブジェクトの最終行の後ろに移動します。

このメソッド呼び出し時のカーソル位置移動先を次の表に示します。

表17‒38　afterLastの移動先

結果集合の行数※

現在の行

afterLast()呼び出し後の行

0

先頭行の前

先頭行の前のまま

n

先頭行の前

最終行の後ろ

1≦現在の行≦n

最終行の後ろ

最終行の後ろ

最終行の後ろのまま
注※

setMaxRowsの値より実際の行数の方が多い場合は，setMaxRowsの値です。

【発生する例外】

次の場合，SQLExceptionを投入します。

  • このResultSetオブジェクトがcloseされている場合

    このResultSetオブジェクトを生成したStatementをcloseしたことによって，このドライバがResultSetをcloseした場合を含みます。

  • このResultSetオブジェクトを生成したStatementを作成したConnectionがcloseされている場合

  • このResultSetオブジェクトの型がTYPE_FORWARD_ONLYの場合

  • トランザクションの決着によってResultSetが無効になった場合

  • データベースアクセスでエラーが発生した場合

(c)　beforeFirst()

【機能】

カーソルを，このResultSetオブジェクトの先頭行の前に移動します。

【形式】
public synchronized void beforeFirst() throws SQLException
【引数】

なし。

【戻り値】

なし。

【機能詳細】

カーソルを，このResultSetオブジェクトの先頭行の前に移動します。

このメソッド呼び出し時のカーソル位置移動先を次の表に示します。

表17‒39　beforeFirstの移動先

結果集合の行数※

現在の行

beforeFirst()呼び出し後の行

0

先頭行の前

先頭行の前のまま

n

先頭行の前

先頭行の前のまま

1≦現在の行≦n

先頭行の前

最終行の後ろ

先頭行の前
注※

setMaxRowsの値より実際の行数の方が多い場合は，setMaxRowsの値です。

【発生する例外】

次の場合，SQLExceptionを投入します。

  • このResultSetオブジェクトがcloseされている場合

    このResultSetオブジェクトを生成したStatementをcloseしたことによって，このドライバがResultSetをcloseした場合を含みます。

  • このResultSetオブジェクトを生成したStatementを作成したConnectionがcloseされている場合

  • このResultSetオブジェクトの型がTYPE_FORWARD_ONLYの場合

  • トランザクションの決着によってResultSetが無効になった場合

  • データベースアクセスでエラーが発生した場合

(d)　clearWarnings()

【機能】

このResultSetオブジェクトに関して報告された，すべての警告をクリアします。

【形式】
public synchronized void clearWarnings() throws SQLException
【引数】

なし。

【戻り値】

なし。

【発生する例外】

トランザクションの決着によってResultSetが無効になった場合，SQLExceptionを投入します。

(e)　close()

【機能】

このResultSetオブジェクトでオープンしていたデータベースのカーソルをクローズし，JDBCリソースを解放します。

【形式】
public synchronized void close() throws SQLException
【引数】

なし。

【戻り値】

なし。

【発生する例外】

データベースアクセスでエラーが発生した場合，SQLExceptionを投入します。

(f)　findColumn(String columnName)

【機能】

指定された列名を列番号にマッピングします。

【形式】
public synchronized int findColumn(String columnName) throws SQLException
【引数】
String columnName：

列名。大文字と小文字は区別しません。columnNameの文字列すべてを列名として扱うため，文字列に引用符「"」が含まれている場合，引用符「"」も列名に含まれます。columnNameの指定値がnull，又は0長文字列の場合，必ず列が存在しないエラーとなります。

columnNameの値と一致する列が複数ある場合，列番号が小さい方が優先されます。また，列名が長いためHiRDBサーバの仕様によって後ろが切り捨てられる場合，切り捨てられた列名が指定されていれば，一致しているとみなします。

【戻り値】

指定された列名に対応する列番号

【機能詳細】

引数columnNameを列名とし，対応する列番号を取得して返します。

【発生する例外】

次の場合，SQLExceptionを投入します。

  • このResultSetオブジェクトがcloseされている場合

    このResultSetオブジェクトを生成したStatementをcloseしたことによって，このドライバがResultSetをcloseした場合を含みます。

  • このResultSetオブジェクトを生成したStatementを作成したConnectionがcloseされている場合

  • トランザクションの決着によってResultSetが無効になった場合

  • 指定された列がない場合

  • データベースアクセスでエラーが発生した場合

(g)　first()

【機能】

カーソルを，このResultSetオブジェクト内の先頭行に移動します。

【形式】
public synchronized boolean first() throws SQLException
【引数】

なし。

【戻り値】

結果集合の行数が0の場合はfalse，そうでない場合はtrueを返します。

【発生する例外】

次の場合，SQLExceptionを投入します。

  • このResultSetオブジェクトがcloseされている場合

    このResultSetオブジェクトを生成したStatementをcloseしたことによって，このドライバがResultSetをcloseした場合を含みます。

  • このResultSetオブジェクトを生成したStatementを作成したConnectionがcloseされている場合

  • このResultSetオブジェクトの型がTYPE_FORWARD_ONLYの場合

  • トランザクションの決着によってResultSetが無効になった場合

  • データベースアクセスでエラーが発生した場合

(h)　getArray(int i)

【機能】

このResultSetオブジェクトの現在行にある，指定された列番号の繰返し列の要素を，Arrayオブジェクトとして取得します。

【形式】
public Array getArray(int i) throws SQLException
【引数】
int i：

列番号

【戻り値】

指定された列に対応するArrayオブジェクトを返します。繰返し列の列全体がnull値の場合，nullを返します。

【発生する例外】

次の場合，SQLExceptionを投入します。

  • このResultSetオブジェクトがcloseされている場合

    このResultSetオブジェクトを生成したStatementオブジェクトをcloseしたことによって，このドライバがResultSetオブジェクトをcloseした場合を含みます。

  • このResultSetオブジェクトを生成したStatementオブジェクトを作成したConnectionオブジェクトがcloseされている場合

  • トランザクションの決着によってResultSetオブジェクトが無効になった場合

  • 引数iに存在しない列番号が指定されている場合

  • 引数iに指定された列番号が示す列が繰返し列ではない場合

  • JDBCドライバ内でエラーが発生した場合

(i)　getArray(String colName)

【機能】

ResultSetオブジェクトの現在行にある，指定された列名の繰返し列の要素を，Arrayオブジェクトとして取得します。

【形式】
public Array getArray(String colName) throws SQLException
【引数】
String colName：

列名

【戻り値】

指定された列名に対応するArrayオブジェクト（繰返し列の列全体がnull値の場合，nullを返します）

【発生する例外】

次の場合，SQLExceptionを投入します。

  • このResultSetオブジェクトがcloseされている場合

    このResultSetオブジェクトを生成したStatementオブジェクトをcloseしたことによって，このドライバがResultSetオブジェクトをcloseした場合を含みます。

  • このResultSetオブジェクトを生成したStatementオブジェクトを作成したConnectionオブジェクトがcloseされている場合

  • トランザクションの決着によってResultSetオブジェクトが無効になった場合

  • 引数colNameに指定した列が存在しない，又はnullである場合

  • JDBCドライバ内でエラー発生した場合

(j)　getAsciiStream(int columnIndex)

【機能】

このResultSetオブジェクトの現在行にある指定された列の値を，PrdbDataStreamオブジェクトとして取得します。

【形式】
public synchronized InputStream getAsciiStream (int columnIndex) throws SQLException
【引数】
int columnIndex：

列番号

【戻り値】

列値を設定したPrdbDataStreamオブジェクト（値がNULL値の場合はnullを返します）

【機能詳細】

このResultSetオブジェクトの現在行にある指定された列の値を，PrdbDataStreamオブジェクトとして取得します。ASCII文字への変換は行いません。

HiRDBのデータ型による検索結果と戻り値の関係を次に示します。

HiRDBのデータ型

検索結果

戻り値

[M｜N][VAR]CHAR

BINARY

BLOB

NULL

null

上記以外

検索結果を格納したInputStreamオブジェクト

その他

−

SQLExceptionを投入

（凡例）　−：該当しません。

【発生する例外】

次の場合，SQLExceptionを投入します。

  • このResultSetオブジェクトがcloseされている場合

    このResultSetオブジェクトを生成したStatementをcloseしたことによって，このドライバがResultSetをcloseした場合を含みます。

  • このResultSetオブジェクトを生成したStatementを作成したConnectionがcloseされている場合

  • トランザクションの決着によってResultSetが無効になった場合

  • 存在しない列番号が指定されている場合

  • このメソッドでは取得できないデータ型の場合

  • JDBCドライバ内でエラーが発生した場合

(k)　getAsciiStream(String columnName)

【機能】

このResultSetオブジェクトの現在行にある指定された列の値を，PrdbDataStreamオブジェクトとして取得します。ASCII文字への変換は行いません。

HiRDBのデータ型による検索結果と戻り値の関係については，「getAsciiStream(int columnIndex)」の【機能詳細】を参照してください。

【形式】
public synchronized InputStream getAsciiStream (String columnName) throws SQLException
【引数】
String columnName：

列名

【戻り値】

列値を設定したPrdbDataStreamオブジェクト（値がNULL値の場合はnullを返します）

【発生する例外】

次の場合，SQLExceptionを投入します。

  • このResultSetオブジェクトがcloseされている場合

    このResultSetオブジェクトを生成したStatementをcloseしたことによって，このドライバがResultSetをcloseした場合を含みます。

  • このResultSetオブジェクトを生成したStatementを作成したConnectionがcloseされている場合

  • トランザクションの決着によってResultSetが無効になった場合

  • 存在しない列名が指定されている場合

  • このメソッドでは取得できないデータ型の場合

  • JDBCドライバ内でエラーが発生した場合

(l)　getBigDecimal(int columnIndex)

【機能】

このResultSetオブジェクトの現在行にある指定された列の値を，java.math.BigDecimalオブジェクトとして取得します。

【形式】
public synchronized BigDecimal getBigDecimal (int columnIndex) throws SQLException
【引数】
int columnIndex：

列番号

【戻り値】

指定された列番号に対応する列値（値がNULL値の場合はnullを返します）

【機能詳細】

このResultSetオブジェクトの現在行にある指定された列の値を，java.math.BigDecimalオブジェクトとして取得します。

HiRDBのデータ型による検索結果と戻り値の関係を次に示します。

HiRDBのデータ型

検索結果

戻り値

[M｜N][VAR]CHAR

NULL

null

[半角空白]整数の文字列表現，10進数の文字列表現，又は浮動小数点数の文字列表現[半角空白]

検索結果を持つBigDecimalオブジェクト。

文字列の前後の半角空白を取り除いた値をBigDecimalオブジェクトにします。

上記以外

SQLExceptionを投入

SMALLINT

NULL

null

上記以外

検索結果を持つBigDecimalオブジェクト。

INTEGER

NULL

null

上記以外

検索結果を持つBigDecimalオブジェクト。

REAL

NULL

null

Infinity

SQLExceptionを投入

-Infinity

SQLExceptionを投入

NaN

SQLExceptionを投入

上記以外

検索結果を持つBigDecimalオブジェクト。

FLOAT

NULL

null

Infinity

SQLExceptionを投入

-Infinity

SQLExceptionを投入

NaN

SQLExceptionを投入

上記以外

検索結果を持つBigDecimalオブジェクト。

DECIMAL

NULL

null

上記以外

検索結果を持つBigDecimalオブジェクト。

BOOLEAN※

NULL

null

true

BigDecimal(1)でBigDecimalオブジェクトにしたもの。

false

BigDecimal(0)でBigDecimalオブジェクトにしたもの。

その他

−

SQLExceptionを投入

（凡例）　−：該当しません。

注※　DatabaseMetadataから生成したResultsetの場合，BOOLEAN型データが存在します。

【発生する例外】

次の場合，SQLExceptionを投入します。

  • このResultSetオブジェクトがcloseされている場合

    このResultSetオブジェクトを生成したStatementをcloseしたことによって，このドライバがResultSetをcloseした場合を含みます。

  • このResultSetオブジェクトを生成したStatementを作成したConnectionがcloseされている場合

  • トランザクションの決着によってResultSetが無効になった場合

  • 存在しない列番号が指定されている場合

  • このメソッドでは取得できないデータ型の場合

  • 列の値がBigDecimalとして取得できない場合

  • JDBCドライバ内でエラーが発生した場合

(m)　getBigDecimal(int columnIndex, int scale)

【機能】

このResultSetオブジェクトの現在行にある指定された列の値を，scaleで指定された小数点以下のけた数を持つjava.math.BigDecimalオブジェクトとして取得します。

【形式】
public synchronized BigDecimal getBigDecimal(int columnIndex,int scale) throws SQLException
【引数】
int columnIndex：

列番号

int scale：

位取り

【戻り値】

指定された列番号に対応する列値の小数点以下のけた数を引数scaleにした値（値がNULL値の場合はnullを返します）

【機能詳細】

このResultSetオブジェクトの現在行にある指定された列の値を，scaleで指定された小数点以下のけた数を持つjava.math.BigDecimalオブジェクトとして取得します。

列値の小数点以下のけた数より引数scaleが小さい場合，scaleで切り捨てます。scaleの方が大きい場合0で補完します。

検索結果の小数点以下のけた数より引数scaleの値が小さい場合，検索結果の小数点以下のけた数をscaleで切り捨てます。検索結果の小数点以下のけた数より引数scaleの値が大きい場合，検索結果の小数点以下のけた数をscaleまで0で補完します。

HiRDBのデータ型による検索結果と戻り値の関係については，「getBigDecimal(int columnIndex)」の【機能詳細】を参照してください。

【発生する例外】

次の場合，SQLExceptionを投入します。

  • このResultSetオブジェクトがcloseされている場合

    このResultSetオブジェクトを生成したStatementをcloseしたことによって，このドライバがResultSetをcloseした場合を含みます。

  • このResultSetオブジェクトを生成したStatementを作成したConnectionがcloseされている場合

  • トランザクションの決着によってResultSetが無効になった場合

  • 存在しない列番号が指定されている場合

  • このメソッドでは取得できないデータ型の場合

  • 列の値がBigDecimalとして取得できない場合

  • scaleに0未満を指定した場合

  • JDBCドライバ内でエラーが発生した場合

(n)　getBigDecimal(String columnName)

【機能】

このResultSetオブジェクトの現在行にある指定された列の値を，java.math.BigDecimalオブジェクトとして取得します。

HiRDBのデータ型による検索結果と戻り値の関係については，「getBigDecimal(int columnIndex)」の【機能詳細】を参照してください。

【形式】
public synchronized BigDecimal getBigDecimal (String columnName) throws SQLException
【引数】
String columnName：

列名

【戻り値】

指定された列名に対応する列値（値がNULL値の場合はnullを返します）

【発生する例外】

次の場合，SQLExceptionを投入します。

  • このResultSetオブジェクトがcloseされている場合

    このResultSetオブジェクトを生成したStatementをcloseしたことによって，このドライバがResultSetをcloseした場合を含みます。

  • このResultSetオブジェクトを生成したStatementを作成したConnectionがcloseされている場合

  • トランザクションの決着によってResultSetが無効になった場合

  • 存在しない列名が指定されている場合

  • このメソッドでは取得できないデータ型の場合

  • 列の値がBigDecimalとして取得できない場合

  • JDBCドライバ内でエラーが発生した場合

(o)　getBigDecimal(String columnName, int scale)

【機能】

このResultSetオブジェクトの現在行にある指定された列の値を，scaleで指定された小数点以下のけた数を持つjava.math.BigDecimalオブジェクトとして取得します。

【形式】
public synchronized BigDecimal getBigDecimal(String columnName,int scale) throws SQLException
【引数】
String columnName：

列名

int scale：

位取り

【戻り値】

指定された列名に対応する列値の小数点以下のけた数を引数scaleにした値（値がNULL値の場合はnullを返します）

【機能詳細】

このResultSetオブジェクトの現在行にある指定された列の値を，scaleで指定された小数点以下のけた数を持つjava.math.BigDecimalオブジェクトとして取得します。

検索結果の小数点以下のけた数より引数scaleの値が小さい場合，検索結果の小数点以下のけた数をscaleで切り捨てます。検索結果の小数点以下のけた数より引数scaleの値が大きい場合，検索結果の小数点以下のけた数をscaleまで0で補完します。

HiRDBのデータ型による検索結果と戻り値の関係については，「getBigDecimal(int columnIndex)」の【機能詳細】を参照してください。

【発生する例外】

次の場合，SQLExceptionを投入します。

  • このResultSetオブジェクトがcloseされている場合

    このResultSetオブジェクトを生成したStatementをcloseしたことによって，このドライバがResultSetをcloseした場合を含みます。

  • このResultSetオブジェクトを生成したStatementを作成したConnectionがcloseされている場合

  • トランザクションの決着によってResultSetが無効になった場合

  • 存在しない列名が指定されている場合

  • このメソッドでは取得できないデータ型の場合

  • 列の値がBigDecimalとして取得できない場合

  • scaleに0未満を指定した場合

  • JDBCドライバ内でエラーが発生した場合

(p)　getBinaryStream(int columnIndex)

【機能】

このResultSetオブジェクトの現在行にある，列番号で指定された列の値を，バイナリストリームとして取得します。

【形式】
public synchronized InputStream getBinaryStream(int columnIndex) throws SQLException
【引数】
int columnIndex：

列番号

【戻り値】

列値を未解釈のバイトストリームとして送るJava入力ストリーム（値がNULL値の場合はnullを返します）

【機能詳細】

このResultSetオブジェクトの現在行にある，列番号で指定された列の値を，バイナリストリームとして取得します。

HiRDBのデータ型による検索結果と戻り値の関係を次に示します。

HiRDBのデータ型

検索結果

戻り値

BINARYBLOB

NULL

null

上記以外

検索結果を格納したInputStreamオブジェクト

その他

−

SQLExceptionを投入

（凡例）　−：該当しません。

【発生する例外】

次の場合，SQLExceptionを投入します。

  • このResultSetオブジェクトがcloseされている場合

    このResultSetオブジェクトを生成したStatementをcloseしたことによって，このドライバがResultSetをcloseした場合を含みます。

  • このResultSetオブジェクトを生成したStatementを作成したConnectionがcloseされている場合

  • トランザクションの決着によってResultSetが無効になった場合

  • 存在しない列番号が指定されている場合

  • このメソッドでは取得できないデータ型の場合

  • JDBCドライバ内でエラーが発生した場合

(q)　getBinaryStream(String columnName)

【機能】

このResultSetオブジェクトの現在行にある，指定された列の値を，バイナリストリームとして取得します。

HiRDBのデータ型による検索結果と戻り値の関係については，「getBinaryStream(int columnIndex)」の【機能詳細】を参照してください。

【形式】
public synchronized InputStream getBinaryStream (String columnName) throws SQLException
【引数】
String columnName：

列名

【戻り値】

列値を未解釈のバイトストリームとして送るJava入力ストリーム（値がNULL値の場合はnullを返します）

【発生する例外】

次の場合，SQLExceptionを投入します。

  • このResultSetオブジェクトがcloseされている場合

    このResultSetオブジェクトを生成したStatementをcloseしたことによって，このドライバがResultSetをcloseした場合を含みます。

  • このResultSetオブジェクトを生成したStatementを作成したConnectionがcloseされている場合

  • トランザクションの決着によってResultSetが無効になった場合

  • 存在しない列名が指定されている場合

  • このメソッドでは取得できないデータ型の場合

  • JDBCドライバ内でエラーが発生した場合

(r)　getBlob(int i)

【機能】

このResultSetオブジェクトの現在行にある，列番号で指定された列の値を，java.sql.Blobオブジェクトとして取得します。

【形式】
public synchronized Blob getBlob(int i) throws SQLException
【引数】
int i：

列番号

【戻り値】

指定された列の値を表すBlobオブジェクト（値がNULL値の場合はnullを返します）

【機能詳細】

このResultSetオブジェクトの現在行にある，列番号で指定された列の値を，java.sql.Blobオブジェクトとして取得します。

HiRDBのデータ型による検索結果と戻り値の関係を次に示します。

HiRDBのデータ型

検索結果

戻り値

BINARYBLOB

NULL

null

上記以外

検索結果を持つjava.sql.Blobオブジェクト

その他

−

SQLExceptionを投入

（凡例）　−：該当しません。

【発生する例外】

次の場合，SQLExceptionを投入します。

  • このResultSetオブジェクトがcloseされている場合

    このResultSetオブジェクトを生成したStatementをcloseしたことによって，このドライバがResultSetをcloseした場合を含みます。

  • このResultSetオブジェクトを生成したStatementを作成したConnectionがcloseされている場合

  • トランザクションの決着によってResultSetが無効になった場合

  • 存在しない列番号が指定されている場合

  • このメソッドでは取得できないデータ型の場合

  • JDBCドライバ内でエラーが発生した場合

(s)　getBlob(String colName)

【機能】

このResultSetオブジェクトの現在行にある，指定された列の値を，java.sql.Blobオブジェクトとして取得します。

HiRDBのデータ型による検索結果と戻り値の関係については，「getBlob(int i)」の【機能詳細】を参照してください。

【形式】
public synchronized Blob getBlob(String colName) throws SQLException
【引数】
String colName：

列名

【戻り値】

指定された列の値を表すBlobオブジェクト（値がNULL値の場合はnullを返します）

【発生する例外】

次の場合，SQLExceptionを投入します。

  • このResultSetオブジェクトがcloseされている場合

    このResultSetオブジェクトを生成したStatementをcloseしたことによって，このドライバがResultSetをcloseした場合を含みます。

  • このResultSetオブジェクトを生成したStatementを作成したConnectionがcloseされている場合

  • トランザクションの決着によってResultSetが無効になった場合

  • 存在しない列名が指定されている場合

  • このメソッドでは取得できないデータ型の場合

  • JDBCドライバ内でエラーが発生した場合

(t)　getBoolean(int columnIndex)

【機能】

このResultSetオブジェクトの現在行にある指定された列の値を，Javaプログラミング言語のbooleanとして取得します。

【形式】
public synchronized boolean getBoolean(int columnIndex) throws SQLException
【引数】
int columnIndex：

列番号

【戻り値】

true又はfalse（値がNULL値の場合はfalseが返されます）

【機能詳細】

このResultSetオブジェクトの現在行にある指定された列の値を，Javaプログラミング言語のbooleanとして取得します。

HiRDBのデータ型による検索結果と戻り値の関係を次に示します。

HiRDBのデータ型

検索結果

戻り値

[M][VAR]CHAR

NVARCHAR

NULL

false

[半角空白]半角true（大文字と小文字は区別しない）[半角空白]

true

[半角空白]半角1[半角空白]

true

上記以外

false

NCHAR

NULL

false

先頭が[半角空白]半角true（大文字と小文字は区別しない）

true

上記以外

false

SMALLINT

NULL

false

0

false

0以外

true

INTEGER

NULL

false

0

false

0以外

true

REAL

NULL

false

Infinity

true

-Inifnity

true

NaN

true

0.0又は-0.0

false

上記以外

true

FLOAT

NULL

false

Infinity

true

-Inifnity

true

NaN

true

0.0又は-0.0

false

上記以外

true

DECIMAL

NULL

false

0[.00…0]

false

上記以外

true

BOOLEAN※

NULL

false

NULL以外

検索結果

その他

−

SQLExceptionを投入

（凡例）　−：該当しません。

注※　DatabaseMetadataから生成したResultsetの場合，BOOLEAN型データが存在します。

【発生する例外】

次の場合，SQLExceptionを投入します。

  • このResultSetオブジェクトがcloseされている場合

    このResultSetオブジェクトを生成したStatementをcloseしたことによって，このドライバがResultSetをcloseした場合を含みます。

  • このResultSetオブジェクトを生成したStatementを作成したConnectionがcloseされている場合

  • トランザクションの決着によってResultSetが無効になった場合

  • 存在しない列番号が指定されている場合

  • このメソッドでは取得できないデータ型の場合

  • JDBCドライバ内でエラーが発生した場合

(u)　getBoolean(String columnName)

【機能】

このResultSetオブジェクトの現在行にある指定された列の値を，Javaプログラミング言語のbooleanとして取得します。

HiRDBのデータ型による検索結果と戻り値の関係については，「getBoolean(int columnIndex)」の【機能詳細】を参照してください。

【形式】
public synchronized boolean getBoolean(String columnName) throws SQLException
【引数】
String columnName：

列名

【戻り値】

true又はfalse（値がNULL値の場合はfalseが返されます）

【発生する例外】

次の場合，SQLExceptionを投入します。

  • このResultSetオブジェクトがcloseされている場合

    このResultSetオブジェクトを生成したStatementをcloseしたことによって，このドライバがResultSetをcloseした場合を含みます。

  • このResultSetオブジェクトを生成したStatementを作成したConnectionがcloseされている場合

  • トランザクションの決着によってResultSetが無効になった場合

  • 存在しない列名が指定されている場合

  • このメソッドでは取得できないデータ型の場合

  • JDBCドライバ内でエラーが発生した場合

(v)　getByte(int columnIndex)

【機能】

このResultSetオブジェクトの現在行にある指定された列の値を，Javaプログラミング言語のbyteとして取得します。

【形式】
public synchronized byte getByte(int columnIndex) throws SQLException
【引数】
int columnIndex：

列番号

【戻り値】

列値（値がNULL値の場合は0を返します）

【機能詳細】

このResultSetオブジェクトの現在行にある指定された列の値を，Javaプログラミング言語のbyteとして取得します。

HiRDBのデータ型による検索結果と戻り値の関係を次に示します。

HiRDBのデータ型

検索結果

戻り値

[M｜N][VAR]CHAR

NULL

0

[半角空白]整数の文字列表現，10進数の文字列表現，又は浮動小数点数の文字列表現[半角空白]であり，かつByte.MIN_VALUE以上，Byte.MAX_VALUE以下

検索結果をbyte値にしたもの

[半角空白]整数の文字列表現，10進数の文字列表現，又は浮動小数点数の文字列表現[半角空白]であり，かつByte.MAX_VALUEより大きいかByte.MIN_VALUEより小さい

SQLExceptionを投入

[半角空白][+]Infinity[半角空白]

SQLExceptionを投入

[半角空白]-Infinity[半角空白]

SQLExceptionを投入

[半角空白][+｜-]NaN[半角空白]

SQLExceptionを投入

上記以外（double値にできない）

SQLExceptionを投入

SMALLINT

NULL

0

Byte.MIN_VALUE以上かつByte.MAX_VALUE以下

検索結果をbyte値にしたもの

上記以外

SQLExceptionを投入

INTEGER

NULL

0

Byte.MIN_VALUE以上かつByte.MAX_VALUE以下

検索結果をbyte値にしたもの

上記以外

SQLExceptionを投入

REAL

NULL

0

Infinity

SQLExceptionを投入

-Infinity

SQLExceptionを投入

NaN

SQLExceptionを投入

Byte.MIN_VALUE以上かつByte.MAX_VALUE以下

検索結果の整数部分の値をbyte値にしたもの

上記以外

SQLExceptionを投入

FLOAT

NULL

0

Infinity

SQLExceptionを投入

-Infinity

SQLExceptionを投入

NaN

SQLExceptionを投入

Byte.MIN_VALUE以上かつByte.MAX_VALUE以下

検索結果の整数部分の値をbyte値にしたもの

上記以外

SQLExceptionを投入

DECIMAL

NULL

0

Byte.MIN_VALUE以上かつByte.MAX_VALUE以下

検索結果の整数部分の値をbyte値にしたもの

上記以外

SQLExceptionを投入

BOOLEAN※

NULL

0

true

1

false

0

その他

−

SQLExceptionを投入

（凡例）　−：該当しません。

注※　DatabaseMetadataから生成したResultsetの場合，BOOLEAN型データが存在します。

【発生する例外】

次の場合，SQLExceptionを投入します。

  • このResultSetオブジェクトがcloseされている場合

    このResultSetオブジェクトを生成したStatementをcloseしたことによって，このドライバがResultSetをcloseした場合を含みます。

  • このResultSetオブジェクトを生成したStatementを作成したConnectionがcloseされている場合

  • トランザクションの決着によってResultSetが無効になった場合

  • 存在しない列番号が指定されている場合

  • このメソッドでは取得できないデータ型の場合

  • 列の値がbyteとして取得できない場合

  • JDBCドライバ内でエラーが発生した場合

(w)　getByte(String columnName)

【機能】

このResultSetオブジェクトの現在行にある指定された列の値を，Javaプログラミング言語のbyteとして取得します。

HiRDBのデータ型による検索結果と戻り値の関係については，「getByte(int columnIndex)」の【機能詳細】を参照してください。

【形式】
public synchronized byte getByte(String columnName) throws SQLException
【引数】
String columnName：

列名

【戻り値】

列値（値がNULL値の場合は0を返します）

【発生する例外】

次の場合，SQLExceptionを投入します。

  • このResultSetオブジェクトがcloseされている場合

    このResultSetオブジェクトを生成したStatementをcloseしたことによって，このドライバがResultSetをcloseした場合を含みます。

  • このResultSetオブジェクトを生成したStatementを作成したConnectionがcloseされている場合

  • トランザクションの決着によってResultSetが無効になった場合

  • 存在しない列名が指定されている場合

  • このメソッドでは取得できないデータ型の場合

  • 列の値がbyteとして取得できない場合

  • JDBCドライバ内でエラーが発生した場合

(x)　getBytes(int columnIndex)

【機能】

ResultSetオブジェクトの現在行にある指定された列の値を，Javaプログラミング言語のbyte配列として取得します。

【形式】
public synchronized byte[] getBytes(int columnIndex) throws SQLException
【引数】
int columnIndex：

列番号

【戻り値】

列値（値がNULL値の場合はnullを返します）

【機能詳細】

ResultSetオブジェクトの現在行にある指定された列の値を，Javaプログラミング言語のbyte配列として取得します。

HiRDBのデータ型による検索結果と戻り値の関係を次に示します。

HiRDBのデータ型

検索結果

戻り値

[M｜N][VAR]CHAR

BINARY

BLOB

NULL

null

上記以外

検索結果をbyte配列にしたもの

その他

−

SQLExceptionを投入

（凡例）　−：該当しません。

【発生する例外】

次の場合，SQLExceptionを投入します。

  • このResultSetオブジェクトがcloseされている場合

    このResultSetオブジェクトを生成したStatementをcloseしたことによって，このドライバがResultSetをcloseした場合を含みます。

  • このResultSetオブジェクトを生成したStatementを作成したConnectionがcloseされている場合

  • トランザクションの決着によってResultSetが無効になった場合

  • 存在しない列番号が指定されている場合

  • このメソッドでは取得できないデータ型の場合

  • JDBCドライバ内でエラーが発生した場合

(y)　getBytes(String columnName)

【機能】

このResultSetオブジェクトの現在行にある指定された列の値を，Javaプログラミング言語のbyte配列として取得します。バイトはドライバによって返された行の値を表します。

HiRDBのデータ型による検索結果と戻り値の関係については，「getBytes(int columnIndex)」の【機能詳細】を参照してください。

【形式】
public synchronized byte[] getBytes (String columnName) throws SQLException
【引数】
String columnName：

列名

【戻り値】

列値（値がNULL値の場合はnullを返します）

【発生する例外】

次の場合，SQLExceptionを投入します。

  • このResultSetオブジェクトがcloseされている場合

    このResultSetオブジェクトを生成したStatementをcloseしたことによって，このドライバがResultSetをcloseした場合を含みます。

  • このResultSetオブジェクトを生成したStatementを作成したConnectionがcloseされている場合

  • トランザクションの決着によってResultSetが無効になった場合

  • 存在しない列名が指定されている場合

  • このメソッドでは取得できないデータ型の場合

  • JDBCドライバ内でエラーが発生した場合

(z)　getCharacterStream(int columnIndex)

【機能】

このResultSetオブジェクトの現在行にある指定された列の値を，java.io.Readerオブジェクトとして取得します。

【形式】
public synchronized Reader getCharacterStream (int columnIndex) throws SQLException
【引数】
int columnIndex：

列番号

【戻り値】

列値を格納するjava.io.Readerオブジェクト（値がNULL値の場合はnullを返します）

【機能詳細】

このResultSetオブジェクトの現在行にある指定された列の値を，java.io.Readerオブジェクトとして取得します。

HiRDBのデータ型による検索結果と戻り値の関係を次に示します。

HiRDBのデータ型

検索結果

戻り値

[M｜N][VAR]CHAR

BINARY

BLOB

NULL

null

上記以外

検索結果を格納したReaderオブジェクト

その他

−

SQLExceptionを投入

（凡例）　−：該当しません。

【発生する例外】

次の場合，SQLExceptionを投入します。

  • このResultSetオブジェクトがcloseされている場合

    このResultSetオブジェクトを生成したStatementをcloseしたことによって，このドライバがResultSetをcloseした場合を含みます。

  • このResultSetオブジェクトを生成したStatementを作成したConnectionがcloseされている場合

  • トランザクションの決着によってResultSetが無効になった場合

  • 存在しない列番号が指定されている場合

  • このメソッドでは取得できないデータ型の場合

  • エンコードに失敗した場合

  • JDBCドライバ内でエラーが発生した場合

(aa)　getCharacterStream(String columnName)

【機能】

このResultSetオブジェクトの現在行にある指定された列の値を，java.io.Readerオブジェクトとして取得します。

HiRDBのデータ型による検索結果と戻り値の関係については，「getCharacterStream(int columnIndex)」の【機能詳細】を参照してください。

【形式】
public synchronized Reader getCharacterStream (String columnName) throws SQLException
【引数】
String columnName：

列名

【戻り値】

列値を格納するjava.io.Readerオブジェクト（値がNULL値の場合はnullを返します）

【発生する例外】

次の場合，SQLExceptionを投入します。

  • このResultSetオブジェクトがcloseされている場合

    このResultSetオブジェクトを生成したStatementをcloseしたことによって，このドライバがResultSetをcloseした場合を含みます。

  • このResultSetオブジェクトを生成したStatementを作成したConnectionがcloseされている場合

  • トランザクションの決着によってResultSetが無効になった場合

  • 存在しない列名が指定されている場合

  • このメソッドでは取得できないデータ型の場合

  • エンコードに失敗した場合

  • JDBCドライバ内でエラーが発生した場合

(ab)　getConcurrency()

【機能】

このResultSetオブジェクトの並行処理モードを返します。更新カーソルは未サポートのため，必ずResultSet.CONCUR_READ_ONLYを返します。

【形式】
public synchronized int getConcurrency() throws SQLException
【引数】

なし。

【戻り値】
ResultSet.CONCUR_READ_ONLY：

列の値を更新できません。

ResultSet.CONCUR_UPDATABLE：

列の値を更新できます。

【発生する例外】

次の場合，SQLExceptionを投入します。

  • このResultSetオブジェクトがcloseされている場合

    このResultSetオブジェクトを生成したStatementをcloseしたことによって，このドライバがResultSetをcloseした場合を含みます。

  • このResultSetオブジェクトを生成したStatementを作成したConnectionがcloseされている場合

  • トランザクションの決着によってResultSetが無効になった場合

(ac)　getCursorName()

【機能】

このResultSetオブジェクトが使用するSQLカーソルの名前を取得します。

HiRDBでは常にnullを返します。

【形式】
public synchronized String getCursorName() throws SQLException
【引数】

なし。

【戻り値】

null

【発生する例外】

次の場合，SQLExceptionを投入します。

  • このResultSetオブジェクトがcloseされている場合

    このResultSetオブジェクトを生成したStatementをcloseしたことによって，このドライバがResultSetをcloseした場合を含みます。

  • このResultSetオブジェクトを生成したStatementを作成したConnectionがcloseされている場合

  • トランザクションの決着によってResultSetが無効になった場合

(ad)　getDate(int columnIndex)

【機能】

このResultSetオブジェクトの現在行にある指定された列の値を，java.sql.Dateオブジェクトとして取得します。

【形式】
public synchronized java.sql.Date getDate(int columnIndex) throws SQLException
【引数】
int columnIndex：

列番号

【戻り値】

列値（値がNULL値の場合はnullを返します）

【機能詳細】

このResultSetオブジェクトの現在行にある指定された列の値を，java.sql.Dateオブジェクトとして取得します。

HiRDBのデータ型による検索結果と戻り値の関係を次に示します。

HiRDBのデータ型

検索結果

戻り値

[M｜N][VAR]CHAR

NULL

null

[半角空白]日付形式[半角空白]

検索結果の前後の半角空白を取り除きjava.sql.Dateオブジェクトにしたもの

上記以外

SQLExceptionを投入

DATE

NULL

null

上記以外

検索結果をjava.sql.Dateオブジェクトにしたもの

TIMESTAMP

NULL

null

上記以外

検索結果をjava.sql.Dateオブジェクトにしたもの

その他

−

SQLExceptionを投入

（凡例）　−：該当しません。

【発生する例外】

次の場合，SQLExceptionを投入します。

  • このResultSetオブジェクトがcloseされている場合

    このResultSetオブジェクトを生成したStatementをcloseしたことによって，このドライバがResultSetをcloseした場合を含みます。

  • このResultSetオブジェクトを生成したStatementを作成したConnectionがcloseされている場合

  • トランザクションの決着によってResultSetが無効になった場合

  • 存在しない列番号が指定されている場合

  • このメソッドでは取得できないデータ型の場合

  • 列の値がjava.sql.Dateとして取得できない場合

  • JDBCドライバ内でエラーが発生した場合

(ae)　getDate(int columnIndex, Calendar cal)

【機能】

このResultSetオブジェクトの現在行にある指定された列の値を，java.sql.Dateオブジェクトとして取得します。このメソッドは指定されたカレンダーを使って日付に適切なミリ秒値を作成します。

HiRDBのデータ型による検索結果と戻り値の関係については，「getDate(int columnIndex)」の【機能詳細】を参照してください。

【形式】
public synchronized java.sql.Date getDate(int columnIndex, Calendar cal) throws SQLException
【引数】
int columnIndex：

列番号

Calendar cal：

データベースに格納されている値のタイムゾーンが設定されたカレンダー

【戻り値】

列値（値がNULL値の場合はnullを返します）

【発生する例外】

次の場合，SQLExceptionを投入します。

  • このResultSetオブジェクトがcloseされている場合

    このResultSetオブジェクトを生成したStatementをcloseしたことによって，このドライバがResultSetをcloseした場合を含みます。

  • このResultSetオブジェクトを生成したStatementを作成したConnectionがcloseされている場合

  • トランザクションの決着によってResultSetが無効になった場合

  • 存在しない列番号が指定されている場合

  • このメソッドでは取得できないデータ型の場合

  • 列の値がjava.sql.Dateとして取得できない場合

  • JDBCドライバ内でエラーが発生した場合

(af)　getDate(String columnName)

【機能】

このResultSetオブジェクトの現在行にある指定された列の値を，java.sql.Dateオブジェクトとして取得します。

HiRDBのデータ型による検索結果と戻り値の関係については，「getDate(int columnIndex)」の【機能詳細】を参照してください。

【形式】
public synchronized java.sql.Date getDate (String columnName) throws SQLException
【引数】
String columnName：

列名

【戻り値】

列値（値がNULL値の場合はnullを返します）

【発生する例外】

次の場合，SQLExceptionを投入します。

  • このResultSetオブジェクトがcloseされている場合

    このResultSetオブジェクトを生成したStatementをcloseしたことによって，このドライバがResultSetをcloseした場合を含みます。

  • このResultSetオブジェクトを生成したStatementを作成したConnectionがcloseされている場合

  • トランザクションの決着によってResultSetが無効になった場合

  • 存在しない列名が指定されている場合

  • このメソッドでは取得できないデータ型の場合

  • 列の値がjava.sql.Dateとして取得できない場合

  • JDBCドライバ内でエラーが発生した場合

(ag)　getDate(String columnName, Calendar cal)

【機能】

このResultSetオブジェクトの現在行にある指定された列の値を，java.sql.Dateオブジェクトとして取得します。このメソッドは指定されたカレンダーを使って日付に適切なミリ秒値を作成します。

HiRDBのデータ型による検索結果と戻り値の関係については，「getDate(int columnIndex)」の【機能詳細】を参照してください。

【形式】
public synchronized java.sql.Date getDate(String columnName, Calendar cal) throws SQLException
【引数】
String columnName：

列名

Calendar cal：

データベースに格納されている値のタイムゾーンが設定されたカレンダー

【戻り値】

列値（値がNULL値の場合はnullを返します）

【発生する例外】

次の場合，SQLExceptionを投入します。

  • このResultSetオブジェクトがcloseされている場合

    このResultSetオブジェクトを生成したStatementをcloseしたことによって，このドライバがResultSetをcloseした場合を含みます。

  • このResultSetオブジェクトを生成したStatementを作成したConnectionがcloseされている場合

  • トランザクションの決着によってResultSetが無効になった場合

  • 存在しない列名が指定されている場合

  • このメソッドでは取得できないデータ型の場合

  • 列の値がjava.sql.Dateとして取得できない場合

  • JDBCドライバ内でエラーが発生した場合

(ah)　getDouble(int columnIndex)

【機能】

このResultSetオブジェクトの現在行にある指定された列の値を，Javaプログラミング言語のdoubleとして取得します。

【形式】
public synchronized double getDouble (int columnIndex) throws SQLException
【引数】
int columnIndex：

列番号

【戻り値】

列値（値がNULL値の場合はnullを返します）

【機能詳細】

このResultSetオブジェクトの現在行にある指定された列の値を，Javaプログラミング言語のdoubleとして取得します。

HiRDBのデータ型による検索結果と戻り値の関係を次に示します。

HiRDBのデータ型

検索結果

戻り値

[M｜N][VAR]CHAR

NULL

0.0

[半角空白]整数の文字列表現，10進数の文字列表現，又は浮動小数点数の文字列表現[半角空白]であり，かつ-Double.MAX_VALUE以上，かつDouble.MIN_VALUE以下，かつDouble.MIN_VALUE以上かつDouble.MAX_VALUE以下

検索結果をdouble値にしたもの

[半角空白]整数の文字列表現，10進数の文字列表現，又は浮動小数点数の文字列表現[半角空白]かつDouble.MAX_VALUEより大きい

Infinity

[半角空白]整数の文字列表現，10進数の文字列表現，又は浮動小数点数の文字列表現[半角空白]かつ-Double.MAX_VALUEより小さい

-Infinity

[半角空白]整数の文字列表現，10進数の文字列表現，又は浮動小数点数の文字列表現[半角空白]かつDouble.MIN_VALUEより小さく0より大きい

0.0

[半角空白]整数の文字列表現，10進数の文字列表現，又は浮動小数点数の文字列表現[半角空白]かつ-Double.MIN_VALUEより大きく0より小さい

-0.0

[半角空白]-Infinity[半角空白]

-Infinity

[半角空白][+]Infinity[半角空白]

Infinity

[半角空白][+｜-]NaN[半角空白]

NaN

上記以外（double値にできない）

SQLExceptionを投入

SMALLINT

NULL

0.0

上記以外

検索結果をdouble値にしたもの

INTEGER

NULL

0

上記以外

検索結果をdouble値にしたもの

REAL

NULL

0.0

Infinity

Infinity

-Infinity

-Infinity

NaN

NaN

上記以外

検索結果をdouble値にしたもの

FLOAT

NULL

0.0

Infinity

Infinity

-Infinity

-Infinity

NaN

NaN

上記以外

検索結果をdouble値にしたもの

DECIMAL

NULL

0

上記以外

検索結果をdouble値にしたもの

BOOLEAN※

NULL

0.0

true

1.0

false

0.0

その他

−

SQLExceptionを投入

（凡例）　−：該当しません。

注※　DatabaseMetadataから生成したResultsetの場合，BOOLEAN型データが存在します。

【発生する例外】

次の場合，SQLExceptionを投入します。

  • このResultSetオブジェクトがcloseされている場合

    このResultSetオブジェクトを生成したStatementをcloseしたことによって，このドライバがResultSetをcloseした場合を含みます。

  • このResultSetオブジェクトを生成したStatementを作成したConnectionがcloseされている場合

  • トランザクションの決着によってResultSetが無効になった場合

  • 存在しない列番号が指定されている場合

  • このメソッドでは取得できないデータ型の場合

  • 列の値がdoubleとして取得できない場合

  • JDBCドライバ内でエラーが発生した場合

(ai)　getDouble(String columnName)

【機能】

このResultSetオブジェクトの現在行にある指定された列の値を，Javaプログラミング言語のdoubleとして取得します。

HiRDBのデータ型による検索結果と戻り値の関係については，「getDouble(int columnIndex)」の【機能詳細】を参照してください。

【形式】
public synchronized double getDouble (String columnName) throws SQLException
【引数】
String columnName：

列名

【戻り値】

列値（値がNULL値の場合はnullを返します）

【発生する例外】

次の場合，SQLExceptionを投入します。

  • このResultSetオブジェクトがcloseされている場合

    このResultSetオブジェクトを生成したStatementをcloseしたことによって，このドライバがResultSetをcloseした場合を含みます。

  • このResultSetオブジェクトを生成したStatementを作成したConnectionがcloseされている場合

  • トランザクションの決着によってResultSetが無効になった場合

  • 存在しない列名が指定されている場合

  • このメソッドでは取得できないデータ型の場合

  • 列の値がdoubleとして取得できない場合

  • JDBCドライバ内でエラーが発生した場合

(aj)　getFetchDirection()

【機能】

このResultSetオブジェクトのフェッチ方向を取得します。HiRDBでは常にResultSet.FETCH_FORWARDを返します。

【形式】
public synchronized int getFetchDirection() throws SQLException
【引数】

なし。

【戻り値】
ResultSet.FETCH_FORWARD：

結果集合が順方向に処理されます。

ResultSet.FETCH_REVERSE：

結果集合が逆方向に処理されます。

ResultSet.FETCH_UNKNOWN：

結果集合が処理される方向が不明です。

【発生する例外】

次の場合，SQLExceptionを投入します。

  • このResultSetオブジェクトがcloseされている場合

    このResultSetオブジェクトを生成したStatementをcloseしたことによって，このドライバがResultSetをcloseした場合を含みます。

  • このResultSetオブジェクトを生成したStatementを作成したConnectionがcloseされている場合

  • トランザクションの決着によってResultSetが無効になった場合

(ak)　getFetchSize()

【機能】

このResultSetオブジェクトのフェッチサイズを取得します。

setFetchSizeで設定した値を返します。

setFetchSizeで設定していない場合は0を返します。

【形式】
public synchronized int getFetchSize() throws SQLException
【引数】

なし。

【戻り値】

このResultSetオブジェクトの現在のフェッチサイズ

【発生する例外】

次の場合，SQLExceptionを投入します。

  • このResultSetオブジェクトがcloseされている場合

    このResultSetオブジェクトを生成したStatementをcloseしたことによって，このドライバがResultSetをcloseした場合を含みます。

  • このResultSetオブジェクトを生成したStatementを作成したConnectionがcloseされている場合

  • トランザクションの決着によってResultSetが無効になった場合

(al)　getFloat(int columnIndex)

【機能】

このResultSetオブジェクトの現在行にある指定された列の値を，Javaプログラミング言語のfloatとして取得します。

【形式】
public synchronized float getFloat (int columnIndex) throws SQLException
【引数】
int columnIndex：

列番号

【戻り値】

列値（値がNULL値の場合はnullを返します）

【機能詳細】

このResultSetオブジェクトの現在行にある指定された列の値を，Javaプログラミング言語のfloatとして取得します。

HiRDBのデータ型による検索結果と戻り値の関係を次に示します。

HiRDBのデータ型

検索結果

戻り値

[M｜N][VAR]CHAR

NULL

0.0

[半角空白]整数の文字列表現，10進数の文字列表現，又は浮動小数点数の文字列表現[半角空白]であり，かつ次のどちらか

  • -Float.MAX_VALUE以上-Float.MIN_VALUE以下

  • Float.MIN_VALUE以上Float.MAX_VALUE以下

検索結果をfloat値にしたもの

[半角空白]整数の文字列表現，10進数の文字列表現，又は浮動小数点数の文字列表現[半角空白]かつFloat.MAX_VALUEより大きい

Infinity

[半角空白]整数の文字列表現，10進数の文字列表現，又は浮動小数点数の文字列表現[半角空白]かつ-Float.MAX_VALUEより小さい

-Infinity

[半角空白]整数の文字列表現，10進数の文字列表現，又は浮動小数点数の文字列表現[半角空白]かつFloat.MIN_VALUEより小さく0より大きい

0.0

[半角空白]整数の文字列表現，10進数の文字列表現，又は浮動小数点数の文字列表現[半角空白]かつ-Float.MIN_VALUEより大きく0より小さい

-0.0

[半角空白]-Infinity[半角空白]

-Infinity

[半角空白][+]Infinity[半角空白]

Infinity

[半角空白][+｜-]NaN[半角空白]

NaN

上記以外（float値にできない）

SQLExceptionを投入

SMALLINT

NULL

0.0

上記以外

検索結果をfloat値にしたもの

INTEGER

NULL

0.0

上記以外

検索結果をfloat値にしたもの

REAL

NULL

0.0

Infinity

Infinity

-Infinity

-Infinity

NaN

NaN

上記以外

検索結果

FLOAT

NULL

0.0

Infinity

Infinity

-Infinity

-Infinity

NaN

NaN

-Float.MAX_VALUE以上-Float.MIN_VALUE以下，又はFloat.MIN_VALUE以上Float.MAX_VALUE以下

検索結果をfloat値にしたもの

Float.MAX_VALUEより大きい

Infinity

-Float.MAX_VALUEより小さい

-Infinity

Float.MIN_VALUEより小さく0より大きい

0.0

-Float.MIN_VALUEより大きく0より小さい

-0.0

DECIMAL

NULL

0.0

上記以外

検索結果をfloat値にしたもの

BOOLEAN※

NULL

0.0

true

1.0

false

0.0

その他

−

SQLExceptionを投入

（凡例）　−：該当しません。

注※　DatabaseMetadataから生成したResultsetの場合，BOOLEAN型データが存在します。

【発生する例外】

次の場合，SQLExceptionを投入します。

  • このResultSetオブジェクトがcloseされている場合

    このResultSetオブジェクトを生成したStatementをcloseしたことによって，このドライバがResultSetをcloseした場合を含みます。

  • このResultSetオブジェクトを生成したStatementを作成したConnectionがcloseされている場合

  • トランザクションの決着によってResultSetが無効になった場合

  • 存在しない列番号が指定されている場合

  • このメソッドでは取得できないデータ型の場合

  • 列の値がfloatとして取得できない場合

  • JDBCドライバ内でエラーが発生した場合

(am)　getFloat(String columnName)

【機能】

このResultSetオブジェクトの現在行にある指定された列の値を，Javaプログラミング言語のfloatとして取得します。

HiRDBのデータ型による検索結果と戻り値の関係については，「getFloat(int columnIndex)」の【機能詳細】を参照してください。

【形式】
public synchronized float getFloat (String columnName) throws SQLException
【引数】
String columnName：

列名

【戻り値】

列値（値がNULL値の場合はnullを返します）

【発生する例外】

次の場合，SQLExceptionを投入します。

  • このResultSetオブジェクトがcloseされている場合

    このResultSetオブジェクトを生成したStatementをcloseしたことによって，このドライバがResultSetをcloseした場合を含みます。

  • このResultSetオブジェクトを生成したStatementを作成したConnectionがcloseされている場合

  • トランザクションの決着によってResultSetが無効になった場合

  • 存在しない列名が指定されている場合

  • このメソッドでは取得できないデータ型の場合

  • 列の値がfloatとして取得できない場合

  • JDBCドライバ内でエラーが発生した場合

(an)　getInt(int columnIndex)

【機能】

このResultSetオブジェクトの現在行にある指定された列の値を，Javaプログラミング言語のintとして取得します。

【形式】
public synchronized int getInt(int columnIndex) throws SQLException
【引数】
int columnIndex：

列番号

【戻り値】

列値（値がNULL値の場合はnullを返します）

【機能詳細】

このResultSetオブジェクトの現在行にある指定された列の値を，Javaプログラミング言語のintとして取得します。

HiRDBのデータ型による検索結果と戻り値の関係を次に示します。

HiRDBのデータ型

検索結果

戻り値

[M｜N][VAR]CHAR

NULL

0

[半角空白]整数の文字列表現，10進数の文字列表現，又は浮動小数点数の文字列表現[半角空白]であり，かつInteger.MIN_VALUE以上，Integer.MAX_VALUE以下

検索結果の整数部分の値をint値にしたもの

[半角空白]整数の文字列表現，10進数の文字列表現，又は浮動小数点数の文字列表現[半角空白]であり，かつInteger.MAX_VALUEより大きいかInteger.MIN_VALUEより小さい

SQLExceptionを投入

[半角空白]-Infinity[半角空白]

SQLExceptionを投入

[半角空白][+]Infinity[半角空白]

SQLExceptionを投入

[半角空白][+｜-]NaN[半角空白]

SQLExceptionを投入

上記以外（double値にできない）

SQLExceptionを投入

SMALLINT

NULL

0

上記以外

検索結果をint値にしたもの

INTEGER

NULL

0

上記以外

検索結果をint値にしたもの

REAL

NULL

0

Infinity

SQLExceptionを投入

-Infinity

SQLExceptionを投入

NaN

SQLExceptionを投入

Integer.MIN_VALUE以上かつ，Integer.MAX_VALUE以下

検索結果の整数部分の値をint値にしたもの

上記以外

SQLExceptionを投入

FLOAT

NULL

0

Infinity

SQLExceptionを投入

-Infinity

SQLExceptionを投入

NaN

SQLExceptionを投入

Integer.MIN_VALUE以上かつ，Integer.MAX_VALUE以下

検索結果の整数部分の値をint値にしたもの

上記以外

SQLExceptionを投入

DECIMAL

NULL

0

Integer.MIN_VALUE以上かつInteger.MAX_VALUE以下

検索結果の整数部分の値をint値にしたもの

上記以外

SQLExceptionを投入

BOOLEAN※

NULL

0

true

1

false

0

その他

−

SQLExceptionを投入

（凡例）　−：該当しません。

注※　DatabaseMetadataから生成したResultsetの場合，BOOLEAN型データが存在します。

【発生する例外】

次の場合，SQLExceptionを投入します。

  • このResultSetオブジェクトがcloseされている場合

    このResultSetオブジェクトを生成したStatementをcloseしたことによって，このドライバがResultSetをcloseした場合を含みます。

  • このResultSetオブジェクトを生成したStatementを作成したConnectionがcloseされている場合

  • トランザクションの決着によってResultSetが無効になった場合

  • 存在しない列番号が指定されている場合

  • このメソッドでは取得できないデータ型の場合

  • 列の値がintとして取得できない場合

  • JDBCドライバ内でエラーが発生した場合

(ao)　getInt(String columnName)

【機能】

このResultSetオブジェクトの現在行にある指定された列の値を，Javaプログラミング言語のintとして取得します。

HiRDBのデータ型による検索結果と戻り値の関係については，「getInt(int columnIndex)」の【機能詳細】を参照してください。

【形式】
public synchronized int getInt(String columnName) throws SQLException
【引数】
String columnName：

列名

【戻り値】

列値（値がNULL値の場合はnullを返します）

【発生する例外】

次の場合，SQLExceptionを投入します。

  • このResultSetオブジェクトがcloseされている場合

    このResultSetオブジェクトを生成したStatementをcloseしたことによって，このドライバがResultSetをcloseした場合を含みます。

  • このResultSetオブジェクトを生成したStatementを作成したConnectionがcloseされている場合

  • トランザクションの決着によってResultSetが無効になった場合

  • 存在しない列名が指定されている場合

  • このメソッドでは取得できないデータ型の場合

  • 列の値がintとして取得できない場合

  • JDBCドライバ内でエラーが発生した場合

(ap)　getLong(int columnIndex)

【機能】

このResultSetオブジェクトの現在行にある指定された列の値を，Javaプログラミング言語のlongとして取得します。

【形式】
public synchronized long getLong (int columnIndex) throws SQLException
【引数】
int columnIndex：

列番号

【戻り値】

列値（値がNULL値の場合はnullを返します）

【機能詳細】

このResultSetオブジェクトの現在行にある指定された列の値を，Javaプログラミング言語のlongとして取得します。

HiRDBのデータ型による検索結果と戻り値の関係を次に示します。

HiRDBのデータ型

検索結果

戻り値

[M｜N][VAR]CHAR

NULL

0

[半角空白]整数の文字列表現，又は10進数の文字列表現かつ15文字以内[半角空白]

検索結果の整数部分の値をlong値にしたもの

[半角空白]整数の文字列表現，又は10進数の文字列表現であり，16文字以上，又は浮動小数点の文字列表現[半角空白]であり，かつLong.MIN_VALUE以上，Long.MAX_VALUE以下

検索結果の整数部分の値をlong値にしたもの

[半角空白]整数の文字列表現，又は10進数の文字列表現であり16文字以上，又は浮動小数点の文字列表現[半角空白]であり，かつLong.MAX_VALUEより大きいかLong.MIN_VALUEより小さい

SQLExceptionを投入

[半角空白]-Infinity[半角空白]

SQLExceptionを投入

[半角空白][+]Infinity[半角空白]

SQLExceptionを投入

[半角空白][+｜-]NaN[半角空白]

SQLExceptionを投入

上記以外（double値，又はBigDecimalオブジェクトにできない）

SQLExceptionを投入

SMALLINT

NULL

0

上記以外

検索結果をlong値にしたもの

INTEGER

NULL

0

上記以外

検索結果をlong値にしたもの

REAL

NULL

0

Infinity

SQLExceptionを投入

-Infinity

SQLExceptionを投入

NaN

SQLExceptionを投入

Long.MIN_VALUE以上かつ，Long.MAX_VALUE以下

検索結果の整数部分の値をlong値にしたもの

上記以外

SQLExceptionを投入

FLOAT

NULL

0

Infinity

SQLExceptionを投入

-Infinity

SQLExceptionを投入

NaN

SQLExceptionを投入

Long.MIN_VALUE以上かつ，Long.MAX_VALUE以下

検索結果の整数部分の値をlong値にしたもの

上記以外

SQLExceptionを投入

DECIMAL

NULL

0

Long.MIN_VALUE以上かつLong.MAX_VALUE以下

検索結果の整数部分の値をlong値にしたもの

BINARYBLOB

NULL

0

0長データ

0

1バイト以上

最大8バイトまでをリトルエンディアン形式でlong値にしたもの

BOOLEAN※

NULL

0

true

1

false

0

その他

−

SQLExceptionを投入

（凡例）　−：該当しません。

注※　DatabaseMetadataから生成したResultsetの場合，BOOLEAN型データが存在します。

【発生する例外】

次の場合，SQLExceptionを投入します。

  • このResultSetオブジェクトがcloseされている場合

    このResultSetオブジェクトを生成したStatementをcloseしたことによって，このドライバがResultSetをcloseした場合を含みます。

  • このResultSetオブジェクトを生成したStatementを作成したConnectionがcloseされている場合

  • トランザクションの決着によってResultSetが無効になった場合

  • 存在しない列番号が指定されている場合

  • このメソッドでは取得できないデータ型の場合

  • 列の値がlongとして取得できない場合

  • JDBCドライバ内でエラーが発生した場合

(aq)　getLong(String columnName)

【機能】

このResultSetオブジェクトの現在行にある指定された列の値を，Javaプログラミング言語のlongとして取得します。

HiRDBのデータ型による検索結果と戻り値の関係については，「getLong(int columnIndex)」の【機能詳細】を参照してください。

【形式】
public synchronized long getLong (String columnName) throws SQLException
【引数】
String columnName：

列名

【戻り値】

列値（値がNULL値の場合はnullを返します）

【発生する例外】

次の場合，SQLExceptionを投入します。

  • このResultSetオブジェクトがcloseされている場合

    このResultSetオブジェクトを生成したStatementをcloseしたことによって，このドライバがResultSetをcloseした場合を含みます。

  • このResultSetオブジェクトを生成したStatementを作成したConnectionがcloseされている場合

  • トランザクションの決着によってResultSetが無効になった場合

  • 存在しない列名が指定されている場合

  • このメソッドでは取得できないデータ型の場合

  • 列の値がlongとして取得できない場合

  • JDBCドライバ内でエラーが発生した場合

(ar)　getMetaData()

【機能】

このResultSetオブジェクトのメタ情報を表すResultSetMetaDataを返します。

【形式】
public synchronized ResultSetMetaData getMetaData() throws SQLException
【引数】

なし。

【戻り値】

このResultSetオブジェクトのメタ情報を，ResultSetMetaDataオブジェクトで返します。

【発生する例外】

次の場合，SQLExceptionを投入します。

  • このResultSetオブジェクトがcloseされている場合

    このResultSetオブジェクトを生成したStatementをcloseしたことによって，このドライバがResultSetをcloseした場合を含みます。

  • このResultSetオブジェクトを生成したStatementを作成したConnectionがcloseされている場合

  • トランザクションの決着によってResultSetが無効になった場合

(as)　getObject(int columnIndex)

【機能】

このResultSetオブジェクトの現在行にある指定された列の値を，Javaプログラミング言語のObjectとして取得します。

【形式】
public synchronized Object getObject (int columnIndex) throws SQLException
【引数】
int columnIndex：

列番号

【戻り値】

列の値をJavaオブジェクトとして返します。

Javaオブジェクトの型は，JDBC仕様で指定されている組み込み型のマッピングに従って，列のSQL型に対応するデフォルトのJavaオブジェクトの型になります。値がNULL値の場合，nullを返します。

【機能詳細】

このResultSetオブジェクトの現在行にある指定された列の値を，Javaプログラミング言語のObjectとして取得します。

HiRDBのデータ型による検索結果と戻り値の関係を次に示します。

HiRDBのデータ型

検索結果

戻り値

[M｜N][VAR]CHAR

NULL

null

上記以外

検索結果

SMALLINT

NULL

null

上記以外

検索結果で生成したIntegerオブジェクト

INTEGER

NULL

null

上記以外

検索結果で生成したIntegerオブジェクト

REAL

NULL

null

上記以外

検索結果で生成したFloatオブジェクト

FLOAT

NULL

null

上記以外

検索結果で生成したDoubleオブジェクト

DECIMAL

NULL

null

上記以外

検索結果

DATE

NULL

null

上記以外

検索結果で生成したjava.sql.Dateオブジェクト

TIME

NULL

null

上記以外

検索結果で生成したjava.sql.Timeオブジェクト

TIMESTAMP

NULL

null

上記以外

検索結果で生成したjava.sql.Timestampオブジェクト

BINARYBLOB

NULL

null

上記以外

検索結果

BOOLEAN※

NULL

null

NULL以外

検索結果で生成したBooleanオブジェクト

注※　DatabaseMetadataから生成したResultsetの場合，BOOLEAN型データが存在します。

【発生する例外】

次の場合，SQLExceptionを投入します。

  • このResultSetオブジェクトがcloseされている場合

    このResultSetオブジェクトを生成したStatementをcloseしたことによって，このドライバがResultSetをcloseした場合を含みます。

  • このResultSetオブジェクトを生成したStatementを作成したConnectionがcloseされている場合

  • トランザクションの決着によってResultSetが無効になった場合

  • 存在しない列番号が指定されている場合

  • JDBCドライバ内でエラーが発生した場合

(at)　getObject(String columnName)

【機能】

このResultSetオブジェクトの現在行にある指定された列の値を，Javaプログラミング言語のObjectとして取得します。

HiRDBのデータ型による検索結果と戻り値の関係については，「getObject(int columnIndex)」の【機能詳細】を参照してください。

【形式】
public synchronized Object getObject (String columnName) throws SQLException
【引数】
String columnName：

列名

【戻り値】

列の値をJavaオブジェクトとして返します。

Javaオブジェクトの型は，JDBC仕様で指定されている組み込み型のマッピングに従って，列のSQL型に対応するデフォルトのJavaオブジェクトの型になります。値がNULL値の場合，nullを返します。

【発生する例外】

次の場合，SQLExceptionを投入します。

  • このResultSetオブジェクトがcloseされている場合

    このResultSetオブジェクトを生成したStatementをcloseしたことによって，このドライバがResultSetをcloseした場合を含みます。

  • このResultSetオブジェクトを生成したStatementを作成したConnectionがcloseされている場合

  • トランザクションの決着によってResultSetが無効になった場合

  • 存在しない列名が指定されている場合

  • JDBCドライバ内でエラーが発生した場合

(au)　getRow()

【機能】

現在の行の番号を取得します。最初の行が1，2番目は2となります。先頭行の前又は最終行の後ろの場合は0となります。

最大検索行数が2147483647を超える場合，2147483647を返します。

【形式】
public synchronized int getRow() throws SQLException
【引数】

なし。

【戻り値】

現在の行番号（現在の行がInteger.MAX_VALUEより大きい場合はInteger.MAX_VALUEを返します）

【発生する例外】

次の場合，SQLExceptionを投入します。

  • このResultSetオブジェクトがcloseされている場合

    このResultSetオブジェクトを生成したStatementをcloseしたことによって，このドライバがResultSetをcloseした場合を含みます。

  • このResultSetオブジェクトを生成したStatementを作成したConnectionがcloseされている場合

  • トランザクションの決着によってResultSetが無効になった場合

  • データベースアクセスでエラーが発生した場合

(av)　getShort(int columnIndex)

【機能】

このResultSetオブジェクトの現在行にある指定された列の値を，Javaプログラミング言語のshortとして取得します。

【形式】
public synchronized short getShort(int columnIndex) throws SQLException
【引数】
int columnIndex：

列番号

【戻り値】

列値（値がNULL値の場合は0を返します）

【機能詳細】

このResultSetオブジェクトの現在行にある指定された列の値を，Javaプログラミング言語のshortとして取得します。

HiRDBのデータ型による検索結果と戻り値の関係を次に示します。

HiRDBのデータ型

検索結果

戻り値

[M｜N][VAR]CHAR

NULL

0

[半角空白]整数の文字列表現，10進数の文字列表現，又は浮動小数点数の文字列表現[半角空白]であり，かつShort.MIN_VALUE以上，Short.MAX_VALUE以下

検索結果の整数部分の値をshort値にしたもの

[半角空白]整数の文字列表現，10進数の文字列表現，又は浮動小数点数の文字列表現[半角空白]であり，かつShort.MAX_VALUEより大きいかShort.MIN_VALUEより小さい

SQLExceptionを投入

[半角空白]-Infinity[半角空白]

SQLExceptionを投入

[半角空白][+]Infinity[半角空白]

SQLExceptionを投入

[半角空白][+｜-]NaN[半角空白]

SQLExceptionを投入

上記以外（double値にできない）

SQLExceptionを投入

SMALLINT

NULL

0

上記以外

検索結果

INTEGER

NULL

0

Short.MIN_VALUE以上かつ，Short.MAX_VALUE以下

検索結果をshort値にしたもの

上記以外

SQLExceptionを投入

REAL

NULL

0

Infinity

SQLExceptionを投入

-Infinity

SQLExceptionを投入

NaN

SQLExceptionを投入

Short.MIN_VALUE以上かつ，Short.MAX_VALUE以下

検索結果の整数部分の値をshort値にしたもの

上記以外

SQLExceptionを投入

FLOAT

NULL

0

Infinity

SQLExceptionを投入

-Infinity

SQLExceptionを投入

NaN

SQLExceptionを投入

Short.MIN_VALUE以上かつ，Short.MAX_VALUE以下

検索結果の整数部分の値をshort値にしたもの

上記以外

SQLExceptionを投入

DECIMAL

NULL

0

Short.MIN_VALUE以上かつShort.MAX_VALUE以下

検索結果の整数部分の値をshort値にしたもの

上記以外

SQLExceptionを投入

BOOLEAN※

NULL

0

true

1

false

0

その他

−

SQLExceptionを投入

（凡例）　−：該当しません。

注※　DatabaseMetadataから生成したResultsetの場合，BOOLEAN型データが存在します。

【発生する例外】

次の場合，SQLExceptionを投入します。

  • このResultSetオブジェクトがcloseされている場合

    このResultSetオブジェクトを生成したStatementをcloseしたことによって，このドライバがResultSetをcloseした場合を含みます。

  • このResultSetオブジェクトを生成したStatementを作成したConnectionがcloseされている場合

  • トランザクションの決着によってResultSetが無効になった場合

  • 存在しない列番号が指定されている場合

  • このメソッドでは取得できないデータ型の場合

  • 列の値がshortとして取得できない場合

  • JDBCドライバ内でエラーが発生した場合

(aw)　getShort(String columnName)

【機能】

このResultSetオブジェクトの現在行にある指定された列の値を，Javaプログラミング言語のshortとして取得します。

HiRDBのデータ型による検索結果と戻り値の関係については，「getShort(int columnIndex)」の【機能詳細】を参照してください。

【形式】
public synchronized short getShort (String columnName) throws SQLException
【引数】
String columnName：

列名

【戻り値】

列値（値がNULL値の場合は0を返します）

【発生する例外】

次の場合，SQLExceptionを投入します。

  • このResultSetオブジェクトがcloseされている場合

    このResultSetオブジェクトを生成したStatementをcloseしたことによって，このドライバがResultSetをcloseした場合を含みます。

  • このResultSetオブジェクトを生成したStatementを作成したConnectionがcloseされている場合

  • トランザクションの決着によってResultSetが無効になった場合

  • 存在しない列名が指定されている場合

  • このメソッドでは取得できないデータ型の場合

  • 列の値がshortとして取得できない場合

  • JDBCドライバ内でエラーが発生した場合

(ax)　getStatement()

【機能】

このResultSetオブジェクトを生成したStatementオブジェクトを取得します。

結果集合がDatabaseMetaDataのメソッドで生成された場合は，nullを返します。

【形式】
public synchronized Statement getStatement() throws SQLException
【引数】

なし。

【戻り値】

このResultSetオブジェクトを生成したStatmentオブジェクト（結果集合がDatabaseMetaDataのメソッドで生成された場合は，nullを返します）

【発生する例外】

次の場合，SQLExceptionを投入します。

  • このResultSetオブジェクトがcloseされている場合

    このResultSetオブジェクトを生成したStatementをcloseしたことによって，このドライバがResultSetをcloseした場合を含みます。

  • このResultSetオブジェクトを生成したStatementを作成したConnectionがcloseされている場合

  • トランザクションの決着によってResultSetが無効になる場合

(ay)　getString(int columnIndex)

【機能】

このResultSetオブジェクトの現在行にある指定された列の値を，Javaプログラミング言語のStringとして取得します。

【形式】
public synchronized String getString(int columnIndex) throws SQLException
【引数】
int columnIndex：

列番号

【戻り値】

列値（値がNULL値の場合，nullを返します）

【機能詳細】

このResultSetオブジェクトの現在行にある指定された列の値を，Javaプログラミング言語のStringとして取得します。

HiRDBのデータ型による検索結果と戻り値の関係を次に示します。

HiRDBのデータ型

検索結果

戻り値

[M｜N][VAR]CHAR

NULL

null

上記以外

検索結果

SMALLINT

NULL

null

上記以外

検索結果を文字列表現にしたStringオブジェクト

INTEGER

NULL

null

上記以外

検索結果を文字列表現にしたStringオブジェクト

REAL

NULL

null

Infinity

文字列"Infinity"のStringオブジェクト

-Infinity

文字列"-Infinity"のStringオブジェクト

NaN

文字列"NaN"のStringオブジェクト

上記以外

検索結果を文字列表現にしたStringオブジェクト

FLOAT

NULL

null

Infinity

文字列"Infinity"のStringオブジェクト

-Infinity

文字列"-Infinity"のStringオブジェクト

NaN

文字列"NaN"のStringオブジェクト

上記以外

検索結果を文字列表現にしたStringオブジェクト

DECIMAL

NULL

null

上記以外

検索結果を文字列表現にしたStringオブジェクト

DATE

NULL

null

上記以外

JdbConvert.convertDate()で取得したyyyy-MM-DD形式の文字列のStringオブジェクト

TIME

NULL

null

上記以外

hh:mm:ss形式の文字列のStringオブジェクト

TIMESTAMP

NULL

null

上記以外

yyyy-MM-DD△hh:mm:ss[.ffffff]形式の文字列のStringオブジェクト

BINARYBLOB

NULL

null

上記以外

検索結果のStringオブジェクト

BOOLEAN※

NULL

null

true

文字列"true"のStringオブジェクト

false

文字列"false"のStringオブジェクト

注※　DatabaseMetadataから生成したResultsetの場合，BOOLEAN型データが存在します。

【発生する例外】

次の場合，SQLExceptionを投入します。

  • このResultSetオブジェクトがcloseされている場合

    このResultSetオブジェクトを生成したStatementをcloseしたことによって，このドライバがResultSetをcloseした場合を含みます。

  • このResultSetオブジェクトを生成したStatementを作成したConnectionがcloseされている場合

  • トランザクションの決着によってResultSetが無効になった場合

  • 存在しない列番号が指定されている場合

  • エンコードに失敗した場合

  • このメソッドでは取得できないデータ型の場合

  • JDBCドライバ内でエラーが発生した場合

(az)　getString(String columnName)

【機能】

このResultSetオブジェクトの現在行にある指定された列の値を，Javaプログラミング言語のStringとして取得します。

HiRDBのデータ型による検索結果と戻り値の関係については，「getString(int columnIndex)」の【機能詳細】を参照してください。

【形式】
public synchronized String getString(String columnName) throws SQLException
【引数】
String columnName：

列名

【戻り値】

列値（値がNULL値の場合，nullを返します）

【発生する例外】

次の場合，SQLExceptionを投入します。

  • このResultSetオブジェクトがcloseされている場合

    このResultSetオブジェクトを生成したStatementをcloseしたことによって，このドライバがResultSetをcloseした場合を含みます。

  • このResultSetオブジェクトを生成したStatementを作成したConnectionがcloseされている場合

  • トランザクションの決着によってResultSetが無効になった場合

  • 存在しない列名が指定されている場合

  • エンコードに失敗した場合

  • このメソッドでは取得できないデータ型の場合

  • JDBCドライバ内でエラーが発生した場合

(ba)　getTime(int columnIndex)

【機能】

このResultSetオブジェクトの現在行にある指定された列の値を，java.sql.Timeとして取得します。

【形式】
public synchronized java.sql.Time getTime(int columnIndex) throws SQLException
【引数】
int columnIndex：

列番号

【戻り値】

列値（値がNULL値の場合，nullを返します）

【機能詳細】

このResultSetオブジェクトの現在行にある指定された列の値を，java.sql.Timeとして取得します。

HiRDBのデータ型による検索結果と戻り値の関係を次に示します。

HiRDBのデータ型

検索結果

戻り値

[M｜N][VAR]CHAR

NULL

null

[半角空白]時刻形式[半角空白]

検索結果の前後の半角空白を取り除きjava.sql.Timeオブジェクトにしたもの

上記以外

SQLExceptionを返します

TIME

NULL

null

上記以外

検索結果をjava.sql.Timeオブジェクトにしたもの

TIMESTAMP

NULL

null

上記以外

検索結果をjava.sql.Timeオブジェクトにしたもの

その他

−

SQLExceptionを返します

（凡例）　−：該当しません。

【発生する例外】

次の場合，SQLExceptionを投入します。

  • このResultSetオブジェクトがcloseされている場合

    このResultSetオブジェクトを生成したStatementをcloseしたことによって，このドライバがResultSetをcloseした場合を含みます。

  • このResultSetオブジェクトを生成したStatementを作成したConnectionがcloseされている場合

  • トランザクションの決着によってResultSetが無効になった場合

  • 存在しない列番号が指定されている場合

  • このメソッドでは取得できないデータ型の場合

  • 列の値がjava.sql.Timeとして取得できない場合

  • JDBCドライバ内でエラーが発生した場合

(bb)　getTime(int columnIndex, Calendar cal)

【機能】

このResultSetオブジェクトの現在行にある指定された列の値を，java.sql.Timeオブジェクトとして取得します。このメソッドは指定されたカレンダーを使って時刻に適切なミリ秒値を作成します。

【形式】
public synchronized java.sql.Time getTime (int columnIndex, Calendar cal) throws SQLException
【引数】
int columnIndex：

列番号

Calendar cal：

データベースに格納されている値のタイムゾーンが設定されたカレンダー

【戻り値】

列値（値がNULL値の場合，nullを返します）

HiRDBのデータ型による検索結果と戻り値の関係については，「getTime(int columnIndex)」の【機能詳細】を参照してください。

【発生する例外】

次の場合，SQLExceptionを投入します。

  • このResultSetオブジェクトがcloseされている場合

    このResultSetオブジェクトを生成したStatementをcloseしたことによって，このドライバがResultSetをcloseした場合を含みます。

  • このResultSetオブジェクトを生成したStatementを作成したConnectionがcloseされている場合

  • トランザクションの決着によってResultSetが無効になった場合

  • 存在しない列番号が指定されている場合

  • このメソッドでは取得できないデータ型の場合

  • 列の値がjava.sql.Timeとして取得できない場合

  • JDBCドライバ内でエラーが発生した場合

(bc)　getTime(String columnName)

【機能】

このResultSetオブジェクトの現在行にある指定された列の値を，java.sql.Timeオブジェクトとして取得します。

HiRDBのデータ型による検索結果と戻り値の関係については，「getTime(int columnIndex)」の【機能詳細】を参照してください。

【形式】
public synchronized java.sql.Time getTime (String columnName) throws SQLException
【引数】
String columnName：

列名

【戻り値】

列値（値がNULL値の場合，nullを返します）

【発生する例外】

次の場合，SQLExceptionを投入します。

  • このResultSetオブジェクトがcloseされている場合

    このResultSetオブジェクトを生成したStatementをcloseしたことによって，このドライバがResultSetをcloseした場合を含みます。

  • このResultSetオブジェクトを生成したStatementを作成したConnectionがcloseされている場合

  • トランザクションの決着によってResultSetが無効になった場合

  • 存在しない列名が指定されている場合

  • このメソッドでは取得できないデータ型の場合

  • 列の値がjava.sql.Timeとして取得できない場合

  • JDBCドライバ内でエラーが発生した場合

(bd)　getTime(String columnName, Calendar cal)

【機能】

このResultSetオブジェクトの現在行にある指定された列の値を，java.sql.Timeオブジェクトとして取得します。このメソッドは指定されたカレンダーを使って時刻に適切なミリ秒値を作成します。

HiRDBのデータ型による検索結果と戻り値の関係については，「getTime(int columnIndex)」の【機能詳細】を参照してください。

【形式】
public synchronized java.sql.Time getTime (String columnName, Calendar cal) throws SQLException
【引数】
String columnName：

列名

Calendar cal：

データベースに格納されている値のタイムゾーンが設定されたカレンダー

【戻り値】

列値（値がNULL値の場合，nullを返します）

【発生する例外】

次の場合，SQLExceptionを投入します。

  • このResultSetオブジェクトがcloseされている場合

    このResultSetオブジェクトを生成したStatementをcloseしたことによって，このドライバがResultSetをcloseした場合を含みます。

  • このResultSetオブジェクトを生成したStatementを作成したConnectionがcloseされている場合

  • トランザクションの決着によってResultSetが無効になった場合

  • 存在しない列名が指定されている場合

  • このメソッドでは取得できないデータ型の場合

  • 列の値がjava.sql.Timeとして取得できない場合

  • JDBCドライバ内でエラーが発生した場合

(be)　getTimestamp(int columnIndex)

【機能】

このResultSetオブジェクトの現在行にある指定された列の値を，java.sql.Timestampオブジェクトとして取得します。

【形式】
public synchronized java.sql.Timestamp getTimestamp (int columnIndex) throws SQLException
【引数】
int columnIndex：

列番号

【戻り値】

列値（値がNULL値の場合，nullを返します）

【機能詳細】

このResultSetオブジェクトの現在行にある指定された列の値を，java.sql.Timestampオブジェクトとして取得します。

HiRDBのデータ型による検索結果と戻り値の関係については「TIME型，DATE型，及びTIMESTAMP型列のデータ変換処理」を参照してください。TIME型，DATE型，TIMESTAMP型，文字列型以外のデータ型を取得した場合，SQLExceptionを投入します。

【発生する例外】

次の場合，SQLExceptionを投入します。

  • このResultSetオブジェクトがcloseされている場合

    このResultSetオブジェクトを生成したStatementをcloseしたことによって，このドライバがResultSetをcloseした場合を含みます。

  • このResultSetオブジェクトを生成したStatementを作成したConnectionがcloseされている場合

  • トランザクションの決着によってResultSetが無効になった場合

  • 存在しない列番号が指定されている場合

  • このメソッドでは取得できないデータ型の場合

  • 列の値がjava.sql.Timestampとして取得できない場合

  • JDBCドライバ内でエラーが発生した場合

(bf)　getTimestamp(int columnIndex, Calendar cal)

【機能】

このResultSetオブジェクトの現在行にある指定された列の値を，java.sql.Timestampオブジェクトとして取得します。このメソッドは指定されたカレンダーを使ってタイムスタンプに適切なミリ秒値を作成します。

HiRDBのデータ型による検索結果と戻り値の関係については，「TIME型，DATE型，及びTIMESTAMP型列のデータ変換処理」を参照してください。TIME型，DATE型，TIMESTAMP型，文字列型以外のデータ型を取得した場合，SQLExceptionを投入します。

【形式】
public synchronized java.sql.Timestamp getTimestamp (int columnIndex, Calendar cal) throws SQLException
【引数】
int columnIndex：

列番号

Calendar cal：

データベースに格納されている値のタイムゾーンが設定されたカレンダー

【戻り値】

列値（値がNULL値の場合，nullを返します）

【発生する例外】

次の場合，SQLExceptionを投入します。

  • このResultSetオブジェクトがcloseされている場合

    このResultSetオブジェクトを生成したStatementをcloseしたことによって，このドライバがResultSetをcloseした場合を含みます。

  • このResultSetオブジェクトを生成したStatementを作成したConnectionがcloseされている場合

  • トランザクションの決着によってResultSetが無効になった場合

  • 存在しない列番号が指定されている場合

  • このメソッドでは取得できないデータ型の場合

  • 列の値がjava.sql.Timestampとして取得できない場合

  • JDBCドライバ内でエラーが発生した場合

(bg)　getTimestamp(String columnName)

【機能】

このResultSetオブジェクトの現在行にある指定された列の値を，java.sql.Timestampオブジェクトとして取得します。

HiRDBのデータ型による検索結果と戻り値の関係については，「TIME型，DATE型，及びTIMESTAMP型列のデータ変換処理」を参照してください。TIME型，DATE型，TIMESTAMP型，文字列型以外のデータ型を取得した場合，SQLExceptionを投入します。

【形式】
public synchronized java.sql.Timestamp getTimestamp (String columnName) throws SQLException
【引数】
String columnName：

列名

【戻り値】

列値（値がNULL値の場合，nullを返します）

【発生する例外】

次の場合，SQLExceptionを投入します。

  • このResultSetオブジェクトがcloseされている場合

    このResultSetオブジェクトを生成したStatementをcloseしたことによって，このドライバがResultSetをcloseした場合を含みます。

  • このResultSetオブジェクトを生成したStatementを作成したConnectionがcloseされている場合

  • トランザクションの決着によってResultSetが無効になった場合

  • 存在しない列名が指定されている場合

  • このメソッドでは取得できないデータ型の場合

  • 列の値がjava.sql.Timestampとして取得できない場合

  • JDBCドライバ内でエラーが発生した場合

(bh)　getTimestamp(String columnName, Calendar cal)

【機能】

このResultSetオブジェクトの現在行にある指定された列の値を，java.sql.Timestampオブジェクトとして取得します。このメソッドは指定されたカレンダーを使ってタイムスタンプに適切なミリ秒値を作成します。

HiRDBのデータ型による検索結果と戻り値の関係については，「TIME型，DATE型，及びTIMESTAMP型列のデータ変換処理」を参照してください。TIME型，DATE型，TIMESTAMP型，文字列型以外のデータ型を取得した場合，SQLExceptionを投入します。

【形式】
public synchronized java.sql.Timestamp getTimestamp (String columnName, Calendar cal) throws SQLException
【引数】
String columnName：

列名

Calendar cal：

データベースに格納されている値のタイムゾーンが設定されたカレンダー

【戻り値】

列値（値がNULL値の場合，nullを返します）

【発生する例外】

次の場合，SQLExceptionを投入します。

  • このResultSetオブジェクトがcloseされている場合

    このResultSetオブジェクトを生成したStatementをcloseしたことによって，このドライバがResultSetをcloseした場合を含みます。

  • このResultSetオブジェクトを生成したStatementを作成したConnectionがcloseされている場合

  • トランザクションの決着によってResultSetが無効になった場合

  • 存在しない列名が指定されている場合

  • このメソッドでは取得できないデータ型の場合

  • 列の値がjava.sql.Timestampとして取得できない場合

  • JDBCドライバ内でエラーが発生した場合

(bi)　getType()

【機能】

このResultSetオブジェクトの型を返します。ResultSet.TYPE_FORWARD_ONLY又はResultSet.TYPE_SCROLL_INSENSITIVEを返します。

【形式】
public synchronized int getType() throws SQLException
【引数】

なし。

【戻り値】
ResultSet.TYPE_FORWARD_ONLY：

カーソルが順方向にだけ移動できます。

ResultSet.TYPE_SCROLL_INSENSITIVE：

カーソルがスクロールできますが，値の変更は反映されません。

ResultSet.TYPE_SCROLL_SENSITIVE：

カーソルはスクロールでき，値の変更が反映されます。

【発生する例外】

次の場合，SQLExceptionを投入します。

  • このResultSetオブジェクトがcloseされている場合

    このResultSetオブジェクトを生成したStatementをcloseしたことによって，このドライバがResultSetをcloseした場合を含みます。

  • このResultSetオブジェクトを生成したStatementを作成したConnectionがcloseされている場合

  • トランザクションの決着によってResultSetが無効になる場合

(bj)　getWarnings()

【機能】

このResultSetオブジェクトに関する呼び出しによって報告される，最初の警告を取得します。二つ以上の警告がある場合，後続の警告は最初の警告にチェーンされ，直前に取得された警告のSQLWarning.getNextWarningメソッドを呼び出すことによって取得されます。

【形式】
public synchronized SQLWarning getWarnings() throws SQLException
【引数】

なし。

【戻り値】

最初のSQLWarningオブジェクト（ない場合はnullを返します）

【発生する例外】

次の場合，SQLExceptionを投入します。

  • このResultSetオブジェクトがcloseされている場合

    このResultSetオブジェクトを生成したStatementをcloseしたことによって，このドライバがResultSetをcloseした場合を含みます。

  • このResultSetオブジェクトを生成したStatementを作成したConnectionがcloseされている場合

  • トランザクションの決着によってResultSetが無効になった場合

(bk)　isAfterLast()

【機能】

カーソルが，このResultSetオブジェクト内の最終行の後ろにあるかどうかを取得します。

【形式】
public synchronized boolean isAfterLast() throws SQLException
【引数】

なし。

【戻り値】

カーソルが最終行の後ろにある場合はtrue，最終行の後ろにない場合，又は結果集合の行数が0行の場合はfalseを返します。

【発生する例外】

次の場合，SQLExceptionを投入します。

  • このResultSetオブジェクトがcloseされている場合

    このResultSetオブジェクトを生成したStatementをcloseしたことによって，このドライバがResultSetをcloseした場合を含みます。

  • このResultSetオブジェクトを生成したStatementを作成したConnectionがcloseされている場合

  • トランザクションの決着によってResultSetが無効になった場合

  • データベースアクセスでエラーが発生した場合

(bl)　isBeforeFirst()

【機能】

カーソルが，このResultSetオブジェクト内の先頭行の前にあるかどうかを取得します。

【形式】
public synchronized boolean isBeforeFirst() throws SQLException
【引数】

なし。

【戻り値】

カーソルが先頭行の前にある場合はtrue，先頭行の前にない場合，又は結果集合の行数が0行の場合はfalseを返します。

【発生する例外】

次の場合，SQLExceptionを投入します。

  • このResultSetオブジェクトがcloseされている場合

    このResultSetオブジェクトを生成したStatementをcloseしたことによって，このドライバがResultSetをcloseした場合を含みます。

  • このResultSetオブジェクトを生成したStatementを作成したConnectionがcloseされている場合

  • トランザクションの決着によってResultSetが無効になった場合

  • データベースアクセスでエラーが発生した場合

(bm)　isFirst()

【機能】

カーソルが，このResultSetオブジェクト内の先頭行にあるかどうかを取得します。

【形式】
public synchronized boolean isFirst() throws SQLException
【引数】

なし。

【戻り値】

カーソルが先頭行にある場合はtrue，そうでない場合はfalseを返します。

【発生する例外】

次の場合，SQLExceptionを投入します。

  • このResultSetオブジェクトがcloseされている場合

    このResultSetオブジェクトを生成したStatementをcloseしたことによって，このドライバがResultSetをcloseした場合を含みます。

  • このResultSetオブジェクトを生成したStatementを作成したConnectionがcloseされている場合

  • トランザクションの決着によってResultSetが無効になった場合

  • データベースアクセスでエラーが発生した場合

(bn)　isLast()

【機能】

カーソルが，このResultSetオブジェクトの最終行にあるかどうかを取得します。

【形式】
public synchronized boolean isLast() throws SQLException
【引数】

なし。

【戻り値】

カーソルが最終行にある場合はtrue，そうでない場合はfalseを返します。

【発生する例外】

次の場合，SQLExceptionを投入します。

  • このResultSetオブジェクトがcloseされている場合

    このResultSetオブジェクトを生成したStatementをcloseしたことによって，このドライバがResultSetをcloseした場合を含みます。

  • このResultSetオブジェクトを生成したStatementを作成したConnectionがcloseされている場合

  • トランザクションの決着によってResultSetが無効になった場合

  • データベースアクセスでエラーが発生した場合

(bo)　last()

【機能】

カーソルを，このResultSetオブジェクトの最終行に移動します。

【形式】
public synchronized boolean last() throws SQLException
【引数】

なし。

【戻り値】

カーソルが最終行に移動した場合はtrueを，結果集合の行数が0の場合はfalseを返します。

【発生する例外】

次の場合，SQLExceptionを投入します。

  • このResultSetオブジェクトがcloseされている場合

    このResultSetオブジェクトを生成したStatementをcloseしたことによって，このドライバがResultSetをcloseした場合を含みます。

  • このResultSetオブジェクトを生成したStatementを作成したConnectionがcloseされている場合

  • このResultSetオブジェクトの型がTYPE_FORWARD_ONLYの場合

  • トランザクションの決着によってResultSetが無効になった場合

  • データベースアクセスでエラーが発生した場合

(bp)　next()

【機能】

カーソルを，現在の位置から次の行に移動します。先頭行の前の場合は先頭行に，最終行の場合は最終行の後ろに移動します。

nextメソッドの最初の呼び出しによって，カーソルがオープンされます。

【形式】
public synchronized boolean next() throws SQLException
【引数】

なし。

【戻り値】

このメソッド呼び出し後のカーソル位置が先頭行の前，又は最終行の後ろの場合はfalse，そうでない場合はtrueを返します。

【発生する例外】

次の場合，SQLExceptionを投入します。

  • このResultSetオブジェクトがcloseされている場合

    このResultSetオブジェクトを生成したStatementをcloseしたことによって，このドライバがResultSetをcloseした場合を含みます。

  • このResultSetオブジェクトを生成したStatementを作成したConnectionがcloseされている場合

  • トランザクションの決着によってResultSetが無効になった場合

  • データベースアクセスでエラーが発生した場合

(bq)　previous()

【機能】

カーソルを，このResultSetオブジェクト内の一つ前の行に移動します。

【形式】
public synchronized boolean previous() throws SQLException
【引数】

なし。

【戻り値】

このメソッド呼び出し後のカーソル位置が先頭行の前の場合はfalse，そうでない場合はtrueを返します。

【発生する例外】

次の場合，SQLExceptionを投入します。

  • このResultSetオブジェクトがcloseされている場合

    このResultSetオブジェクトを生成したStatementをcloseしたことによって，このドライバがResultSetをcloseした場合を含みます。

  • このResultSetオブジェクトを生成したStatementを作成したConnectionがcloseされている場合

  • このResultSetオブジェクトの型がTYPE_FORWARD_ONLYの場合

  • トランザクションの決着によってResultSetが無効になった場合

  • データベースアクセスでエラーが発生した場合

(br)　relative(int rows)

【機能】

カーソルを，正又は負の相対行数だけ移動します。

正の数はカーソルを順方向に移動し，負の数は逆方向に移動します。

【形式】
public synchronized boolean relative(int rows) throws SQLException
【引数】
int rows：

現在の行から移動する行数

【戻り値】

このメソッド呼び出し後のカーソル位置が先頭行の前，又は最終行の後ろの場合はfalse，そうでない場合はtrueに返します。

【発生する例外】

次の場合，SQLExceptionを投入します。

  • このResultSetオブジェクトがcloseされている場合

    このResultSetオブジェクトを生成したStatementをcloseしたことによって，このドライバがResultSetをcloseした場合を含みます。

  • このResultSetオブジェクトを生成したStatementを作成したConnectionがcloseされている場合

  • このResultSetオブジェクトの型がTYPE_FORWARD_ONLYの場合

  • 現在の位置が取得できない場合

  • 現在のカーソル位置が有効な行にない場合

  • トランザクションの決着によってResultSetが無効になった場合

  • データベースアクセスでエラーが発生した場合

(bs)　setFetchDirection(int direction)

【機能】

このStatementオブジェクトから生成される結果集合の，デフォルトのフェッチ方向を指定します。

ResultSet.FETCH_FORWARDだけ指定できます。

【形式】
public synchronized void setFetchDirection(int direction) throws SQLException
【引数】
int direction：

デフォルトのフェッチ方向

【戻り値】

なし。

【発生する例外】

次の場合，SQLExceptionを投入します。

  • このStatementオブジェクトがcloseされている場合

  • このStatementオブジェクトを生成したConnectionがcloseされている場合

  • directionにResultSet.FETCH_FORWARD以外が指定された場合

(bt)　setFetchSize(int rows)

【機能】

このResultSetオブジェクトのフェッチサイズを設定します。0を指定した場合は，クライアント環境定義に依存します。

【形式】
public synchronized void setFetchSize(int rows) throws SQLException
【引数】
int rows：

フェッチする行数。設定できる範囲は0〜4096です。

【戻り値】

なし。

【機能詳細】

このResultSetオブジェクトのフェッチサイズを設定します。0を指定した場合は，クライアント環境定義に依存します。

このメソッドによる指定がない場合は，Statementオブジェクトに指定した行数値をヒントとして検索します。Statementオブジェクトに行数値を指定していない，又はStatementオブジェクトから生成したResultSetオブジェクトでない場合は，クライアント環境定義PDBLKFの値をヒントとして検索します。このメソッドで0を指定した場合は，クライアント環境定義PDBLKFの値をヒントとして検索します。その他の注意事項については，「setFetchSize(int rows)」を参照してください。

【発生する例外】

次の場合，SQLExceptionを投入します。

  • このResultSetオブジェクトがcloseされている場合

    このResultSetオブジェクトを生成したStatementをcloseしたことによって，このドライバがResultSetをcloseした場合を含みます。

  • このResultSetオブジェクトを生成したStatementを作成したConnectionがcloseされている場合

  • このResultSetオブジェクトの型がTYPE_FORWARD_ONLYの場合

  • 現在の位置が取得できない場合

  • 現在のカーソル位置が有効な行にない場合

  • トランザクションの決着によってResultSetが無効になった場合

  • データベースアクセスでエラーが発生した場合

(bu)　wasNull()

【機能】

最後に取得した列の値が，NULL値であるかどうかを通知します。

getXXXメソッドによって値を取得する前は，falseを返します。

【形式】
public synchronized boolean wasNull() throws SQLException
【引数】

なし。

【戻り値】

最後に取得した列の値がNULL値の場合はtrue，そうでない場合はfalseを返します。

【発生する例外】

次の場合，SQLExceptionを投入します。

  • このResultSetオブジェクトがcloseされている場合

    このResultSetオブジェクトを生成したStatementをcloseしたことによって，このドライバがResultSetをcloseした場合を含みます。

  • このResultSetオブジェクトを生成したStatementを作成したConnectionがcloseされている場合

  • トランザクションの決着によってResultSetが無効になった場合

(bv)　getHoldability()

【機能】

ResultSetオブジェクトの保持機能についての状態を示す値を取得します。

【形式】
public int getHoldability() throws SQLException
【引数】

なし。

【戻り値】
ResultSet.HOLD_CURSORS_OVER_COMMIT：

現在のトランザクションがコミットするとき，オープンしているResultSetオブジェクトはオープンしたままになります。

ResultSet.CLOSE_CURSORS_AT_COMMIT：

現在のトランザクションがコミットするとき，オープンしているResultSetオブジェクトはクローズされます。

【発生する例外】

次の場合，SQLExceptionを投入します。

  • このResultSetオブジェクトがクローズされている場合

    このResultSetオブジェクトを生成したStatementをクローズしたことによって，このドライバがResultSetをクローズした場合を含みます。

  • このResultSetオブジェクトを生成したStatementを作成したConnectionがクローズされている場合

(bw)　isClosed()

【機能】

ResultSetオブジェクトがクローズされているかどうかの情報を取得します。

【形式】
public boolean isClosed() throws SQLException
【引数】

なし。

【戻り値】
true：

ResultSetオブジェクトはクローズされています。

false：

ResultSetオブジェクトはオープンされています。

【機能詳細】

ResultSetオブジェクトがクローズされているかどうかの情報を取得します。次の場合，trueが返されます。

  • このResultSetオブジェクトがクローズされている場合

    このResultSetオブジェクトを生成したStatementをクローズしたことによって，このドライバがResultSetをクローズした場合を含みます。

  • このResultSetオブジェクトを生成したStatementを作成したConnectionがクローズされている場合

【発生する例外】

なし。

ページの先頭へ

(3)　パッケージ名称及びクラス名称

このインタフェースを実装するパッケージ名称とクラス名称を次に示します。

パッケージ名称：JP.co.Hitachi.soft.HiRDB.JDBC

クラス名称：PrdbResultSet

ページの先頭へ

(4)　フィールド

ResultSetインタフェースでサポートするフィールドを次の表に示します。

表17‒40　ResultSetインタフェースでサポートするフィールド

フィールド

備考

public static final int FETCH_FORWARD

−

public static final int FETCH_REVERSE

−

public static final int FETCH_UNKNOWN

−

public static final int TYPE_FORWARD_ONLY

−

public static final int TYPE_SCROLL_INSENSITIVE

−

public static final int TYPE_SCROLL_SENSITIVE

JDBCドライバでは，この値が指定されると，TYPE_SCROLL_INSENSITIVEが指定されたものとみなします。

public static final int CONCUR_READ_ONLY

−

public static final int CONCUR_UPDATABLE

JDBCドライバでは，この値が指定されると，CONCUR_READ_ONLYが指定されたものとみなします。

public static final int HOLD_CURSORS_OVER_COMMIT

−

public static final int CLOSE_CURSORS_AT_COMMIT

−
（凡例）

−：特にありません。

ページの先頭へ

(5)　注意事項

(a)　getXXXメソッドによる値の取得

  • getXXXメソッドによってマッピングできるかどうかについては，「検索データ取得時のマッピング」を参照してください。

  • getXXXメソッドに指定した列番号又は列名称が存在しない場合は，SQLExceptionを投入します。

  • getXXXメソッドに指定する値が，実際の値を表現できない場合（例：INTEGER型の40,000という値をgetShortで取得する場合），オーバフローによってSQLExceptionを投入します。オーバフローが発生する可能性のあるgetXXXメソッドとHiRDBのデータ型の組み合わせについては，「オーバフローの扱い」を参照してください。

(b)　マッピング（変換）

検索データ取得時に使用するgetXXXメソッドによってマッピングできるかどうかについては，「検索データ取得時のマッピング」を参照してください。マッピングできないJDBC SQLタイプに対してgetXXXメソッドが呼び出された場合，SQLExceptionを投入します。

(c)　setFetchSizeメソッドの指定によるブロック転送機能の利用

「setFetchSizeメソッドの指定によるブロック転送機能の利用」を参照してください。

(d)　結果セットタイプがResultSet.TYPE_SCROLL_INSENSITIVE，又はResultSet.TYPE_SCROLL_SENSITIVEである場合のメモリ使用量

結果セットタイプがResultSet.TYPE_SCROLL_INSENSITIVE，又はResultSet.TYPE_SCROLL_SENSITIVEである場合，ResultSetインタフェースの次のメソッドを実行するとき，検索結果蓄積用のメモリをJDBCドライバが確保します。

  • ResultSet.nextメソッド

  • ResultSet.lastメソッド

  • ResultSet.absoluteメソッド

  • ResultSet.relativeメソッド

  • ResultSet.afterLastメソッド

JDBCドライバは，検索結果中のすべての値ごとにメモリオブジェクトを割り当てて蓄積します。値が可変長である場合，メモリオブジェクトは検索データの実サイズに合わせた大きさとなります。

(e)　next，absolute，relative，last，及びafterLastメソッド

nextメソッドを実行すると，JDBCドライバは次の表に示すようにデータベースからデータを取得，蓄積します。

表17‒41　nextメソッド実行時の，データベースからのデータの取得，蓄積

状態

結果セットタイプ

TYPE_FORWARD_ONLY

TYPE_SCROLL_INSENSITIVE，又はTYPE_SCROLL_SENSITIVE

nextメソッドで移動した現在行のデータをJDBCドライバ内に読み込んでいない。

遷移した現在行を接続先のデータベースから取得します。

遷移した現在行を接続先のデータベースから取得し，JDBCドライバのメモリに読み込み，蓄積します。

nextメソッドで移動した現在行のデータをJDBCドライバ内に読み込んでいる。

接続先のデータベースからデータを取得しません。

absolute，relative，last，及びafterLastメソッドを実行すると，JDBCドライバは次の表に示すようにデータベースからデータを取得，蓄積します。

表17‒42　absolute，relative，last，及びafterLastメソッド実行時の，データベースからのデータの取得，蓄積

状態

結果セットタイプが

TYPE_SCROLL_INSENSITIVE，又はTYPE_SCROLL_SENSITIVE

検索結果の先頭行から指定行※までに，JDBCドライバが読み込んでいないデータがある。

読み込んでいない行を接続先のデータベースから取得し，JDBCドライバのメモリに蓄積します。

検索結果の先頭行から指定行※までに，JDBCドライバが読み込んでいないデータはない。

接続先のデータベースからデータを取得しません。
注

結果セットタイプがTYPE_FORWARD_ONLYの場合，SQLExceptionを投入します。

注※

lastメソッド及びafterLastメソッドの場合，先頭行から最終行です。

(f)　getAsciiStream，getBinaryStream，getCharacterStream，及びgetUnicodeStreamメソッド

getAsciiStream，getBinaryStream，getCharacterStream，及びgetUnicodeStreamメソッドが返却したオブジェクトは，JDBCドライバが暗黙的にクローズすることはありません。メソッド呼び出し側でcloseメソッドを実行してください。

(g)　検索結果行数

ResultSetオブジェクトがHiRDBサーバから取得できる検索結果の行数を次の表に示します。次の表に示す行以上の検索結果は，JDBCドライバが破棄します。

表17‒43　ResultSetオブジェクトがHiRDBサーバから取得できる検索結果の行数

ResultSetオブジェクト

結果セットタイプ

TYPE_SCROLL_INSENSITIVE，又はTYPE_SCROLL_SENSITIVE

左記以外

setMaxRowsメソッドを実行したStatementオブジェクトから生成したResultSetオブジェクト

検索結果行数は，setMaxRowsメソッドで指定した行数です。

上記以外のResultSetオブジェクト

検索結果行数は，setMaxRowsメソッドの上限（2,147,483,647）です。

上限はありません。

(h)　ナル既定値について

ナル値の既定値設定機能を使用している場合（クライアント環境定義PDDFLNVALにUSEを指定），検索結果がナル既定値のときの，HiRDBデータ型でのgetXXXXメソッドの戻り値を次の表に示します。

ナル値の既定値設定機能については，マニュアル「HiRDB SQLリファレンス」を参照してください。

wasNullメソッドでは，ナル値の既定値設定機能を使用している場合，戻り値にFALSEを設定します。

なお，DatabaseMetaDataクラスのメソッドで取得したResultSetオブジェクトには，ナル値の既定値設定機能は適用されません。ナル値の既定値設定機能を使用している場合でも，getXXXXメソッドの戻り値にNULLを設定します。

表17‒44　検索結果がNULL既定値の場合のHiRDBのデータ型でのgetXXXメソッドの戻り値（1/2）

getXXXメソッド

HiRDBデータ型

[M｜N][VAR]CHAR

BINARY

BLOB

DATE

TIME

TIMESTAMP

getByte

×

×

×

×

×

getShort

×

×

×

×

×

getInt

×

×

×

×

×

getLong

×

×

×

×

×

getFloat

×

×

×

×

×

getDouble

×

×

×

×

×

getBigDecimal

×

×

×

×

×

getBoolean

FALSE

×

×

×

×

getString

NULL規定値

NULL既定値のStringオブジェクト

NULL既定値を変換したyyyy-MM-DD形式の文字列のStringオブジェクト

NULL既定値を変換したhh:mm:ss形式の文字列のStringオブジェクト

NULL既定値を変換したyyyy-MM-DD△hh:mm:ss[.ffffff]形式の文字列のStringオブジェクト

getBytes

NULL規定値をbyte配列にしたもの

同左

×

×

×

getDate

×

×

NULL規定値をjava.sql.Dateオブジェクトにしたもの

×

NULL規定値をjava.sql.Dateオブジェクトにしたもの

getTime

×

×

×

NULL既定値をjava.sql.Timeオブジェクトにしたもの

同左

getTimestamp

×

×

NULL既定値をjava.sql.Timestampオブジェクトにしたもの

×

NULL既定値をjava.sql.Timestampオブジェクトにしたもの

getAsciiStream

NULL既定値を格納したInputStreamオブジェクト

同左

×

×

×

getBinaryStream

×

NULL既定値を格納したInputStreamオブジェクト

×

×

×

getObject

NULL規定値

同左

NULL既定値で生成したjava.sql.Dateオブジェクト

NULL既定値で生成したjava.sql.Timeオブジェクト

NULL既定値で生成したjava.sql.Timestampオブジェクト

getCharacterStream

NULL既定値を格納したReaderオブジェクト

同左

×

×

×

getArray

×

×

×

×

×

getBlob

×

NULL既定値の値を持つjava.sql.Blobオブジェクト

×

×

×

（凡例）　×：SQLExceptionを投入します。

表17‒45　検索結果がNULL既定値の場合のHiRDBのデータ型でのgetXXXメソッドの戻り値（2/2）

getXXXメソッド

JDBC SQLタイプ

SMALLINT

INTEGER

REAL

FLOAT

DECIMAL

ARRAY

getByte

NULL既定値をbyte値にしたもの

同左

同左

同左

同左

×

getShort

NULL既定値

NULL規定値をshort値にしたもの

NULL規定値の整数部分の値をshort値にしたもの

同左

同左

×

getInt

NULL規定値をint値にしたもの

同左

NULL規定値の整数部分の値をint値にしたもの

同左

同左

×

getLong

NULL規定値をlong値にしたもの

同左

NULL規定値の整数部分の値をlong値にしたもの

同左

同左

×

getFloat

NULL規定値をfloat値にしたもの

同左

同左

同左

同左

×

getDouble

NULL規定値をdouble値にしたもの

同左

同左

同左

同左

×

getBigDecimal

NULL規定値の値を持つBigDecimalオブジェクト

同左

同左

同左

同左

×

getBoolean

FALSE

同左

同左

同左

同左

×

getString

NULL既定値を文字列表現にしたStringオブジェクト

同左

同左

同左

同左

×

getBytes

×

×

×

×

×

×

getDate

×

×

×

×

×

×

getTime

×

×

×

×

×

×

getTimestamp

×

×

×

×

×

×

getAsciiStream

×

×

×

×

×

×

getBinaryStream

×

×

×

×

×

×

getObject

NULL既定値で生成したIntegerオブジェクト

同左

NULL既定値で生成したFloatオブジェクト

NULL既定値で生成したDoubleオブジェクト

NULL規定値

NULL既定値で生成したArrayオブジェクト

getCharacterStream

×

×

×

×

×

×

getArray

×

×

×

×

×

要素数0のjava.sql.Arrayオブジェクト

getBlob

×

×

×

×

×

×

（凡例）　×：SQLExceptionを投入します。

ページの先頭へ

商品名称に関する表示

All Rights Reserved. Copyright (C) 2018, 2022, Hitachi, Ltd.