概要  パッケージ   クラス  使用  階層ツリー  非推奨 API  索引  ヘルプ 
JavaTM Platform
Standard Ed. 6
 前のクラス   次のクラス フレームあり    フレームなし    
概要: 入れ子 | フィールド | コンストラクタ | メソッド 詳細: フィールド | コンストラクタ | メソッド

java.sql
インタフェース ResultSet

すべてのスーパーインタフェース:
Wrapper
既知のサブインタフェースの一覧:
CachedRowSet, FilteredRowSet, JdbcRowSet, JoinRowSet, RowSet, SyncResolver, WebRowSet
public interface ResultSet
extends Wrapper

データベースの結果セットを表すデータのテーブルで、通常、データベースに照会する文を実行することによって生成されます。

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 (JavaTM 2 SDK, Standard Edition, Version 1.2) で、updater メソッドのセットが追加されました。getter メソッドのパラメータに関するコメントは、updater メソッドのパラメータにも適用されます。

updater メソッドは、次の 2 つの方法で使用できます。

  1. 現在の行の列値を更新します。スクロール可能な 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 be AINSWORTH
rs.updateRow(); // updates the row in the data source
  2. 列値を挿入行に挿入します。更新可能な 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 be 35
rs.updateBoolean(3, true); // updates the third column to true
rs.insertRow();
rs.moveToCurrentRow();

ResultSet オブジェクトは、このオブジェクトを生成した Statement オブジェクトが閉じられるとき、再実行されるとき、あるいは一連の複数の結果から次の結果を取り出すために使われるときに、自動的に閉じられます。

ResultSet オブジェクトの列の数、型、およびプロパティーは、ResultSet.getMetaData メソッドによって返される ResulSetMetaData オブジェクトで提供されます。

関連項目:
Statement.executeQuery(java.lang.String), Statement.getResultSet(), ResultSetMetaData

フィールドの概要
static int CLOSE_CURSORS_AT_COMMIT
          現在のトランザクションがコミットされたときに、この保持機能を持つオープンしている ResultSet オブジェクトがクローズすることを示す定数です。
static int CONCUR_READ_ONLY
          更新できない ResultSet オブジェクトの並行処理モードを示す定数です。
static int CONCUR_UPDATABLE
          更新できる ResultSet オブジェクトの並行処理モードを示す定数です。
static int FETCH_FORWARD
          結果セットの行が順方向に、つまり最初から最後に向かって処理されることを示す定数です。
static int FETCH_REVERSE
          結果セットの行が逆方向に、つまり最後から最初に向かって処理されることを示す定数です。
static int FETCH_UNKNOWN
          結果セットの行が処理される順序が不明であることを示す定数です。
static int HOLD_CURSORS_OVER_COMMIT
          現在のトランザクションがコミットされたときに、この保持機能を持つオープンしている ResultSet オブジェクトがオープンしたままになることを示す定数です。
static int TYPE_FORWARD_ONLY
          カーソルが順方向にだけ移動する ResultSet オブジェクトの型を示す定数です。
static int TYPE_SCROLL_INSENSITIVE
          スクロール可能だが、通常は ResultSet の基になっているデータに対する変更を反映しない ResultSet オブジェクトの型を示す定数です。
static int TYPE_SCROLL_SENSITIVE
          スクロール可能で、通常は ResultSet の基になっているデータに対する変更を反映する ResultSet オブジェクトの型を示す定数です。
 
メソッドの概要
 boolean absolute(int row)
          カーソルをこの ResultSet オブジェクト内の指定された行に移動します。
 void afterLast()
          カーソルをこの ResultSet オブジェクトの終端、つまり最終行の直後に移動します。
 void beforeFirst()
          カーソルをこの ResultSet オブジェクトの先端、つまり先頭行の直前に移動します。
 void cancelRowUpdates()
          この ResultSet オブジェクトの現在の行に対して行った更新を取り消します。
 void clearWarnings()
          この ResultSet オブジェクトに関して報告されたすべての警告をクリアします。
 void close()
          自動的にクローズされるとき、これを待つのではなく、ただちに ResultSet オブジェクトのデータベースと JDBC リソースを解放します。
 void deleteRow()
          この ResultSet オブジェクトおよび基になるデータベースから、現在の行を削除します。
 int findColumn(String columnLabel)
          指定された ResultSet の列ラベルを ResultSet 列インデックスにマッピングします。
 boolean first()
          カーソルをこの ResultSet オブジェクト内の先頭行に移動します。
 Array getArray(int columnIndex)
          この ResultSet オブジェクトの現在行にある指定された列の値を、Java プログラミング言語の Array オブジェクトとして取得します。
 Array getArray(String columnLabel)
          この ResultSet オブジェクトの現在行にある指定された列の値を、Java プログラミング言語の Array オブジェクトとして取得します。
 InputStream getAsciiStream(int columnIndex)
          この ResultSet オブジェクトの現在行にある指定された列の値を、ASCII 文字のストリームとして取得します。
 InputStream getAsciiStream(String columnLabel)
          この ResultSet オブジェクトの現在行にある指定された列の値を、ASCII 文字のストリームとして取得します。
 BigDecimal getBigDecimal(int columnIndex)
          この ResultSet オブジェクトの現在行にある指定された列の値を、java.math.BigDecimal オブジェクトとして全精度で取得します。
 BigDecimal getBigDecimal(int columnIndex, int scale)
          推奨されていません。  
 BigDecimal getBigDecimal(String columnLabel)
          この ResultSet オブジェクトの現在行にある指定された列の値を、java.math.BigDecimal オブジェクトとして全精度で取得します。
 BigDecimal getBigDecimal(String columnLabel, int scale)
          推奨されていません。  
 InputStream getBinaryStream(int columnIndex)
          この ResultSet オブジェクトの現在行にある指定された列の値を、未解釈のバイトのストリームとして取得します。
 InputStream getBinaryStream(String columnLabel)
          この ResultSet オブジェクトの現在行にある指定された列の値を、未解釈のバイトストリームとして取得します。
 Blob getBlob(int columnIndex)
          この ResultSet オブジェクトの現在行にある指定された列の値を、Java プログラミング言語の Blob オブジェクトとして取得します。
 Blob getBlob(String columnLabel)
          この 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 getByte(String columnLabel)
          この ResultSet オブジェクトの現在行にある指定された列の値を、Java プログラミング言語の byte として取得します。
 byte[] getBytes(int columnIndex)
          この ResultSet オブジェクトの現在行にある指定された列の値を、Java プログラミング言語の byte 配列として取得します。
 byte[] getBytes(String columnLabel)
          この ResultSet オブジェクトの現在行にある指定された列の値を、Java プログラミング言語の byte 配列として取得します。
 Reader getCharacterStream(int columnIndex)
          この ResultSet オブジェクトの現在行にある指定された列の値を、java.io.Reader オブジェクトとして取得します。
 Reader getCharacterStream(String columnLabel)
          この ResultSet オブジェクトの現在行にある指定された列の値を、java.io.Reader オブジェクトとして取得します。
 Clob getClob(int columnIndex)
          この ResultSet オブジェクトの現在行にある指定された列の値を、Java プログラミング言語の Clob オブジェクトとして取得します。
 Clob getClob(String columnLabel)
          この ResultSet オブジェクトの現在行にある指定された列の値を、Java プログラミング言語の Clob オブジェクトとして取得します。
 int getConcurrency()
          この ResultSet オブジェクトの並行処理モードを取得します。
 String getCursorName()
          この ResultSet オブジェクトが使用する SQL カーソルの名前を取得します。
 Date getDate(int columnIndex)
          この ResultSet オブジェクトの現在行にある指定された列の値を、Java プログラミング言語の java.sql.Date オブジェクトとして取得します。
 Date getDate(int columnIndex, Calendar cal)
          この ResultSet オブジェクトの現在行にある指定された列の値を、Java プログラミング言語の java.sql.Date オブジェクトとして取得します。
 Date getDate(String columnLabel)
          この ResultSet オブジェクトの現在行にある指定された列の値を、Java プログラミング言語の java.sql.Date オブジェクトとして取得します。
 Date getDate(String columnLabel, Calendar cal)
          この ResultSet オブジェクトの現在行にある指定された列の値を、Java プログラミング言語の java.sql.Date オブジェクトとして取得します。
 double getDouble(int columnIndex)
          この ResultSet オブジェクトの現在行にある指定された列の値を、Java プログラミング言語の double として取得します。
 double getDouble(String columnLabel)
          この ResultSet オブジェクトの現在行にある指定された列の値を、Java プログラミング言語の double として取得します。
 int getFetchDirection()
          この ResultSet オブジェクトのフェッチ方向を取得します。
 int getFetchSize()
          この ResultSet オブジェクトのフェッチサイズを取得します。
 float getFloat(int columnIndex)
          この ResultSet オブジェクトの現在行にある指定された列の値を、Java プログラミング言語の float として取得します。
 float getFloat(String columnLabel)
          この ResultSet オブジェクトの現在行にある指定された列の値を、Java プログラミング言語の float として取得します。
 int getHoldability()
          この ResultSet オブジェクトの保持機能を取得します。
 int getInt(int columnIndex)
          この ResultSet オブジェクトの現在行にある指定された列の値を、Java プログラミング言語の int として取得します。
 int getInt(String columnLabel)
          この ResultSet オブジェクトの現在行にある指定された列の値を、Java プログラミング言語の int として取得します。
 long getLong(int columnIndex)
          この ResultSet オブジェクトの現在行にある指定された列の値を、Java プログラミング言語の long として取得します。
 long getLong(String columnLabel)
          この ResultSet オブジェクトの現在行にある指定された列の値を、Java プログラミング言語の long として取得します。
 ResultSetMetaData getMetaData()
          この ResultSet オブジェクトの列の数、型、およびプロパティーを取得します。
 Reader getNCharacterStream(int columnIndex)
          この ResultSet オブジェクトの現在行にある指定された列の値を、java.io.Reader オブジェクトとして取得します。
 Reader getNCharacterStream(String columnLabel)
          この ResultSet オブジェクトの現在行にある指定された列の値を、java.io.Reader オブジェクトとして取得します。
 NClob getNClob(int columnIndex)
          この ResultSet オブジェクトの現在行にある指定された列の値を、Java プログラミング言語の NClob オブジェクトとして取得します。
 NClob getNClob(String columnLabel)
          この ResultSet オブジェクトの現在行にある指定された列の値を、Java プログラミング言語の NClob オブジェクトとして取得します。
 String getNString(int columnIndex)
          この ResultSet オブジェクトの現在行にある指定された列の値を、Java プログラミング言語の String として取得します。
 String getNString(String columnLabel)
          この ResultSet オブジェクトの現在行にある指定された列の値を、Java プログラミング言語の String として取得します。
 Object getObject(int columnIndex)
          この ResultSet オブジェクトの現在行にある指定された列の値を、Java プログラミング言語の Object として取得します。
 Object getObject(int columnIndex, Map<String,Class<?>> map)
          この ResultSet オブジェクトの現在行にある指定された列の値を、Java プログラミング言語の Object として取得します。
 Object getObject(String columnLabel)
          この ResultSet オブジェクトの現在行にある指定された列の値を、Java プログラミング言語の Object として取得します。
 Object getObject(String columnLabel, Map<String,Class<?>> map)
          この ResultSet オブジェクトの現在行にある指定された列の値を、Java プログラミング言語の Object として取得します。
 Ref getRef(int columnIndex)
          この ResultSet オブジェクトの現在行にある指定された列の値を、Java プログラミング言語の Ref オブジェクトとして取得します。
 Ref getRef(String columnLabel)
          この ResultSet オブジェクトの現在行にある指定された列の値を、Java プログラミング言語の Ref オブジェクトとして取得します。
 int getRow()
          現在の行の番号を取得します。
 RowId getRowId(int columnIndex)
          この ResultSet オブジェクトの現在行にある指定された列の値を、Java プログラミング言語の java.sql.RowId オブジェクトとして取得します。
 RowId getRowId(String columnLabel)
          この ResultSet オブジェクトの現在行にある指定された列の値を、Java プログラミング言語の java.sql.RowId オブジェクトとして取得します。
 short getShort(int columnIndex)
          この ResultSet オブジェクトの現在行にある指定された列の値を、Java プログラミング言語の short として取得します。
 short getShort(String columnLabel)
          この ResultSet オブジェクトの現在行にある指定された列の値を、Java プログラミング言語の short として取得します。
 SQLXML getSQLXML(int columnIndex)
          この ResultSet の現在行にある指定された列の値を、Java プログラミング言語の java.sql.SQLXML オブジェクトとして取得します。
 SQLXML getSQLXML(String columnLabel)
          この ResultSet の現在行にある指定された列の値を、Java プログラミング言語の java.sql.SQLXML オブジェクトとして取得します。
 Statement getStatement()
          この ResultSet オブジェクトを生成した Statement オブジェクトを取得します。
 String getString(int columnIndex)
          この ResultSet オブジェクトの現在行にある指定された列の値を、Java プログラミング言語の String として取得します。
 String getString(String columnLabel)
          この ResultSet オブジェクトの現在行にある指定された列の値を、Java プログラミング言語の String として取得します。
 Time getTime(int columnIndex)
          この ResultSet オブジェクトの現在行にある指定された列の値を、Java プログラミング言語の java.sql.Time オブジェクトとして取得します。
 Time getTime(int columnIndex, Calendar cal)
          この ResultSet オブジェクトの現在行にある指定された列の値を、Java プログラミング言語の java.sql.Time オブジェクトとして取得します。
 Time getTime(String columnLabel)
          この ResultSet オブジェクトの現在行にある指定された列の値を、Java プログラミング言語の java.sql.Time オブジェクトとして取得します。
 Time getTime(String columnLabel, Calendar cal)
          この ResultSet オブジェクトの現在行にある指定された列の値を、Java プログラミング言語の java.sql.Time オブジェクトとして取得します。
 Timestamp getTimestamp(int columnIndex)
          この ResultSet オブジェクトの現在行にある指定された列の値を、Java プログラミング言語の java.sql.Timestamp オブジェクトとして取得します。
 Timestamp getTimestamp(int columnIndex, Calendar cal)
          この ResultSet オブジェクトの現在行にある指定された列の値を、Java プログラミング言語の java.sql.Timestamp オブジェクトとして取得します。
 Timestamp getTimestamp(String columnLabel)
          この ResultSet オブジェクトの現在行にある指定された列の値を、Java プログラミング言語の java.sql.Timestamp オブジェクトとして取得します。
 Timestamp getTimestamp(String columnLabel, Calendar cal)
          この ResultSet オブジェクトの現在行にある指定された列の値を、Java プログラミング言語の java.sql.Timestamp オブジェクトとして取得します。
 int getType()
          この ResultSet オブジェクトの型を返します。
 InputStream getUnicodeStream(int columnIndex)
          推奨されていません。 getUnicodeStream の代わりに getCharacterStream を使用
 InputStream getUnicodeStream(String columnLabel)
          推奨されていません。 代わりに getCharacterStream を使用
 URL getURL(int columnIndex)
          この ResultSet オブジェクトの現在行にある指定された列の値を、Java プログラミング言語の java.net.URL オブジェクトとして取得します。
 URL getURL(String columnLabel)
          この ResultSet オブジェクトの現在行にある指定された列の値を、Java プログラミング言語の java.net.URL オブジェクトとして取得します。
 SQLWarning getWarnings()
          この ResultSet オブジェクトに関する呼び出しによって報告される最初の警告を返します。
 void insertRow()
          挿入行の内容を、この ResultSet オブジェクトおよびデータベースに挿入します。
 boolean isAfterLast()
          カーソルがこの ResultSet オブジェクト内の最終行より後ろにあるかどうかを取得します。
 boolean isBeforeFirst()
          カーソルがこの ResultSet オブジェクト内の先頭行より前にあるかどうかを取得します。
 boolean isClosed()
          この ResultSet オブジェクトがクローズされているかどうかを取得します。
 boolean isFirst()
          カーソルがこの ResultSet オブジェクト内の先頭行にあるかどうかを取得します。
 boolean isLast()
          カーソルがこの ResultSet オブジェクトの最終行にあるかどうかを取得します。
 boolean last()
          カーソルをこの ResultSet オブジェクト内の最終行に移動します。
 void moveToCurrentRow()
          カーソルを、記憶されているカーソル位置 (通常は現在の行) に移動します。
 void moveToInsertRow()
          カーソルを挿入行に移動します。
 boolean next()
          カーソルを現在の位置から 1 行順方向に移動します。
 boolean previous()
          カーソルをこの ResultSet オブジェクト内の前の行に移動します。
 void refreshRow()
          現在の行をデータベース内の最新の値で再表示します。
 boolean relative(int rows)
          カーソルを正または負の相対行数だけ移動します。
 boolean rowDeleted()
          行が削除されているかどうかを取得します。
 boolean rowInserted()
          現在の行に挿入があったかどうかを取得します。
 boolean rowUpdated()
          現在の行が更新されているかどうかを取得します。
 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, Blob x)
          指定された列を java.sql.Blob 値で更新します。
 void updateBlob(int columnIndex, InputStream inputStream)
          指定された列を、指定された入力ストリームを使用して更新します。
 void updateBlob(int columnIndex, InputStream inputStream, long length)
          指定された列を、指定されたバイト数を持つ指定された入力ストリームを使用して更新します。
 void updateBlob(String columnLabel, Blob x)
          指定された列を java.sql.Blob 値で更新します。
 void updateBlob(String columnLabel, InputStream inputStream)
          指定された列を、指定された入力ストリームを使用して更新します。
 void updateBlob(String columnLabel, InputStream inputStream, long length)
          指定された列を、指定されたバイト数を持つ指定された入力ストリームを使用して更新します。
 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, Clob x)
          指定された列を java.sql.Clob 値で更新します。
 void updateClob(int columnIndex, Reader reader)
          指定された列を、指定された Reader オブジェクトを使用して更新します。
 void updateClob(int columnIndex, Reader reader, long length)
          指定された列を、指定された文字数である指定された Reader オブジェクトを使用して更新します。
 void updateClob(String columnLabel, Clob x)
          指定された列を java.sql.Clob 値で更新します。
 void updateClob(String columnLabel, Reader reader)
          指定された列を、指定された Reader オブジェクトを使用して更新します。
 void updateClob(String columnLabel, Reader reader, long length)
          指定された列を、指定された文字数である指定された Reader オブジェクトを使用して更新します。
 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 updateInt(String columnLabel, int x)
          指定された列を 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, NClob nClob)
          指定された列を java.sql.NClob 値で更新します。
 void updateNClob(int columnIndex, Reader reader)
          指定された列を、指定された Reader を使用して更新します。
 void updateNClob(int columnIndex, Reader reader, long length)
          指定された列を、指定された文字数である指定された Reader オブジェクトを使用して更新します。
 void updateNClob(String columnLabel, NClob nClob)
          指定された列を java.sql.NClob 値で更新します。
 void updateNClob(String columnLabel, Reader reader)
          指定された列を、指定された Reader オブジェクトを使用して更新します。
 void updateNClob(String columnLabel, Reader reader, long length)
          指定された列を、指定された文字数である指定された Reader オブジェクトを使用して更新します。
 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 値で更新します。
 void updateObject(String columnLabel, Object x)
          指定された列を Object 値で更新します。
 void updateObject(String columnLabel, Object x, int scaleOrLength)
          指定された列を Object 値で更新します。
 void updateRef(int columnIndex, Ref x)
          指定された列を java.sql.Ref 値で更新します。
 void updateRef(String columnLabel, Ref x)
          指定された列を java.sql.Ref 値で更新します。
 void updateRow()
          基になるデータベースを、この 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()
          最後に読み込まれた列の値が SQL NULL であるかどうかを通知します。
 
インタフェース 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 メソッドを呼び出すと、操作は行われません。  

例外:
SQLException - データベースアクセスエラーが発生した場合

wasNull

boolean wasNull()
                throws SQLException
最後に読み込まれた列の値が SQL NULL であるかどうかを通知します。最初に列の getter メソッドの 1 つを呼び出してその値を読み込み、次に wasNull メソッドを呼び出して読み込まれた値が SQL NULL かどうかを判定する必要があります。

戻り値:
最後に読み込まれた列値が 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

BigDecimal getBigDecimal(int columnIndex,
                         int scale)
                         throws SQLException
推奨されていません。 

この 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 配列として取得します。バイトはドライバによって返された行の値を表します。

パラメータ:
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

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

BigDecimal getBigDecimal(String columnLabel,
                         int scale)
                         throws SQLException
推奨されていません。 

この 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 配列として取得します。バイトはドライバによって返された行の値を表します。

パラメータ:
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

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 オブジェクトの現在行にある指定された列の値を、未解釈のバイトストリームとして取得します。 そのストリームから一括して値を読み込めるようになります。このメソッドは、特に大きな 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 の場合、ドライバは Java null を返します。

このメソッドは、データベース固有の抽象データ型の読み込みにも使用できます。 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 の場合、ドライバは Java null を返します。  

このメソッドは、データベース固有の抽象データ型の読み込みにも使用できます。  

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 オブジェクト。値が SQL NULL の場合、返される値は 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 オブジェクト。値が SQL NULL の場合、返される値は 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 オブジェクトを生成した Statment オブジェクト。結果セットが別の方法で生成された場合は null
例外:
SQLException - データベースアクセスエラーが発生した場合、またはこのメソッドがクローズされた結果セットで呼び出された場合
導入されたバージョン:
1.2

getObject

Object getObject(int columnIndex,
                 Map<String,Class<?>> map)
                 throws SQLException
この ResultSet オブジェクトの現在行にある指定された列の値を、Java プログラミング言語の Object として取得します。値が SQL NULL の場合、ドライバは Java null を返します。このメソッドは、取り出される 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

Object getObject(String columnLabel,
                 Map<String,Class<?>> map)
                 throws SQLException
この ResultSet オブジェクトの現在行にある指定された列の値を、Java プログラミング言語の Object として取得します。値が SQL NULL の場合、ドライバは Java null を返します。このメソッドは、該当する場合、指定された 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 オブジェクトとして表された列の値。値が SQL NULL の場合、返される値は 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 オブジェクトとして表された列の値。値が SQL NULL の場合、返される値は 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 オブジェクトとして表された列の値。値が SQL NULL の場合、返される値は 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 オブジェクトとして表された列の値。値が SQL NULL の場合、返される値は 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 オブジェクトとして表された列の値。値が SQL NULL の場合、返される値は 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 オブジェクトとして表された列の値。値が SQL NULL の場合、返される値は 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 オブジェクトとして表された列の値。値が SQL NULL の場合、返される値は 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 オブジェクトとして表された列の値。値が SQL NULL の場合、返される値は 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 が有効でない場合、データベースアクセスエラーが発生した場合、このメソッドがクローズされた結果セットで呼び出された場合、java.xml.transform.Result、Writer、または OutputStream が SQLXML オブジェクトに対してクローズされていない場合、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 が有効でない場合、データベースアクセスエラーが発生した場合、このメソッドがクローズされた結果セットで呼び出された場合、java.xml.transform.Result、Writer、または OutputStream が SQLXML オブジェクトに対してクローズされていない場合、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 オブジェクト。値が SQL NULL の場合、返される値は 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 オブジェクト。値が SQL NULL の場合、返される値は 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
概要  パッケージ   クラス  使用  階層ツリー  非推奨 API  索引  ヘルプ 
JavaTM Platform
Standard Ed. 6
 前のクラス   次のクラス フレームあり    フレームなし    
概要: 入れ子 | フィールド | コンストラクタ | メソッド 詳細: フィールド | コンストラクタ | メソッド
バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。