- すべてのスーパー・インタフェース:
AutoCloseable
,Wrapper
- 既知のすべてのサブインタフェース:
CachedRowSet
,FilteredRowSet
,JdbcRowSet
,JoinRowSet
,RowSet
,SyncResolver
,WebRowSet
ResultSet
オブジェクトは、カーソルがデータの現在の行を指し示すよう維持します。 初期状態では、カーソルは最初の行の先頭に配置されます。 next
メソッドにより、カーソルは次の行に移動します。nextは、ResultSet
オブジェクトにそれ以上行がない場合にfalse
を返すので、while
ループに使用して結果セットを反復処理することができます。
デフォルトのResultSet
オブジェクトは更新不可で、カーソルは順方向にのみ進みます。 したがってこのオブジェクトは、最初の行から最後の行へ向かって1回だけ実行できます。 スクロールまたは更新、あるいはその両方が可能なResultSet
オブジェクトを生成できます。 con
が有効なConnection
オブジェクトである次のコード・フラグメントは、スクロール可能でほかで行われた更新を反映しない結果セット、および更新可能な結果セットの作成方法を示しています。 ほかのオプションについては、ResultSet
のフィールドを参照してください。
Statement stmt = con.createStatement( ResultSet.TYPE_SCROLL_INSENSITIVE, ResultSet.CONCUR_UPDATABLE); ResultSet rs = stmt.executeQuery("SELECT a, b FROM TABLE2"); // rs will be scrollable, will not show changes made by others, // and will be updatable
ResultSet
インタフェースは、現在の行から列値を取得するgetterメソッド(getBoolean
、getLong
など)を提供します。 値は、列のインデックス番号か列名のどちらかを使って取得できます。 通常は列インデックスを使用する方が効果的です。 列は1から順に番号付けされます。 移植性を最大限に引き出すため、各行内の結果セットの列は左から右の順に読み込まれ、各行は1回だけ読み込まれるようにします。
getterメソッドでは、JDBCドライバが基本的なデータをgetterメソッドで指定されたJava型に変換し、適切なJavaの値を返します。 JDBC仕様には、ResultSet
getterメソッドで使用可能なSQL型からJava型へのマッピングを示す表があります。
getterメソッドへの入力として使用される列名では、大文字と小文字は区別されません。 列名でgetterメソッドが呼び出され、複数の列が同じ名前を持つ場合は、最初に一致する列の値が返されます。 列名のオプションは、結果セットで生成されるSQLクエリーで列名が使用される場合に使われるよう設計されています。 クエリーで明示的に命名されない列の場合には、列番号を使用するのがもっともよい方法です。 列名を使用する場合、プログラマは目的の列を一意に指すことを保証するように注意してください。これは、SQL AS節を使用して実現できます。
JDBC 2.0 API (Java 2 SDK, Standard Edition,バージョン1.2)で、このインタフェースにアップ・データ・メソッドのセットが追加されました。 getterメソッドのパラメータに関するコメントは、updaterメソッドのパラメータにも適用されます。
updaterメソッドは、次の2つの方法で使用できます。
- 現在の行の列値を更新します。 スクロール可能な
ResultSet
オブジェクトでは、カーソルを順方向および逆方向に動かして絶対位置または現在の行との相対的な位置にもっていくことができます。 次のコード・フラグメントは、ResultSet
オブジェクトrs
の5行目にあるNAME
列を更新し、続いてupdateRow
メソッドを使用して、rs
を取得したデータ・ソース表を更新します。rs.absolute(5); // moves the cursor to the fifth row of rs rs.updateString("NAME", "AINSWORTH"); // updates the //
NAME
column of row 5 to beAINSWORTH
rs.updateRow(); // updates the row in the data source - 列値を挿入行に挿入します。 更新可能な
ResultSet
オブジェクトには、このオブジェクトに関連付けられた特殊な行があります。この行は、挿入する行を作成する準備領域の役目をします。 次のコード・フラグメントは、カーソルを挿入行に移動させ、3列の行を作成し、insertRow
メソッドを使用してその行をrs
およびデータ・ソース表に挿入します。rs.moveToInsertRow(); // moves cursor to the insert row rs.updateString(1, "AINSWORTH"); // updates the // first column of the insert row to be
AINSWORTH
rs.updateInt(2,35); // updates the second column to be35
rs.updateBoolean(3, true); // updates the third column totrue
rs.insertRow(); rs.moveToCurrentRow();
ResultSet
オブジェクトは、このオブジェクトを生成したStatement
オブジェクトが閉じられるとき、再実行されるとき、あるいは一連の複数の結果から次の結果を取り出すために使われるときに、自動的に閉じられます。
ResultSet
オブジェクトの列の数、型、およびプロパティは、ResultSet.getMetaData
メソッドによって返されるResultSetMetaData
オブジェクトで提供されます。
- 導入されたバージョン:
- 1.1
- 関連項目:
Statement.executeQuery(java.lang.String)
、Statement.getResultSet()
、ResultSetMetaData
-
フィールドのサマリー
修飾子と型フィールド説明static int
現在のトランザクションがコミットされたときに、この保持機能を持つオープンしているResultSet
オブジェクトがクローズすることを示す定数です。static int
更新できないResultSet
オブジェクトの並行処理モードを示す定数です。static int
更新できるResultSet
オブジェクトの並行処理モードを示す定数です。static int
結果セットの行が順方向に、つまり最初から最後に向かって処理されることを示す定数です。static int
結果セットの行が逆方向に、つまり最後から最初に向かって処理されることを示す定数です。static int
結果セットの行が処理される順序が不明であることを示す定数です。static int
現在のトランザクションがコミットされたときに、この保持機能を持つオープンしているResultSet
オブジェクトがオープンしたままになることを示す定数です。static int
カーソルが順方向にだけ移動するResultSet
オブジェクトの型を示す定数です。static int
スクロール可能だが、通常はResultSet
の基になっているデータに対する変更を反映しないResultSet
オブジェクトの型を示す定数です。static int
スクロール可能で、通常はResultSet
の基になっているデータに対する変更を反映するResultSet
オブジェクトの型を示す定数です。 -
メソッドのサマリー
修飾子と型メソッド説明boolean
absolute(int row)
カーソルをこのResultSet
オブジェクト内の指定された行番号に移動します。void
カーソルをこのResultSet
オブジェクトの終端、つまり最終行の直後に移動します。void
カーソルをこのResultSet
オブジェクトの先端、つまり先頭行の直前に移動します。void
このResultSet
オブジェクトの現在の行に対して行った更新を取り消します。void
このResultSet
オブジェクトに関して報告されたすべての警告をクリアします。void
close()
自動的にクローズされるときにResultSet
オブジェクトのデータベースとJDBCリソースが解放されるのを待つのではなく、ただちにそれらを解放します。void
このResultSet
オブジェクトおよび基になるデータベースから、現在の行を削除します。int
findColumn(String columnLabel)
指定されたResultSet
の列ラベルをResultSet
列インデックスにマッピングします。boolean
first()
カーソルをこのResultSet
オブジェクト内の先頭行に移動します。getArray(int columnIndex)
このResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のArray
オブジェクトとして取得します。このResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のArray
オブジェクトとして取得します。getAsciiStream(int columnIndex)
このResultSet
オブジェクトの現在行にある指定された列の値を、ASCII文字のストリームとして取得します。getAsciiStream(String columnLabel)
このResultSet
オブジェクトの現在行にある指定された列の値を、ASCII文字のストリームとして取得します。getBigDecimal(int columnIndex)
このResultSet
オブジェクトの現在行にある指定された列の値を、完全な精度のjava.math.BigDecimal
として取得します。getBigDecimal(int columnIndex, int scale)
非推奨。getBigDecimal(String columnLabel)
このResultSet
オブジェクトの現在行にある指定された列の値を、完全な精度のjava.math.BigDecimal
として取得します。getBigDecimal(String columnLabel, int scale)
非推奨。getBigDecimal(int columnIndex)
またはgetBigDecimal(String columnLabel)
を使用します。getBinaryStream(int columnIndex)
このResultSet
オブジェクトの現在行にある指定された列の値を、未解釈のバイトのストリームとして取得します。getBinaryStream(String columnLabel)
このResultSet
オブジェクトの現在行にある指定された列の値を、未解釈のbyte
のストリームとして取得します。getBlob(int columnIndex)
このResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のBlob
オブジェクトとして取り出します。このResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のBlob
オブジェクトとして取り出します。boolean
getBoolean(int columnIndex)
このResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のboolean
として取り出します。boolean
getBoolean(String columnLabel)
このResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のboolean
として取り出します。byte
getByte(int columnIndex)
このResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のbyte
として取り出します。byte
このResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のbyte
として取り出します。byte[]
getBytes(int columnIndex)
このResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のbyte
配列として取得します。byte[]
このResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のbyte
配列として取得します。getCharacterStream(int columnIndex)
このResultSet
オブジェクトの現在行にある指定された列の値をjava.io.Reader
オブジェクトとして取り出します。getCharacterStream(String columnLabel)
このResultSet
オブジェクトの現在行にある指定された列の値をjava.io.Reader
オブジェクトとして取り出します。getClob(int columnIndex)
このResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のClob
オブジェクトとして取り出します。このResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のClob
オブジェクトとして取り出します。int
このResultSet
オブジェクトの並行処理モードを取得します。このResultSet
オブジェクトが使用するSQLカーソルの名前を取得します。getDate(int columnIndex)
このResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のjava.sql.Date
オブジェクトとして取り出します。このResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のjava.sql.Date
オブジェクトとして取り出します。このResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のjava.sql.Date
オブジェクトとして取り出します。このResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のjava.sql.Date
オブジェクトとして取り出します。double
getDouble(int columnIndex)
このResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のdouble
として取り出します。double
このResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のdouble
として取り出します。int
このResultSet
オブジェクトのフェッチ方向を取得します。int
このResultSet
オブジェクトのフェッチ・サイズを取得します。float
getFloat(int columnIndex)
このResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のfloat
として取り出します。float
このResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のfloat
として取り出します。int
このResultSet
オブジェクトの保持機能を取得します。int
getInt(int columnIndex)
このResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のint
として取り出します。int
このResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のint
として取り出します。long
getLong(int columnIndex)
このResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のlong
として取り出します。long
このResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のlong
として取り出します。このResultSet
オブジェクトの列の数、型、およびプロパティを取得します。getNCharacterStream(int columnIndex)
このResultSet
オブジェクトの現在行にある指定された列の値をjava.io.Reader
オブジェクトとして取り出します。getNCharacterStream(String columnLabel)
このResultSet
オブジェクトの現在行にある指定された列の値をjava.io.Reader
オブジェクトとして取り出します。getNClob(int columnIndex)
このResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のNClob
オブジェクトとして取り出します。このResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のNClob
オブジェクトとして取り出します。getNString(int columnIndex)
このResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のString
として取り出します。getNString(String columnLabel)
このResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のString
として取り出します。getObject(int columnIndex)
このResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のObject
として取り出します。<T> T
このResultSet
オブジェクトの現在の行の指定された列の値を取得し、変換がサポートされている場合には、その列のSQL型を要求されたJavaデータ型に変換します。このResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のObject
として取り出します。このResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のObject
として取り出します。<T> T
このResultSet
オブジェクトの現在の行の指定された列の値を取得し、変換がサポートされている場合には、その列のSQL型を要求されたJavaデータ型に変換します。このResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のObject
として取り出します。getRef(int columnIndex)
このResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のRef
オブジェクトとして取り出します。このResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のRef
オブジェクトとして取り出します。int
getRow()
現在の行の番号を取得します。getRowId(int columnIndex)
このResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のjava.sql.RowId
オブジェクトとして取り出します。このResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のjava.sql.RowId
オブジェクトとして取り出します。short
getShort(int columnIndex)
このResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のshort
として取り出します。short
このResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のshort
として取り出します。getSQLXML(int columnIndex)
このResultSet
の現在行にある指定された列の値を、Javaプログラミング言語のjava.sql.SQLXML
オブジェクトとして取り出します。このResultSet
の現在行にある指定された列の値を、Javaプログラミング言語のjava.sql.SQLXML
オブジェクトとして取り出します。このResultSet
オブジェクトを生成したStatement
オブジェクトを取得します。getString(int columnIndex)
このResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のString
として取り出します。このResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のString
として取り出します。getTime(int columnIndex)
このResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のjava.sql.Time
オブジェクトとして取り出します。このResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のjava.sql.Time
オブジェクトとして取り出します。このResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のjava.sql.Time
オブジェクトとして取り出します。このResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のjava.sql.Time
オブジェクトとして取り出します。getTimestamp(int columnIndex)
このResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のjava.sql.Timestamp
オブジェクトとして取り出します。getTimestamp(int columnIndex, Calendar cal)
このResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のjava.sql.Timestamp
オブジェクトとして取り出します。getTimestamp(String columnLabel)
このResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のjava.sql.Timestamp
オブジェクトとして取り出します。getTimestamp(String columnLabel, Calendar cal)
このResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のjava.sql.Timestamp
オブジェクトとして取り出します。int
getType()
このResultSet
オブジェクトの型を返します。getUnicodeStream(int columnIndex)
非推奨。getUnicodeStream
の代わりに
getCharacterStreamを使用getUnicodeStream(String columnLabel)
非推奨。代わりにgetCharacterStream
を使用してくださいgetURL(int columnIndex)
このResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のjava.net.URL
オブジェクトとして取り出します。このResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のjava.net.URL
オブジェクトとして取り出します。このResultSet
オブジェクトに関する呼出しによって報告される最初の警告を取得します。void
挿入行の内容を、このResultSet
オブジェクトおよびデータベースに挿入します。boolean
カーソルがこのResultSet
オブジェクト内の最終行より後ろにあるかどうかを取得します。boolean
カーソルがこのResultSet
オブジェクト内の先頭行より前にあるかどうかを取得します。boolean
isClosed()
このResultSet
オブジェクトがクローズされているかどうかを取得します。boolean
isFirst()
カーソルがこのResultSet
オブジェクト内の先頭行にあるかどうかを取得します。boolean
isLast()
カーソルがこのResultSet
オブジェクトの最終行にあるかどうかを取得します。boolean
last()
カーソルをこのResultSet
オブジェクト内の最終行に移動します。void
カーソルを、記憶されているカーソル位置(通常は現在の行)に移動します。void
カーソルを挿入行に移動します。boolean
next()
カーソルを現在の位置から順方向に1行移動します。boolean
previous()
カーソルをこのResultSet
オブジェクト内の前の行に移動します。void
現在の行をデータベース内の最新の値で再表示します。boolean
relative(int rows)
カーソルを正または負の相対行数だけ移動します。boolean
行が削除されているかどうかを取得します。boolean
現在の行に挿入があったかどうかを取得します。boolean
現在の行が更新されているかどうかを取得します。void
setFetchDirection(int direction)
このResultSet
オブジェクト内の行が処理される方向についてのヒントを提供します。void
setFetchSize(int rows)
このResultSet
オブジェクトでより多くの行が必要なときにデータベースから取り出す必要がある行数についてのヒントをJDBCドライバに提供します。void
updateArray(int columnIndex, Array x)
指定された列をjava.sql.Array
値で更新します。void
updateArray(String columnLabel, Array x)
指定された列をjava.sql.Array
値で更新します。void
updateAsciiStream(int columnIndex, InputStream x)
指定された列をASCIIストリーム値で更新します。void
updateAsciiStream(int columnIndex, InputStream x, int length)
指定された列を、指定されたバイト数を持つasciiストリーム値で更新します。void
updateAsciiStream(int columnIndex, InputStream x, long length)
指定された列を、指定されたバイト数を持つasciiストリーム値で更新します。void
updateAsciiStream(String columnLabel, InputStream x)
指定された列をASCIIストリーム値で更新します。void
updateAsciiStream(String columnLabel, InputStream x, int length)
指定された列を、指定されたバイト数を持つasciiストリーム値で更新します。void
updateAsciiStream(String columnLabel, InputStream x, long length)
指定された列を、指定されたバイト数を持つasciiストリーム値で更新します。void
updateBigDecimal(int columnIndex, BigDecimal x)
指定された列をjava.math.BigDecimal
値で更新します。void
updateBigDecimal(String columnLabel, BigDecimal x)
指定された列をjava.sql.BigDecimal
値で更新します。void
updateBinaryStream(int columnIndex, InputStream x)
指定された列をバイナリ・ストリーム値で更新します。void
updateBinaryStream(int columnIndex, InputStream x, int length)
指定された列を、指定されたバイト数を持つバイナリ・ストリーム値で更新します。void
updateBinaryStream(int columnIndex, InputStream x, long length)
指定された列を、指定されたバイト数を持つバイナリ・ストリーム値で更新します。void
updateBinaryStream(String columnLabel, InputStream x)
指定された列をバイナリ・ストリーム値で更新します。void
updateBinaryStream(String columnLabel, InputStream x, int length)
指定された列を、指定されたバイト数を持つバイナリ・ストリーム値で更新します。void
updateBinaryStream(String columnLabel, InputStream x, long length)
指定された列を、指定されたバイト数を持つバイナリ・ストリーム値で更新します。void
updateBlob(int columnIndex, InputStream inputStream)
指定された列を、指定された入力ストリームを使用して更新します。void
updateBlob(int columnIndex, InputStream inputStream, long length)
指定された列を、指定されたバイト数を持つ指定された入力ストリームを使用して更新します。void
updateBlob(int columnIndex, Blob x)
指定された列をjava.sql.Blob
値で更新します。void
updateBlob(String columnLabel, InputStream inputStream)
指定された列を、指定された入力ストリームを使用して更新します。void
updateBlob(String columnLabel, InputStream inputStream, long length)
指定された列を、指定されたバイト数を持つ指定された入力ストリームを使用して更新します。void
updateBlob(String columnLabel, Blob x)
指定された列をjava.sql.Blob
値で更新します。void
updateBoolean(int columnIndex, boolean x)
指定された列をboolean
値で更新します。void
updateBoolean(String columnLabel, boolean x)
指定された列をboolean
値で更新します。void
updateByte(int columnIndex, byte x)
指定された列をbyte
値で更新します。void
updateByte(String columnLabel, byte x)
指定された列をbyte
値で更新します。void
updateBytes(int columnIndex, byte[] x)
指定された列をbyte
配列値で更新します。void
updateBytes(String columnLabel, byte[] x)
指定された列をbyte配列値で更新します。void
updateCharacterStream(int columnIndex, Reader x)
指定された列を文字ストリーム値で更新します。void
updateCharacterStream(int columnIndex, Reader x, int length)
指定された列を、指定されたバイト数を持つ文字ストリーム値で更新します。void
updateCharacterStream(int columnIndex, Reader x, long length)
指定された列を、指定されたバイト数を持つ文字ストリーム値で更新します。void
updateCharacterStream(String columnLabel, Reader reader)
指定された列を文字ストリーム値で更新します。void
updateCharacterStream(String columnLabel, Reader reader, int length)
指定された列を、指定されたバイト数を持つ文字ストリーム値で更新します。void
updateCharacterStream(String columnLabel, Reader reader, long length)
指定された列を、指定されたバイト数を持つ文字ストリーム値で更新します。void
updateClob(int columnIndex, Reader reader)
指定された列を、指定されたReader
オブジェクトを使用して更新します。void
updateClob(int columnIndex, Reader reader, long length)
指定された列を、指定された文字数である指定されたReader
オブジェクトを使用して更新します。void
updateClob(int columnIndex, Clob x)
指定された列をjava.sql.Clob
値で更新します。void
updateClob(String columnLabel, Reader reader)
指定された列を、指定されたReader
オブジェクトを使用して更新します。void
updateClob(String columnLabel, Reader reader, long length)
指定された列を、指定された文字数である指定されたReader
オブジェクトを使用して更新します。void
updateClob(String columnLabel, Clob x)
指定された列をjava.sql.Clob
値で更新します。void
updateDate(int columnIndex, Date x)
指定された列をjava.sql.Date
値で更新します。void
updateDate(String columnLabel, Date x)
指定された列をjava.sql.Date
値で更新します。void
updateDouble(int columnIndex, double x)
指定された列をdouble
値で更新します。void
updateDouble(String columnLabel, double x)
指定された列をdouble
値で更新します。void
updateFloat(int columnIndex, float x)
指定された列をfloat
値で更新します。void
updateFloat(String columnLabel, float x)
指定された列をfloat
値で更新します。void
updateInt(int columnIndex, int x)
指定された列をint
値で更新します。void
指定された列をint
値で更新します。void
updateLong(int columnIndex, long x)
指定された列をlong
値で更新します。void
updateLong(String columnLabel, long x)
指定された列をlong
値で更新します。void
updateNCharacterStream(int columnIndex, Reader x)
指定された列を文字ストリーム値で更新します。void
updateNCharacterStream(int columnIndex, Reader x, long length)
指定された列を、指定されたバイト数を持つ文字ストリーム値で更新します。void
updateNCharacterStream(String columnLabel, Reader reader)
指定された列を文字ストリーム値で更新します。void
updateNCharacterStream(String columnLabel, Reader reader, long length)
指定された列を、指定されたバイト数を持つ文字ストリーム値で更新します。void
updateNClob(int columnIndex, Reader reader)
指定された列を、指定されたReader
を使用して更新します。ストリームの終わりに達するまで必要に応じてストリームからデータが読み込まれます。void
updateNClob(int columnIndex, Reader reader, long length)
指定された列を、指定された文字数である指定されたReader
オブジェクトを使用して更新します。void
updateNClob(int columnIndex, NClob nClob)
指定された列をjava.sql.NClob
値で更新します。void
updateNClob(String columnLabel, Reader reader)
指定された列を、指定されたReader
オブジェクトを使用して更新します。void
updateNClob(String columnLabel, Reader reader, long length)
指定された列を、指定された文字数である指定されたReader
オブジェクトを使用して更新します。void
updateNClob(String columnLabel, NClob nClob)
指定された列をjava.sql.NClob
値で更新します。void
updateNString(int columnIndex, String nString)
指定された列をString
値で更新します。void
updateNString(String columnLabel, String nString)
指定された列をString
値で更新します。void
updateNull(int columnIndex)
指定された列をnull
値で更新します。void
updateNull(String columnLabel)
指定された列をnull
値で更新します。void
updateObject(int columnIndex, Object x)
指定された列をObject
値で更新します。void
updateObject(int columnIndex, Object x, int scaleOrLength)
指定された列をObject
値で更新します。default void
updateObject(int columnIndex, Object x, SQLType targetSqlType)
指定された列をObject
値で更新します。default void
updateObject(int columnIndex, Object x, SQLType targetSqlType, int scaleOrLength)
指定された列をObject
値で更新します。void
updateObject(String columnLabel, Object x)
指定された列をObject
値で更新します。void
updateObject(String columnLabel, Object x, int scaleOrLength)
指定された列をObject
値で更新します。default void
updateObject(String columnLabel, Object x, SQLType targetSqlType)
指定された列をObject
値で更新します。default void
updateObject(String columnLabel, Object x, SQLType targetSqlType, int scaleOrLength)
指定された列をObject
値で更新します。void
指定された列をjava.sql.Ref
値で更新します。void
指定された列をjava.sql.Ref
値で更新します。void
基になるデータベースを、このResultSet
オブジェクトの現在の行の新しい内容に更新します。void
updateRowId(int columnIndex, RowId x)
指定された列をRowId
値で更新します。void
updateRowId(String columnLabel, RowId x)
指定された列をRowId
値で更新します。void
updateShort(int columnIndex, short x)
指定された列をshort
値で更新します。void
updateShort(String columnLabel, short x)
指定された列をshort
値で更新します。void
updateSQLXML(int columnIndex, SQLXML xmlObject)
指定された列をjava.sql.SQLXML
値で更新します。void
updateSQLXML(String columnLabel, SQLXML xmlObject)
指定された列をjava.sql.SQLXML
値で更新します。void
updateString(int columnIndex, String x)
指定された列をString
値で更新します。void
updateString(String columnLabel, String x)
指定された列をString
値で更新します。void
updateTime(int columnIndex, Time x)
指定された列をjava.sql.Time
値で更新します。void
updateTime(String columnLabel, Time x)
指定された列をjava.sql.Time
値で更新します。void
updateTimestamp(int columnIndex, Timestamp x)
指定された列をjava.sql.Timestamp
値で更新します。void
updateTimestamp(String columnLabel, Timestamp x)
指定された列をjava.sql.Timestamp
値で更新します。boolean
wasNull()
最後に読み込まれた列の値がSQLNULL
であるかどうかを通知します。インタフェース java.sql.Wrapperで宣言されたメソッド
isWrapperFor, unwrap
-
フィールド詳細
-
FETCH_FORWARD
static final int FETCH_FORWARD結果セットの行が順方向に、つまり最初から最後に向かって処理されることを示す定数です。 この定数は、setFetchDirection
メソッドがドライバへのヒントとして使用しますが、ドライバはこれを無視することがあります。- 導入されたバージョン:
- 1.2
- 関連項目:
- 定数フィールド値
-
FETCH_REVERSE
static final int FETCH_REVERSE結果セットの行が逆方向に、つまり最後から最初に向かって処理されることを示す定数です。 この定数は、setFetchDirection
メソッドがドライバへのヒントとして使用しますが、ドライバはこれを無視することがあります。- 導入されたバージョン:
- 1.2
- 関連項目:
- 定数フィールド値
-
FETCH_UNKNOWN
static final int FETCH_UNKNOWN結果セットの行が処理される順序が不明であることを示す定数です。 この定数は、setFetchDirection
メソッドがドライバへのヒントとして使用しますが、ドライバはこれを無視することがあります。- 関連項目:
- 定数フィールド値
-
TYPE_FORWARD_ONLY
static final int TYPE_FORWARD_ONLYカーソルが順方向にだけ移動するResultSet
オブジェクトの型を示す定数です。- 導入されたバージョン:
- 1.2
- 関連項目:
- 定数フィールド値
-
TYPE_SCROLL_INSENSITIVE
static final int TYPE_SCROLL_INSENSITIVEスクロール可能だが、通常はResultSet
の基になっているデータに対する変更を反映しないResultSet
オブジェクトの型を示す定数です。- 導入されたバージョン:
- 1.2
- 関連項目:
- 定数フィールド値
-
TYPE_SCROLL_SENSITIVE
static final int TYPE_SCROLL_SENSITIVEスクロール可能で、通常はResultSet
の基になっているデータに対する変更を反映するResultSet
オブジェクトの型を示す定数です。- 導入されたバージョン:
- 1.2
- 関連項目:
- 定数フィールド値
-
CONCUR_READ_ONLY
static final int CONCUR_READ_ONLY更新できないResultSet
オブジェクトの並行処理モードを示す定数です。- 導入されたバージョン:
- 1.2
- 関連項目:
- 定数フィールド値
-
CONCUR_UPDATABLE
static final int CONCUR_UPDATABLE更新できるResultSet
オブジェクトの並行処理モードを示す定数です。- 導入されたバージョン:
- 1.2
- 関連項目:
- 定数フィールド値
-
HOLD_CURSORS_OVER_COMMIT
static final int HOLD_CURSORS_OVER_COMMIT現在のトランザクションがコミットされたときに、この保持機能を持つオープンしているResultSet
オブジェクトがオープンしたままになることを示す定数です。- 導入されたバージョン:
- 1.4
- 関連項目:
- 定数フィールド値
-
CLOSE_CURSORS_AT_COMMIT
static final int CLOSE_CURSORS_AT_COMMIT現在のトランザクションがコミットされたときに、この保持機能を持つオープンしているResultSet
オブジェクトがクローズすることを示す定数です。- 導入されたバージョン:
- 1.4
- 関連項目:
- 定数フィールド値
-
-
メソッドの詳細
-
next
boolean next() throws SQLExceptionカーソルを現在の位置から順方向に1行移動します。ResultSet
のカーソルは、初期状態では最初の行の前に位置付けられています。next
メソッドの最初の呼出しによって、最初の行が現在の行になります。2番目の呼出しによって2行目が現在の行になり、以下同様に続きます。next
メソッドの呼出しでfalse
が返されると、カーソルは最終行の後ろに位置します。 現在の行が必要なResultSet
メソッドのあらゆる呼出しによって、SQLException
がスローされます。 結果セットのタイプがTYPE_FORWARD_ONLY
である場合、以降のnext
の呼出しでJDBCドライバ実装がfalse
を返すかSQLException
をスローするかは、そのベンダーによって指定されます。現在の行で入力ストリームがオープンしている場合、
next
メソッドへの呼出しは暗黙的にそのストリームをクローズさせます。 新しい行が読み込まれるときに、ResultSet
オブジェクトの警告チェーンはクリアされます。- 戻り値:
- 新しい現在の行が有効である場合は
true
、行がそれ以上存在しない場合はfalse
- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされた結果セットで呼び出された場合
-
close
void close() throws SQLException自動的にクローズされるときにResultSet
オブジェクトのデータベースとJDBCリソースが解放されるのを待つのではなく、ただちにそれらを解放します。ResultSet
オブジェクトがクローズしても、ResultSet
によって作成されたBlob
、Clob
、またはNClob
オブジェクトはクローズしません。Blob
、Clob
またはNClob
オブジェクトは、free
メソッドが呼び出されないかぎり、少なくともそれが作成されたトランザクション内では有効です。ResultSet
がクローズしても、getMetaData
メソッドを呼び出して作成された任意のResultSetMetaData
インスタンスはアクセス可能なままです。ノート:
ResultSet
オブジェクトは、このオブジェクトを生成したStatement
オブジェクトがクローズされるとき、再実行されるとき、または一連の複数の結果から次の結果を取り出すのに使用されるときに、そのStatement
によって自動的にクローズされます。すでにクローズされた
ResultSet
オブジェクトでclose
メソッドを呼び出すと、操作は行われません。- 定義:
close
、インタフェース:AutoCloseable
- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合
-
wasNull
boolean wasNull() throws SQLException最後に読み込まれた列の値がSQLNULL
であるかどうかを通知します。 最初に列のgetterメソッドの1つを呼び出してその値を読み込み、次にwasNull
メソッドを呼び出して読み込まれた値がSQLNULL
かどうかを判定する必要があります。- 戻り値:
- 最後に読み込まれた列の値がSQL
NULL
の場合はtrue
、そうでない場合はfalse
- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされた結果セットで呼び出された場合
-
getString
String getString(int columnIndex) throws SQLExceptionこのResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のString
として取り出します。- パラメータ:
columnIndex
- 最初の列は1、2番目の列は2、... となる- 戻り値:
- 列値。値がSQL
NULL
の場合、返される値はnull
- 例外:
SQLException
- columnIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされた結果セットで呼び出された場合
-
getBoolean
boolean getBoolean(int columnIndex) throws SQLExceptionこのResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のboolean
として取り出します。指定された列のデータ型がCHARまたはVARCHARで"0"を含む場合、またはデータ型がBIT、TINYINT、SMALLINT、INTEGER、またはBIGINTで0を含む場合は、値
false
が返されます。 指定された列のデータ型がCHARまたはVARCHARで"1"を含む場合、またはデータ型がBIT、TINYINT、SMALLINT、INTEGER、またはBIGINTで1を含む場合は、値true
が返されます。- パラメータ:
columnIndex
- 最初の列は1、2番目の列は2、... となる- 戻り値:
- 列値。値がSQL
NULL
の場合、返される値はfalse
- 例外:
SQLException
- columnIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされた結果セットで呼び出された場合
-
getByte
byte getByte(int columnIndex) throws SQLExceptionこのResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のbyte
として取り出します。- パラメータ:
columnIndex
- 最初の列は1、2番目の列は2、... となる- 戻り値:
- 列値。値がSQL
NULL
の場合、返される値は0
- 例外:
SQLException
- columnIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされた結果セットで呼び出された場合
-
getShort
short getShort(int columnIndex) throws SQLExceptionこのResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のshort
として取り出します。- パラメータ:
columnIndex
- 最初の列は1、2番目の列は2、... となる- 戻り値:
- 列値。値がSQL
NULL
の場合、返される値は0
- 例外:
SQLException
- columnIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされた結果セットで呼び出された場合
-
getInt
int getInt(int columnIndex) throws SQLExceptionこのResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のint
として取り出します。- パラメータ:
columnIndex
- 最初の列は1、2番目の列は2、... となる- 戻り値:
- 列値。値がSQL
NULL
の場合、返される値は0
- 例外:
SQLException
- columnIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされた結果セットで呼び出された場合
-
getLong
long getLong(int columnIndex) throws SQLExceptionこのResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のlong
として取り出します。- パラメータ:
columnIndex
- 最初の列は1、2番目の列は2、... となる- 戻り値:
- 列値。値がSQL
NULL
の場合、返される値は0
- 例外:
SQLException
- columnIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされた結果セットで呼び出された場合
-
getFloat
float getFloat(int columnIndex) throws SQLExceptionこのResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のfloat
として取り出します。- パラメータ:
columnIndex
- 最初の列は1、2番目の列は2、... となる- 戻り値:
- 列値。値がSQL
NULL
の場合、返される値は0
- 例外:
SQLException
- columnIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされた結果セットで呼び出された場合
-
getDouble
double getDouble(int columnIndex) throws SQLExceptionこのResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のdouble
として取り出します。- パラメータ:
columnIndex
- 最初の列は1、2番目の列は2、... となる- 戻り値:
- 列値。値がSQL
NULL
の場合、返される値は0
- 例外:
SQLException
- columnIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされた結果セットで呼び出された場合
-
getBigDecimal
@Deprecated(since="1.2")BigDecimal getBigDecimal(int columnIndex, int scale) throws SQLException非推奨。getBigDecimal(int columnIndex)
またはgetBigDecimal(String columnLabel)
を使用します。このResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のjava.sql.BigDecimal
として取り出します。- パラメータ:
columnIndex
- 最初の列は1、2番目の列は2、... となるscale
- 小数点以下の桁数- 戻り値:
- 列値。値がSQL
NULL
の場合、返される値はnull
- 例外:
SQLException
- columnIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合
-
getBytes
byte[] getBytes(int columnIndex) throws SQLExceptionこのResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のbyte
配列として取得します。 バイトはドライバによって返されたraw値を表します。- パラメータ:
columnIndex
- 最初の列は1、2番目の列は2、... となる- 戻り値:
- 列値。値がSQL
NULL
の場合、返される値はnull
- 例外:
SQLException
- columnIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされた結果セットで呼び出された場合
-
getDate
Date getDate(int columnIndex) throws SQLExceptionこのResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のjava.sql.Date
オブジェクトとして取り出します。- パラメータ:
columnIndex
- 最初の列は1、2番目の列は2、... となる- 戻り値:
- 列値。値がSQL
NULL
の場合、返される値はnull
- 例外:
SQLException
- columnIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされた結果セットで呼び出された場合
-
getTime
Time getTime(int columnIndex) throws SQLExceptionこのResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のjava.sql.Time
オブジェクトとして取り出します。- パラメータ:
columnIndex
- 最初の列は1、2番目の列は2、... となる- 戻り値:
- 列値。値がSQL
NULL
の場合、返される値はnull
- 例外:
SQLException
- columnIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされた結果セットで呼び出された場合
-
getTimestamp
Timestamp getTimestamp(int columnIndex) throws SQLExceptionこのResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のjava.sql.Timestamp
オブジェクトとして取り出します。- パラメータ:
columnIndex
- 最初の列は1、2番目の列は2、... となる- 戻り値:
- 列値。値がSQL
NULL
の場合、返される値はnull
- 例外:
SQLException
- columnIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされた結果セットで呼び出された場合
-
getAsciiStream
InputStream getAsciiStream(int columnIndex) throws SQLExceptionこのResultSet
オブジェクトの現在行にある指定された列の値を、ASCII文字のストリームとして取得します。 そのストリームから一括して値を読み込めるようになります。 このメソッドは、特に大きなLONGVARCHAR
値を取り出すのに適しています。 JDBCドライバがデータベース形式からASCIIへの必要な変換を行います。ノート: 返されたストリーム中のデータはすべて、ほかの列の値を取得する前に読み込む必要があります。 次のgetterメソッドへの呼出しは、暗黙的にストリームをクローズします。 また、
InputStream.available
メソッドが呼び出されたときに、使用可能なデータがあるかないかに関係なく、ストリームは0
を返すことがあります。- パラメータ:
columnIndex
- 最初の列は1、2番目の列は2、... となる- 戻り値:
- データベースの列値を1バイトASCII文字のストリームとして送るJava入力ストリーム。値がSQL
NULL
の場合、返される値はnull
- 例外:
SQLException
- columnIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされた結果セットで呼び出された場合
-
getUnicodeStream
@Deprecated(since="1.2")InputStream getUnicodeStream(int columnIndex) throws SQLException非推奨。getUnicodeStream
の代わりに
getCharacterStreamを使用このResultSet
オブジェクトの現在行にある指定された列の値を、2バイト3文字のストリームとして取得します。 最初のバイトが上位バイトで、2番目のバイトが下位バイトです。 そのストリームから一括して値を読み込めるようになります。 このメソッドは、特に大きなLONGVARCHAR
値を取り出すのに適しています。 JDBCドライバが、データベース形式からUnicodeへの必要な変換を行います。ノート: 返されたストリーム中のデータはすべて、ほかの列の値を取得する前に読み込む必要があります。 次のgetterメソッドへの呼出しは、暗黙的にストリームをクローズします。 また、
InputStream.available
メソッドが呼び出されたときに、使用可能なデータがあるかないかに関係なく、ストリームは0
を返すことがあります。- パラメータ:
columnIndex
- 最初の列は1、2番目の列は2、... となる- 戻り値:
- データベースの列値を2バイトUnicode文字のストリームとして送るJava入力ストリーム。値がSQL
NULL
の場合、返される値はnull
- 例外:
SQLException
- columnIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合
-
getBinaryStream
InputStream getBinaryStream(int columnIndex) throws SQLExceptionこのResultSet
オブジェクトの現在行にある指定された列の値を、未解釈のバイトのストリームとして取得します。 そのストリームから一括して値を読み込めるようになります。 このメソッドは、特に大きなLONGVARBINARY
値を取り出すのに適しています。ノート: 返されたストリーム中のデータはすべて、ほかの列の値を取得する前に読み込む必要があります。 次のgetterメソッドへの呼出しは、暗黙的にストリームをクローズします。 また、
InputStream.available
メソッドが呼び出されたときに、使用可能なデータがあるかないかに関係なく、ストリームは0
を返すことがあります。- パラメータ:
columnIndex
- 最初の列は1、2番目の列は2、... となる- 戻り値:
- データベースの列値を未解釈のバイト・ストリームとして送るJava入力ストリーム。値がSQL
NULL
の場合、返される値はnull
- 例外:
SQLException
- columnIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされた結果セットで呼び出された場合
-
getString
String getString(String columnLabel) throws SQLExceptionこのResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のString
として取り出します。- パラメータ:
columnLabel
- SQL AS節として指定された列のラベル。 SQL AS節が指定されなかった場合、このラベルは列の名前- 戻り値:
- 列値。値がSQL
NULL
の場合、返される値はnull
- 例外:
SQLException
- columnLabelが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされた結果セットで呼び出された場合
-
getBoolean
boolean getBoolean(String columnLabel) throws SQLExceptionこのResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のboolean
として取り出します。指定された列のデータ型がCHARまたはVARCHARで"0"を含む場合、またはデータ型がBIT、TINYINT、SMALLINT、INTEGER、またはBIGINTで0を含む場合は、値
false
が返されます。 指定された列のデータ型がCHARまたはVARCHARで"1"を含む場合、またはデータ型がBIT、TINYINT、SMALLINT、INTEGER、またはBIGINTで1を含む場合は、値true
が返されます。- パラメータ:
columnLabel
- SQL AS節として指定された列のラベル。 SQL AS節が指定されなかった場合、このラベルは列の名前- 戻り値:
- 列値。値がSQL
NULL
の場合、返される値はfalse
- 例外:
SQLException
- columnLabelが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされた結果セットで呼び出された場合
-
getByte
byte getByte(String columnLabel) throws SQLExceptionこのResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のbyte
として取り出します。- パラメータ:
columnLabel
- SQL AS節として指定された列のラベル。 SQL AS節が指定されなかった場合、このラベルは列の名前- 戻り値:
- 列値。値がSQL
NULL
の場合、返される値は0
- 例外:
SQLException
- columnLabelが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされた結果セットで呼び出された場合
-
getShort
short getShort(String columnLabel) throws SQLExceptionこのResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のshort
として取り出します。- パラメータ:
columnLabel
- SQL AS節として指定された列のラベル。 SQL AS節が指定されなかった場合、このラベルは列の名前- 戻り値:
- 列値。値がSQL
NULL
の場合、返される値は0
- 例外:
SQLException
- columnLabelが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされた結果セットで呼び出された場合
-
getInt
int getInt(String columnLabel) throws SQLExceptionこのResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のint
として取り出します。- パラメータ:
columnLabel
- SQL AS節として指定された列のラベル。 SQL AS節が指定されなかった場合、このラベルは列の名前- 戻り値:
- 列値。値がSQL
NULL
の場合、返される値は0
- 例外:
SQLException
- columnLabelが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされた結果セットで呼び出された場合
-
getLong
long getLong(String columnLabel) throws SQLExceptionこのResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のlong
として取り出します。- パラメータ:
columnLabel
- SQL AS節として指定された列のラベル。 SQL AS節が指定されなかった場合、このラベルは列の名前- 戻り値:
- 列値。値がSQL
NULL
の場合、返される値は0
- 例外:
SQLException
- columnLabelが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされた結果セットで呼び出された場合
-
getFloat
float getFloat(String columnLabel) throws SQLExceptionこのResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のfloat
として取り出します。- パラメータ:
columnLabel
- SQL AS節として指定された列のラベル。 SQL AS節が指定されなかった場合、このラベルは列の名前- 戻り値:
- 列値。値がSQL
NULL
の場合、返される値は0
- 例外:
SQLException
- columnLabelが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされた結果セットで呼び出された場合
-
getDouble
double getDouble(String columnLabel) throws SQLExceptionこのResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のdouble
として取り出します。- パラメータ:
columnLabel
- SQL AS節として指定された列のラベル。 SQL AS節が指定されなかった場合、このラベルは列の名前- 戻り値:
- 列値。値がSQL
NULL
の場合、返される値は0
- 例外:
SQLException
- columnLabelが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされた結果セットで呼び出された場合
-
getBigDecimal
@Deprecated(since="1.2")BigDecimal getBigDecimal(String columnLabel, int scale) throws SQLException非推奨。getBigDecimal(int columnIndex)
またはgetBigDecimal(String columnLabel)
を使用します。このResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のjava.math.BigDecimal
として取り出します。- パラメータ:
columnLabel
- SQL AS節として指定された列のラベル。 SQL AS節が指定されなかった場合、このラベルは列の名前scale
- 小数点以下の桁数- 戻り値:
- 列値。値がSQL
NULL
の場合、返される値はnull
- 例外:
SQLException
- columnLabelが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合
-
getBytes
byte[] getBytes(String columnLabel) throws SQLExceptionこのResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のbyte
配列として取得します。 バイトはドライバによって返されたraw値を表します。- パラメータ:
columnLabel
- SQL AS節として指定された列のラベル。 SQL AS節が指定されなかった場合、このラベルは列の名前- 戻り値:
- 列値。値がSQL
NULL
の場合、返される値はnull
- 例外:
SQLException
- columnLabelが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされた結果セットで呼び出された場合
-
getDate
Date getDate(String columnLabel) throws SQLExceptionこのResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のjava.sql.Date
オブジェクトとして取り出します。- パラメータ:
columnLabel
- SQL AS節として指定された列のラベル。 SQL AS節が指定されなかった場合、このラベルは列の名前- 戻り値:
- 列値。値がSQL
NULL
の場合、返される値はnull
- 例外:
SQLException
- columnLabelが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされた結果セットで呼び出された場合
-
getTime
Time getTime(String columnLabel) throws SQLExceptionこのResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のjava.sql.Time
オブジェクトとして取り出します。- パラメータ:
columnLabel
- SQL AS節として指定された列のラベル。 SQL AS節が指定されなかった場合、このラベルは列の名前- 戻り値:
- 列値。値がSQL
NULL
の場合、返される値はnull
- 例外:
SQLException
- columnLabelが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされた結果セットで呼び出された場合
-
getTimestamp
Timestamp getTimestamp(String columnLabel) throws SQLExceptionこのResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のjava.sql.Timestamp
オブジェクトとして取り出します。- パラメータ:
columnLabel
- SQL AS節として指定された列のラベル。 SQL AS節が指定されなかった場合、このラベルは列の名前- 戻り値:
- 列値。値がSQL
NULL
の場合、返される値はnull
- 例外:
SQLException
- columnLabelが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされた結果セットで呼び出された場合
-
getAsciiStream
InputStream getAsciiStream(String columnLabel) throws SQLExceptionこのResultSet
オブジェクトの現在行にある指定された列の値を、ASCII文字のストリームとして取得します。 そのストリームから一括して値を読み込めるようになります。 このメソッドは、特に大きなLONGVARCHAR
値を取り出すのに適しています。 JDBCドライバがデータベース形式からASCIIへの必要な変換を行います。ノート: 返されたストリーム中のデータはすべて、ほかの列の値を取得する前に読み込む必要があります。 次のgetterメソッドへの呼出しは、暗黙的にストリームをクローズします。 また、
available
メソッドが呼び出されたときに、使用可能なデータがあるかないかに関係なく、ストリームは0
を返すことがあります。- パラメータ:
columnLabel
- SQL AS節として指定された列のラベル。 SQL AS節が指定されなかった場合、このラベルは列の名前- 戻り値:
- データベースの列値を1バイトASCII文字のストリームとして送るJava入力ストリーム。 値がSQL
NULL
の場合、返される値はnull
- 例外:
SQLException
- columnLabelが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされた結果セットで呼び出された場合
-
getUnicodeStream
@Deprecated(since="1.2")InputStream getUnicodeStream(String columnLabel) throws SQLException非推奨。代わりにgetCharacterStream
を使用してくださいこのResultSet
オブジェクトの現在行にある指定された列の値を、2バイトUnicode文字のストリームとして取得します。 最初のバイトが上位バイトで、2番目のバイトが下位バイトです。 そのストリームから一括して値を読み込めるようになります。 このメソッドは、特に大きなLONGVARCHAR
値を取り出すのに適しています。 JDBC対応ドライバが、データベース形式からUnicodeへの必要な変換を行います。ノート: 返されたストリーム中のデータはすべて、ほかの列の値を取得する前に読み込む必要があります。 次のgetterメソッドへの呼出しは、暗黙的にストリームをクローズします。 また、
InputStream.available
メソッドが呼び出されたときに、使用可能なデータがあるかないかに関係なく、ストリームは0
を返すことがあります。- パラメータ:
columnLabel
- SQL AS節として指定された列のラベル。 SQL AS節が指定されなかった場合、このラベルは列の名前- 戻り値:
- データベースの列値を2バイトUnicode文字のストリームとして送るJava入力ストリーム。 値がSQL
NULL
の場合、返される値はnull
- 例外:
SQLException
- columnLabelが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合
-
getBinaryStream
InputStream getBinaryStream(String columnLabel) throws SQLExceptionこのResultSet
オブジェクトの現在行にある指定された列の値を、未解釈のbyte
のストリームとして取得します。 そのストリームから一括して値を読み込めるようになります。 このメソッドは、特に大きなLONGVARBINARY
値を取り出すのに適しています。ノート: 返されたストリーム中のデータはすべて、ほかの列の値を取得する前に読み込む必要があります。 次のgetterメソッドへの呼出しは、暗黙的にストリームをクローズします。 また、
available
メソッドが呼び出されたときに、使用可能なデータがあるかないかに関係なく、ストリームは0
を返すことがあります。- パラメータ:
columnLabel
- SQL AS節として指定された列のラベル。 SQL AS節が指定されなかった場合、このラベルは列の名前- 戻り値:
- データベースの列値を未解釈のバイト・ストリームとして送るJava入力ストリーム。値がSQL
NULL
の場合、結果はnull
- 例外:
SQLException
- columnLabelが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされた結果セットで呼び出された場合
-
getWarnings
SQLWarning getWarnings() throws SQLExceptionこのResultSet
オブジェクトに関する呼出しによって報告される最初の警告を取得します。 後続のResultSet
オブジェクトの警告は、このメソッドが返すSQLWarning
オブジェクトにチェーンされます。警告チェーンは、新しい行が読み込まれるたびに自動的にクリアされます。 クローズ済みの
ResultSet
オブジェクトでこのメソッドを呼び出すことはできません。そうした場合にはSQLException
がスローされます。ノート: この警告チェーンは、
ResultSet
メソッドが原因となった警告だけを対象とします。Statement
メソッド(読み込んでいるOUTパラメータなど)が原因となった警告はStatement
オブジェクトにチェーンされます。- 戻り値:
- 最初に報告された
SQLWarning
オブジェクト。ない場合はnull
- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされた結果セットで呼び出された場合
-
clearWarnings
void clearWarnings() throws SQLExceptionこのResultSet
オブジェクトに関して報告されたすべての警告をクリアします。 このメソッドが呼び出されたあと、このResultSet
オブジェクトに対する新しい警告が報告されるまで、getWarnings
メソッドはnull
を返します。- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされた結果セットで呼び出された場合
-
getCursorName
String getCursorName() throws SQLExceptionこのResultSet
オブジェクトが使用するSQLカーソルの名前を取得します。SQLでは、結果の表は、名付けられたカーソルを介して検索されます。 結果セットの現在の行は、カーソル名を参照する、位置決めされた更新文または削除文を使用して更新または削除できます。 更新をサポートする適切な遮断レベルをカーソルが確実に持つためには、カーソルの
SELECT
文をSELECT FOR UPDATE
の形式にするようにしてください。FOR UPDATE
節が省略されている場合、位置決めされた更新は失敗します。JDBC APIはこのSQL機能を、
ResultSet
オブジェクトが使用するSQLカーソルの名前を提供することによってサポートします。ResultSet
オブジェクトの現在の行は、このSQLカーソルの現在の行でもあります。- 戻り値:
- この
ResultSet
オブジェクトのカーソルのSQL名 - 例外:
SQLException
- データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合
-
getMetaData
ResultSetMetaData getMetaData() throws SQLExceptionこのResultSet
オブジェクトの列の数、型、およびプロパティを取得します。- 戻り値:
- この
ResultSet
オブジェクトの列の記述 - 例外:
SQLException
- データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされた結果セットで呼び出された場合
-
getObject
Object getObject(int columnIndex) throws SQLExceptionこの
ResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のObject
として取り出します。このメソッドは、指定された列の値をJavaオブジェクトとして返します。 Javaオブジェクトの型は、JDBC仕様で指定されている組込み型のマッピングに従って、列のSQL型に対応するデフォルトのJavaオブジェクト型になります。 値がSQL
NULL
の場合、ドライバはJavanull
を返します。このメソッドは、データベース固有の抽象データ型の読込みにも使用できます。 JDBC 2.0 APIでは、
getObject
メソッドの動作はSQLユーザー定義型のデータを生成するように拡張されています。Connection.getTypeMap
がSQLFeatureNotSupportedException
をスローしない場合、列が構造化型または個別の型の値であれば、このメソッドの動作は、getObject(columnIndex, this.getStatement().getConnection().getTypeMap())
を呼び出した場合と同じになります。Connection.getTypeMap
がSQLFeatureNotSupportedException
をスローする場合、構造化型の値はサポートされず、個別の型の値はDISTINCT型の基になるSQL型で決定されるデフォルトのJavaクラスにマッピングされます。- パラメータ:
columnIndex
- 最初の列は1、2番目の列は2、... となる- 戻り値:
- 列値を保持している
java.lang.Object
- 例外:
SQLException
- columnIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされた結果セットで呼び出された場合
-
getObject
Object getObject(String columnLabel) throws SQLExceptionこの
ResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のObject
として取り出します。このメソッドは、指定された列の値をJavaオブジェクトとして返します。 Javaオブジェクトの型は、JDBC仕様で指定されている組込み型のマッピングに従って、列のSQL型に対応するデフォルトのJavaオブジェクト型になります。 値がSQL
NULL
の場合、ドライバはJavanull
を返します。このメソッドは、データベース固有の抽象データ型の読込みにも使用できます。
JDBC 2.0 APIでは、
getObject
メソッドの動作はSQLユーザー定義型のデータを生成するように拡張されています。 列が構造化型または個別の型の値である場合、このメソッドの動作は、getObject(columnIndex, this.getStatement().getConnection().getTypeMap())
を呼び出した場合と同じになります。- パラメータ:
columnLabel
- SQL AS節として指定された列のラベル。 SQL AS節が指定されなかった場合、このラベルは列の名前- 戻り値:
- 列値を保持している
java.lang.Object
- 例外:
SQLException
- columnLabelが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされた結果セットで呼び出された場合
-
findColumn
int findColumn(String columnLabel) throws SQLException指定されたResultSet
の列ラベルをResultSet
列インデックスにマッピングします。- パラメータ:
columnLabel
- SQL AS節として指定された列のラベル。 SQL AS節が指定されなかった場合、このラベルは列の名前- 戻り値:
- 指定された列名の列インデックス
- 例外:
SQLException
-ResultSet
オブジェクトにcolumnLabel
というラベルの列が含まれない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされた結果セットで呼び出された場合
-
getCharacterStream
Reader getCharacterStream(int columnIndex) throws SQLExceptionこのResultSet
オブジェクトの現在行にある指定された列の値をjava.io.Reader
オブジェクトとして取り出します。- パラメータ:
columnIndex
- 最初の列は1、2番目の列は2、... となる- 戻り値:
- 列値を格納する
java.io.Reader
オブジェクト。値がSQLNULL
の場合、返される値はJavaプログラミング言語のnull
- 例外:
SQLException
- columnIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされた結果セットで呼び出された場合- 導入されたバージョン:
- 1.2
-
getCharacterStream
Reader getCharacterStream(String columnLabel) throws SQLExceptionこのResultSet
オブジェクトの現在行にある指定された列の値をjava.io.Reader
オブジェクトとして取り出します。- パラメータ:
columnLabel
- SQL AS節として指定された列のラベル。 SQL AS節が指定されなかった場合、このラベルは列の名前- 戻り値:
- 列値を格納する
java.io.Reader
オブジェクト。値がSQLNULL
の場合、返される値はJavaプログラミング言語のnull
- 例外:
SQLException
- columnLabelが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされた結果セットで呼び出された場合- 導入されたバージョン:
- 1.2
-
getBigDecimal
BigDecimal getBigDecimal(int columnIndex) throws SQLExceptionこのResultSet
オブジェクトの現在行にある指定された列の値を、完全な精度のjava.math.BigDecimal
として取得します。- パラメータ:
columnIndex
- 最初の列は1、2番目の列は2、... となる- 戻り値:
- 全精度の列値。値がSQL
NULL
の場合、返される値はJavaプログラミング言語のnull
- 例外:
SQLException
- columnIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされた結果セットで呼び出された場合- 導入されたバージョン:
- 1.2
-
getBigDecimal
BigDecimal getBigDecimal(String columnLabel) throws SQLExceptionこのResultSet
オブジェクトの現在行にある指定された列の値を、完全な精度のjava.math.BigDecimal
として取得します。- パラメータ:
columnLabel
- SQL AS節として指定された列のラベル。 SQL AS節が指定されなかった場合、このラベルは列の名前- 戻り値:
- 全精度の列値。値がSQL
NULL
の場合、返される値はJavaプログラミング言語のnull
- 例外:
SQLException
- columnLabelが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされた結果セットで呼び出された場合- 導入されたバージョン:
- 1.2
-
isBeforeFirst
boolean isBeforeFirst() throws SQLExceptionカーソルがこのResultSet
オブジェクト内の先頭行より前にあるかどうかを取得します。ノート: 結果セットのタイプが
TYPE_FORWARD_ONLY
であるResultSet
の場合、isBeforeFirst
メソッドのサポートはオプションです。- 戻り値:
- カーソルが先頭行より前にある場合は
true
、カーソルがほかの位置にあるか、結果セットに行がない場合はfalse
- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
isAfterLast
boolean isAfterLast() throws SQLExceptionカーソルがこのResultSet
オブジェクト内の最終行より後ろにあるかどうかを取得します。ノート: 結果セットのタイプが
TYPE_FORWARD_ONLY
であるResultSet
の場合、isAfterLast
メソッドのサポートはオプションです。- 戻り値:
- カーソルが最終行より後ろにある場合は
true
、カーソルがほかの位置にあるか、結果セットに行がない場合はfalse
- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
isFirst
boolean isFirst() throws SQLExceptionカーソルがこのResultSet
オブジェクト内の先頭行にあるかどうかを取得します。ノート: 結果セットのタイプが
TYPE_FORWARD_ONLY
であるResultSet
の場合、isFirst
メソッドのサポートはオプションです。- 戻り値:
- カーソルが先頭行にある場合は
true
、そうでない場合はfalse
- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
isLast
boolean isLast() throws SQLExceptionカーソルがこのResultSet
オブジェクトの最終行にあるかどうかを取得します。 ノート: JDBCドライバは現在の行が結果セット内の最終行であるかどうかを判定するために1つ先の行を取り出すことが必要な場合があるので、isLast
メソッドの呼出しは負荷が大きくなる場合があります。ノート: 結果セットのタイプが
TYPE_FORWARD_ONLY
であるResultSet
の場合、isLast
メソッドのサポートはオプションです。- 戻り値:
- カーソルが最終行にある場合は
true
、そうでない場合はfalse
- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
beforeFirst
void beforeFirst() throws SQLExceptionカーソルをこのResultSet
オブジェクトの先端、つまり先頭行の直前に移動します。 結果セットに行がない場合、このメソッドは無効です。- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合、このメソッドがクローズされた結果セットで呼び出された場合、または結果セットのタイプがTYPE_FORWARD_ONLY
である場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
afterLast
void afterLast() throws SQLExceptionカーソルをこのResultSet
オブジェクトの終端、つまり最終行の直後に移動します。 結果セットに行がない場合、このメソッドは無効です。- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合、このメソッドがクローズされた結果セットで呼び出された場合、または結果セットのタイプがTYPE_FORWARD_ONLY
である場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
first
boolean first() throws SQLExceptionカーソルをこのResultSet
オブジェクト内の先頭行に移動します。- 戻り値:
- カーソルが有効な行にある場合は
true
、結果セットに行がない場合はfalse
- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合、このメソッドがクローズされた結果セットで呼び出された場合、または結果セットのタイプがTYPE_FORWARD_ONLY
である場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
last
boolean last() throws SQLExceptionカーソルをこのResultSet
オブジェクト内の最終行に移動します。- 戻り値:
- カーソルが有効な行にある場合は
true
、結果セットに行がない場合はfalse
- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合、このメソッドがクローズされた結果セットで呼び出された場合、または結果セットのタイプがTYPE_FORWARD_ONLY
である場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
getRow
int getRow() throws SQLException現在の行の番号を取得します。 最初の行が1、2番目は2、などとなります。ノート: 結果セットのタイプが
TYPE_FORWARD_ONLY
であるResultSet
の場合、getRow
メソッドのサポートはオプションです。- 戻り値:
- 現在の行の番号。現在の行がない場合は
0
- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
absolute
boolean absolute(int row) throws SQLExceptionカーソルをこのResultSet
オブジェクト内の指定された行番号に移動します。指定された行番号が正の値の場合は、カーソルは結果セットの先頭を基準にして指定された行番号に移動します。 最初の行が行1、2番目が行2、などとします。
指定された行番号が負の値の場合は、カーソルは結果セットの終端に対する絶対行位置に移動します。 たとえば、
absolute(-1)
メソッドを呼び出すと、カーソルは最終行に移動し、メソッドabsolute(-2)
を呼び出すと、カーソルは最終行の次の行に移動します。指定された行番号がゼロの場合、カーソルは最初の行の前に移動します。
結果セット内の先頭行または最終行を越える位置にカーソルを移動しようとすると、カーソルは先頭行の前または最終行の後ろに置かれます。
ノート:
absolute(1)
を呼び出すことは、first()
を呼び出すのと同じです。absolute(-1)
を呼び出すことは、last()
を呼び出すのと同じです。- パラメータ:
row
- カーソルの移動先の行番号。 ゼロの値は、カーソルが最初の行の前に置かれることを示します。正の番号は行番号が結果セットの先頭からカウントされることを示し、負の番号は行番号を結果セットの終端からカウントされることを示す- 戻り値:
- カーソルがこの
ResultSet
オブジェクト内の位置に移動する場合はtrue
、最初の行の前または最終行の後ろにカーソルが位置する場合はfalse
- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合、このメソッドがクローズされた結果セットで呼び出された場合、または結果セットのタイプがTYPE_FORWARD_ONLY
である場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
relative
boolean relative(int rows) throws SQLExceptionカーソルを正または負の相対行数だけ移動します。 結果セット内の先頭行または最終行を越える位置にカーソルを移動しようとすると、カーソルは先頭行の前または最終行の後ろに置かれます。relative(0)
の呼出しは有効ですが、カーソル位置は変更されません。ノート:
relative(1)
メソッドの呼出しは、next()
メソッドを呼び出すのと同じです。relative(-1)
メソッドの呼出しはprevious()
メソッドを呼び出すのと同じです。- パラメータ:
rows
- 現在の行から移動する行数を指定するint
。正の数はカーソルを順方向に移動し、負の数は逆方向に移動する- 戻り値:
- カーソルが行にある場合は
true
、そうでない場合はfalse
- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合、このメソッドがクローズされた結果セットで呼び出された場合、または結果セットのタイプがTYPE_FORWARD_ONLY
である場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
previous
boolean previous() throws SQLExceptionカーソルをこのResultSet
オブジェクト内の前の行に移動します。previous
メソッドの呼出しでfalse
が返されると、カーソルは最初の行の前に位置します。 現在の行が必要なResultSet
メソッドのあらゆる呼出しによって、SQLException
がスローされます。現在の行で入力ストリームがオープンしている場合、
previous
メソッドへの呼出しは暗黙的にそのストリームをクローズさせます。 新しい行が読み込まれるときに、ResultSet
オブジェクトの警告の変更内容はクリアされます。- 戻り値:
- カーソルが有効な行に位置している場合は
true
、最初の行の前にカーソルが位置している場合はfalse
- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合、このメソッドがクローズされた結果セットで呼び出された場合、または結果セットのタイプがTYPE_FORWARD_ONLY
である場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
setFetchDirection
void setFetchDirection(int direction) throws SQLExceptionこのResultSet
オブジェクト内の行が処理される方向についてのヒントを提供します。 初期値はこのResultSet
オブジェクトを生成したStatement
オブジェクトによって決まります。 フェッチ方向はいつでも変更できます。- パラメータ:
direction
- 推奨されるフェッチ方向を指定するint
。ResultSet.FETCH_FORWARD
、ResultSet.FETCH_REVERSE
、またはResultSet.FETCH_UNKNOWN
のうちの1つ- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合、このメソッドがクローズされた結果セットで呼び出された場合、または結果セットのタイプがTYPE_FORWARD_ONLY
で、フェッチ方向がFETCH_FORWARD
でない場合- 導入されたバージョン:
- 1.2
- 関連項目:
Statement.setFetchDirection(int)
,getFetchDirection()
-
getFetchDirection
int getFetchDirection() throws SQLExceptionこのResultSet
オブジェクトのフェッチ方向を取得します。- 戻り値:
- この
ResultSet
オブジェクトの現在のフェッチ方向 - 例外:
SQLException
- データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされた結果セットで呼び出された場合- 導入されたバージョン:
- 1.2
- 関連項目:
setFetchDirection(int)
-
setFetchSize
void setFetchSize(int rows) throws SQLExceptionこのResultSet
オブジェクトでより多くの行が必要なときにデータベースから取り出す必要がある行数についてのヒントをJDBCドライバに提供します。 指定されたフェッチ・サイズが0の場合、JDBCドライバはその値を無視し、もっとも適切と考えられるフェッチ・サイズを自分で決めます。 デフォルト値は結果セットを作成したStatement
オブジェクトによって設定されます。 フェッチ・サイズはいつでも変更できます。- パラメータ:
rows
- フェッチする行数- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合、このメソッドがクローズされた結果セットで呼び出された場合、または条件rows>= 0
が満たされない場合- 導入されたバージョン:
- 1.2
- 関連項目:
getFetchSize()
-
getFetchSize
int getFetchSize() throws SQLExceptionこのResultSet
オブジェクトのフェッチ・サイズを取得します。- 戻り値:
- この
ResultSet
オブジェクトの現在のフェッチ・サイズ - 例外:
SQLException
- データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされた結果セットで呼び出された場合- 導入されたバージョン:
- 1.2
- 関連項目:
setFetchSize(int)
-
getType
int getType() throws SQLExceptionこのResultSet
オブジェクトの型を返します。 型は結果セットを作成したStatement
オブジェクトによって決まります。- 戻り値:
ResultSet.TYPE_FORWARD_ONLY
、ResultSet.TYPE_SCROLL_INSENSITIVE
、またはResultSet.TYPE_SCROLL_SENSITIVE
- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされた結果セットで呼び出された場合- 導入されたバージョン:
- 1.2
-
getConcurrency
int getConcurrency() throws SQLExceptionこのResultSet
オブジェクトの並行処理モードを取得します。 使用される並行処理は、結果セットを生成したStatement
オブジェクトによって決まります。- 戻り値:
- 並行処理の種類。
ResultSet.CONCUR_READ_ONLY
またはResultSet.CONCUR_UPDATABLE
- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされた結果セットで呼び出された場合- 導入されたバージョン:
- 1.2
-
rowUpdated
boolean rowUpdated() throws SQLException現在の行が更新されているかどうかを取得します。 返される値は、結果セットが更新を検出できるかどうかによって異なります。ノート: 結果セットの並行処理が
CONCUR_READ_ONLY
である場合、rowUpdated
メソッドのサポートはオプションです。- 戻り値:
- 現在の行が所有者などによって可視的に更新されたことが検出された場合は
true
、そうでない場合はfalse
- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
- 関連項目:
DatabaseMetaData.updatesAreDetected(int)
-
rowInserted
boolean rowInserted() throws SQLException現在の行に挿入があったかどうかを取得します。 返される値は、このResultSet
オブジェクトが可視の挿入を検出できるかどうかによって異なります。ノート: 結果セットの並行処理が
CONCUR_READ_ONLY
である場合、rowInserted
メソッドのサポートはオプションです。- 戻り値:
- 現在の行が挿入されていたことを検出した場合は
true
、そうでない場合はfalse
- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
- 関連項目:
DatabaseMetaData.insertsAreDetected(int)
-
rowDeleted
boolean rowDeleted() throws SQLException行が削除されているかどうかを取得します。 削除された行は、結果セットに可視の「穴」を残すことがあります。 このメソッドは結果セット内の穴を検出するのに使用できます。 返される値は、このResultSet
オブジェクトが削除を検出できるかどうかによって異なります。ノート: 結果セットの並行処理が
CONCUR_READ_ONLY
である場合、rowDeleted
メソッドのサポートはオプションです。- 戻り値:
- 現在の行が所有者などによって削除されていたことが検出された場合は
true
、そうでない場合はfalse
- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
- 関連項目:
DatabaseMetaData.deletesAreDetected(int)
-
updateNull
void updateNull(int columnIndex) throws SQLException指定された列をnull
値で更新します。 updaterメソッドは、現在行または挿入行の列値を更新するのに使用します。 updaterメソッドは基になるデータベースを更新しません。データベースを更新するには、代わりにupdateRow
またはinsertRow
メソッドを呼び出します。- パラメータ:
columnIndex
- 最初の列は1、2番目の列は2、... となる- 例外:
SQLException
- columnIndexが無効な場合、データベース・アクセス・エラーが発生した場合、結果セットの並行処理がCONCUR_READ_ONLY
である場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
updateBoolean
void updateBoolean(int columnIndex, boolean x) throws SQLException指定された列をboolean
値で更新します。 updaterメソッドは、現在行または挿入行の列値を更新するのに使用します。 updaterメソッドは基になるデータベースを更新しません。データベースを更新するには、代わりにupdateRow
またはinsertRow
メソッドを呼び出します。- パラメータ:
columnIndex
- 最初の列は1、2番目の列は2、... となるx
- 新しい列値- 例外:
SQLException
- columnIndexが無効な場合、データベース・アクセス・エラーが発生した場合、結果セットの並行処理がCONCUR_READ_ONLY
である場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
updateByte
void updateByte(int columnIndex, byte x) throws SQLException指定された列をbyte
値で更新します。 updaterメソッドは、現在行または挿入行の列値を更新するのに使用します。 updaterメソッドは基になるデータベースを更新しません。データベースを更新するには、代わりにupdateRow
またはinsertRow
メソッドを呼び出します。- パラメータ:
columnIndex
- 最初の列は1、2番目の列は2、... となるx
- 新しい列値- 例外:
SQLException
- columnIndexが無効な場合、データベース・アクセス・エラーが発生した場合、結果セットの並行処理がCONCUR_READ_ONLY
である場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
updateShort
void updateShort(int columnIndex, short x) throws SQLException指定された列をshort
値で更新します。 updaterメソッドは、現在行または挿入行の列値を更新するのに使用します。 updaterメソッドは基になるデータベースを更新しません。データベースを更新するには、代わりにupdateRow
またはinsertRow
メソッドを呼び出します。- パラメータ:
columnIndex
- 最初の列は1、2番目の列は2、... となるx
- 新しい列値- 例外:
SQLException
- columnIndexが無効な場合、データベース・アクセス・エラーが発生した場合、結果セットの並行処理がCONCUR_READ_ONLY
である場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
updateInt
void updateInt(int columnIndex, int x) throws SQLException指定された列をint
値で更新します。 updaterメソッドは、現在行または挿入行の列値を更新するのに使用します。 updaterメソッドは基になるデータベースを更新しません。データベースを更新するには、代わりにupdateRow
またはinsertRow
メソッドを呼び出します。- パラメータ:
columnIndex
- 最初の列は1、2番目の列は2、... となるx
- 新しい列値- 例外:
SQLException
- columnIndexが無効な場合、データベース・アクセス・エラーが発生した場合、結果セットの並行処理がCONCUR_READ_ONLY
である場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
updateLong
void updateLong(int columnIndex, long x) throws SQLException指定された列をlong
値で更新します。 updaterメソッドは、現在行または挿入行の列値を更新するのに使用します。 updaterメソッドは基になるデータベースを更新しません。データベースを更新するには、代わりにupdateRow
またはinsertRow
メソッドを呼び出します。- パラメータ:
columnIndex
- 最初の列は1、2番目の列は2、... となるx
- 新しい列値- 例外:
SQLException
- columnIndexが無効な場合、データベース・アクセス・エラーが発生した場合、結果セットの並行処理がCONCUR_READ_ONLY
である場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
updateFloat
void updateFloat(int columnIndex, float x) throws SQLException指定された列をfloat
値で更新します。 updaterメソッドは、現在行または挿入行の列値を更新するのに使用します。 updaterメソッドは基になるデータベースを更新しません。データベースを更新するには、代わりにupdateRow
またはinsertRow
メソッドを呼び出します。- パラメータ:
columnIndex
- 最初の列は1、2番目の列は2、... となるx
- 新しい列値- 例外:
SQLException
- columnIndexが無効な場合、データベース・アクセス・エラーが発生した場合、結果セットの並行処理がCONCUR_READ_ONLY
である場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
updateDouble
void updateDouble(int columnIndex, double x) throws SQLException指定された列をdouble
値で更新します。 updaterメソッドは、現在行または挿入行の列値を更新するのに使用します。 updaterメソッドは基になるデータベースを更新しません。データベースを更新するには、代わりにupdateRow
またはinsertRow
メソッドを呼び出します。- パラメータ:
columnIndex
- 最初の列は1、2番目の列は2、... となるx
- 新しい列値- 例外:
SQLException
- columnIndexが無効な場合、データベース・アクセス・エラーが発生した場合、結果セットの並行処理がCONCUR_READ_ONLY
である場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
updateBigDecimal
void updateBigDecimal(int columnIndex, BigDecimal x) throws SQLException指定された列をjava.math.BigDecimal
値で更新します。 updaterメソッドは、現在行または挿入行の列値を更新するのに使用します。 updaterメソッドは基になるデータベースを更新しません。データベースを更新するには、代わりにupdateRow
またはinsertRow
メソッドを呼び出します。- パラメータ:
columnIndex
- 最初の列は1、2番目の列は2、... となるx
- 新しい列値- 例外:
SQLException
- columnIndexが無効な場合、データベース・アクセス・エラーが発生した場合、結果セットの並行処理がCONCUR_READ_ONLY
である場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
updateString
void updateString(int columnIndex, String x) throws SQLException指定された列をString
値で更新します。 updaterメソッドは、現在行または挿入行の列値を更新するのに使用します。 updaterメソッドは基になるデータベースを更新しません。データベースを更新するには、代わりにupdateRow
またはinsertRow
メソッドを呼び出します。- パラメータ:
columnIndex
- 最初の列は1、2番目の列は2、... となるx
- 新しい列値- 例外:
SQLException
- columnIndexが無効な場合、データベース・アクセス・エラーが発生した場合、結果セットの並行処理がCONCUR_READ_ONLY
である場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
updateBytes
void updateBytes(int columnIndex, byte[] x) throws SQLException指定された列をbyte
配列値で更新します。 updaterメソッドは、現在行または挿入行の列値を更新するのに使用します。 updaterメソッドは基になるデータベースを更新しません。データベースを更新するには、代わりにupdateRow
またはinsertRow
メソッドを呼び出します。- パラメータ:
columnIndex
- 最初の列は1、2番目の列は2、... となるx
- 新しい列値- 例外:
SQLException
- columnIndexが無効な場合、データベース・アクセス・エラーが発生した場合、結果セットの並行処理がCONCUR_READ_ONLY
である場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
updateDate
void updateDate(int columnIndex, Date x) throws SQLException指定された列をjava.sql.Date
値で更新します。 updaterメソッドは、現在行または挿入行の列値を更新するのに使用します。 updaterメソッドは基になるデータベースを更新しません。データベースを更新するには、代わりにupdateRow
またはinsertRow
メソッドを呼び出します。- パラメータ:
columnIndex
- 最初の列は1、2番目の列は2、... となるx
- 新しい列値- 例外:
SQLException
- columnIndexが無効な場合、データベース・アクセス・エラーが発生した場合、結果セットの並行処理がCONCUR_READ_ONLY
である場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
updateTime
void updateTime(int columnIndex, Time x) throws SQLException指定された列をjava.sql.Time
値で更新します。 updaterメソッドは、現在行または挿入行の列値を更新するのに使用します。 updaterメソッドは基になるデータベースを更新しません。データベースを更新するには、代わりにupdateRow
またはinsertRow
メソッドを呼び出します。- パラメータ:
columnIndex
- 最初の列は1、2番目の列は2、... となるx
- 新しい列値- 例外:
SQLException
- columnIndexが無効な場合、データベース・アクセス・エラーが発生した場合、結果セットの並行処理がCONCUR_READ_ONLY
である場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
updateTimestamp
void updateTimestamp(int columnIndex, Timestamp x) throws SQLException指定された列をjava.sql.Timestamp
値で更新します。 updaterメソッドは、現在行または挿入行の列値を更新するのに使用します。 updaterメソッドは基になるデータベースを更新しません。データベースを更新するには、代わりにupdateRow
またはinsertRow
メソッドを呼び出します。- パラメータ:
columnIndex
- 最初の列は1、2番目の列は2、... となるx
- 新しい列値- 例外:
SQLException
- columnIndexが無効な場合、データベース・アクセス・エラーが発生した場合、結果セットの並行処理がCONCUR_READ_ONLY
である場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
updateAsciiStream
void updateAsciiStream(int columnIndex, InputStream x, int length) throws SQLException指定された列を、指定されたバイト数を持つasciiストリーム値で更新します。 updaterメソッドは、現在行または挿入行の列値を更新するのに使用します。 updaterメソッドは基になるデータベースを更新しません。データベースを更新するには、代わりにupdateRow
またはinsertRow
メソッドを呼び出します。- パラメータ:
columnIndex
- 最初の列は1、2番目の列は2、... となるx
- 新しい列値length
- ストリームの長さ- 例外:
SQLException
- columnIndexが無効な場合、データベース・アクセス・エラーが発生した場合、結果セットの並行処理がCONCUR_READ_ONLY
である場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
updateBinaryStream
void updateBinaryStream(int columnIndex, InputStream x, int length) throws SQLException指定された列を、指定されたバイト数を持つバイナリ・ストリーム値で更新します。 updaterメソッドは、現在行または挿入行の列値を更新するのに使用します。 updaterメソッドは基になるデータベースを更新しません。データベースを更新するには、代わりにupdateRow
またはinsertRow
メソッドを呼び出します。- パラメータ:
columnIndex
- 最初の列は1、2番目の列は2、... となるx
- 新しい列値length
- ストリームの長さ- 例外:
SQLException
- columnIndexが無効な場合、データベース・アクセス・エラーが発生した場合、結果セットの並行処理がCONCUR_READ_ONLY
である場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
updateCharacterStream
void updateCharacterStream(int columnIndex, Reader x, int length) throws SQLException指定された列を、指定されたバイト数を持つ文字ストリーム値で更新します。 updaterメソッドは、現在行または挿入行の列値を更新するのに使用します。 updaterメソッドは基になるデータベースを更新しません。データベースを更新するには、代わりにupdateRow
またはinsertRow
メソッドを呼び出します。- パラメータ:
columnIndex
- 最初の列は1、2番目の列は2、... となるx
- 新しい列値length
- ストリームの長さ- 例外:
SQLException
- columnIndexが無効な場合、データベース・アクセス・エラーが発生した場合、結果セットの並行処理がCONCUR_READ_ONLY
である場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
updateObject
void updateObject(int columnIndex, Object x, int scaleOrLength) throws SQLException指定された列をObject
値で更新します。 updaterメソッドは、現在行または挿入行の列値を更新するのに使用します。 updaterメソッドは基になるデータベースを更新しません。データベースを更新するには、代わりにupdateRow
またはinsertRow
メソッドを呼び出します。2番目の引数が
InputStream
である場合、ストリームにはscaleOrLengthで指定されるバイト数が含まれる必要があります。 2番目の引数がReader
である場合、リーダーにはscaleOrLengthで指定される文字数が含まれる必要があります。 これらの条件がtrueではない場合、文の実行時にドライバはSQLException
を生成します。- パラメータ:
columnIndex
- 最初の列は1、2番目の列は2、... となるx
- 新しい列値scaleOrLength
-java.math.BigDecimal
のオブジェクトの場合、小数点のあとの桁数。 Javaオブジェクト型InputStream
およびReader
の場合は、ストリームまたはリーダーのデータ長。 ほかのすべての型では、この値は無視される。- 例外:
SQLException
- columnIndexが無効な場合、データベース・アクセス・エラーが発生した場合、結果セットの並行処理がCONCUR_READ_ONLY
である場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
updateObject
void updateObject(int columnIndex, Object x) throws SQLException指定された列をObject
値で更新します。 updaterメソッドは、現在行または挿入行の列値を更新するのに使用します。 updaterメソッドは基になるデータベースを更新しません。データベースを更新するには、代わりにupdateRow
またはinsertRow
メソッドを呼び出します。- パラメータ:
columnIndex
- 最初の列は1、2番目の列は2、... となるx
- 新しい列値- 例外:
SQLException
- columnIndexが無効な場合、データベース・アクセス・エラーが発生した場合、結果セットの並行処理がCONCUR_READ_ONLY
である場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
updateNull
void updateNull(String columnLabel) throws SQLException指定された列をnull
値で更新します。 updaterメソッドは、現在行または挿入行の列値を更新するのに使用します。 updaterメソッドは基になるデータベースを更新しません。データベースを更新するには、代わりにupdateRow
またはinsertRow
メソッドを呼び出します。- パラメータ:
columnLabel
- SQL AS節として指定された列のラベル。 SQL AS節が指定されなかった場合、このラベルは列の名前- 例外:
SQLException
- columnLabelが無効な場合、データベース・アクセス・エラーが発生した場合、結果セットの並行処理がCONCUR_READ_ONLY
である場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
updateBoolean
void updateBoolean(String columnLabel, boolean x) throws SQLException指定された列をboolean
値で更新します。 updaterメソッドは、現在行または挿入行の列値を更新するのに使用します。 updaterメソッドは基になるデータベースを更新しません。データベースを更新するには、代わりにupdateRow
またはinsertRow
メソッドを呼び出します。- パラメータ:
columnLabel
- SQL AS節として指定された列のラベル。 SQL AS節が指定されなかった場合、このラベルは列の名前x
- 新しい列値- 例外:
SQLException
- columnLabelが無効な場合、データベース・アクセス・エラーが発生した場合、結果セットの並行処理がCONCUR_READ_ONLY
である場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
updateByte
void updateByte(String columnLabel, byte x) throws SQLException指定された列をbyte
値で更新します。 updaterメソッドは、現在行または挿入行の列値を更新するのに使用します。 updaterメソッドは基になるデータベースを更新しません。データベースを更新するには、代わりにupdateRow
またはinsertRow
メソッドを呼び出します。- パラメータ:
columnLabel
- SQL AS節として指定された列のラベル。 SQL AS節が指定されなかった場合、このラベルは列の名前x
- 新しい列値- 例外:
SQLException
- columnLabelが無効な場合、データベース・アクセス・エラーが発生した場合、結果セットの並行処理がCONCUR_READ_ONLY
である場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
updateShort
void updateShort(String columnLabel, short x) throws SQLException指定された列をshort
値で更新します。 updaterメソッドは、現在行または挿入行の列値を更新するのに使用します。 updaterメソッドは基になるデータベースを更新しません。データベースを更新するには、代わりにupdateRow
またはinsertRow
メソッドを呼び出します。- パラメータ:
columnLabel
- SQL AS節として指定された列のラベル。 SQL AS節が指定されなかった場合、このラベルは列の名前x
- 新しい列値- 例外:
SQLException
- columnLabelが無効な場合、データベース・アクセス・エラーが発生した場合、結果セットの並行処理がCONCUR_READ_ONLY
である場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
updateInt
void updateInt(String columnLabel, int x) throws SQLException指定された列をint
値で更新します。 updaterメソッドは、現在行または挿入行の列値を更新するのに使用します。 updaterメソッドは基になるデータベースを更新しません。データベースを更新するには、代わりにupdateRow
またはinsertRow
メソッドを呼び出します。- パラメータ:
columnLabel
- SQL AS節として指定された列のラベル。 SQL AS節が指定されなかった場合、このラベルは列の名前x
- 新しい列値- 例外:
SQLException
- columnLabelが無効な場合、データベース・アクセス・エラーが発生した場合、結果セットの並行処理がCONCUR_READ_ONLY
である場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
updateLong
void updateLong(String columnLabel, long x) throws SQLException指定された列をlong
値で更新します。 updaterメソッドは、現在行または挿入行の列値を更新するのに使用します。 updaterメソッドは基になるデータベースを更新しません。データベースを更新するには、代わりにupdateRow
またはinsertRow
メソッドを呼び出します。- パラメータ:
columnLabel
- SQL AS節として指定された列のラベル。 SQL AS節が指定されなかった場合、このラベルは列の名前x
- 新しい列値- 例外:
SQLException
- columnLabelが無効な場合、データベース・アクセス・エラーが発生した場合、結果セットの並行処理がCONCUR_READ_ONLY
である場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
updateFloat
void updateFloat(String columnLabel, float x) throws SQLException指定された列をfloat
値で更新します。 updaterメソッドは、現在行または挿入行の列値を更新するのに使用します。 updaterメソッドは基になるデータベースを更新しません。データベースを更新するには、代わりにupdateRow
またはinsertRow
メソッドを呼び出します。- パラメータ:
columnLabel
- SQL AS節として指定された列のラベル。 SQL AS節が指定されなかった場合、このラベルは列の名前x
- 新しい列値- 例外:
SQLException
- columnLabelが無効な場合、データベース・アクセス・エラーが発生した場合、結果セットの並行処理がCONCUR_READ_ONLY
である場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
updateDouble
void updateDouble(String columnLabel, double x) throws SQLException指定された列をdouble
値で更新します。 updaterメソッドは、現在行または挿入行の列値を更新するのに使用します。 updaterメソッドは基になるデータベースを更新しません。データベースを更新するには、代わりにupdateRow
またはinsertRow
メソッドを呼び出します。- パラメータ:
columnLabel
- SQL AS節として指定された列のラベル。 SQL AS節が指定されなかった場合、このラベルは列の名前x
- 新しい列値- 例外:
SQLException
- columnLabelが無効な場合、データベース・アクセス・エラーが発生した場合、結果セットの並行処理がCONCUR_READ_ONLY
である場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
updateBigDecimal
void updateBigDecimal(String columnLabel, BigDecimal x) throws SQLException指定された列をjava.sql.BigDecimal
値で更新します。 updaterメソッドは、現在行または挿入行の列値を更新するのに使用します。 updaterメソッドは基になるデータベースを更新しません。データベースを更新するには、代わりにupdateRow
またはinsertRow
メソッドを呼び出します。- パラメータ:
columnLabel
- SQL AS節として指定された列のラベル。 SQL AS節が指定されなかった場合、このラベルは列の名前x
- 新しい列値- 例外:
SQLException
- columnLabelが無効な場合、データベース・アクセス・エラーが発生した場合、結果セットの並行処理がCONCUR_READ_ONLY
である場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
updateString
void updateString(String columnLabel, String x) throws SQLException指定された列をString
値で更新します。 updaterメソッドは、現在行または挿入行の列値を更新するのに使用します。 updaterメソッドは基になるデータベースを更新しません。データベースを更新するには、代わりにupdateRow
またはinsertRow
メソッドを呼び出します。- パラメータ:
columnLabel
- SQL AS節として指定された列のラベル。 SQL AS節が指定されなかった場合、このラベルは列の名前x
- 新しい列値- 例外:
SQLException
- columnLabelが無効な場合、データベース・アクセス・エラーが発生した場合、結果セットの並行処理がCONCUR_READ_ONLY
である場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
updateBytes
void updateBytes(String columnLabel, byte[] x) throws SQLException指定された列をbyte配列値で更新します。 updaterメソッドは、現在行または挿入行の列値を更新するのに使用します。 updaterメソッドは基になるデータベースを更新しません。データベースを更新するには、代わりにupdateRow
またはinsertRow
メソッドを呼び出します。- パラメータ:
columnLabel
- SQL AS節として指定された列のラベル。 SQL AS節が指定されなかった場合、このラベルは列の名前x
- 新しい列値- 例外:
SQLException
- columnLabelが無効な場合、データベース・アクセス・エラーが発生した場合、結果セットの並行処理がCONCUR_READ_ONLY
である場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
updateDate
void updateDate(String columnLabel, Date x) throws SQLException指定された列をjava.sql.Date
値で更新します。 updaterメソッドは、現在行または挿入行の列値を更新するのに使用します。 updaterメソッドは基になるデータベースを更新しません。データベースを更新するには、代わりにupdateRow
またはinsertRow
メソッドを呼び出します。- パラメータ:
columnLabel
- SQL AS節として指定された列のラベル。 SQL AS節が指定されなかった場合、このラベルは列の名前x
- 新しい列値- 例外:
SQLException
- columnLabelが無効な場合、データベース・アクセス・エラーが発生した場合、結果セットの並行処理がCONCUR_READ_ONLY
である場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
updateTime
void updateTime(String columnLabel, Time x) throws SQLException指定された列をjava.sql.Time
値で更新します。 updaterメソッドは、現在行または挿入行の列値を更新するのに使用します。 updaterメソッドは基になるデータベースを更新しません。データベースを更新するには、代わりにupdateRow
またはinsertRow
メソッドを呼び出します。- パラメータ:
columnLabel
- SQL AS節として指定された列のラベル。 SQL AS節が指定されなかった場合、このラベルは列の名前x
- 新しい列値- 例外:
SQLException
- columnLabelが無効な場合、データベース・アクセス・エラーが発生した場合、結果セットの並行処理がCONCUR_READ_ONLY
である場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
updateTimestamp
void updateTimestamp(String columnLabel, Timestamp x) throws SQLException指定された列をjava.sql.Timestamp
値で更新します。 updaterメソッドは、現在行または挿入行の列値を更新するのに使用します。 updaterメソッドは基になるデータベースを更新しません。データベースを更新するには、代わりにupdateRow
またはinsertRow
メソッドを呼び出します。- パラメータ:
columnLabel
- SQL AS節として指定された列のラベル。 SQL AS節が指定されなかった場合、このラベルは列の名前x
- 新しい列値- 例外:
SQLException
- columnLabelが無効な場合、データベース・アクセス・エラーが発生した場合、結果セットの並行処理がCONCUR_READ_ONLY
である場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
updateAsciiStream
void updateAsciiStream(String columnLabel, InputStream x, int length) throws SQLException指定された列を、指定されたバイト数を持つasciiストリーム値で更新します。 updaterメソッドは、現在行または挿入行の列値を更新するのに使用します。 updaterメソッドは基になるデータベースを更新しません。データベースを更新するには、代わりにupdateRow
またはinsertRow
メソッドを呼び出します。- パラメータ:
columnLabel
- SQL AS節として指定された列のラベル。 SQL AS節が指定されなかった場合、このラベルは列の名前x
- 新しい列値length
- ストリームの長さ- 例外:
SQLException
- columnLabelが無効な場合、データベース・アクセス・エラーが発生した場合、結果セットの並行処理がCONCUR_READ_ONLY
である場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
updateBinaryStream
void updateBinaryStream(String columnLabel, InputStream x, int length) throws SQLException指定された列を、指定されたバイト数を持つバイナリ・ストリーム値で更新します。 updaterメソッドは、現在行または挿入行の列値を更新するのに使用します。 updaterメソッドは基になるデータベースを更新しません。データベースを更新するには、代わりにupdateRow
またはinsertRow
メソッドを呼び出します。- パラメータ:
columnLabel
- SQL AS節として指定された列のラベル。 SQL AS節が指定されなかった場合、このラベルは列の名前x
- 新しい列値length
- ストリームの長さ- 例外:
SQLException
- columnLabelが無効な場合、データベース・アクセス・エラーが発生した場合、結果セットの並行処理がCONCUR_READ_ONLY
である場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
updateCharacterStream
void updateCharacterStream(String columnLabel, Reader reader, int length) throws SQLException指定された列を、指定されたバイト数を持つ文字ストリーム値で更新します。 updaterメソッドは、現在行または挿入行の列値を更新するのに使用します。 updaterメソッドは基になるデータベースを更新しません。データベースを更新するには、代わりにupdateRow
またはinsertRow
メソッドを呼び出します。- パラメータ:
columnLabel
- SQL AS節として指定された列のラベル。 SQL AS節が指定されなかった場合、このラベルは列の名前reader
- 新しい列値を格納するjava.io.Reader
オブジェクトlength
- ストリームの長さ- 例外:
SQLException
- columnLabelが無効な場合、データベース・アクセス・エラーが発生した場合、結果セットの並行処理がCONCUR_READ_ONLY
である場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
updateObject
void updateObject(String columnLabel, Object x, int scaleOrLength) throws SQLException指定された列をObject
値で更新します。 updaterメソッドは、現在行または挿入行の列値を更新するのに使用します。 updaterメソッドは基になるデータベースを更新しません。データベースを更新するには、代わりにupdateRow
またはinsertRow
メソッドを呼び出します。2番目の引数が
InputStream
である場合、ストリームにはscaleOrLengthで指定されるバイト数が含まれる必要があります。 2番目の引数がReader
である場合、リーダーにはscaleOrLengthで指定される文字数が含まれる必要があります。 これらの条件がtrueではない場合、文の実行時にドライバはSQLException
を生成します。- パラメータ:
columnLabel
- SQL AS節として指定された列のラベル。 SQL AS節が指定されなかった場合、このラベルは列の名前x
- 新しい列値scaleOrLength
-java.math.BigDecimal
のオブジェクトの場合、小数点のあとの桁数。 Javaオブジェクト型InputStream
およびReader
の場合は、ストリームまたはリーダーのデータ長。 ほかのすべての型では、この値は無視される。- 例外:
SQLException
- columnLabelが無効な場合、データベース・アクセス・エラーが発生した場合、結果セットの並行処理がCONCUR_READ_ONLY
である場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
updateObject
void updateObject(String columnLabel, Object x) throws SQLException指定された列をObject
値で更新します。 updaterメソッドは、現在行または挿入行の列値を更新するのに使用します。 updaterメソッドは基になるデータベースを更新しません。データベースを更新するには、代わりにupdateRow
またはinsertRow
メソッドを呼び出します。- パラメータ:
columnLabel
- SQL AS節として指定された列のラベル。 SQL AS節が指定されなかった場合、このラベルは列の名前x
- 新しい列値- 例外:
SQLException
- columnLabelが無効な場合、データベース・アクセス・エラーが発生した場合、結果セットの並行処理がCONCUR_READ_ONLY
である場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
insertRow
void insertRow() throws SQLException挿入行の内容を、このResultSet
オブジェクトおよびデータベースに挿入します。 このメソッドを呼び出すときは、カーソルが挿入行にある必要があります。- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合、結果セットの並行処理がCONCUR_READ_ONLY
である場合、このメソッドがクローズされた結果セットで呼び出された場合、カーソルが挿入行にないときにこのメソッドが呼び出された場合、または挿入行内のnullを許さない列の一部にnull値が指定された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
updateRow
void updateRow() throws SQLException基になるデータベースを、このResultSet
オブジェクトの現在の行の新しい内容に更新します。 カーソルが挿入行にある場合、このメソッドは呼び出すことができません。- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合、結果セットの並行処理がCONCUR_READ_ONLY
である場合、このメソッドがクローズされた結果セットで呼び出された場合、カーソルが挿入行内にあるときにこのメソッドが呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
deleteRow
void deleteRow() throws SQLExceptionこのResultSet
オブジェクトおよび基になるデータベースから、現在の行を削除します。 カーソルが挿入行にある場合、このメソッドは呼び出すことができません。- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合、結果セットの並行処理がCONCUR_READ_ONLY
である場合、このメソッドがクローズされた結果セットで呼び出された場合、カーソルが挿入行内にあるときにこのメソッドが呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
refreshRow
void refreshRow() throws SQLException現在の行をデータベース内の最新の値で再表示します。 カーソルが挿入行にある場合、このメソッドは呼び出すことができません。refreshRow
メソッドは、データベースからの行の再取出しをアプリケーションがJDBCドライバに明示的に指示する手段を提供します。 データベースから行の最新の値を取り出すために、JDBCドライバによってキャッシングまたは先取りが実行されているときに、アプリケーションはrefreshRow
を呼び出すことがあります。 フェッチ・サイズが1より大きい場合、実際にはJDBCドライバは一度に複数の行を再表示することがあります。値はすべて、トランザクションの遮断レベルおよびカーソル応答性に従って取出し直されます。 updaterメソッドを呼び出したあと、
updateRow
メソッドを呼び出す前にrefreshRow
を呼び出すと、行に対して行った更新は失われます。refreshRow
メソッドを頻繁に呼び出すと、パフォーマンスが低下することがあります。- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合、このメソッドがクローズされた結果セットで呼び出された場合、結果セットのタイプがTYPE_FORWARD_ONLY
である場合、またはカーソルが挿入行内にあるときにこのメソッドが呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合、またはこのメソッドが指定された結果セットのタイプと結果セットの並行処理でサポートされない場合- 導入されたバージョン:
- 1.2
-
cancelRowUpdates
void cancelRowUpdates() throws SQLExceptionこのResultSet
オブジェクトの現在の行に対して行った更新を取り消します。 updaterメソッドを呼び出したあと、updateRow
メソッドを呼び出す前にこのメソッドを呼び出すと、行の更新をロールバックできます。 更新が行われていない場合、またはupdateRow
がすでに呼び出されている場合は、このメソッドは無効です。- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合、このメソッドがクローズされた結果セットで呼び出された場合、結果セットの並行処理がCONCUR_READ_ONLY
である場合、またはカーソルが挿入行内にあるときにこのメソッドが呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
moveToInsertRow
void moveToInsertRow() throws SQLExceptionカーソルを挿入行に移動します。 カーソルが挿入行に位置決めされている間、現在のカーソル位置は記憶されています。 挿入行は更新可能な結果セットに関連した特殊な行です。 実質的には、行を結果セットに挿入する前にupdaterメソッドを呼び出すことによって新しい行が作成されるバッファです。 カーソルが挿入行にあるときに呼び出すことができるのは、updaterメソッド、getterメソッド、およびinsertRow
メソッドだけです。insertRow
を呼び出す前にこのメソッドを呼び出すと、そのたびに結果セット内のすべての列に値を設定する必要があります。 列値でgetterメソッドを呼び出すには、その前にupdaterメソッドを呼び出す必要があります。- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合、このメソッドがクローズされた結果セットで呼び出された場合、または結果セットの並行処理がCONCUR_READ_ONLY
である場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
moveToCurrentRow
void moveToCurrentRow() throws SQLExceptionカーソルを、記憶されているカーソル位置(通常は現在の行)に移動します。 このメソッドは、カーソルが挿入行にある場合以外は無効です。- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合、このメソッドがクローズされた結果セットで呼び出された場合、または結果セットの並行処理がCONCUR_READ_ONLY
である場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
getStatement
Statement getStatement() throws SQLExceptionこのResultSet
オブジェクトを生成したStatement
オブジェクトを取得します。 結果セットがDatabaseMetaData
メソッドなどのほかの方法で生成された場合、このメソッドはnull
を返すことがあります。- 戻り値:
- この
ResultSet
オブジェクトを生成したStatement
オブジェクト、または結果セットが他の方法で生成された場合はnull
- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされた結果セットで呼び出された場合- 導入されたバージョン:
- 1.2
-
getObject
Object getObject(int columnIndex, Map<String,Class<?>> map) throws SQLExceptionこのResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のObject
として取り出します。 値がSQLNULL
の場合、ドライバはJavanull
を返します。 このメソッドは、取り出されるSQL構造化型または個別の型のカスタム・マッピングに、指定されたMap
オブジェクトを使用します。- パラメータ:
columnIndex
- 最初の列は1、2番目の列は2、... となるmap
- SQL型名からJavaプログラミング言語のクラスへのマッピングが格納されているjava.util.Map
オブジェクト- 戻り値:
- SQL値を表すJavaプログラミング言語の
Object
- 例外:
SQLException
- columnIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
getRef
Ref getRef(int columnIndex) throws SQLExceptionこのResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のRef
オブジェクトとして取り出します。- パラメータ:
columnIndex
- 最初の列は1、2番目の列は2、... となる- 戻り値:
- SQL
REF
値を表すRef
オブジェクト - 例外:
SQLException
- columnIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
getBlob
Blob getBlob(int columnIndex) throws SQLExceptionこのResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のBlob
オブジェクトとして取り出します。- パラメータ:
columnIndex
- 最初の列は1、2番目の列は2、... となる- 戻り値:
- 指定された列のSQL
BLOB
値を表すBlob
オブジェクト - 例外:
SQLException
- columnIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
getClob
Clob getClob(int columnIndex) throws SQLExceptionこのResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のClob
オブジェクトとして取り出します。- パラメータ:
columnIndex
- 最初の列は1、2番目の列は2、... となる- 戻り値:
- 指定された列のSQL
CLOB
値を表すClob
オブジェクト - 例外:
SQLException
- columnIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
getArray
Array getArray(int columnIndex) throws SQLExceptionこのResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のArray
オブジェクトとして取得します。- パラメータ:
columnIndex
- 最初の列は1、2番目の列は2、... となる- 戻り値:
- 指定された列のSQL
ARRAY
値を表すArray
オブジェクト - 例外:
SQLException
- columnIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
getObject
このResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のObject
として取り出します。 値がSQLNULL
の場合、ドライバはJavanull
を返します。 このメソッドは、該当する場合、指定されたMap
オブジェクトをカスタム・マッピングに使用します。- パラメータ:
columnLabel
- SQL AS節として指定された列のラベル。 SQL AS節が指定されなかった場合、このラベルは列の名前map
- SQL型名からJavaプログラミング言語のクラスへのマッピングが格納されているjava.util.Map
オブジェクト- 戻り値:
- 指定された列のSQL値を表す
Object
- 例外:
SQLException
- columnLabelが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
getRef
Ref getRef(String columnLabel) throws SQLExceptionこのResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のRef
オブジェクトとして取り出します。- パラメータ:
columnLabel
- SQL AS節として指定された列のラベル。 SQL AS節が指定されなかった場合、このラベルは列の名前- 戻り値:
- 指定された列のSQL
REF
値を表すRef
オブジェクト - 例外:
SQLException
- columnLabelが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
getBlob
Blob getBlob(String columnLabel) throws SQLExceptionこのResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のBlob
オブジェクトとして取り出します。- パラメータ:
columnLabel
- SQL AS節として指定された列のラベル。 SQL AS節が指定されなかった場合、このラベルは列の名前- 戻り値:
- 指定された列のSQL
BLOB
値を表すBlob
オブジェクト - 例外:
SQLException
- columnLabelが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
getClob
Clob getClob(String columnLabel) throws SQLExceptionこのResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のClob
オブジェクトとして取り出します。- パラメータ:
columnLabel
- SQL AS節として指定された列のラベル。 SQL AS節が指定されなかった場合、このラベルは列の名前- 戻り値:
- 指定された列のSQL
CLOB
値を表すClob
オブジェクト - 例外:
SQLException
- columnLabelが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
getArray
Array getArray(String columnLabel) throws SQLExceptionこのResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のArray
オブジェクトとして取得します。- パラメータ:
columnLabel
- SQL AS節として指定された列のラベル。 SQL AS節が指定されなかった場合、このラベルは列の名前- 戻り値:
- 指定された列のSQL
ARRAY
値を表すArray
オブジェクト - 例外:
SQLException
- columnLabelが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
getDate
Date getDate(int columnIndex, Calendar cal) throws SQLExceptionこのResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のjava.sql.Date
オブジェクトとして取り出します。 基になるデータベースがタイムゾーン情報を格納していない場合、このメソッドは指定されたカレンダを使って日付に適切なミリ秒値を作成します。- パラメータ:
columnIndex
- 最初の列は1、2番目の列は2、... となるcal
- 日付を作成するのに使うjava.util.Calendar
オブジェクト- 戻り値:
java.sql.Date
オブジェクトとして表された列の値。値がSQLNULL
の場合、返される値はJavaプログラミング言語のnull
- 例外:
SQLException
- columnIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされた結果セットで呼び出された場合- 導入されたバージョン:
- 1.2
-
getDate
Date getDate(String columnLabel, Calendar cal) throws SQLExceptionこのResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のjava.sql.Date
オブジェクトとして取り出します。 基になるデータベースがタイムゾーン情報を格納していない場合、このメソッドは指定されたカレンダを使って日付に適切なミリ秒値を作成します。- パラメータ:
columnLabel
- SQL AS節として指定された列のラベル。 SQL AS節が指定されなかった場合、このラベルは列の名前cal
- 日付を作成するのに使うjava.util.Calendar
オブジェクト- 戻り値:
java.sql.Date
オブジェクトとして表された列の値。値がSQLNULL
の場合、返される値はJavaプログラミング言語のnull
- 例外:
SQLException
- columnLabelが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされた結果セットで呼び出された場合- 導入されたバージョン:
- 1.2
-
getTime
Time getTime(int columnIndex, Calendar cal) throws SQLExceptionこのResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のjava.sql.Time
オブジェクトとして取り出します。 基になるデータベースがタイムゾーン情報を格納していない場合、このメソッドは指定されたカレンダを使って時間に適切なミリ秒値を作成します。- パラメータ:
columnIndex
- 最初の列は1、2番目の列は2、... となるcal
- 時間を作成するのに使うjava.util.Calendar
オブジェクト- 戻り値:
java.sql.Time
オブジェクトとして表された列の値。値がSQLNULL
の場合、返される値はJavaプログラミング言語のnull
- 例外:
SQLException
- columnIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされた結果セットで呼び出された場合- 導入されたバージョン:
- 1.2
-
getTime
Time getTime(String columnLabel, Calendar cal) throws SQLExceptionこのResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のjava.sql.Time
オブジェクトとして取り出します。 基になるデータベースがタイムゾーン情報を格納していない場合、このメソッドは指定されたカレンダを使って時間に適切なミリ秒値を作成します。- パラメータ:
columnLabel
- SQL AS節として指定された列のラベル。 SQL AS節が指定されなかった場合、このラベルは列の名前cal
- 時間を作成するのに使うjava.util.Calendar
オブジェクト- 戻り値:
java.sql.Time
オブジェクトとして表された列の値。値がSQLNULL
の場合、返される値はJavaプログラミング言語のnull
- 例外:
SQLException
- columnLabelが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされた結果セットで呼び出された場合- 導入されたバージョン:
- 1.2
-
getTimestamp
Timestamp getTimestamp(int columnIndex, Calendar cal) throws SQLExceptionこのResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のjava.sql.Timestamp
オブジェクトとして取り出します。 基になるデータベースがタイムゾーン情報を格納していない場合、このメソッドは指定されたカレンダを使ってタイムスタンプに適切なミリ秒値を作成します。- パラメータ:
columnIndex
- 最初の列は1、2番目の列は2、... となるcal
- タイムスタンプを作成するのに使うjava.util.Calendar
オブジェクト- 戻り値:
java.sql.Timestamp
オブジェクトとして表された列の値。値がSQLNULL
の場合、返される値はJavaプログラミング言語のnull
- 例外:
SQLException
- columnIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされた結果セットで呼び出された場合- 導入されたバージョン:
- 1.2
-
getTimestamp
Timestamp getTimestamp(String columnLabel, Calendar cal) throws SQLExceptionこのResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のjava.sql.Timestamp
オブジェクトとして取り出します。 基になるデータベースがタイムゾーン情報を格納していない場合、このメソッドは指定されたカレンダを使ってタイムスタンプに適切なミリ秒値を作成します。- パラメータ:
columnLabel
- SQL AS節として指定された列のラベル。 SQL AS節が指定されなかった場合、このラベルは列の名前cal
- 日付を作成するのに使うjava.util.Calendar
オブジェクト- 戻り値:
java.sql.Timestamp
オブジェクトとして表された列の値。値がSQLNULL
の場合、返される値はJavaプログラミング言語のnull
- 例外:
SQLException
- columnLabelが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされた結果セットで呼び出された場合- 導入されたバージョン:
- 1.2
-
getURL
URL getURL(int columnIndex) throws SQLExceptionこのResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のjava.net.URL
オブジェクトとして取り出します。- パラメータ:
columnIndex
- 最初の列のインデックスは1、2番目の列のインデックスは2、などとする- 戻り値:
java.net.URL
オブジェクトとして表された列の値。値がSQLNULL
の場合、返される値はJavaプログラミング言語のnull
- 例外:
SQLException
- columnIndexが無効な場合、データベース・アクセス・エラーが発生した場合、このメソッドがクローズされた結果セットで呼び出された場合、またはURLが無効の場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.4
-
getURL
URL getURL(String columnLabel) throws SQLExceptionこのResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のjava.net.URL
オブジェクトとして取り出します。- パラメータ:
columnLabel
- SQL AS節として指定された列のラベル。 SQL AS節が指定されなかった場合、このラベルは列の名前- 戻り値:
java.net.URL
オブジェクトとして表された列の値。値がSQLNULL
の場合、返される値はJavaプログラミング言語のnull
- 例外:
SQLException
- columnLabelが無効な場合、データベース・アクセス・エラーが発生した場合、このメソッドがクローズされた結果セットで呼び出された場合、またはURLが無効の場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.4
-
updateRef
void updateRef(int columnIndex, Ref x) throws SQLException指定された列をjava.sql.Ref
値で更新します。 updaterメソッドは、現在行または挿入行の列値を更新するのに使用します。 updaterメソッドは基になるデータベースを更新しません。データベースを更新するには、代わりにupdateRow
またはinsertRow
メソッドを呼び出します。- パラメータ:
columnIndex
- 最初の列は1、2番目の列は2、... となるx
- 新しい列値- 例外:
SQLException
- columnIndexが無効な場合、データベース・アクセス・エラーが発生した場合、結果セットの並行処理がCONCUR_READ_ONLY
である場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.4
-
updateRef
void updateRef(String columnLabel, Ref x) throws SQLException指定された列をjava.sql.Ref
値で更新します。 updaterメソッドは、現在行または挿入行の列値を更新するのに使用します。 updaterメソッドは基になるデータベースを更新しません。データベースを更新するには、代わりにupdateRow
またはinsertRow
メソッドを呼び出します。- パラメータ:
columnLabel
- SQL AS節として指定された列のラベル。 SQL AS節が指定されなかった場合、このラベルは列の名前x
- 新しい列値- 例外:
SQLException
- columnLabelが無効な場合、データベース・アクセス・エラーが発生した場合、結果セットの並行処理がCONCUR_READ_ONLY
である場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.4
-
updateBlob
void updateBlob(int columnIndex, Blob x) throws SQLException指定された列をjava.sql.Blob
値で更新します。 updaterメソッドは、現在行または挿入行の列値を更新するのに使用します。 updaterメソッドは基になるデータベースを更新しません。データベースを更新するには、代わりにupdateRow
またはinsertRow
メソッドを呼び出します。- パラメータ:
columnIndex
- 最初の列は1、2番目の列は2、... となるx
- 新しい列値- 例外:
SQLException
- columnIndexが無効な場合、データベース・アクセス・エラーが発生した場合、結果セットの並行処理がCONCUR_READ_ONLY
である場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.4
-
updateBlob
void updateBlob(String columnLabel, Blob x) throws SQLException指定された列をjava.sql.Blob
値で更新します。 updaterメソッドは、現在行または挿入行の列値を更新するのに使用します。 updaterメソッドは基になるデータベースを更新しません。データベースを更新するには、代わりにupdateRow
またはinsertRow
メソッドを呼び出します。- パラメータ:
columnLabel
- SQL AS節として指定された列のラベル。 SQL AS節が指定されなかった場合、このラベルは列の名前x
- 新しい列値- 例外:
SQLException
- columnLabelが無効な場合、データベース・アクセス・エラーが発生した場合、結果セットの並行処理がCONCUR_READ_ONLY
である場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.4
-
updateClob
void updateClob(int columnIndex, Clob x) throws SQLException指定された列をjava.sql.Clob
値で更新します。 updaterメソッドは、現在行または挿入行の列値を更新するのに使用します。 updaterメソッドは基になるデータベースを更新しません。データベースを更新するには、代わりにupdateRow
またはinsertRow
メソッドを呼び出します。- パラメータ:
columnIndex
- 最初の列は1、2番目の列は2、... となるx
- 新しい列値- 例外:
SQLException
- columnIndexが無効な場合、データベース・アクセス・エラーが発生した場合、結果セットの並行処理がCONCUR_READ_ONLY
である場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.4
-
updateClob
void updateClob(String columnLabel, Clob x) throws SQLException指定された列をjava.sql.Clob
値で更新します。 updaterメソッドは、現在行または挿入行の列値を更新するのに使用します。 updaterメソッドは基になるデータベースを更新しません。データベースを更新するには、代わりにupdateRow
またはinsertRow
メソッドを呼び出します。- パラメータ:
columnLabel
- SQL AS節として指定された列のラベル。 SQL AS節が指定されなかった場合、このラベルは列の名前x
- 新しい列値- 例外:
SQLException
- columnLabelが無効な場合、データベース・アクセス・エラーが発生した場合、結果セットの並行処理がCONCUR_READ_ONLY
である場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.4
-
updateArray
void updateArray(int columnIndex, Array x) throws SQLException指定された列をjava.sql.Array
値で更新します。 updaterメソッドは、現在行または挿入行の列値を更新するのに使用します。 updaterメソッドは基になるデータベースを更新しません。データベースを更新するには、代わりにupdateRow
またはinsertRow
メソッドを呼び出します。- パラメータ:
columnIndex
- 最初の列は1、2番目の列は2、... となるx
- 新しい列値- 例外:
SQLException
- columnIndexが無効な場合、データベース・アクセス・エラーが発生した場合、結果セットの並行処理がCONCUR_READ_ONLY
である場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.4
-
updateArray
void updateArray(String columnLabel, Array x) throws SQLException指定された列をjava.sql.Array
値で更新します。 updaterメソッドは、現在行または挿入行の列値を更新するのに使用します。 updaterメソッドは基になるデータベースを更新しません。データベースを更新するには、代わりにupdateRow
またはinsertRow
メソッドを呼び出します。- パラメータ:
columnLabel
- SQL AS節として指定された列のラベル。 SQL AS節が指定されなかった場合、このラベルは列の名前x
- 新しい列値- 例外:
SQLException
- columnLabelが無効な場合、データベース・アクセス・エラーが発生した場合、結果セットの並行処理がCONCUR_READ_ONLY
である場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.4
-
getRowId
RowId getRowId(int columnIndex) throws SQLExceptionこのResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のjava.sql.RowId
オブジェクトとして取り出します。- パラメータ:
columnIndex
- 最初の列は1、2番目の列は2、... となる- 戻り値:
- 列値。値がSQL
NULL
の場合、返される値はnull
- 例外:
SQLException
- columnIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
getRowId
RowId getRowId(String columnLabel) throws SQLExceptionこのResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のjava.sql.RowId
オブジェクトとして取り出します。- パラメータ:
columnLabel
- SQL AS節として指定された列のラベル。 SQL AS節が指定されなかった場合、このラベルは列の名前- 戻り値:
- 列値。値がSQL
NULL
の場合、返される値はnull
- 例外:
SQLException
- columnLabelが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
updateRowId
void updateRowId(int columnIndex, RowId x) throws SQLException指定された列をRowId
値で更新します。 updaterメソッドは、現在行または挿入行の列値を更新するのに使用します。 updaterメソッドは基になるデータベースを更新しません。データベースを更新するには、代わりにupdateRow
またはinsertRow
メソッドを呼び出します。- パラメータ:
columnIndex
- 最初の列は1、2番目の列は2、... となるx
- 列値- 例外:
SQLException
- columnIndexが無効な場合、データベース・アクセス・エラーが発生した場合、結果セットの並行処理がCONCUR_READ_ONLY
である場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
updateRowId
void updateRowId(String columnLabel, RowId x) throws SQLException指定された列をRowId
値で更新します。 updaterメソッドは、現在行または挿入行の列値を更新するのに使用します。 updaterメソッドは基になるデータベースを更新しません。データベースを更新するには、代わりにupdateRow
またはinsertRow
メソッドを呼び出します。- パラメータ:
columnLabel
- SQL AS節として指定された列のラベル。 SQL AS節が指定されなかった場合、このラベルは列の名前x
- 列値- 例外:
SQLException
- columnLabelが無効な場合、データベース・アクセス・エラーが発生した場合、結果セットの並行処理がCONCUR_READ_ONLY
である場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
getHoldability
int getHoldability() throws SQLExceptionこのResultSet
オブジェクトの保持機能を取得します。- 戻り値:
ResultSet.HOLD_CURSORS_OVER_COMMIT
またはResultSet.CLOSE_CURSORS_AT_COMMIT
- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされた結果セットで呼び出された場合- 導入されたバージョン:
- 1.6
-
isClosed
boolean isClosed() throws SQLExceptionこのResultSet
オブジェクトがクローズされているかどうかを取得します。ResultSet
でcloseメソッドが呼び出されるか、または自動的にクローズされる場合、このオブジェクトはクローズされます。- 戻り値:
- この
ResultSet
オブジェクトがクローズされている場合はtrue、まだオープンの状態の場合はfalse - 例外:
SQLException
- データベース・アクセス・エラーが発生した場合- 導入されたバージョン:
- 1.6
-
updateNString
void updateNString(int columnIndex, String nString) throws SQLException指定された列をString
値で更新します。NCHAR
、NVARCHAR
、およびLONGNVARCHAR
列を更新するときに使用します。 updaterメソッドは、現在行または挿入行の列値を更新するのに使用します。 updaterメソッドは基になるデータベースを更新しません。データベースを更新するには、代わりにupdateRow
またはinsertRow
メソッドを呼び出します。- パラメータ:
columnIndex
- 最初の列は1、2番目の列は2、... となるnString
- 更新される列の値- 例外:
SQLException
- columnIndexが有効でない場合、ドライバが各国の文字セットをサポートしない場合、ドライバがデータ変換エラーが発生した可能性を検出できる場合、このメソッドがクローズされた結果セットで呼び出された場合、結果セットの並行処理がCONCUR_READ_ONLY
である場合、またはデータベース・アクセス・エラーが発生した場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
updateNString
void updateNString(String columnLabel, String nString) throws SQLException指定された列をString
値で更新します。NCHAR
、NVARCHAR
、およびLONGNVARCHAR
列を更新するときに使用します。 updaterメソッドは、現在行または挿入行の列値を更新するのに使用します。 updaterメソッドは基になるデータベースを更新しません。データベースを更新するには、代わりにupdateRow
またはinsertRow
メソッドを呼び出します。- パラメータ:
columnLabel
- SQL AS節として指定された列のラベル。 SQL AS節が指定されなかった場合、このラベルは列の名前nString
- 更新される列の値- 例外:
SQLException
- columnLabelが有効でない場合、ドライバが各国の文字セットをサポートしない場合、ドライバがデータ変換エラーが発生した可能性を検出できる場合、このメソッドがクローズされた結果セットで呼び出された場合、結果セットの並行処理がCONCUR_READ_ONLY
である場合、またはデータベース・アクセス・エラーが発生した場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
updateNClob
void updateNClob(int columnIndex, NClob nClob) throws SQLException指定された列をjava.sql.NClob
値で更新します。 updaterメソッドは、現在行または挿入行の列値を更新するのに使用します。 updaterメソッドは基になるデータベースを更新しません。データベースを更新するには、代わりにupdateRow
またはinsertRow
メソッドを呼び出します。- パラメータ:
columnIndex
- 最初の列は1、2番目の列は2、... となるnClob
- 更新される列の値- 例外:
SQLException
- columnIndexが有効でない場合、ドライバが各国の文字セットをサポートしない場合、ドライバがデータ変換エラーが発生した可能性を検出できる場合、このメソッドがクローズされた結果セットで呼び出された場合、データベース・アクセス・エラーが発生した場合、または結果セットの並行処理がCONCUR_READ_ONLY
である場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
updateNClob
void updateNClob(String columnLabel, NClob nClob) throws SQLException指定された列をjava.sql.NClob
値で更新します。 updaterメソッドは、現在行または挿入行の列値を更新するのに使用します。 updaterメソッドは基になるデータベースを更新しません。データベースを更新するには、代わりにupdateRow
またはinsertRow
メソッドを呼び出します。- パラメータ:
columnLabel
- SQL AS節として指定された列のラベル。 SQL AS節が指定されなかった場合、このラベルは列の名前nClob
- 更新される列の値- 例外:
SQLException
- columnLabelが有効でない場合、ドライバが各国の文字セットをサポートしない場合、ドライバがデータ変換エラーが発生した可能性を検出できる場合、このメソッドがクローズされた結果セットで呼び出された場合、データベース・アクセス・エラーが発生した場合、または結果セットの並行処理がCONCUR_READ_ONLY
である場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
getNClob
NClob getNClob(int columnIndex) throws SQLExceptionこのResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のNClob
オブジェクトとして取り出します。- パラメータ:
columnIndex
- 最初の列は1、2番目の列は2、... となる- 戻り値:
- 指定された列のSQL
NCLOB
値を表すNClob
オブジェクト - 例外:
SQLException
- columnIndexが有効でない場合、ドライバが各国の文字セットをサポートしない場合、ドライバがデータ変換エラーが発生した可能性を検出できる場合、このメソッドがクローズされた結果セットで呼び出された場合、またはデータベース・アクセス・エラーが発生した場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
getNClob
NClob getNClob(String columnLabel) throws SQLExceptionこのResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のNClob
オブジェクトとして取り出します。- パラメータ:
columnLabel
- SQL AS節として指定された列のラベル。 SQL AS節が指定されなかった場合、このラベルは列の名前- 戻り値:
- 指定された列のSQL
NCLOB
値を表すNClob
オブジェクト - 例外:
SQLException
- columnLabelが有効でない場合、ドライバが各国の文字セットをサポートしない場合、ドライバがデータ変換エラーが発生した可能性を検出できる場合、このメソッドがクローズされた結果セットで呼び出された場合、またはデータベース・アクセス・エラーが発生した場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
getSQLXML
SQLXML getSQLXML(int columnIndex) throws SQLExceptionこのResultSet
の現在行にある指定された列の値を、Javaプログラミング言語のjava.sql.SQLXML
オブジェクトとして取り出します。- パラメータ:
columnIndex
- 最初の列は1、2番目の列は2、... となる- 戻り値:
SQL XML
値をマッピングするSQLXML
オブジェクト- 例外:
SQLException
- columnIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
getSQLXML
SQLXML getSQLXML(String columnLabel) throws SQLExceptionこのResultSet
の現在行にある指定された列の値を、Javaプログラミング言語のjava.sql.SQLXML
オブジェクトとして取り出します。- パラメータ:
columnLabel
- SQL AS節として指定された列のラベル。 SQL AS節が指定されなかった場合、このラベルは列の名前- 戻り値:
SQL XML
値をマッピングするSQLXML
オブジェクト- 例外:
SQLException
- columnLabelが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
updateSQLXML
void updateSQLXML(int columnIndex, SQLXML xmlObject) throws SQLException指定された列をjava.sql.SQLXML
値で更新します。 updaterメソッドは、現在行または挿入行の列値を更新するのに使用します。 updaterメソッドは基になるデータベースを更新しません。データベースを更新するには、代わりにupdateRow
またはinsertRow
メソッドを呼び出します。- パラメータ:
columnIndex
- 最初の列は1、2番目の列は2、... となるxmlObject
- 更新される列の値- 例外:
SQLException
- columnIndexが有効でない場合、データベース・アクセス・エラーが発生した場合、このメソッドがクローズされた結果セットで呼び出された場合、SQLXML
オブジェクト用のjava.xml.transform.Result
、Writer
、またはOutputStream
がクローズされていない場合、あるいはXML値の処理中にエラーが発生したか、結果セットの並行処理がCONCUR_READ_ONLY
である場合。 この例外のgetCause
メソッドにより、より詳細な例外が提供されることがある(たとえばストリームに有効なXMLが含まれていない場合)。SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
updateSQLXML
void updateSQLXML(String columnLabel, SQLXML xmlObject) throws SQLException指定された列をjava.sql.SQLXML
値で更新します。 updaterメソッドは、現在行または挿入行の列値を更新するのに使用します。 updaterメソッドは基になるデータベースを更新しません。データベースを更新するには、代わりにupdateRow
またはinsertRow
メソッドを呼び出します。- パラメータ:
columnLabel
- SQL AS節として指定された列のラベル。 SQL AS節が指定されなかった場合、このラベルは列の名前xmlObject
- 列値- 例外:
SQLException
- columnLabelが有効でない場合、データベース・アクセス・エラーが発生した場合、このメソッドがクローズされた結果セットで呼び出された場合、SQLXML
オブジェクト用のjava.xml.transform.Result
、Writer
、またはOutputStream
がクローズされていない場合、あるいはXML値の処理中にエラーが発生したか、結果セットの並行処理がCONCUR_READ_ONLY
である場合。 この例外のgetCause
メソッドにより、より詳細な例外が提供されることがある(たとえばストリームに有効なXMLが含まれていない場合)。SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
getNString
String getNString(int columnIndex) throws SQLExceptionこのResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のString
として取り出します。NCHAR
、NVARCHAR
、およびLONGNVARCHAR
列にアクセスするときに使用します。- パラメータ:
columnIndex
- 最初の列は1、2番目の列は2、... となる- 戻り値:
- 列値。値がSQL
NULL
の場合、返される値はnull
- 例外:
SQLException
- columnIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
getNString
String getNString(String columnLabel) throws SQLExceptionこのResultSet
オブジェクトの現在行にある指定された列の値を、Javaプログラミング言語のString
として取り出します。NCHAR
、NVARCHAR
、およびLONGNVARCHAR
列にアクセスするときに使用します。- パラメータ:
columnLabel
- SQL AS節として指定された列のラベル。 SQL AS節が指定されなかった場合、このラベルは列の名前- 戻り値:
- 列値。値がSQL
NULL
の場合、返される値はnull
- 例外:
SQLException
- columnLabelが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
getNCharacterStream
Reader getNCharacterStream(int columnIndex) throws SQLExceptionこのResultSet
オブジェクトの現在行にある指定された列の値をjava.io.Reader
オブジェクトとして取り出します。NCHAR
、NVARCHAR
、およびLONGNVARCHAR
列にアクセスするときに使用します。- パラメータ:
columnIndex
- 最初の列は1、2番目の列は2、... となる- 戻り値:
- 列値を格納する
java.io.Reader
オブジェクト。値がSQLNULL
の場合、返される値はJavaプログラミング言語のnull
- 例外:
SQLException
- columnIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
getNCharacterStream
Reader getNCharacterStream(String columnLabel) throws SQLExceptionこのResultSet
オブジェクトの現在行にある指定された列の値をjava.io.Reader
オブジェクトとして取り出します。NCHAR
、NVARCHAR
、およびLONGNVARCHAR
列にアクセスするときに使用します。- パラメータ:
columnLabel
- SQL AS節として指定された列のラベル。 SQL AS節が指定されなかった場合、このラベルは列の名前- 戻り値:
- 列値を格納する
java.io.Reader
オブジェクト。値がSQLNULL
の場合、返される値はJavaプログラミング言語のnull
- 例外:
SQLException
- columnLabelが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
updateNCharacterStream
void updateNCharacterStream(int columnIndex, Reader x, long length) throws SQLException指定された列を、指定されたバイト数を持つ文字ストリーム値で更新します。 ドライバは、必要に応じて、Javaの文字表現をデータベース内の各国文字セットに変換します。NCHAR
、NVARCHAR
、およびLONGNVARCHAR
列を更新するときに使用します。updaterメソッドは、現在行または挿入行の列値を更新するのに使用します。 updaterメソッドは基になるデータベースを更新しません。データベースを更新するには、代わりに
updateRow
またはinsertRow
メソッドを呼び出します。- パラメータ:
columnIndex
- 最初の列は1、2番目の列は2、... となるx
- 新しい列値length
- ストリームの長さ- 例外:
SQLException
- columnIndexが無効な場合、データベース・アクセス・エラーが発生した場合、結果セットの並行処理がCONCUR_READ_ONLY
である場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
updateNCharacterStream
void updateNCharacterStream(String columnLabel, Reader reader, long length) throws SQLException指定された列を、指定されたバイト数を持つ文字ストリーム値で更新します。 ドライバは、必要に応じて、Javaの文字表現をデータベース内の各国文字セットに変換します。NCHAR
、NVARCHAR
、およびLONGNVARCHAR
列を更新するときに使用します。updaterメソッドは、現在行または挿入行の列値を更新するのに使用します。 updaterメソッドは基になるデータベースを更新しません。データベースを更新するには、代わりに
updateRow
またはinsertRow
メソッドを呼び出します。- パラメータ:
columnLabel
- SQL AS節として指定された列のラベル。 SQL AS節が指定されなかった場合、このラベルは列の名前reader
- 新しい列値を格納するjava.io.Reader
オブジェクトlength
- ストリームの長さ- 例外:
SQLException
- columnLabelが無効な場合、データベース・アクセス・エラーが発生した場合、結果セットの並行処理がCONCUR_READ_ONLY
である場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
updateAsciiStream
void updateAsciiStream(int columnIndex, InputStream x, long length) throws SQLException指定された列を、指定されたバイト数を持つasciiストリーム値で更新します。updaterメソッドは、現在行または挿入行の列値を更新するのに使用します。 updaterメソッドは基になるデータベースを更新しません。データベースを更新するには、代わりに
updateRow
またはinsertRow
メソッドを呼び出します。- パラメータ:
columnIndex
- 最初の列は1、2番目の列は2、... となるx
- 新しい列値length
- ストリームの長さ- 例外:
SQLException
- columnIndexが無効な場合、データベース・アクセス・エラーが発生した場合、結果セットの並行処理がCONCUR_READ_ONLY
である場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
updateBinaryStream
void updateBinaryStream(int columnIndex, InputStream x, long length) throws SQLException指定された列を、指定されたバイト数を持つバイナリ・ストリーム値で更新します。updaterメソッドは、現在行または挿入行の列値を更新するのに使用します。 updaterメソッドは基になるデータベースを更新しません。データベースを更新するには、代わりに
updateRow
またはinsertRow
メソッドを呼び出します。- パラメータ:
columnIndex
- 最初の列は1、2番目の列は2、... となるx
- 新しい列値length
- ストリームの長さ- 例外:
SQLException
- columnIndexが無効な場合、データベース・アクセス・エラーが発生した場合、結果セットの並行処理がCONCUR_READ_ONLY
である場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
updateCharacterStream
void updateCharacterStream(int columnIndex, Reader x, long length) throws SQLException指定された列を、指定されたバイト数を持つ文字ストリーム値で更新します。updaterメソッドは、現在行または挿入行の列値を更新するのに使用します。 updaterメソッドは基になるデータベースを更新しません。データベースを更新するには、代わりに
updateRow
またはinsertRow
メソッドを呼び出します。- パラメータ:
columnIndex
- 最初の列は1、2番目の列は2、... となるx
- 新しい列値length
- ストリームの長さ- 例外:
SQLException
- columnIndexが無効な場合、データベース・アクセス・エラーが発生した場合、結果セットの並行処理がCONCUR_READ_ONLY
である場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
updateAsciiStream
void updateAsciiStream(String columnLabel, InputStream x, long length) throws SQLException指定された列を、指定されたバイト数を持つasciiストリーム値で更新します。updaterメソッドは、現在行または挿入行の列値を更新するのに使用します。 updaterメソッドは基になるデータベースを更新しません。データベースを更新するには、代わりに
updateRow
またはinsertRow
メソッドを呼び出します。- パラメータ:
columnLabel
- SQL AS節として指定された列のラベル。 SQL AS節が指定されなかった場合、このラベルは列の名前x
- 新しい列値length
- ストリームの長さ- 例外:
SQLException
- columnLabelが無効な場合、データベース・アクセス・エラーが発生した場合、結果セットの並行処理がCONCUR_READ_ONLY
である場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
updateBinaryStream
void updateBinaryStream(String columnLabel, InputStream x, long length) throws SQLException指定された列を、指定されたバイト数を持つバイナリ・ストリーム値で更新します。updaterメソッドは、現在行または挿入行の列値を更新するのに使用します。 updaterメソッドは基になるデータベースを更新しません。データベースを更新するには、代わりに
updateRow
またはinsertRow
メソッドを呼び出します。- パラメータ:
columnLabel
- SQL AS節として指定された列のラベル。 SQL AS節が指定されなかった場合、このラベルは列の名前x
- 新しい列値length
- ストリームの長さ- 例外:
SQLException
- columnLabelが無効な場合、データベース・アクセス・エラーが発生した場合、結果セットの並行処理がCONCUR_READ_ONLY
である場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
updateCharacterStream
void updateCharacterStream(String columnLabel, Reader reader, long length) throws SQLException指定された列を、指定されたバイト数を持つ文字ストリーム値で更新します。updaterメソッドは、現在行または挿入行の列値を更新するのに使用します。 updaterメソッドは基になるデータベースを更新しません。データベースを更新するには、代わりに
updateRow
またはinsertRow
メソッドを呼び出します。- パラメータ:
columnLabel
- SQL AS節として指定された列のラベル。 SQL AS節が指定されなかった場合、このラベルは列の名前reader
- 新しい列値を格納するjava.io.Reader
オブジェクトlength
- ストリームの長さ- 例外:
SQLException
- columnLabelが無効な場合、データベース・アクセス・エラーが発生した場合、結果セットの並行処理がCONCUR_READ_ONLY
である場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
updateBlob
void updateBlob(int columnIndex, InputStream inputStream, long length) throws SQLException指定された列を、指定されたバイト数を持つ指定された入力ストリームを使用して更新します。updaterメソッドは、現在行または挿入行の列値を更新するのに使用します。 updaterメソッドは基になるデータベースを更新しません。データベースを更新するには、代わりに
updateRow
またはinsertRow
メソッドを呼び出します。- パラメータ:
columnIndex
- 最初の列は1、2番目の列は2、... となるinputStream
- パラメータ値に設定されるデータを含むオブジェクト。length
- パラメータ・データ内のバイト数。- 例外:
SQLException
- columnIndexが無効な場合、データベース・アクセス・エラーが発生した場合、結果セットの並行処理がCONCUR_READ_ONLY
である場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
updateBlob
void updateBlob(String columnLabel, InputStream inputStream, long length) throws SQLException指定された列を、指定されたバイト数を持つ指定された入力ストリームを使用して更新します。updaterメソッドは、現在行または挿入行の列値を更新するのに使用します。 updaterメソッドは基になるデータベースを更新しません。データベースを更新するには、代わりに
updateRow
またはinsertRow
メソッドを呼び出します。- パラメータ:
columnLabel
- SQL AS節として指定された列のラベル。 SQL AS節が指定されなかった場合、このラベルは列の名前inputStream
- パラメータ値に設定されるデータを含むオブジェクト。length
- パラメータ・データ内のバイト数。- 例外:
SQLException
- columnLabelが無効な場合、データベース・アクセス・エラーが発生した場合、結果セットの並行処理がCONCUR_READ_ONLY
である場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
updateClob
void updateClob(int columnIndex, Reader reader, long length) throws SQLException指定された列を、指定された文字数である指定されたReader
オブジェクトを使用して更新します。LONGVARCHAR
パラメータに非常に大きなUNICODE値が入力されるときには、java.io.Reader
オブジェクトを介して送るのが現実的です。 JDBCドライバは、データをUNICODEからデータベースのchar形式に変換します。updaterメソッドは、現在行または挿入行の列値を更新するのに使用します。 updaterメソッドは基になるデータベースを更新しません。データベースを更新するには、代わりに
updateRow
またはinsertRow
メソッドを呼び出します。- パラメータ:
columnIndex
- 最初の列は1、2番目の列は2、... となるreader
- パラメータ値に設定されるデータを含むオブジェクト。length
- パラメータ・データ内の文字数。- 例外:
SQLException
- columnIndexが無効な場合、データベース・アクセス・エラーが発生した場合、結果セットの並行処理がCONCUR_READ_ONLY
である場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
updateClob
void updateClob(String columnLabel, Reader reader, long length) throws SQLException指定された列を、指定された文字数である指定されたReader
オブジェクトを使用して更新します。LONGVARCHAR
パラメータに非常に大きなUNICODE値が入力されるときには、java.io.Reader
オブジェクトを介して送るのが現実的です。 JDBCドライバは、データをUNICODEからデータベースのchar形式に変換します。updaterメソッドは、現在行または挿入行の列値を更新するのに使用します。 updaterメソッドは基になるデータベースを更新しません。データベースを更新するには、代わりに
updateRow
またはinsertRow
メソッドを呼び出します。- パラメータ:
columnLabel
- SQL AS節として指定された列のラベル。 SQL AS節が指定されなかった場合、このラベルは列の名前reader
- パラメータ値に設定されるデータを含むオブジェクト。length
- パラメータ・データ内の文字数。- 例外:
SQLException
- columnLabelが無効な場合、データベース・アクセス・エラーが発生した場合、結果セットの並行処理がCONCUR_READ_ONLY
である場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
updateNClob
void updateNClob(int columnIndex, Reader reader, long length) throws SQLException指定された列を、指定された文字数である指定されたReader
オブジェクトを使用して更新します。LONGVARCHAR
パラメータに非常に大きなUNICODE値が入力されるときには、java.io.Reader
オブジェクトを介して送るのが現実的です。 JDBCドライバは、データをUNICODEからデータベースのchar形式に変換します。updaterメソッドは、現在行または挿入行の列値を更新するのに使用します。 updaterメソッドは基になるデータベースを更新しません。データベースを更新するには、代わりに
updateRow
またはinsertRow
メソッドを呼び出します。- パラメータ:
columnIndex
- 最初の列は1、2番目の列は2、... となるreader
- パラメータ値に設定されるデータを含むオブジェクト。length
- パラメータ・データ内の文字数。- 例外:
SQLException
- columnIndexが有効でない場合、ドライバが各国の文字セットをサポートしない場合、ドライバがデータ変換エラーが発生した可能性を検出できる場合、このメソッドがクローズされた結果セットで呼び出された場合、データベース・アクセス・エラーが発生した場合、または結果セットの並行処理がCONCUR_READ_ONLY
である場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
updateNClob
void updateNClob(String columnLabel, Reader reader, long length) throws SQLException指定された列を、指定された文字数である指定されたReader
オブジェクトを使用して更新します。LONGVARCHAR
パラメータに非常に大きなUNICODE値が入力されるときには、java.io.Reader
オブジェクトを介して送るのが現実的です。 JDBCドライバは、データをUNICODEからデータベースのchar形式に変換します。updaterメソッドは、現在行または挿入行の列値を更新するのに使用します。 updaterメソッドは基になるデータベースを更新しません。データベースを更新するには、代わりに
updateRow
またはinsertRow
メソッドを呼び出します。- パラメータ:
columnLabel
- SQL AS節として指定された列のラベル。 SQL AS節が指定されなかった場合、このラベルは列の名前reader
- パラメータ値に設定されるデータを含むオブジェクト。length
- パラメータ・データ内の文字数。- 例外:
SQLException
- columnLabelが有効でない場合、ドライバが各国の文字セットをサポートしない場合、ドライバがデータ変換エラーが発生した可能性を検出できる場合、このメソッドがクローズされた結果セットで呼び出された場合、データベース・アクセス・エラーが発生した場合、または結果セットの並行処理がCONCUR_READ_ONLY
である場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
updateNCharacterStream
void updateNCharacterStream(int columnIndex, Reader x) throws SQLException指定された列を文字ストリーム値で更新します。 ストリームの終わりに達するまで必要に応じてストリームからデータが読み込まれます。 ドライバは、必要に応じて、Javaの文字表現をデータベース内の各国文字セットに変換します。NCHAR
、NVARCHAR
、およびLONGNVARCHAR
列を更新するときに使用します。updaterメソッドは、現在行または挿入行の列値を更新するのに使用します。 updaterメソッドは基になるデータベースを更新しません。データベースを更新するには、代わりに
updateRow
またはinsertRow
メソッドを呼び出します。ノート: lengthパラメータを使用するバージョンの
updateNCharacterStream
を使用する方が効率的かどうかを判断するには、JDBCドライバのドキュメントを参照してください。- パラメータ:
columnIndex
- 最初の列は1、2番目の列は2、... となるx
- 新しい列値- 例外:
SQLException
- columnIndexが無効な場合、データベース・アクセス・エラーが発生した場合、結果セットの並行処理がCONCUR_READ_ONLY
である場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
updateNCharacterStream
void updateNCharacterStream(String columnLabel, Reader reader) throws SQLException指定された列を文字ストリーム値で更新します。 ストリームの終わりに達するまで必要に応じてストリームからデータが読み込まれます。 ドライバは、必要に応じて、Javaの文字表現をデータベース内の各国文字セットに変換します。NCHAR
、NVARCHAR
、およびLONGNVARCHAR
列を更新するときに使用します。updaterメソッドは、現在行または挿入行の列値を更新するのに使用します。 updaterメソッドは基になるデータベースを更新しません。データベースを更新するには、代わりに
updateRow
またはinsertRow
メソッドを呼び出します。ノート: lengthパラメータを使用するバージョンの
updateNCharacterStream
を使用する方が効率的かどうかを判断するには、JDBCドライバのドキュメントを参照してください。- パラメータ:
columnLabel
- SQL AS節として指定された列のラベル。 SQL AS節が指定されなかった場合、このラベルは列の名前reader
- 新しい列値を格納するjava.io.Reader
オブジェクト- 例外:
SQLException
- columnLabelが無効な場合、データベース・アクセス・エラーが発生した場合、結果セットの並行処理がCONCUR_READ_ONLY
である場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
updateAsciiStream
void updateAsciiStream(int columnIndex, InputStream x) throws SQLException指定された列をASCIIストリーム値で更新します。 ストリームの終わりに達するまで必要に応じてストリームからデータが読み込まれます。updaterメソッドは、現在行または挿入行の列値を更新するのに使用します。 updaterメソッドは基になるデータベースを更新しません。データベースを更新するには、代わりに
updateRow
またはinsertRow
メソッドを呼び出します。ノート: lengthパラメータを使用するバージョンの
updateAsciiStream
を使用する方が効率的かどうかを判断するには、JDBCドライバのドキュメントを参照してください。- パラメータ:
columnIndex
- 最初の列は1、2番目の列は2、... となるx
- 新しい列値- 例外:
SQLException
- columnIndexが無効な場合、データベース・アクセス・エラーが発生した場合、結果セットの並行処理がCONCUR_READ_ONLY
である場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
updateBinaryStream
void updateBinaryStream(int columnIndex, InputStream x) throws SQLException指定された列をバイナリ・ストリーム値で更新します。 ストリームの終わりに達するまで必要に応じてストリームからデータが読み込まれます。updaterメソッドは、現在行または挿入行の列値を更新するのに使用します。 updaterメソッドは基になるデータベースを更新しません。データベースを更新するには、代わりに
updateRow
またはinsertRow
メソッドを呼び出します。ノート: lengthパラメータを使用するバージョンの
updateBinaryStream
を使用する方が効率的かどうかを判断するには、JDBCドライバのドキュメントを参照してください。- パラメータ:
columnIndex
- 最初の列は1、2番目の列は2、... となるx
- 新しい列値- 例外:
SQLException
- columnIndexが無効な場合、データベース・アクセス・エラーが発生した場合、結果セットの並行処理がCONCUR_READ_ONLY
である場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
updateCharacterStream
void updateCharacterStream(int columnIndex, Reader x) throws SQLException指定された列を文字ストリーム値で更新します。 ストリームの終わりに達するまで必要に応じてストリームからデータが読み込まれます。updaterメソッドは、現在行または挿入行の列値を更新するのに使用します。 updaterメソッドは基になるデータベースを更新しません。データベースを更新するには、代わりに
updateRow
またはinsertRow
メソッドを呼び出します。ノート: lengthパラメータを使用するバージョンの
updateCharacterStream
を使用する方が効率的かどうかを判断するには、JDBCドライバのドキュメントを参照してください。- パラメータ:
columnIndex
- 最初の列は1、2番目の列は2、... となるx
- 新しい列値- 例外:
SQLException
- columnIndexが無効な場合、データベース・アクセス・エラーが発生した場合、結果セットの並行処理がCONCUR_READ_ONLY
である場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
updateAsciiStream
void updateAsciiStream(String columnLabel, InputStream x) throws SQLException指定された列をASCIIストリーム値で更新します。 ストリームの終わりに達するまで必要に応じてストリームからデータが読み込まれます。updaterメソッドは、現在行または挿入行の列値を更新するのに使用します。 updaterメソッドは基になるデータベースを更新しません。データベースを更新するには、代わりに
updateRow
またはinsertRow
メソッドを呼び出します。ノート: lengthパラメータを使用するバージョンの
updateAsciiStream
を使用する方が効率的かどうかを判断するには、JDBCドライバのドキュメントを参照してください。- パラメータ:
columnLabel
- SQL AS節として指定された列のラベル。 SQL AS節が指定されなかった場合、このラベルは列の名前x
- 新しい列値- 例外:
SQLException
- columnLabelが無効な場合、データベース・アクセス・エラーが発生した場合、結果セットの並行処理がCONCUR_READ_ONLY
である場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
updateBinaryStream
void updateBinaryStream(String columnLabel, InputStream x) throws SQLException指定された列をバイナリ・ストリーム値で更新します。 ストリームの終わりに達するまで必要に応じてストリームからデータが読み込まれます。updaterメソッドは、現在行または挿入行の列値を更新するのに使用します。 updaterメソッドは基になるデータベースを更新しません。データベースを更新するには、代わりに
updateRow
またはinsertRow
メソッドを呼び出します。ノート: lengthパラメータを使用するバージョンの
updateBinaryStream
を使用する方が効率的かどうかを判断するには、JDBCドライバのドキュメントを参照してください。- パラメータ:
columnLabel
- SQL AS節として指定された列のラベル。 SQL AS節が指定されなかった場合、このラベルは列の名前x
- 新しい列値- 例外:
SQLException
- columnLabelが無効な場合、データベース・アクセス・エラーが発生した場合、結果セットの並行処理がCONCUR_READ_ONLY
である場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
updateCharacterStream
void updateCharacterStream(String columnLabel, Reader reader) throws SQLException指定された列を文字ストリーム値で更新します。 ストリームの終わりに達するまで必要に応じてストリームからデータが読み込まれます。updaterメソッドは、現在行または挿入行の列値を更新するのに使用します。 updaterメソッドは基になるデータベースを更新しません。データベースを更新するには、代わりに
updateRow
またはinsertRow
メソッドを呼び出します。ノート: lengthパラメータを使用するバージョンの
updateCharacterStream
を使用する方が効率的かどうかを判断するには、JDBCドライバのドキュメントを参照してください。- パラメータ:
columnLabel
- SQL AS節として指定された列のラベル。 SQL AS節が指定されなかった場合、このラベルは列の名前reader
- 新しい列値を格納するjava.io.Reader
オブジェクト- 例外:
SQLException
- columnLabelが無効な場合、データベース・アクセス・エラーが発生した場合、結果セットの並行処理がCONCUR_READ_ONLY
である場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
updateBlob
void updateBlob(int columnIndex, InputStream inputStream) throws SQLException指定された列を、指定された入力ストリームを使用して更新します。 ストリームの終わりに達するまで必要に応じてストリームからデータが読み込まれます。updaterメソッドは、現在行または挿入行の列値を更新するのに使用します。 updaterメソッドは基になるデータベースを更新しません。データベースを更新するには、代わりに
updateRow
またはinsertRow
メソッドを呼び出します。ノート: lengthパラメータを使用するバージョンの
updateBlob
を使用する方が効率的かどうかを判断するには、JDBCドライバのドキュメントを参照してください。- パラメータ:
columnIndex
- 最初の列は1、2番目の列は2、... となるinputStream
- パラメータ値に設定されるデータを含むオブジェクト。- 例外:
SQLException
- columnIndexが無効な場合、データベース・アクセス・エラーが発生した場合、結果セットの並行処理がCONCUR_READ_ONLY
である場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
updateBlob
void updateBlob(String columnLabel, InputStream inputStream) throws SQLException指定された列を、指定された入力ストリームを使用して更新します。 ストリームの終わりに達するまで必要に応じてストリームからデータが読み込まれます。updaterメソッドは、現在行または挿入行の列値を更新するのに使用します。 updaterメソッドは基になるデータベースを更新しません。データベースを更新するには、代わりに
updateRow
またはinsertRow
メソッドを呼び出します。ノート: lengthパラメータを使用するバージョンの
updateBlob
を使用する方が効率的かどうかを判断するには、JDBCドライバのドキュメントを参照してください。- パラメータ:
columnLabel
- SQL AS節として指定された列のラベル。 SQL AS節が指定されなかった場合、このラベルは列の名前inputStream
- パラメータ値に設定されるデータを含むオブジェクト。- 例外:
SQLException
- columnLabelが無効な場合、データベース・アクセス・エラーが発生した場合、結果セットの並行処理がCONCUR_READ_ONLY
である場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
updateClob
void updateClob(int columnIndex, Reader reader) throws SQLException指定された列を、指定されたReader
オブジェクトを使用して更新します。 ストリームの終わりに達するまで必要に応じてストリームからデータが読み込まれます。 JDBCドライバは、データをUNICODEからデータベースのchar形式に変換します。updaterメソッドは、現在行または挿入行の列値を更新するのに使用します。 updaterメソッドは基になるデータベースを更新しません。データベースを更新するには、代わりに
updateRow
またはinsertRow
メソッドを呼び出します。ノート: lengthパラメータを使用するバージョンの
updateClob
を使用する方が効率的かどうかを判断するには、JDBCドライバのドキュメントを参照してください。- パラメータ:
columnIndex
- 最初の列は1、2番目の列は2、... となるreader
- パラメータ値に設定されるデータを含むオブジェクト。- 例外:
SQLException
- columnIndexが無効な場合、データベース・アクセス・エラーが発生した場合、結果セットの並行処理がCONCUR_READ_ONLY
である場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
updateClob
void updateClob(String columnLabel, Reader reader) throws SQLException指定された列を、指定されたReader
オブジェクトを使用して更新します。 ストリームの終わりに達するまで必要に応じてストリームからデータが読み込まれます。 JDBCドライバは、データをUNICODEからデータベースのchar形式に変換します。updaterメソッドは、現在行または挿入行の列値を更新するのに使用します。 updaterメソッドは基になるデータベースを更新しません。データベースを更新するには、代わりに
updateRow
またはinsertRow
メソッドを呼び出します。ノート: lengthパラメータを使用するバージョンの
updateClob
を使用する方が効率的かどうかを判断するには、JDBCドライバのドキュメントを参照してください。- パラメータ:
columnLabel
- SQL AS節として指定された列のラベル。 SQL AS節が指定されなかった場合、このラベルは列の名前reader
- パラメータ値に設定されるデータを含むオブジェクト。- 例外:
SQLException
- columnLabelが無効な場合、データベース・アクセス・エラーが発生した場合、結果セットの並行処理がCONCUR_READ_ONLY
である場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
updateNClob
void updateNClob(int columnIndex, Reader reader) throws SQLException指定された列を、指定されたReader
を使用して更新します。ストリームの終わりに達するまで必要に応じてストリームからデータが読み込まれます。 JDBCドライバは、データをUNICODEからデータベースのchar形式に変換します。updaterメソッドは、現在行または挿入行の列値を更新するのに使用します。 updaterメソッドは基になるデータベースを更新しません。データベースを更新するには、代わりに
updateRow
またはinsertRow
メソッドを呼び出します。ノート: lengthパラメータを使用するバージョンの
updateNClob
を使用する方が効率的かどうかを判断するには、JDBCドライバのドキュメントを参照してください。- パラメータ:
columnIndex
- 最初の列は1、2番目の列は2、... となるreader
- パラメータ値に設定されるデータを含むオブジェクト。- 例外:
SQLException
- columnIndexが有効でない場合、ドライバが各国の文字セットをサポートしない場合、ドライバがデータ変換エラーが発生した可能性を検出できる場合、このメソッドがクローズされた結果セットで呼び出された場合、データベース・アクセス・エラーが発生した場合、または結果セットの並行処理がCONCUR_READ_ONLY
である場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
updateNClob
void updateNClob(String columnLabel, Reader reader) throws SQLException指定された列を、指定されたReader
オブジェクトを使用して更新します。 ストリームの終わりに達するまで必要に応じてストリームからデータが読み込まれます。 JDBCドライバは、データをUNICODEからデータベースのchar形式に変換します。updaterメソッドは、現在行または挿入行の列値を更新するのに使用します。 updaterメソッドは基になるデータベースを更新しません。データベースを更新するには、代わりに
updateRow
またはinsertRow
メソッドを呼び出します。ノート: lengthパラメータを使用するバージョンの
updateNClob
を使用する方が効率的かどうかを判断するには、JDBCドライバのドキュメントを参照してください。- パラメータ:
columnLabel
- SQL AS節として指定された列のラベル。 SQL AS節が指定されなかった場合、このラベルは列の名前reader
- パラメータ値に設定されるデータを含むオブジェクト。- 例外:
SQLException
- columnLabelが有効でない場合、ドライバが各国の文字セットをサポートしない場合、ドライバがデータ変換エラーが発生した可能性を検出できる場合、このメソッドがクローズされた結果セットで呼び出された場合、データベース・アクセス・エラーが発生した場合、または結果セットの並行処理がCONCUR_READ_ONLY
である場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
getObject
<T> T getObject(int columnIndex, Class<T> type) throws SQLExceptionこの
ResultSet
オブジェクトの現在の行の指定された列の値を取得し、変換がサポートされている場合には、その列のSQL型を要求されたJavaデータ型に変換します。 変換がサポートされていない場合、またはtypeにnullが指定された場合は、SQLException
がスローされます。実装は、少なくとも、付録Bの表B-3に定義されている変換とユーザー定義SQL型から
SQLData
を実装するJava型への変換、またはStruct
をサポートする必要があります。 ほかの変換がサポートされている場合もあり、それらはベンダーによって定義されます。- 型パラメータ:
T
- このClassオブジェクトでモデル化されるクラスの型- パラメータ:
columnIndex
- 最初の列は1、2番目の列は2、... となるtype
- 指定された列の変換後のJavaデータ型を表すクラス- 戻り値:
- 列値を保持する
type
のインスタンス - 例外:
SQLException
- 変換がサポートされていない場合、typeがnullの場合、またはほかのエラーが発生した場合。 この例外のgetCause()メソッドにより、より詳細な例外が提供されることがある(たとえば変換エラーが発生した場合)SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.7
-
getObject
<T> T getObject(String columnLabel, Class<T> type) throws SQLExceptionこの
ResultSet
オブジェクトの現在の行の指定された列の値を取得し、変換がサポートされている場合には、その列のSQL型を要求されたJavaデータ型に変換します。 変換がサポートされていない場合、またはtypeにnullが指定された場合は、SQLException
がスローされます。実装は、少なくとも、付録Bの表B-3に定義されている変換とユーザー定義SQL型から
SQLData
を実装するJava型への変換、またはStruct
をサポートする必要があります。 ほかの変換がサポートされている場合もあり、それらはベンダーによって定義されます。- 型パラメータ:
T
- このClassオブジェクトでモデル化されるクラスの型- パラメータ:
columnLabel
- SQL AS節として指定された列のラベル。 SQL AS節が指定されなかった場合、このラベルは列の名前type
- 指定された列の変換後のJavaデータ型を表すクラス- 戻り値:
- 列値を保持する
type
のインスタンス - 例外:
SQLException
- 変換がサポートされていない場合、typeがnullの場合、またはほかのエラーが発生した場合。 この例外のgetCause()メソッドにより、より詳細な例外が提供されることがある(たとえば変換エラーが発生した場合)SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.7
-
updateObject
default void updateObject(int columnIndex, Object x, SQLType targetSqlType, int scaleOrLength) throws SQLException指定された列をObject
値で更新します。 updaterメソッドは、現在行または挿入行の列値を更新するのに使用します。 updaterメソッドは基になるデータベースを更新しません。データベースを更新するには、代わりにupdateRow
またはinsertRow
メソッドを呼び出します。2番目の引数が
InputStream
である場合、ストリームにはscaleOrLengthで指定されるバイト数が含まれる必要があります。 2番目の引数がReader
である場合、リーダーにはscaleOrLengthで指定される文字数が含まれる必要があります。 これらの条件がtrueではない場合、文の実行時にドライバはSQLException
を生成します。デフォルト実装は
SQLFeatureNotSupportedException
をスローします- パラメータ:
columnIndex
- 最初の列は1、2番目の列は2、... となるx
- 新しい列値targetSqlType
- データベースに送られるSQL型scaleOrLength
-java.math.BigDecimal
のオブジェクトの場合、小数点のあとの桁数。 Javaオブジェクト型InputStream
およびReader
の場合は、ストリームまたはリーダーのデータ長。 ほかのすべての型では、この値は無視される。- 例外:
SQLException
- columnIndexが無効な場合、データベース・アクセス・エラーが発生した場合、結果セットの並行処理がCONCUR_READ_ONLY
である場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合、またはJDBCドライバが指定されたtargetSqlTypeをサポートしない場合- 導入されたバージョン:
- 1.8
- 関連項目:
JDBCType
,SQLType
-
updateObject
default void updateObject(String columnLabel, Object x, SQLType targetSqlType, int scaleOrLength) throws SQLException指定された列をObject
値で更新します。 updaterメソッドは、現在行または挿入行の列値を更新するのに使用します。 updaterメソッドは基になるデータベースを更新しません。データベースを更新するには、代わりにupdateRow
またはinsertRow
メソッドを呼び出します。2番目の引数が
InputStream
である場合、ストリームにはscaleOrLengthで指定されるバイト数が含まれる必要があります。 2番目の引数がReader
である場合、リーダーにはscaleOrLengthで指定される文字数が含まれる必要があります。 これらの条件がtrueではない場合、文の実行時にドライバはSQLException
を生成します。デフォルト実装は
SQLFeatureNotSupportedException
をスローします- パラメータ:
columnLabel
- SQL AS節として指定された列のラベル。 SQL AS節が指定されなかった場合、このラベルは列の名前x
- 新しい列値targetSqlType
- データベースに送られるSQL型scaleOrLength
-java.math.BigDecimal
のオブジェクトの場合、小数点のあとの桁数。 Javaオブジェクト型InputStream
およびReader
の場合は、ストリームまたはリーダーのデータ長。 ほかのすべての型では、この値は無視される。- 例外:
SQLException
- columnLabelが無効な場合、データベース・アクセス・エラーが発生した場合、結果セットの並行処理がCONCUR_READ_ONLY
である場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合、またはJDBCドライバが指定されたtargetSqlTypeをサポートしない場合- 導入されたバージョン:
- 1.8
- 関連項目:
JDBCType
,SQLType
-
updateObject
default void updateObject(int columnIndex, Object x, SQLType targetSqlType) throws SQLException指定された列をObject
値で更新します。 updaterメソッドは、現在行または挿入行の列値を更新するのに使用します。 updaterメソッドは基になるデータベースを更新しません。データベースを更新するには、代わりにupdateRow
またはinsertRow
メソッドを呼び出します。デフォルト実装は
SQLFeatureNotSupportedException
をスローします- パラメータ:
columnIndex
- 最初の列は1、2番目の列は2、... となるx
- 新しい列値targetSqlType
- データベースに送られるSQL型- 例外:
SQLException
- columnIndexが無効な場合、データベース・アクセス・エラーが発生した場合、結果セットの並行処理がCONCUR_READ_ONLY
である場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合、またはJDBCドライバが指定されたtargetSqlTypeをサポートしない場合- 導入されたバージョン:
- 1.8
- 関連項目:
JDBCType
,SQLType
-
updateObject
default void updateObject(String columnLabel, Object x, SQLType targetSqlType) throws SQLException指定された列をObject
値で更新します。 updaterメソッドは、現在行または挿入行の列値を更新するのに使用します。 updaterメソッドは基になるデータベースを更新しません。データベースを更新するには、代わりにupdateRow
またはinsertRow
メソッドを呼び出します。デフォルト実装は
SQLFeatureNotSupportedException
をスローします- パラメータ:
columnLabel
- SQL AS節として指定された列のラベル。 SQL AS節が指定されなかった場合、このラベルは列の名前x
- 新しい列値targetSqlType
- データベースに送られるSQL型- 例外:
SQLException
- columnLabelが無効な場合、データベース・アクセス・エラーが発生した場合、結果セットの並行処理がCONCUR_READ_ONLY
である場合、またはこのメソッドがクローズされた結果セットで呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合、またはJDBCドライバが指定されたtargetSqlTypeをサポートしない場合- 導入されたバージョン:
- 1.8
- 関連項目:
JDBCType
,SQLType
-
getBigDecimal(int columnIndex)
またはgetBigDecimal(String columnLabel)
を使用します。