-
- すべてのスーパー・インタフェース:
AutoCloseable,ResultSet,Wrapper
- 既知のすべてのサブインタフェース:
CachedRowSet,FilteredRowSet,JdbcRowSet,JoinRowSet,SyncResolver,WebRowSet
public interface RowSet extends ResultSet
JavaBeans™コンポーネント・モデルのサポートをJDBC APIに追加するインタフェースです。 行セットはビジュアルなBean開発環境でJavaBeansコンポーネントとして使用できます。また、設計時に作成および構成が行われ、実行時に実行されます。RowSetインタフェースではJavaBeansプロパティの組を提供します。これらのプロパティによって、RowSetインスタンスがJDBCデータ・ソースに接続し、そのデータ・ソースからデータを読み取るように構成できます。 値を設定するメソッド(setInt、setBytes、setStringなど)では、入力パラメータを行セットのコマンド・プロパティに渡す方法を提供します。 このコマンドは、行セットが通常は関係データベースから自身のデータを取得するときに使用するSQLクエリーです。RowSetインタフェースではJavaBeansイベントをサポートしており、行セットにイベントが発生したとき(値の変更など)に、アプリケーションのほかのコンポーネントに通知することができます。JDBC APIのほかの部分を使用して実装するようにしている点で、
RowSetインタフェースは独特です。 言い換えると、RowSetの実装とは、JDBCドライバの最上部で実行されるソフトウェアのレイヤーです。RowSetインタフェースの実装は、JDBC製品の一部としてRowSetの実装を提供しようとするJDBCドライバ・ベンダーを始めとして、誰でも提供できます。RowSetオブジェクトでは、データ・ソースとの接続を作成し、オブジェクトのライフ・サイクルを通じてその接続を保持します。このような場合、接続された行セットと呼ばれます。 また、行セットはデータ・ソースと接続してデータを取得し、接続を閉じることもできます。 そのような行セットは未接続の行セットと呼ばれます。 未接続の行セットでは、未接続中にデータに変更を加えてから、データの元のソースに変更を送り戻すことができます。しかし、そのためには接続をもう一度確立する必要があります。切断された行セットには、
Reader(RowSetReaderオブジェクト)とそれに関連付けられたライター(RowSetWriterオブジェクト)があります。Readerは、多くの異なる方法で実装され、非リレーショナル・データ・ソースからデータを取得することを含む、行セットにデータを取り込むことができます。 ライターもまたさまざまな方法で実装されており、行セットのデータに加えられた変更を基本となるデータ・ソースへ送り戻すことができます。行セットを使用するのは簡単です。
RowSetインタフェースは標準java.sql.ResultSetインタフェースを拡張したものです。RowSetMetaDataインタフェースはjava.sql.ResultSetMetaDataインタフェースを拡張したものです。 それにより、JDBC APIに精通している開発者が行セットを使うためには、最小限の新しいAPIを覚えれば済みます。 さらに、JDBCResultSetオブジェクトとともに動作するサード・パーティ製のソフトウェア・ツールを、行セットを使用して動作するようにすることも簡単にできます。- 導入されたバージョン:
- 1.4
-
-
フィールドのサマリー
-
インタフェース java.sql.ResultSetで宣言されたフィールド
CLOSE_CURSORS_AT_COMMIT, CONCUR_READ_ONLY, CONCUR_UPDATABLE, FETCH_FORWARD, FETCH_REVERSE, FETCH_UNKNOWN, HOLD_CURSORS_OVER_COMMIT, TYPE_FORWARD_ONLY, TYPE_SCROLL_INSENSITIVE, TYPE_SCROLL_SENSITIVE
-
-
メソッドのサマリー
すべてのメソッド インスタンス・メソッド 抽象メソッド 修飾子と型 メソッド 説明 voidaddRowSetListener(RowSetListener listener)指定したイベント・リスナーを登録して、このRowSetオブジェクトで発生するイベントが通知されるようにします。voidclearParameters()このRowSetオブジェクトのコマンド用のパラメータ・セットをクリアします。voidexecute()このRowSetオブジェクトにデータを格納します。StringgetCommand()このRowSetオブジェクトのcommandプロパティを取得します。StringgetDataSourceName()このRowSetオブジェクトのデータ・ソースを特定する論理名を取得します。booleangetEscapeProcessing()このRowSetオブジェクトのエスケープの処理が有効かどうかを取得します。intgetMaxFieldSize()ある列値で返される最大バイト数を取得します。intgetMaxRows()このRowSetオブジェクトに含めることのできる最大行数を取得します。StringgetPassword()データベース接続の作成に使用するパスワードを取得します。intgetQueryTimeout()ドライバが文の実行を待つ最大秒数を取得します。intgetTransactionIsolation()このRowSetオブジェクトのトランザクション遮断レベルの設定を取得します。Map<String,Class<?>>getTypeMap()このRowSetオブジェクトに関連付けられたSQLユーザー定義型のカスタム・マッピングがある場合には、それを指定するMapオブジェクトを取得します。StringgetUrl()このRowSetオブジェクトが接続を確立するのにDataSourceオブジェクトではなくDriverManagerを使用する場合に、接続を作成するために使用するurlプロパティを取得します。StringgetUsername()このRowSetオブジェクトのデータベース接続を作成するために使用されるusernameを取得します。booleanisReadOnly()このRowSetオブジェクトが読取り専用かどうかを確認します。voidremoveRowSetListener(RowSetListener listener)指定したリスナーを、このRowSetオブジェクトでイベントが発生したときに通知されるコンポーネントのリストから削除します。voidsetArray(int i, Array x)このRowSetオブジェクトのコマンドで指定したパラメータを、指定したArray値に設定します。voidsetAsciiStream(int parameterIndex, InputStream x)このRowSetオブジェクトのコマンド内の指定されたパラメータを、指定された入力ストリームに設定します。voidsetAsciiStream(int parameterIndex, InputStream x, int length)このRowSetオブジェクトのコマンド内の指定されたパラメータを、指定されたjava.io.InputStream値に設定します。voidsetAsciiStream(String parameterName, InputStream x)指定されたパラメータを指定された入力ストリームに設定します。voidsetAsciiStream(String parameterName, InputStream x, int length)指定されたパラメータを、指定されたバイト数を持つ指定された入力ストリームに設定します。voidsetBigDecimal(int parameterIndex, BigDecimal x)このRowSetオブジェクト・コマンド内の指定されたパラメータを、指定されたjava.math.BigDecimal値に設定します。voidsetBigDecimal(String parameterName, BigDecimal x)指定されたパラメータを、指定されたjava.math.BigDecimal値に設定します。voidsetBinaryStream(int parameterIndex, InputStream x)このRowSetオブジェクトのコマンド内の指定されたパラメータを、指定された入力ストリームに設定します。voidsetBinaryStream(int parameterIndex, InputStream x, int length)このRowSetオブジェクトのコマンド内の指定されたパラメータを、指定されたjava.io.InputStream値に設定します。voidsetBinaryStream(String parameterName, InputStream x)指定されたパラメータを指定された入力ストリームに設定します。voidsetBinaryStream(String parameterName, InputStream x, int length)指定されたパラメータを、指定されたバイト数を持つ指定された入力ストリームに設定します。voidsetBlob(int parameterIndex, InputStream inputStream)指定されたパラメータをInputStreamオブジェクトに設定します。voidsetBlob(int parameterIndex, InputStream inputStream, long length)指定されたパラメータをInputStreamオブジェクトに設定します。voidsetBlob(int i, Blob x)このRowSetオブジェクトのコマンドで指定したパラメータを、指定したBlob値に設定します。voidsetBlob(String parameterName, InputStream inputStream)指定されたパラメータをInputStreamオブジェクトに設定します。voidsetBlob(String parameterName, InputStream inputStream, long length)指定されたパラメータをInputStreamオブジェクトに設定します。voidsetBlob(String parameterName, Blob x)指定されたパラメータを指定されたjava.sql.Blobオブジェクトに設定します。voidsetBoolean(int parameterIndex, boolean x)このRowSetオブジェクトのコマンド内の指定されたパラメータを、指定されたJavaboolean値に設定します。voidsetBoolean(String parameterName, boolean x)指定されたパラメータを指定されたJavaのboolean値に設定します。voidsetByte(int parameterIndex, byte x)このRowSetオブジェクトのコマンド内の指定されたパラメータを、指定されたJavabyte値に設定します。voidsetByte(String parameterName, byte x)指定されたパラメータを指定されたJavaのbyte値に設定します。voidsetBytes(int parameterIndex, byte[] x)このRowSetオブジェクトのコマンド内の指定したパラメータを、byte値の指定したJava配列値に設定します。voidsetBytes(String parameterName, byte[] x)指定されたパラメータを指定されたJavaのバイト配列に設定します。voidsetCharacterStream(int parameterIndex, Reader reader)このRowSetオブジェクトのコマンド内の指定されたパラメータを、指定されたReaderオブジェクトに設定します。voidsetCharacterStream(int parameterIndex, Reader reader, int length)このRowSetオブジェクトのコマンド内の指定されたパラメータを、指定されたjava.io.Reader値に設定します。voidsetCharacterStream(String parameterName, Reader reader)指定されたパラメータを指定されたReaderオブジェクトに設定します。voidsetCharacterStream(String parameterName, Reader reader, int length)指定されたパラメータを、指定された文字数である指定されたReaderオブジェクトに設定します。voidsetClob(int parameterIndex, Reader reader)指定されたパラメータをReaderオブジェクトに設定します。voidsetClob(int parameterIndex, Reader reader, long length)指定されたパラメータをReaderオブジェクトに設定します。voidsetClob(int i, Clob x)このRowSetオブジェクトのコマンドで指定したパラメータを、指定したClob値に設定します。voidsetClob(String parameterName, Reader reader)指定されたパラメータをReaderオブジェクトに設定します。voidsetClob(String parameterName, Reader reader, long length)指定されたパラメータをReaderオブジェクトに設定します。voidsetClob(String parameterName, Clob x)指定されたパラメータを指定されたjava.sql.Clobオブジェクトに設定します。voidsetCommand(String cmd)このRowSetオブジェクトのcommandプロパティにSQLクエリーを設定します。voidsetConcurrency(int concurrency)このRowSetオブジェクトの並行性を、指定した並行性レベルに設定します。voidsetDataSourceName(String name)このRowSetオブジェクトのデータ・ソース名プロパティを、指定したStringに設定します。voidsetDate(int parameterIndex, Date x)このRowSetオブジェクトのコマンド内の指定されたパラメータを、指定されたjava.sql.Date値に設定します。voidsetDate(int parameterIndex, Date x, Calendar cal)このRowSetオブジェクトのコマンドで指定したパラメータを、指定したjava.sql.Date値に設定します。voidsetDate(String parameterName, Date x)アプリケーションを実行している仮想マシンのデフォルトのタイムゾーンを使用して、指定されたパラメータを指定されたjava.sql.Date値に設定します。voidsetDate(String parameterName, Date x, Calendar cal)指定されたCalendarオブジェクトを使用して、指定されたパラメータを指定されたjava.sql.Date値に設定します。voidsetDouble(int parameterIndex, double x)このRowSetオブジェクトのコマンド内の指定されたパラメータを、指定されたJavadouble値に設定します。voidsetDouble(String parameterName, double x)指定されたパラメータを指定されたJavaのdouble値に設定します。voidsetEscapeProcessing(boolean enable)このRowSetオブジェクトのエスケープの処理をオンまたはオフに設定します。voidsetFloat(int parameterIndex, float x)このRowSetオブジェクトのコマンド内の指定されたパラメータを、指定されたJavafloat値に設定します。voidsetFloat(String parameterName, float x)指定されたパラメータを指定されたJavaのfloat値に設定します。voidsetInt(int parameterIndex, int x)このRowSetオブジェクトのコマンド内の指定されたパラメータを、指定されたJavaint値に設定します。voidsetInt(String parameterName, int x)指定されたパラメータを指定されたJavaのint値に設定します。voidsetLong(int parameterIndex, long x)このRowSetオブジェクトのコマンド内の指定されたパラメータを、指定されたJavalong値に設定します。voidsetLong(String parameterName, long x)指定されたパラメータを指定されたJavaのlong値に設定します。voidsetMaxFieldSize(int max)列値に返される最大バイト数を、指定されたバイト数に設定します。voidsetMaxRows(int max)データベース・アクセス・エラーが発生した場合、このRowSetオブジェクトに含めることのできる最大の行数を、指定した値に設定します。voidsetNCharacterStream(int parameterIndex, Reader value)このRowSetオブジェクトのコマンド内の指定されたパラメータを、Readerオブジェクトに設定します。voidsetNCharacterStream(int parameterIndex, Reader value, long length)指定されたパラメータをReaderオブジェクトに設定します。voidsetNCharacterStream(String parameterName, Reader value)指定されたパラメータをReaderオブジェクトに設定します。voidsetNCharacterStream(String parameterName, Reader value, long length)指定されたパラメータをReaderオブジェクトに設定します。voidsetNClob(int parameterIndex, Reader reader)指定されたパラメータをReaderオブジェクトに設定します。voidsetNClob(int parameterIndex, Reader reader, long length)指定されたパラメータをReaderオブジェクトに設定します。voidsetNClob(int parameterIndex, NClob value)指定されたパラメータをjava.sql.NClobオブジェクトに設定します。voidsetNClob(String parameterName, Reader reader)指定されたパラメータをReaderオブジェクトに設定します。voidsetNClob(String parameterName, Reader reader, long length)指定されたパラメータをReaderオブジェクトに設定します。voidsetNClob(String parameterName, NClob value)指定されたパラメータをjava.sql.NClobオブジェクトに設定します。voidsetNString(int parameterIndex, String value)指定されたパラメータを指定されたStringオブジェクトに設定します。voidsetNString(String parameterName, String value)指定されたパラメータを指定されたStringオブジェクトに設定します。voidsetNull(int parameterIndex, int sqlType)このRowSetオブジェクトのSQLコマンド内の指定されたパラメータを、SQLNULLに設定します。voidsetNull(int paramIndex, int sqlType, String typeName)このRowSetオブジェクトのSQLコマンド内の指定されたパラメータを、SQLNULLに設定します。voidsetNull(String parameterName, int sqlType)指定されたパラメータをSQLNULLに設定します。voidsetNull(String parameterName, int sqlType, String typeName)指定されたパラメータをSQLNULLに設定します。voidsetObject(int parameterIndex, Object x)このRowSetオブジェクトのコマンド内の指定したパラメータを、JavaObjectに設定します。voidsetObject(int parameterIndex, Object x, int targetSqlType)このRowSetオブジェクトのコマンド内の指定したパラメータを、JavaObjectに設定します。voidsetObject(int parameterIndex, Object x, int targetSqlType, int scaleOrLength)このRowSetオブジェクトのコマンド内の指定したパラメータを、指定したJavaObjectに設定します。voidsetObject(String parameterName, Object x)指定されたパラメータの値を、指定されたオブジェクトで設定します。voidsetObject(String parameterName, Object x, int targetSqlType)指定されたパラメータの値を、指定されたオブジェクトで設定します。voidsetObject(String parameterName, Object x, int targetSqlType, int scale)指定されたパラメータの値を、指定されたオブジェクトで設定します。voidsetPassword(String password)このRowSetオブジェクトのデータベース・パスワードを、指定したStringに設定します。voidsetQueryTimeout(int seconds)データベース・アクセス・エラーが発生した場合にドライバが文の実行を待つ最大時間を、指定した秒数に設定します。voidsetReadOnly(boolean value)このRowSetオブジェクトが読取り専用かどうかを、指定したbooleanに設定します。voidsetRef(int i, Ref x)このRowSetオブジェクトのコマンドで指定したパラメータを、指定したRef値に設定します。voidsetRowId(int parameterIndex, RowId x)指定されたパラメータを指定されたjava.sql.RowIdオブジェクトに設定します。voidsetRowId(String parameterName, RowId x)指定されたパラメータを指定されたjava.sql.RowIdオブジェクトに設定します。voidsetShort(int parameterIndex, short x)このRowSetオブジェクトのコマンド内の指定されたパラメータを、指定されたJavashort値に設定します。voidsetShort(String parameterName, short x)指定されたパラメータを指定されたJavaのshort値に設定します。voidsetSQLXML(int parameterIndex, SQLXML xmlObject)指定されたパラメータを指定されたjava.sql.SQLXMLオブジェクトに設定します。voidsetSQLXML(String parameterName, SQLXML xmlObject)指定されたパラメータを指定されたjava.sql.SQLXMLオブジェクトに設定します。voidsetString(int parameterIndex, String x)このRowSetオブジェクトのコマンド内の指定されたパラメータを、指定されたJavaString値に設定します。voidsetString(String parameterName, String x)指定されたパラメータを指定されたJavaのString値に設定します。voidsetTime(int parameterIndex, Time x)このRowSetオブジェクトのコマンド内の指定されたパラメータを、指定されたjava.sql.Time値に設定します。voidsetTime(int parameterIndex, Time x, Calendar cal)このRowSetオブジェクトのコマンドで指定したパラメータを、指定したjava.sql.Time値に設定します。voidsetTime(String parameterName, Time x)指定されたパラメータを、指定されたjava.sql.Time値に設定します。voidsetTime(String parameterName, Time x, Calendar cal)指定されたCalendarオブジェクトを使用して、指定されたパラメータを指定されたjava.sql.Time値に設定します。voidsetTimestamp(int parameterIndex, Timestamp x)このRowSetオブジェクトのコマンド内の指定されたパラメータを、指定されたjava.sql.Timestamp値に設定します。voidsetTimestamp(int parameterIndex, Timestamp x, Calendar cal)このRowSetオブジェクトのコマンドで指定したパラメータを、指定したjava.sql.Timestamp値に設定します。voidsetTimestamp(String parameterName, Timestamp x)指定されたパラメータを、指定されたjava.sql.Timestamp値に設定します。voidsetTimestamp(String parameterName, Timestamp x, Calendar cal)指定されたCalendarオブジェクトを使用して、指定されたパラメータを指定されたjava.sql.Timestamp値に設定します。voidsetTransactionIsolation(int level)このRowSetオブジェクトのトランザクション遮断レベルを設定します。voidsetType(int type)このRowSetオブジェクトの型を、指定した型に設定します。voidsetTypeMap(Map<String,Class<?>> map)このRowSetオブジェクトのデフォルトの型マップとして指定されたjava.util.Mapオブジェクトをインストールします。voidsetUrl(String url)このRowSetオブジェクトがDriverManagerを使って接続を作成するときに使用するURLを設定します。voidsetURL(int parameterIndex, URL x)指定されたパラメータを、指定されたjava.net.URL値に設定します。voidsetUsername(String name)このRowSetオブジェクトのusernameプロパティを、指定したStringに設定します。-
インタフェース java.sql.ResultSetで宣言されたメソッド
absolute, afterLast, beforeFirst, cancelRowUpdates, clearWarnings, close, deleteRow, findColumn, first, getArray, getArray, getAsciiStream, getAsciiStream, getBigDecimal, getBigDecimal, getBigDecimal, getBigDecimal, getBinaryStream, getBinaryStream, getBlob, getBlob, getBoolean, getBoolean, getByte, getByte, getBytes, getBytes, getCharacterStream, getCharacterStream, getClob, getClob, getConcurrency, getCursorName, getDate, getDate, getDate, getDate, getDouble, getDouble, getFetchDirection, getFetchSize, getFloat, getFloat, getHoldability, getInt, getInt, getLong, getLong, getMetaData, getNCharacterStream, getNCharacterStream, getNClob, getNClob, getNString, getNString, getObject, getObject, getObject, getObject, getObject, getObject, getRef, getRef, getRow, getRowId, getRowId, getShort, getShort, getSQLXML, getSQLXML, getStatement, getString, getString, getTime, getTime, getTime, getTime, getTimestamp, getTimestamp, getTimestamp, getTimestamp, getType, getUnicodeStream, getUnicodeStream, getURL, getURL, getWarnings, insertRow, isAfterLast, isBeforeFirst, isClosed, isFirst, isLast, last, moveToCurrentRow, moveToInsertRow, next, previous, refreshRow, relative, rowDeleted, rowInserted, rowUpdated, setFetchDirection, setFetchSize, updateArray, updateArray, updateAsciiStream, updateAsciiStream, updateAsciiStream, updateAsciiStream, updateAsciiStream, updateAsciiStream, updateBigDecimal, updateBigDecimal, updateBinaryStream, updateBinaryStream, updateBinaryStream, updateBinaryStream, updateBinaryStream, updateBinaryStream, updateBlob, updateBlob, updateBlob, updateBlob, updateBlob, updateBlob, updateBoolean, updateBoolean, updateByte, updateByte, updateBytes, updateBytes, updateCharacterStream, updateCharacterStream, updateCharacterStream, updateCharacterStream, updateCharacterStream, updateCharacterStream, updateClob, updateClob, updateClob, updateClob, updateClob, updateClob, updateDate, updateDate, updateDouble, updateDouble, updateFloat, updateFloat, updateInt, updateInt, updateLong, updateLong, updateNCharacterStream, updateNCharacterStream, updateNCharacterStream, updateNCharacterStream, updateNClob, updateNClob, updateNClob, updateNClob, updateNClob, updateNClob, updateNString, updateNString, updateNull, updateNull, updateObject, updateObject, updateObject, updateObject, updateObject, updateObject, updateObject, updateObject, updateRef, updateRef, updateRow, updateRowId, updateRowId, updateShort, updateShort, updateSQLXML, updateSQLXML, updateString, updateString, updateTime, updateTime, updateTimestamp, updateTimestamp, wasNull
-
インタフェース java.sql.Wrapperで宣言されたメソッド
isWrapperFor, unwrap
-
-
-
-
メソッドの詳細
-
getUrl
String getUrl() throws SQLException
このRowSetオブジェクトが接続を確立するのにDataSourceオブジェクトではなくDriverManagerを使用する場合に、接続を作成するために使用するurlプロパティを取得します。 デフォルト値はnullです。- 戻り値:
- URLを表す文字列
- 例外:
SQLException- データベース・アクセス・エラーが発生した場合- 関連項目:
setUrl(java.lang.String)
-
setUrl
void setUrl(String url) throws SQLException
このRowSetオブジェクトがDriverManagerを使って接続を作成するときに使用するURLを設定します。 このプロパティの設定はオプションです。 URLを使用する場合は、データベースへの接続に行セットが使用される前に、そのURLを受け入れるJDBCドライバをロードします。 行セットでは、データを読み書きするときに、このURLを内部的に使用して、データベース接続を作成します。 URLとデータ・ソース名のうち、新しくnull以外の値が設定された方が接続の作成に使用されます。- パラメータ:
url- 文字列値。nullも可- 例外:
SQLException- データベース・アクセス・エラーが発生した場合- 関連項目:
getUrl()
-
getDataSourceName
String getDataSourceName()
このRowSetオブジェクトのデータ・ソースを特定する論理名を取得します。- 戻り値:
- データ・ソース名
- 関連項目:
setDataSourceName(java.lang.String),setUrl(java.lang.String)
-
setDataSourceName
void setDataSourceName(String name) throws SQLException
このRowSetオブジェクトのデータ・ソース名プロパティを、指定したStringに設定します。データ・ソース名プロパティの値は、ネーム・サービスで登録された
DataSourceオブジェクトをルックアップするために使用されます。 取得されたDataSourceオブジェクトを使って、このオブジェクトが表すデータ・ソースへの接続を作成できます。- パラメータ:
name- このRowSetオブジェクトのデータ・ソースの論理名。nullも可- 例外:
SQLException- データベース・アクセス・エラーが発生した場合- 関連項目:
getDataSourceName()
-
getUsername
String getUsername()
このRowSetオブジェクトのデータベース接続を作成するために使用されるusernameを取得します。 usernameプロパティは、実行時にexecuteメソッドを呼び出す前に設定されます。 通常、これはRowSetオブジェクトの直列化状態の一部ではありません。- 戻り値:
- usernameプロパティ
- 関連項目:
setUsername(java.lang.String)
-
setUsername
void setUsername(String name) throws SQLException
このRowSetオブジェクトのusernameプロパティを、指定したStringに設定します。- パラメータ:
name- ユーザー名- 例外:
SQLException- データベース・アクセス・エラーが発生した場合- 関連項目:
getUsername()
-
getPassword
String getPassword()
データベース接続の作成に使用するパスワードを取得します。 passwordプロパティは、実行時にexecuteメソッドを呼び出す前に設定されます。 通常、これはRowSetオブジェクトの直列化状態の一部ではありません。- 戻り値:
- データベース接続の作成に必要なパスワード
- 関連項目:
setPassword(java.lang.String)
-
setPassword
void setPassword(String password) throws SQLException
このRowSetオブジェクトのデータベース・パスワードを、指定したStringに設定します。- パラメータ:
password- パスワードを表す文字列- 例外:
SQLException- データベース・アクセス・エラーが発生した場合- 関連項目:
getPassword()
-
getTransactionIsolation
int getTransactionIsolation()
このRowSetオブジェクトのトランザクション遮断レベルの設定を取得します。- 戻り値:
- トランザクション遮断レベル。
Connection.TRANSACTION_READ_UNCOMMITTED、Connection.TRANSACTION_READ_COMMITTED、Connection.TRANSACTION_REPEATABLE_READ、またはConnection.TRANSACTION_SERIALIZABLEのうちの1つ - 関連項目:
setTransactionIsolation(int)
-
setTransactionIsolation
void setTransactionIsolation(int level) throws SQLExceptionこのRowSetオブジェクトのトランザクション遮断レベルを設定します。- パラメータ:
level- トランザクション遮断レベル。Connection.TRANSACTION_READ_UNCOMMITTED、Connection.TRANSACTION_READ_COMMITTED、Connection.TRANSACTION_REPEATABLE_READ、またはConnection.TRANSACTION_SERIALIZABLEのうちの1つ- 例外:
SQLException- データベース・アクセス・エラーが発生した場合- 関連項目:
getTransactionIsolation()
-
getTypeMap
Map<String,Class<?>> getTypeMap() throws SQLException
このRowSetオブジェクトに関連付けられたSQLユーザー定義型のカスタム・マッピングがある場合には、それを指定するMapオブジェクトを取得します。 型マップのデフォルトは空です。- 戻り値:
- SQLユーザー定義型とそれらがマッピングされるJavaクラスが格納されている
java.util.Mapオブジェクト - 例外:
SQLException- データベース・アクセス・エラーが発生した場合- 関連項目:
setTypeMap(java.util.Map<java.lang.String, java.lang.Class<?>>)
-
setTypeMap
void setTypeMap(Map<String,Class<?>> map) throws SQLException
このRowSetオブジェクトのデフォルトの型マップとして指定されたjava.util.Mapオブジェクトをインストールします。 別の型マップがメソッドのパラメータとして指定されるまで、この型マップが使用されます。- パラメータ:
map- SQLユーザー定義型とそれらがマッピングされるJavaクラスが格納されているjava.util.Mapオブジェクト- 例外:
SQLException- データベース・アクセス・エラーが発生した場合- 関連項目:
getTypeMap()
-
getCommand
String getCommand()
このRowSetオブジェクトのcommandプロパティを取得します。 commandプロパティには、SQLクエリーであるコマンド文字列が格納されます。これは、行セットにデータを格納するために実行されます。 デフォルト値はnullです。- 戻り値:
- コマンド文字列。
nullも可 - 関連項目:
setCommand(java.lang.String)
-
setCommand
void setCommand(String cmd) throws SQLException
このRowSetオブジェクトのcommandプロパティにSQLクエリーを設定します。 行セットがコマンドをサポートしないデータ・ソースからデータを得る場合(スプレッドシートなど)、このプロパティはオプションです。- パラメータ:
cmd- このRowSetオブジェクトのデータを取得するために使用されるSQLクエリー。nullも可- 例外:
SQLException- データベース・アクセス・エラーが発生した場合- 関連項目:
getCommand()
-
isReadOnly
boolean isReadOnly()
このRowSetオブジェクトが読取り専用かどうかを確認します。 更新が可能な場合、行セットのデフォルトは更新可能になります。読取り専用の行セットを更新しようとすると、
SQLExceptionがスローされます。- 戻り値:
- この
RowSetオブジェクトが読取り専用の場合はtrue、更新可能な場合はfalse - 関連項目:
setReadOnly(boolean)
-
setReadOnly
void setReadOnly(boolean value) throws SQLExceptionこのRowSetオブジェクトが読取り専用かどうかを、指定したbooleanに設定します。- パラメータ:
value- 読取り専用の場合はtrue、更新可能な場合はfalse- 例外:
SQLException- データベース・アクセス・エラーが発生した場合- 関連項目:
isReadOnly()
-
getMaxFieldSize
int getMaxFieldSize() throws SQLExceptionある列値で返される最大バイト数を取得します。 この制限値は、BINARY、VARBINARY、LONGVARBINARYBINARY、CHAR、VARCHAR、LONGVARCHAR、NCHAR、およびNVARCHARの各列だけに適用されます。 制限値を超えたデータは通知なしに破棄されます。- 戻り値:
- 現在の最大列サイズ制限値。0は制限がないことを表す
- 例外:
SQLException- データベース・アクセス・エラーが発生した場合- 関連項目:
setMaxFieldSize(int)
-
setMaxFieldSize
void setMaxFieldSize(int max) throws SQLException列値に返される最大バイト数を、指定されたバイト数に設定します。 この制限値は、BINARY、VARBINARY、LONGVARBINARYBINARY、CHAR、VARCHAR、LONGVARCHAR、NCHAR、およびNVARCHARの各列だけに適用されます。 制限値を超えたデータは通知なしに破棄されます。 移植性を最大限にするには、256より大きい値を使用します。- パラメータ:
max- 新しい最大列サイズの制限値(バイト)。ゼロは無制限を意味する- 例外:
SQLException- データベース・アクセス・エラーが発生した場合- 関連項目:
getMaxFieldSize()
-
getMaxRows
int getMaxRows() throws SQLExceptionこのRowSetオブジェクトに含めることのできる最大行数を取得します。 制限値を超えた行は通知なしに除外されます。- 戻り値:
- この
RowSetオブジェクトに含めることのできる現在の最大行数。ゼロは無制限を意味する - 例外:
SQLException- データベース・アクセス・エラーが発生した場合- 関連項目:
setMaxRows(int)
-
setMaxRows
void setMaxRows(int max) throws SQLExceptionデータベース・アクセス・エラーが発生した場合、このRowSetオブジェクトに含めることのできる最大の行数を、指定した値に設定します。 制限値を超えた行は通知なしに除外されます。- パラメータ:
max- 新しい最大行数。ゼロは無制限を意味する- 例外:
SQLException- データベース・アクセス・エラーが発生した場合- 関連項目:
getMaxRows()
-
getEscapeProcessing
boolean getEscapeProcessing() throws SQLExceptionこのRowSetオブジェクトのエスケープの処理が有効かどうかを取得します。 エスケープ・スキャニングが有効の場合(デフォルト)、ドライバはSQL文をデータベースに送る前にエスケープ置換えを実行します。- 戻り値:
- エスケープ処理が有効な場合は
true、無効な場合はfalse - 例外:
SQLException- データベース・アクセス・エラーが発生した場合- 関連項目:
setEscapeProcessing(boolean)
-
setEscapeProcessing
void setEscapeProcessing(boolean enable) throws SQLExceptionこのRowSetオブジェクトのエスケープの処理をオンまたはオフに設定します。 エスケープ・スキャニングがオンの場合(デフォルト)、ドライバはSQL文をデータベースに送る前にエスケープ置換えを実行します。- パラメータ:
enable- エスケープ処理を有効にする場合はtrue、無効にする場合はfalse- 例外:
SQLException- データベース・アクセス・エラーが発生した場合- 関連項目:
getEscapeProcessing()
-
getQueryTimeout
int getQueryTimeout() throws SQLExceptionドライバが文の実行を待つ最大秒数を取得します。 この制限時間を経過すると、SQLExceptionがスローされます。- 戻り値:
- 現在のクエリー・タイムアウトの制限値(秒数)。ゼロは無制限を意味する
- 例外:
SQLException- データベース・アクセス・エラーが発生した場合- 関連項目:
setQueryTimeout(int)
-
setQueryTimeout
void setQueryTimeout(int seconds) throws SQLExceptionデータベース・アクセス・エラーが発生した場合にドライバが文の実行を待つ最大時間を、指定した秒数に設定します。 この制限時間を経過すると、SQLExceptionがスローされます。- パラメータ:
seconds- 新しいクエリー・タイムアウトの制限値の秒数。ゼロは無制限を意味する- 例外:
SQLException- データベース・アクセス・エラーが発生した場合- 関連項目:
getQueryTimeout()
-
setType
void setType(int type) throws SQLExceptionこのRowSetオブジェクトの型を、指定した型に設定します。 このメソッドは、デフォルトで読取り専用でスクロール不可の行セットの型を変更するために用いられます。- パラメータ:
type- タイプを指定するResultSet定数。ResultSet.TYPE_FORWARD_ONLY、ResultSet.TYPE_SCROLL_INSENSITIVE、またはResultSet.TYPE_SCROLL_SENSITIVE- 例外:
SQLException- データベース・アクセス・エラーが発生した場合- 関連項目:
ResultSet.getType()
-
setConcurrency
void setConcurrency(int concurrency) throws SQLExceptionこのRowSetオブジェクトの並行性を、指定した並行性レベルに設定します。 このメソッドは、デフォルトでResultSet.CONCUR_READ_ONLYである行セットの並行性レベルを変更するために用いられます。- パラメータ:
concurrency- 並行処理のレベルを指定するResultSet定数。ResultSet.CONCUR_READ_ONLYまたはResultSet.CONCUR_UPDATABLE- 例外:
SQLException- データベース・アクセス・エラーが発生した場合- 関連項目:
ResultSet.getConcurrency()
-
setNull
void setNull(int parameterIndex, int sqlType) throws SQLExceptionこのRowSetオブジェクトのSQLコマンド内の指定されたパラメータを、SQLNULLに設定します。注: パラメータのSQLの型を指定する必要があります。
- パラメータ:
parameterIndex- 最初のパラメータは1、2番目のパラメータは2、... となるsqlType-java.sql.Typesによって定義されるSQL型のコード- 例外:
SQLException- データベース・アクセス・エラーが発生した場合
-
setNull
void setNull(String parameterName, int sqlType) throws SQLException
指定されたパラメータをSQLNULLに設定します。注: パラメータのSQLの型を指定する必要があります。
- パラメータ:
parameterName- パラメータの名前sqlType-java.sql.Typesで定義されるSQL型コード- 例外:
SQLException- データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementについて呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.4
-
setNull
void setNull(int paramIndex, int sqlType, String typeName) throws SQLExceptionこのRowSetオブジェクトのSQLコマンド内の指定されたパラメータを、SQLNULLに設定します。 SQLユーザー定義型(UDT)およびREF型のパラメータでは、このバージョンのsetNullメソッドを使用する必要があります。 UDTの例には、STRUCT、DISTINCT、JAVA_OBJECT、および名前付き配列があります。注: 移植性を実現するためには、アプリケーションはNULLのユーザー定義パラメータまたは
REFパラメータを指定するときにSQL型コードおよび完全指定のSQL型名を指定しなければいけません。 ユーザー定義型の場合、名前はパラメータ自体の型名です。REFパラメータの場合、名前は参照される型の型名です。 JDBCドライバが型コードまたは型名の情報を必要としない場合、それは無視されます。 UDTおよびREFパラメータを対象としていますが、このメソッドは任意のJDBC型のnullパラメータを設定するために使用できます。 パラメータがユーザー定義の型またはREF型を持たない場合、typeNameパラメータは無視されます。- パラメータ:
paramIndex- 最初のパラメータは1、2番目のパラメータは2、... となるsqlType-java.sql.Typesからの値typeName- SQL UDTの完全指定名、またはREF型で参照されるSQL構造型の型名。パラメータがUDTまたはREF型でない場合は無視される- 例外:
SQLException- データベース・アクセス・エラーが発生した場合
-
setNull
void setNull(String parameterName, int sqlType, String typeName) throws SQLException
指定されたパラメータをSQLNULLに設定します。 ユーザー定義型およびREF型のパラメータでは、このバージョンのsetNullメソッドを使用するべきです。 ユーザー定義型の例には、STRUCT、DISTINCT、JAVA_OBJECT、および名前付き配列があります。注: 移植性を実現するためには、アプリケーションはNULLのユーザー定義パラメータまたはREFパラメータを指定するときにSQL型コードおよび完全指定のSQL型名を指定しなければいけません。 ユーザー定義型の場合、名前はパラメータ自体の型名です。 REFパラメータの場合、名前は参照される型の型名です。 JDBCドライバが型コードまたは型名の情報を必要としない場合、それは無視されます。 ユーザー定義パラメータおよびREFパラメータを対象としていますが、このメソッドは任意のJDBC型のnullパラメータを設定するために使用できます。 パラメータがユーザー定義の型またはREF型を持たない場合、指定されたtypeNameは無視されます。
- パラメータ:
parameterName- パラメータの名前sqlType-java.sql.Typesからの値typeName- SQLユーザー定義型の完全指定された名前。パラメータがユーザー定義型でもSQLREF値でもない場合は無視される- 例外:
SQLException- データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementについて呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.4
-
setBoolean
void setBoolean(int parameterIndex, boolean x) throws SQLExceptionこのRowSetオブジェクトのコマンド内の指定されたパラメータを、指定されたJavaboolean値に設定します。 このパラメータは、データベースに送信される前に、ドライバによってSQLBIT値に変換されます。- パラメータ:
parameterIndex- 最初のパラメータは1、2番目のパラメータは2、... となるx- パラメータ値- 例外:
SQLException- データベース・アクセス・エラーが発生した場合
-
setBoolean
void setBoolean(String parameterName, boolean x) throws SQLException
指定されたパラメータを指定されたJavaのboolean値に設定します。 データベースに送るときに、ドライバはこれをSQLBITまたはBOOLEAN値に変換します。- パラメータ:
parameterName- パラメータの名前x- パラメータ値- 例外:
SQLException- データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementについて呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.4
- 関連項目:
ResultSet.getBoolean(int)
-
setByte
void setByte(int parameterIndex, byte x) throws SQLExceptionこのRowSetオブジェクトのコマンド内の指定されたパラメータを、指定されたJavabyte値に設定します。 このパラメータは、データベースに送信される前に、ドライバによってSQLTINYINT値に変換されます。- パラメータ:
parameterIndex- 最初のパラメータは1、2番目のパラメータは2、... となるx- パラメータ値- 例外:
SQLException- データベース・アクセス・エラーが発生した場合
-
setByte
void setByte(String parameterName, byte x) throws SQLException
指定されたパラメータを指定されたJavaのbyte値に設定します。 データベースに送るときに、ドライバはこれをSQLTINYINT値に変換します。- パラメータ:
parameterName- パラメータの名前x- パラメータ値- 例外:
SQLException- データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementについて呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.4
- 関連項目:
ResultSet.getByte(int)
-
setShort
void setShort(int parameterIndex, short x) throws SQLExceptionこのRowSetオブジェクトのコマンド内の指定されたパラメータを、指定されたJavashort値に設定します。 このパラメータは、データベースに送信される前に、ドライバによってSQLSMALLINT値に変換されます。- パラメータ:
parameterIndex- 最初のパラメータは1、2番目のパラメータは2、... となるx- パラメータ値- 例外:
SQLException- データベース・アクセス・エラーが発生した場合
-
setShort
void setShort(String parameterName, short x) throws SQLException
指定されたパラメータを指定されたJavaのshort値に設定します。 データベースに送るときに、ドライバはこれをSQLSMALLINT値に変換します。- パラメータ:
parameterName- パラメータの名前x- パラメータ値- 例外:
SQLException- データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementについて呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.4
- 関連項目:
ResultSet.getShort(int)
-
setInt
void setInt(int parameterIndex, int x) throws SQLExceptionこのRowSetオブジェクトのコマンド内の指定されたパラメータを、指定されたJavaint値に設定します。 このパラメータは、データベースに送信される前に、ドライバによってSQLINTEGER値に変換されます。- パラメータ:
parameterIndex- 最初のパラメータは1、2番目のパラメータは2、... となるx- パラメータ値- 例外:
SQLException- データベース・アクセス・エラーが発生した場合
-
setInt
void setInt(String parameterName, int x) throws SQLException
指定されたパラメータを指定されたJavaのint値に設定します。 データベースに送るときに、ドライバはこれをSQLINTEGER値に変換します。- パラメータ:
parameterName- パラメータの名前x- パラメータ値- 例外:
SQLException- データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementについて呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.4
- 関連項目:
ResultSet.getInt(int)
-
setLong
void setLong(int parameterIndex, long x) throws SQLExceptionこのRowSetオブジェクトのコマンド内の指定されたパラメータを、指定されたJavalong値に設定します。 このパラメータは、データベースに送信される前に、ドライバによってSQLBIGINT値に変換されます。- パラメータ:
parameterIndex- 最初のパラメータは1、2番目のパラメータは2、... となるx- パラメータ値- 例外:
SQLException- データベース・アクセス・エラーが発生した場合
-
setLong
void setLong(String parameterName, long x) throws SQLException
指定されたパラメータを指定されたJavaのlong値に設定します。 データベースに送るときに、ドライバはこれをSQLBIGINT値に変換します。- パラメータ:
parameterName- パラメータの名前x- パラメータ値- 例外:
SQLException- データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementについて呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.4
- 関連項目:
ResultSet.getLong(int)
-
setFloat
void setFloat(int parameterIndex, float x) throws SQLExceptionこのRowSetオブジェクトのコマンド内の指定されたパラメータを、指定されたJavafloat値に設定します。 このパラメータは、データベースに送信される前に、ドライバによってSQLREAL値に変換されます。- パラメータ:
parameterIndex- 最初のパラメータは1、2番目のパラメータは2、... となるx- パラメータ値- 例外:
SQLException- データベース・アクセス・エラーが発生した場合
-
setFloat
void setFloat(String parameterName, float x) throws SQLException
指定されたパラメータを指定されたJavaのfloat値に設定します。 データベースに送るときに、ドライバはこれをSQLFLOAT値に変換します。- パラメータ:
parameterName- パラメータの名前x- パラメータ値- 例外:
SQLException- データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementについて呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.4
- 関連項目:
ResultSet.getFloat(int)
-
setDouble
void setDouble(int parameterIndex, double x) throws SQLExceptionこのRowSetオブジェクトのコマンド内の指定されたパラメータを、指定されたJavadouble値に設定します。 このパラメータは、データベースに送信される前に、ドライバによってSQLDOUBLE値に変換されます。- パラメータ:
parameterIndex- 最初のパラメータは1、2番目のパラメータは2、... となるx- パラメータ値- 例外:
SQLException- データベース・アクセス・エラーが発生した場合
-
setDouble
void setDouble(String parameterName, double x) throws SQLException
指定されたパラメータを指定されたJavaのdouble値に設定します。 データベースに送るときに、ドライバはこれをSQLDOUBLE値に変換します。- パラメータ:
parameterName- パラメータの名前x- パラメータ値- 例外:
SQLException- データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementについて呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.4
- 関連項目:
ResultSet.getDouble(int)
-
setBigDecimal
void setBigDecimal(int parameterIndex, BigDecimal x) throws SQLExceptionこのRowSetオブジェクト・コマンド内の指定されたパラメータを、指定されたjava.math.BigDecimal値に設定します。 このパラメータは、データベースに送信される前に、ドライバによってSQLNUMERIC値に変換されます。- パラメータ:
parameterIndex- 最初のパラメータは1、2番目のパラメータは2、... となるx- パラメータ値- 例外:
SQLException- データベース・アクセス・エラーが発生した場合
-
setBigDecimal
void setBigDecimal(String parameterName, BigDecimal x) throws SQLException
指定されたパラメータを、指定されたjava.math.BigDecimal値に設定します。 データベースに送るときに、ドライバはこれをSQLNUMERIC値に変換します。- パラメータ:
parameterName- パラメータの名前x- パラメータ値- 例外:
SQLException- データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementについて呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.4
- 関連項目:
ResultSet.getBigDecimal(int, int)
-
setString
void setString(int parameterIndex, String x) throws SQLExceptionこのRowSetオブジェクトのコマンド内の指定されたパラメータを、指定されたJavaString値に設定します。 これは、データベースへの送信前に、ドライバによってSQLVARCHARまたはLONGVARCHAR値に変換されます(ドライバのVARCHAR値の制限に関する引数のサイズに依存)。- パラメータ:
parameterIndex- 最初のパラメータは1、2番目のパラメータは2、... となるx- パラメータ値- 例外:
SQLException- データベース・アクセス・エラーが発生した場合
-
setString
void setString(String parameterName, String x) throws SQLException
指定されたパラメータを指定されたJavaのString値に設定します。 データベースに送るときに、ドライバはこれをSQLVARCHARまたはLONGVARCHAR値(ドライバのVARCHAR値の制限に対する引数のサイズに依存)に変換します。- パラメータ:
parameterName- パラメータの名前x- パラメータ値- 例外:
SQLException- データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementについて呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.4
- 関連項目:
ResultSet.getString(int)
-
setBytes
void setBytes(int parameterIndex, byte[] x) throws SQLExceptionこのRowSetオブジェクトのコマンド内の指定したパラメータを、byte値の指定したJava配列値に設定します。 これは、データベースへの送信前に、ドライバによってSQLVARBINARYまたはLONGVARBINARY値に変換されます(ドライバのVARBINARY値の制限に関する引数のサイズに依存)。- パラメータ:
parameterIndex- 最初のパラメータは1、2番目のパラメータは2、... となるx- パラメータ値- 例外:
SQLException- データベース・アクセス・エラーが発生した場合
-
setBytes
void setBytes(String parameterName, byte[] x) throws SQLException
指定されたパラメータを指定されたJavaのバイト配列に設定します。 データベースに送るときに、ドライバはこれをSQLVARBINARYまたはLONGVARBINARY(ドライバのVARBINARY値の制限に対する引数のサイズに依存)に変換します。- パラメータ:
parameterName- パラメータの名前x- パラメータ値- 例外:
SQLException- データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementについて呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.4
- 関連項目:
ResultSet.getBytes(int)
-
setDate
void setDate(int parameterIndex, Date x) throws SQLExceptionこのRowSetオブジェクトのコマンド内の指定されたパラメータを、指定されたjava.sql.Date値に設定します。 このパラメータは、データベースへの送信前に、デフォルトのjava.util.Calendarを使用して日付が計算され、ドライバによってSQLDATE値に変換されます。- パラメータ:
parameterIndex- 最初のパラメータは1、2番目のパラメータは2、... となるx- パラメータ値- 例外:
SQLException- データベース・アクセス・エラーが発生した場合
-
setTime
void setTime(int parameterIndex, Time x) throws SQLExceptionこのRowSetオブジェクトのコマンド内の指定されたパラメータを、指定されたjava.sql.Time値に設定します。 このパラメータは、データベースへの送信前に、デフォルトのjava.util.Calendarを使用して計算され、ドライバによってSQLTIME値に変換されます。- パラメータ:
parameterIndex- 最初のパラメータは1、2番目のパラメータは2、... となるx- パラメータ値- 例外:
SQLException- データベース・アクセス・エラーが発生した場合
-
setTimestamp
void setTimestamp(int parameterIndex, Timestamp x) throws SQLExceptionこのRowSetオブジェクトのコマンド内の指定されたパラメータを、指定されたjava.sql.Timestamp値に設定します。 このパラメータは、データベースへの送信前に、デフォルトのjava.util.Calendarを使用して計算され、ドライバによってSQLTIMESTAMP値に変換されます。- パラメータ:
parameterIndex- 最初のパラメータは1、2番目のパラメータは2、... となるx- パラメータ値- 例外:
SQLException- データベース・アクセス・エラーが発生した場合
-
setTimestamp
void setTimestamp(String parameterName, Timestamp x) throws SQLException
指定されたパラメータを、指定されたjava.sql.Timestamp値に設定します。 データベースに送るときに、ドライバはこれをSQLTIMESTAMP値に変換します。- パラメータ:
parameterName- パラメータの名前x- パラメータ値- 例外:
SQLException- データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementについて呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.4
- 関連項目:
ResultSet.getTimestamp(int)
-
setAsciiStream
void setAsciiStream(int parameterIndex, InputStream x, int length) throws SQLExceptionこのRowSetオブジェクトのコマンド内の指定されたパラメータを、指定されたjava.io.InputStream値に設定します。java.io.InputStreamを介して非常に大きなASCII値を送信するほうが、LONGVARCHARパラメータを使用するより現実的です。 ファイルの終わりに達するまで必要に応じて、ドライバによってデータがストリームから読み取られます。注: このストリーム・オブジェクトは、標準のJavaストリーム・オブジェクト、または標準インタフェースを実装する独自のサブクラスのどちらでもかまいません。
- パラメータ:
parameterIndex- 最初のパラメータは1、2番目のパラメータは2、... となるx- ASCIIパラメータ値を含むJava入力ストリームlength- ストリームのバイト数- 例外:
SQLException- データベース・アクセス・エラーが発生した場合
-
setAsciiStream
void setAsciiStream(String parameterName, InputStream x, int length) throws SQLException
指定されたパラメータを、指定されたバイト数を持つ指定された入力ストリームに設定します。LONGVARCHARパラメータに非常に大きなASCII値が入力されるときには、java.io.InputStreamを介して送るのが現実的です。 ファイルの終わりに達するまで必要に応じてストリームからデータが読み込まれます。 JDBCドライバは、データをASCIIからデータベースのchar形式に変換します。注: このストリーム・オブジェクトは、標準のJavaストリーム・オブジェクト、または標準インタフェースを実装する独自のサブクラスのどちらでもかまいません。
- パラメータ:
parameterName- パラメータの名前x- ASCIIパラメータ値を含むJava入力ストリームlength- ストリームのバイト数- 例外:
SQLException- データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementについて呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.4
-
setBinaryStream
void setBinaryStream(int parameterIndex, InputStream x, int length) throws SQLExceptionこのRowSetオブジェクトのコマンド内の指定されたパラメータを、指定されたjava.io.InputStream値に設定します。java.io.InputStreamを介して非常に大きなバイナリ値を送信するほうが、LONGVARBINARYパラメータを使用するより現実的です。 ファイルの終わりに達するまで必要に応じて、ドライバによってデータがストリームから読み取られます。注: このストリーム・オブジェクトは、標準のJavaストリーム・オブジェクト、または標準インタフェースを実装する独自のサブクラスのどちらでもかまいません。
- パラメータ:
parameterIndex- 最初のパラメータは1、2番目のパラメータは2、... となるx- バイナリ・パラメータ値を含むJava入力ストリームlength- ストリームのバイト数- 例外:
SQLException- データベース・アクセス・エラーが発生した場合
-
setBinaryStream
void setBinaryStream(String parameterName, InputStream x, int length) throws SQLException
指定されたパラメータを、指定されたバイト数を持つ指定された入力ストリームに設定します。LONGVARBINARYパラメータに非常に大きなバイナリ値が入力されるときには、java.io.InputStreamオブジェクトを介して送るのが現実的です。 ファイルの終わりに達するまで必要に応じてストリームからデータが読み込まれます。注: このストリーム・オブジェクトは、標準のJavaストリーム・オブジェクト、または標準インタフェースを実装する独自のサブクラスのどちらでもかまいません。
- パラメータ:
parameterName- パラメータの名前x- バイナリ・パラメータ値を含むJava入力ストリームlength- ストリームのバイト数- 例外:
SQLException- データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementについて呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.4
-
setCharacterStream
void setCharacterStream(int parameterIndex, Reader reader, int length) throws SQLExceptionこのRowSetオブジェクトのコマンド内の指定されたパラメータを、指定されたjava.io.Reader値に設定します。java.io.Readerを介して非常に大きなUNICODE値を送信するほうが、LONGVARCHARパラメータを使用するより現実的です。 ファイルの終わりに達するまで必要に応じて、ドライバによってデータがストリームから読み取られます。注: このストリーム・オブジェクトは、標準のJavaストリーム・オブジェクト、または標準インタフェースを実装する独自のサブクラスのどちらでもかまいません。
- パラメータ:
parameterIndex- 最初のパラメータは1、2番目のパラメータは2、... となるreader- 設定するUNICODEデータを含むReaderオブジェクトlength- ストリーム内の文字数- 例外:
SQLException- データベース・アクセス・エラーが発生した場合
-
setCharacterStream
void setCharacterStream(String parameterName, Reader reader, int length) throws SQLException
指定されたパラメータを、指定された文字数である指定されたReaderオブジェクトに設定します。LONGVARCHARパラメータに非常に大きなUNICODE値が入力されるときには、java.io.Readerオブジェクトを介して送るのが現実的です。 ファイルの終わりに達するまで必要に応じてストリームからデータが読み込まれます。 JDBCドライバは、データをUNICODEからデータベースのchar形式に変換します。注: このストリーム・オブジェクトは、標準のJavaストリーム・オブジェクト、または標準インタフェースを実装する独自のサブクラスのどちらでもかまいません。
- パラメータ:
parameterName- パラメータの名前reader- 指定されたパラメータとして使用されるUNICODEデータを含むjava.io.Readerオブジェクトlength- ストリーム内の文字数- 例外:
SQLException- データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementについて呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.4
-
setAsciiStream
void setAsciiStream(int parameterIndex, InputStream x) throws SQLExceptionこのRowSetオブジェクトのコマンド内の指定されたパラメータを、指定された入力ストリームに設定します。LONGVARCHARパラメータに非常に大きなASCII値が入力されるときには、java.io.InputStreamを介して送るのが現実的です。 ファイルの終わりに達するまで必要に応じてストリームからデータが読み込まれます。 JDBCドライバは、データをASCIIからデータベースのchar形式に変換します。注: このストリーム・オブジェクトは、標準のJavaストリーム・オブジェクト、または標準インタフェースを実装する独自のサブクラスのどちらでもかまいません。
注: lengthパラメータを使用するバージョンの
setAsciiStreamを使用する方が効率的かどうかを判断するには、JDBCドライバのドキュメントを参照してください。- パラメータ:
parameterIndex- 最初のパラメータは1、2番目のパラメータは2、... となるx- ASCIIパラメータ値を含むJava入力ストリーム- 例外:
SQLException- データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたPreparedStatementについて呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
setAsciiStream
void setAsciiStream(String parameterName, InputStream x) throws SQLException
指定されたパラメータを指定された入力ストリームに設定します。LONGVARCHARパラメータに非常に大きなASCII値が入力されるときには、java.io.InputStreamを介して送るのが現実的です。 ファイルの終わりに達するまで必要に応じてストリームからデータが読み込まれます。 JDBCドライバは、データをASCIIからデータベースのchar形式に変換します。注: このストリーム・オブジェクトは、標準のJavaストリーム・オブジェクト、または標準インタフェースを実装する独自のサブクラスのどちらでもかまいません。
注: lengthパラメータを使用するバージョンの
setAsciiStreamを使用する方が効率的かどうかを判断するには、JDBCドライバのドキュメントを参照してください。- パラメータ:
parameterName- パラメータの名前x- ASCIIパラメータ値を含むJava入力ストリーム- 例外:
SQLException- データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementについて呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
setBinaryStream
void setBinaryStream(int parameterIndex, InputStream x) throws SQLExceptionこのRowSetオブジェクトのコマンド内の指定されたパラメータを、指定された入力ストリームに設定します。LONGVARBINARYパラメータに非常に大きなバイナリ値が入力されるときには、java.io.InputStreamオブジェクトを介して送るのが現実的です。 ファイルの終わりに達するまで必要に応じてストリームからデータが読み込まれます。注: このストリーム・オブジェクトは、標準のJavaストリーム・オブジェクト、または標準インタフェースを実装する独自のサブクラスのどちらでもかまいません。
注: lengthパラメータを使用するバージョンの
setBinaryStreamを使用する方が効率的かどうかを判断するには、JDBCドライバのドキュメントを参照してください。- パラメータ:
parameterIndex- 最初のパラメータは1、2番目のパラメータは2、... となるx- バイナリ・パラメータ値を含むJava入力ストリーム- 例外:
SQLException- データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたPreparedStatementについて呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
setBinaryStream
void setBinaryStream(String parameterName, InputStream x) throws SQLException
指定されたパラメータを指定された入力ストリームに設定します。LONGVARBINARYパラメータに非常に大きなバイナリ値が入力されるときには、java.io.InputStreamオブジェクトを介して送るのが現実的です。 ファイルの終わりに達するまで必要に応じてストリームからデータが読み込まれます。注: このストリーム・オブジェクトは、標準のJavaストリーム・オブジェクト、または標準インタフェースを実装する独自のサブクラスのどちらでもかまいません。
注: lengthパラメータを使用するバージョンの
setBinaryStreamを使用する方が効率的かどうかを判断するには、JDBCドライバのドキュメントを参照してください。- パラメータ:
parameterName- パラメータの名前x- バイナリ・パラメータ値を含むJava入力ストリーム- 例外:
SQLException- データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementについて呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
setCharacterStream
void setCharacterStream(int parameterIndex, Reader reader) throws SQLExceptionこのRowSetオブジェクトのコマンド内の指定されたパラメータを、指定されたReaderオブジェクトに設定します。LONGVARCHARパラメータに非常に大きなUNICODE値が入力されるときには、java.io.Readerオブジェクトを介して送るのが現実的です。 ファイルの終わりに達するまで必要に応じてストリームからデータが読み込まれます。 JDBCドライバは、データをUNICODEからデータベースのchar形式に変換します。注: このストリーム・オブジェクトは、標準のJavaストリーム・オブジェクト、または標準インタフェースを実装する独自のサブクラスのどちらでもかまいません。
注: lengthパラメータを使用するバージョンの
setCharacterStreamを使用する方が効率的かどうかを判断するには、JDBCドライバのドキュメントを参照してください。- パラメータ:
parameterIndex- 最初のパラメータは1、2番目のパラメータは2、... となるreader- Unicodeデータを格納するjava.io.Readerオブジェクト- 例外:
SQLException- データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたPreparedStatementについて呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
setCharacterStream
void setCharacterStream(String parameterName, Reader reader) throws SQLException
指定されたパラメータを指定されたReaderオブジェクトに設定します。LONGVARCHARパラメータに非常に大きなUNICODE値が入力されるときには、java.io.Readerオブジェクトを介して送るのが現実的です。 ファイルの終わりに達するまで必要に応じてストリームからデータが読み込まれます。 JDBCドライバは、データをUNICODEからデータベースのchar形式に変換します。注: このストリーム・オブジェクトは、標準のJavaストリーム・オブジェクト、または標準インタフェースを実装する独自のサブクラスのどちらでもかまいません。
注: lengthパラメータを使用するバージョンの
setCharacterStreamを使用する方が効率的かどうかを判断するには、JDBCドライバのドキュメントを参照してください。- パラメータ:
parameterName- パラメータの名前reader- Unicodeデータを格納するjava.io.Readerオブジェクト- 例外:
SQLException- データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementについて呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
setNCharacterStream
void setNCharacterStream(int parameterIndex, Reader value) throws SQLExceptionこのRowSetオブジェクトのコマンド内の指定されたパラメータを、Readerオブジェクトに設定します。Readerは、ファイルの終わりに達するまでデータを読み込みます。 ドライバは、必要に応じて、Javaの文字表現をデータベース内の各国文字セットに変換します。注: このストリーム・オブジェクトは、標準のJavaストリーム・オブジェクト、または標準インタフェースを実装する独自のサブクラスのどちらでもかまいません。
注: lengthパラメータを使用するバージョンの
setNCharacterStreamを使用する方が効率的かどうかを判断するには、JDBCドライバのドキュメントを参照してください。- パラメータ:
parameterIndex- 最初のパラメータのインデックスは1、2番目のパラメータのインデックスは2、... となるvalue- パラメータ値- 例外:
SQLException- ドライバが各国文字セットをサポートしない場合、ドライバがデータ変換エラーが発生した可能性を検出できる場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたPreparedStatement上で呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
setObject
void setObject(int parameterIndex, Object x, int targetSqlType, int scaleOrLength) throws SQLExceptionこのRowSetオブジェクトのコマンド内の指定したパラメータを、指定したJavaObjectに設定します。 整数値の場合は等価なjava.langオブジェクトを使用する必要があります(たとえばintに対してIntegerクラスのインスタンス)。 2番目の引数がInputStreamである場合、ストリームにはscaleOrLengthで指定されるバイト数が含まれる必要があります。 2番目の引数がReaderの場合、ReaderにはscaleOrLengthで指定された文字数が含まれている必要があります。 これらの条件がtrueではない場合、準備された文の実行時にドライバはSQLExceptionを生成します。指定されたJavaオブジェクトは、データベースに送られる前にtargetSqlTypeに変換されます。
オブジェクトのクラスが
SQLDataを実装する場合は、行セットでSQLData.writeSQLメソッドを呼び出して、オブジェクトをSQLOutputデータ・ストリームに書き込む必要があります。 また、オブジェクトがRef、Blob、Clob、NClob、Struct、java.net.URL、またはArrayを実装するクラスのオブジェクトである場合、ドライバはこのオブジェクトを対応するSQL型の値としてデータベースに渡す必要があります。このメソッドは、データベース固有の抽象データ型を渡すために使用することに注意してください。
- パラメータ:
parameterIndex- 最初のパラメータは1、2番目のパラメータは2、... となるx- 入力パラメータ値を含むオブジェクトtargetSqlType- データベースに送られる(java.sql.Typesで定義される) SQL型。 scale引数で、さらにこの型を限定できる。scaleOrLength-java.sql.Types.DECIMALまたはjava.sql.Types.NUMERIC typesの場合、これは小数点のあとの桁数になる。 Javaオブジェクト型InputStreamおよびReaderの場合、ストリームまたはReader内のデータの長さです。 ほかのすべての型では、この値は無視される。- 例外:
SQLException- データベース・アクセス・エラーが発生した場合- 関連項目:
Types
-
setObject
void setObject(String parameterName, Object x, int targetSqlType, int scale) throws SQLException
指定されたパラメータの値を、指定されたオブジェクトで設定します。 2番目の引数はオブジェクト型である必要があります。整数値の場合は等価なjava.langオブジェクトを使用すべきです。指定されたJavaオブジェクトは、データベースに送られる前に、指定されたtargetSqlTypeに変換されます。 オブジェクトがカスタム・マッピングを持つ場合(オブジェクトがインタフェース
SQLDataを実装するクラスのインスタンスである場合)、JDBCドライバはSQLData.writeSQLメソッドを呼び出して、そのオブジェクトをSQLデータ・ストリームへ書き込む必要があります。 また、オブジェクトがRef、Blob、Clob、NClob、Struct、java.net.URL、またはArrayを実装するクラスのオブジェクトである場合、ドライバはこのオブジェクトを対応するSQL型の値としてデータベースに渡す必要があります。このメソッドは、データベース固有の抽象データ型を渡すために使用することに注意してください。
- パラメータ:
parameterName- パラメータの名前x- 入力パラメータ値を含むオブジェクトtargetSqlType- データベースに送られる(java.sql.Typesで定義される) SQL型。 scale引数で、さらにこの型を限定できる。scale- java.sql.Types.DECIMALやjava.sql.Types.NUMERIC型では、小数点以下の桁数。 ほかのすべての型では、この値は無視される。- 例外:
SQLException- データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementについて呼び出された場合SQLFeatureNotSupportedException-targetSqlTypeのデータ型が、ARRAY、BLOB、CLOB、DATALINK、JAVA_OBJECT、NCHAR、NCLOB、NVARCHAR、LONGNVARCHAR、REF、ROWID、SQLXML、またはSTRUCTで、JDBCドライバがこのデータ型をサポートしていない場合- 導入されたバージョン:
- 1.4
- 関連項目:
Types、ResultSet.getObject(int)
-
setObject
void setObject(int parameterIndex, Object x, int targetSqlType) throws SQLExceptionこのRowSetオブジェクトのコマンド内の指定したパラメータを、JavaObjectに設定します。 整数値の場合は等価なjava.langオブジェクトを使用する必要があります。 このメソッドは前述のsetObjectに似ていますが、使われるスケールは2番目のパラメータのスケールになります。 スカラー値のスケールは0です。 リテラル値が保持するスケールは、リテラル内に存在します。浮動小数点の入力値でこのメソッドを呼び出すことは、サポートされていますが推奨はされていません。
- パラメータ:
parameterIndex- 最初のパラメータは1、2番目のパラメータは2、... となるx- 入力パラメータ値を含むオブジェクトtargetSqlType- データベースに送られる(java.sql.Typesで定義される) SQL型- 例外:
SQLException- データベース・アクセス・エラーが発生した場合
-
setObject
void setObject(String parameterName, Object x, int targetSqlType) throws SQLException
指定されたパラメータの値を、指定されたオブジェクトで設定します。 このメソッドは、上記のsetObjectメソッドに似ていますが、scaleに0を仮定している点が異なります。- パラメータ:
parameterName- パラメータの名前x- 入力パラメータ値を含むオブジェクトtargetSqlType- データベースに送られる(java.sql.Typesで定義される) SQL型- 例外:
SQLException- データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementについて呼び出された場合SQLFeatureNotSupportedException-targetSqlTypeのデータ型が、ARRAY、BLOB、CLOB、DATALINK、JAVA_OBJECT、NCHAR、NCLOB、NVARCHAR、LONGNVARCHAR、REF、ROWID、SQLXML、またはSTRUCTで、JDBCドライバがこのデータ型をサポートしていない場合- 導入されたバージョン:
- 1.4
- 関連項目:
ResultSet.getObject(int)
-
setObject
void setObject(String parameterName, Object x) throws SQLException
指定されたパラメータの値を、指定されたオブジェクトで設定します。 2番目のパラメータはObject型である必要があります。したがって、組込み型の場合、等価なjava.langオブジェクトを使用すべきです。JDBCの仕様では、Javaの
Object型からSQL型への標準マッピングを規定しています。 指定された引数は、データベースに送られる前に、対応するSQL型に変換されます。このメソッドは、ドライバ固有のJava型を使用して、データベース固有の抽象データ型を渡すために使用できます。 オブジェクトがインタフェース
SQLDataを実装するクラスのインスタンスである場合、JDBCドライバはSQLData.writeSQLメソッドを呼び出して、そのオブジェクトをSQLデータ・ストリームへ書き込む必要があります。 また、オブジェクトがRef、Blob、Clob、NClob、Struct、java.net.URL、またはArrayを実装するクラスのオブジェクトである場合、ドライバはこのオブジェクトを対応するSQL型の値としてデータベースに渡す必要があります。たとえば、オブジェクトが上記のインタフェースを複数実装するクラスであるなど、あいまいさがある場合、このメソッドは例外をスローします。
- パラメータ:
parameterName- パラメータの名前x- 入力パラメータ値を含むオブジェクト- 例外:
SQLException- データベース・アクセス・エラーが発生した場合、このメソッドがクローズされたCallableStatementで呼び出された場合、または指定されたObjectパラメータがあいまいな場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.4
- 関連項目:
ResultSet.getObject(int)
-
setObject
void setObject(int parameterIndex, Object x) throws SQLExceptionこのRowSetオブジェクトのコマンド内の指定したパラメータを、JavaObjectに設定します。 整数値の場合は等価なjava.langオブジェクトを使用する必要があります。JDBCは、JavaのObject型からSQL型への標準マッピングを提供します。 指定されたJavaオブジェクトは、データベースに送られる前にドライバによって標準のSQLマッピングに変換されます。
このメソッドは、ドライバ固有のJava型を使用して、データベース固有の抽象データ型を渡すために使用できます。 オブジェクトのクラスが
SQLDataを実装する場合は、行セットでSQLData.writeSQLメソッドを呼び出して、オブジェクトをSQLOutputデータ・ストリームに書き込む必要があります。 また、オブジェクトがRef、Blob、Clob、NClob、Struct、java.net.URL、またはArrayを実装するクラスのオブジェクトである場合、ドライバはこのオブジェクトを対応するSQL型の値としてデータベースに渡す必要があります。たとえば、オブジェクトがこれらのインタフェースを複数実装するクラスであるなど、あいまいさがある場合、例外がスローされます。
- パラメータ:
parameterIndex- 最初のパラメータは1、2番目のパラメータは2、... となるx- 入力パラメータ値を含むオブジェクト- 例外:
SQLException- データベース・アクセス・エラーが発生した場合
-
setRef
void setRef(int i, Ref x) throws SQLExceptionこのRowSetオブジェクトのコマンドで指定したパラメータを、指定したRef値に設定します。 このパラメータはドライバによって適切なREF(<structured-type>)(構造化型)値に変換されます。- パラメータ:
i- 最初のパラメータは1、2番目のパラメータは2、... となるx- SQLREF型のデータを表すオブジェクト- 例外:
SQLException- データベース・アクセス・エラーが発生した場合
-
setBlob
void setBlob(int i, Blob x) throws SQLExceptionこのRowSetオブジェクトのコマンドで指定したパラメータを、指定したBlob値に設定します。 このパラメータは、データベースへの送信前に、ドライバによってBlobオブジェクトが表すBLOB値に変換されます。- パラメータ:
i- 最初のパラメータは1、2番目のパラメータは2、... となるx- BLOBを表すオブジェクト- 例外:
SQLException- データベース・アクセス・エラーが発生した場合
-
setBlob
void setBlob(int parameterIndex, InputStream inputStream, long length) throws SQLException指定されたパラメータをInputStreamオブジェクトに設定します。InputStreamには、長さで指定された文字数が含まれていなければなりません。それ以外の場合は、PreparedStatementが実行されるときにSQLExceptionが生成されます。 このメソッドは、setBinaryStream (int, InputStream, int)メソッドと異なり、パラメータ値をBLOBとしてサーバーに送信するべきであることをドライバに通知します。setBinaryStreamメソッドを使用すると、ドライバは、パラメータ・データをLONGVARBINARYとBLOBのどちらとしてサーバーに送信するべきかを判断するために余計な作業を行う必要がある可能性があります。- パラメータ:
parameterIndex- 最初のパラメータのインデックスは1、2番目のパラメータのインデックスは2、... となるinputStream- パラメータ値に設定されるデータを含むオブジェクト。length- パラメータ・データ内のバイト数。- 例外:
SQLException- データベース・アクセス・エラーが発生した場合、parameterIndexがSQL文のパラメータ・マーカーに対応していない場合、指定された長さが0より小さい場合、またはInputStreamのバイト数が一致しない場合、閉じたPreparedStatementに対してこのメソッドが呼び出されます。SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
setBlob
void setBlob(int parameterIndex, InputStream inputStream) throws SQLException指定されたパラメータをInputStreamオブジェクトに設定します。 このメソッドは、setBinaryStream (int, InputStream)メソッドと異なり、パラメータ値をBLOBとしてサーバーに送信しなければならないことをドライバに通知します。setBinaryStreamメソッドを使用すると、ドライバは、パラメータ・データをLONGVARBINARYとBLOBのどちらとしてサーバーに送信するべきかを判断するために余計な作業を行う必要がある可能性があります。注: lengthパラメータを使用するバージョンの
setBlobを使用する方が効率的かどうかを判断するには、JDBCドライバのドキュメントを参照してください。- パラメータ:
parameterIndex- 最初のパラメータのインデックスは1、2番目のパラメータのインデックスは2、... となるinputStream- パラメータ値に設定されるデータを含むオブジェクト。- 例外:
SQLException- データベース・アクセス・エラーが発生した場合、このメソッドがクローズされたPreparedStatementで呼び出された場合、またはparameterIndexがSQL文のパラメータ・マーカーと対応していない場合、SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
setBlob
void setBlob(String parameterName, InputStream inputStream, long length) throws SQLException
指定されたパラメータをInputStreamオブジェクトに設定します。InputStreamにはlengthで指定された文字数が含まれていなければなりません。そうでない場合は、CallableStatementが実行されるときにSQLExceptionが生成されます。 このメソッドは、setBinaryStream (int, InputStream, int)メソッドと異なり、パラメータ値をBLOBとしてサーバーに送信するべきであることをドライバに通知します。setBinaryStreamメソッドを使用すると、ドライバは、パラメータ・データをLONGVARBINARYとBLOBのどちらとしてサーバーに送信するべきかを判断するために余計な作業を行う必要がある可能性があります。- パラメータ:
parameterName- 2番目は2に設定されるパラメータの名前inputStream- パラメータ値に設定されるデータを含むオブジェクト。length- パラメータ・データ内のバイト数。- 例外:
SQLException- parameterIndexがSQL文のパラメータ・マーカーに対応していない場合、または指定された長さがゼロ未満の場合。InputStreamのバイト数が指定された長さと一致しない場合データベース・アクセス・エラーが発生した場合、またはこのメソッドが閉じられたCallableStatementで呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
setBlob
void setBlob(String parameterName, Blob x) throws SQLException
指定されたパラメータを指定されたjava.sql.Blobオブジェクトに設定します。 データベースに送るときに、ドライバはこれをSQLBLOB値に変換します。- パラメータ:
parameterName- パラメータの名前x- SQLBLOB値をマッピングするBlobオブジェクト- 例外:
SQLException- データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementについて呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
setBlob
void setBlob(String parameterName, InputStream inputStream) throws SQLException
指定されたパラメータをInputStreamオブジェクトに設定します。 このメソッドは、setBinaryStream (int, InputStream)メソッドと異なり、パラメータ値をBLOBとしてサーバーに送信しなければならないことをドライバに通知します。setBinaryStreamメソッドを使用すると、ドライバは、パラメータ・データをLONGVARBINARYとBLOBのどちらとしてサーバーに送信するかを判断するために余計な作業を行う必要がある可能性があります。注: lengthパラメータを使用するバージョンの
setBlobを使用する方が効率的かどうかを判断するには、JDBCドライバのドキュメントを参照してください。- パラメータ:
parameterName- パラメータの名前inputStream- パラメータ値に設定されるデータを含むオブジェクト。- 例外:
SQLException- データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementについて呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
setClob
void setClob(int i, Clob x) throws SQLExceptionこのRowSetオブジェクトのコマンドで指定したパラメータを、指定したClob値に設定します。 このパラメータは、データベースへの送信前に、ドライバによってClobオブジェクトが表すCLOB値に変換されます。- パラメータ:
i- 最初のパラメータは1、2番目のパラメータは2、... となるx- CLOBを表すオブジェクト- 例外:
SQLException- データベース・アクセス・エラーが発生した場合
-
setClob
void setClob(int parameterIndex, Reader reader, long length) throws SQLException指定されたパラメータをReaderオブジェクトに設定します。Readerには、長さで指定された文字数が含まれていなければなりません。それ以外の場合は、PreparedStatementが実行されるときにSQLExceptionが生成されます。 このメソッドは、setCharacterStream (int, Reader, int)メソッドと異なり、パラメータ値をCLOBとしてサーバーに送信するべきであることをドライバに通知します。setCharacterStreamメソッドを使用すると、ドライバは、パラメータ・データをLONGVARCHARとCLOBのどちらとしてサーバーに送信するべきかを判断するために余計な作業を行う必要がある可能性があります。- パラメータ:
parameterIndex- 最初のパラメータのインデックスは1、2番目のパラメータのインデックスは2、... となるreader- パラメータ値に設定されるデータを含むオブジェクト。length- パラメータ・データ内の文字数。- 例外:
SQLException- データベース・アクセス・エラーが発生した場合、このメソッドがクローズされたPreparedStatementで呼び出された場合、parameterIndexがSQL文のパラメータ・マーカーと対応していない場合、または長さとしてゼロ未満の値が指定された場合。SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
setClob
void setClob(int parameterIndex, Reader reader) throws SQLException指定されたパラメータをReaderオブジェクトに設定します。 このメソッドは、setCharacterStream (int, Reader)メソッドと異なり、パラメータ値をCLOBとしてサーバーに送信するべきであることをドライバに通知します。setCharacterStreamメソッドを使用すると、ドライバは、パラメータ・データをLONGVARCHARとCLOBのどちらとしてサーバーに送信するべきかを判断するために余計な作業を行う必要がある可能性があります。注: lengthパラメータを使用するバージョンの
setClobを使用する方が効率的かどうかを判断するには、JDBCドライバのドキュメントを参照してください。- パラメータ:
parameterIndex- 最初のパラメータのインデックスは1、2番目のパラメータのインデックスは2、... となるreader- パラメータ値に設定されるデータを含むオブジェクト。- 例外:
SQLException- データベース・アクセス・エラーが発生した場合、このメソッドがクローズされたPreparedStatementで呼び出された場合、またはparameterIndexがSQL文のパラメータ・マーカーと対応していない場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
setClob
void setClob(String parameterName, Reader reader, long length) throws SQLException
指定されたパラメータをReaderオブジェクトに設定します。Readerには、長さで指定された文字数が含まれていなければなりません。それ以外の場合は、CallableStatementが実行されるときにSQLExceptionが生成されます。 このメソッドは、setCharacterStream (int, Reader, int)メソッドと異なり、パラメータ値をCLOBとしてサーバーに送信するべきであることをドライバに通知します。setCharacterStreamメソッドを使用すると、ドライバは、パラメータ・データをLONGVARCHARとCLOBのどちらとしてサーバーに送信するかを判断するために余計な作業を行う必要がある可能性があります。- パラメータ:
parameterName- 設定されるパラメータの名前。reader- パラメータ値に設定されるデータを含むオブジェクト。length- パラメータ・データ内の文字数。- 例外:
SQLException- parameterIndexがSQL文のパラメータ・マーカーと対応していない場合、長さとしてゼロ未満の値が指定された場合、データベース・アクセス・エラーが発生した場合、このメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
setClob
void setClob(String parameterName, Clob x) throws SQLException
指定されたパラメータを指定されたjava.sql.Clobオブジェクトに設定します。 データベースに送るときに、ドライバはこれをSQLCLOB値に変換します。- パラメータ:
parameterName- パラメータの名前x- SQLCLOB値をマッピングするClobオブジェクト- 例外:
SQLException- データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementについて呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
setClob
void setClob(String parameterName, Reader reader) throws SQLException
指定されたパラメータをReaderオブジェクトに設定します。 このメソッドは、setCharacterStream (int, Reader)メソッドと異なり、パラメータ値をCLOBとしてサーバーに送信するべきであることをドライバに通知します。setCharacterStreamメソッドを使用すると、ドライバは、パラメータ・データをLONGVARCHARとCLOBのどちらとしてサーバーに送信するかを判断するために余計な作業を行う必要がある可能性があります。注: lengthパラメータを使用するバージョンの
setClobを使用する方が効率的かどうかを判断するには、JDBCドライバのドキュメントを参照してください。- パラメータ:
parameterName- パラメータの名前reader- パラメータ値に設定されるデータを含むオブジェクト。- 例外:
SQLException- データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementについて呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
setArray
void setArray(int i, Array x) throws SQLExceptionこのRowSetオブジェクトのコマンドで指定したパラメータを、指定したArray値に設定します。 このパラメータは、データベースへの送信前に、ドライバによってArrayオブジェクトが表すARRAY値に変換されます。- パラメータ:
i- 最初のパラメータは1、2番目のパラメータは2、... となるx- SQL ARRAYを表すオブジェクト- 例外:
SQLException- データベース・アクセス・エラーが発生した場合
-
setDate
void setDate(int parameterIndex, Date x, Calendar cal) throws SQLExceptionこのRowSetオブジェクトのコマンドで指定したパラメータを、指定したjava.sql.Date値に設定します。 このパラメータは、指定したjava.util.Calendarオブジェクトを使用して日付が計算され、ドライバによってSQLDATE値に変換されます。- パラメータ:
parameterIndex- 最初のパラメータは1、2番目のパラメータは2、... となるx- パラメータ値cal- 日付の計算に使用するjava.util.Calendarオブジェクト- 例外:
SQLException- データベース・アクセス・エラーが発生した場合
-
setDate
void setDate(String parameterName, Date x) throws SQLException
アプリケーションを実行している仮想マシンのデフォルトのタイムゾーンを使用して、指定されたパラメータを指定されたjava.sql.Date値に設定します。 データベースに送るときに、ドライバはこれをSQLDATE値に変換します。- パラメータ:
parameterName- パラメータの名前x- パラメータ値- 例外:
SQLException- データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementについて呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.4
- 関連項目:
ResultSet.getDate(int)
-
setDate
void setDate(String parameterName, Date x, Calendar cal) throws SQLException
指定されたCalendarオブジェクトを使用して、指定されたパラメータを指定されたjava.sql.Date値に設定します。 ドライバはCalendarオブジェクトを使用してSQLDATE値を作成し、続いてそれをデータベースに送ります。Calendarオブジェクトを使用すると、ドライバはカスタム・タイムゾーンを考慮して日付を計算できます。Calendarオブジェクトを指定しない場合、ドライバは、アプリケーションを実行している仮想マシンのタイムゾーンであるデフォルトのタイムゾーンを使用します。- パラメータ:
parameterName- パラメータの名前x- パラメータ値cal- ドライバが日付を作成するために使用するCalendarオブジェクト- 例外:
SQLException- データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementについて呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.4
- 関連項目:
ResultSet.getDate(int)
-
setTime
void setTime(int parameterIndex, Time x, Calendar cal) throws SQLExceptionこのRowSetオブジェクトのコマンドで指定したパラメータを、指定したjava.sql.Time値に設定します。 このパラメータは、データベースへの送信前に、指定したjava.util.Calendarオブジェクトを使用して日付が計算され、ドライバによってSQLTIME値に変換されます。- パラメータ:
parameterIndex- 最初のパラメータは1、2番目のパラメータは2、... となるx- パラメータ値cal- 時間の計算に使用するjava.util.Calendarオブジェクト- 例外:
SQLException- データベース・アクセス・エラーが発生した場合
-
setTime
void setTime(String parameterName, Time x) throws SQLException
指定されたパラメータを、指定されたjava.sql.Time値に設定します。 データベースに送るときに、ドライバはこれをSQLTIME値に変換します。- パラメータ:
parameterName- パラメータの名前x- パラメータ値- 例外:
SQLException- データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementについて呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.4
- 関連項目:
ResultSet.getTime(int)
-
setTime
void setTime(String parameterName, Time x, Calendar cal) throws SQLException
指定されたCalendarオブジェクトを使用して、指定されたパラメータを指定されたjava.sql.Time値に設定します。 ドライバはCalendarオブジェクトを使用してSQLTIME値を作成し、続いてそれをデータベースに送ります。Calendarオブジェクトを使用すると、ドライバはカスタム・タイムゾーンを考慮して時間を計算できます。Calendarオブジェクトを指定しない場合、ドライバは、アプリケーションを実行している仮想マシンのタイムゾーンであるデフォルトのタイムゾーンを使用します。- パラメータ:
parameterName- パラメータの名前x- パラメータ値cal- ドライバが時間を作成するために使用するCalendarオブジェクト- 例外:
SQLException- データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementについて呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.4
- 関連項目:
ResultSet.getTime(int)
-
setTimestamp
void setTimestamp(int parameterIndex, Timestamp x, Calendar cal) throws SQLExceptionこのRowSetオブジェクトのコマンドで指定したパラメータを、指定したjava.sql.Timestamp値に設定します。 このパラメータは、データベースへの送信前に、指定したjava.util.Calendarオブジェクトを使用して日付が計算され、ドライバによってSQLTIMESTAMP値に変換されます。- パラメータ:
parameterIndex- 最初のパラメータは1、2番目のパラメータは2、... となるx- パラメータ値cal- タイムスタンプの計算に使用するjava.util.Calendarオブジェクト- 例外:
SQLException- データベース・アクセス・エラーが発生した場合
-
setTimestamp
void setTimestamp(String parameterName, Timestamp x, Calendar cal) throws SQLException
指定されたCalendarオブジェクトを使用して、指定されたパラメータを指定されたjava.sql.Timestamp値に設定します。 ドライバはCalendarオブジェクトを使用してSQLTIMESTAMP値を作成し、続いてそれをデータベースに送ります。Calendarオブジェクトを使用すると、ドライバはカスタム・タイムゾーンを考慮してタイムスタンプを計算できます。Calendarオブジェクトを指定しない場合、ドライバは、アプリケーションを実行している仮想マシンのタイムゾーンであるデフォルトのタイムゾーンを使用します。- パラメータ:
parameterName- パラメータの名前x- パラメータ値cal- ドライバがタイムスタンプを作成するために使用するCalendarオブジェクト- 例外:
SQLException- データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementについて呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.4
- 関連項目:
ResultSet.getTimestamp(int)
-
clearParameters
void clearParameters() throws SQLExceptionこのRowSetオブジェクトのコマンド用のパラメータ・セットをクリアします。通常、
RowSetオブジェクトを繰返し使用するために、パラメータ値は強制的に残されます。 パラメータ値を設定すると、前の値は自動的にクリアされます。 しかし、現在のパラメータ値によって使用されたリソースをただちに解放した方が役に立つ場合があります。これは、clearParametersメソッドを呼び出して実行できます。- 例外:
SQLException- データベース・アクセス・エラーが発生した場合
-
execute
void execute() throws SQLExceptionこのRowSetオブジェクトにデータを格納します。executeメソッドは、url、データ・ソース名、ユーザー名、パスワード、トランザクション遮断、型マップなどのプロパティを使用して、データを読み取るために接続を作成します。executeメソッドは、コマンド、読取り専用、最大フィールド・サイズ、最大行数、エスケープ処理、クエリー・タイムアウトなどのプロパティを使用して、コマンド実行文を作成します。要求したプロパティが設定されていない場合は例外がスローされます。 このメソッドの実行が成功すると、行セットの現在の内容は破棄され、行セットのメタデータも(再)設定されます。 未処理の更新がある場合、これらは無視されます。
この
RowSetオブジェクトがデータソースとの継続的な接続を維持しない場合は、Reader(RowSetReaderオブジェクト)を使用してデータを埋め込むことができます。 この場合、ReaderはこのRowSetオブジェクトに登録され、メソッドexecuteはその実装の一部としてReaderreadDataメソッドを呼び出します。- 例外:
SQLException- データベース・アクセス・エラーが発生した場合、または、接続を作成し、文を作成するために必要なプロパティのどれかが設定されていない場合
-
addRowSetListener
void addRowSetListener(RowSetListener listener)
指定したイベント・リスナーを登録して、このRowSetオブジェクトで発生するイベントが通知されるようにします。- パラメータ:
listener-RowSetListenerインタフェースを実装し、かつ、このRowSetオブジェクトでイベントが発生したときに通知を受けるコンポーネント- 関連項目:
removeRowSetListener(javax.sql.RowSetListener)
-
removeRowSetListener
void removeRowSetListener(RowSetListener listener)
指定したリスナーを、このRowSetオブジェクトでイベントが発生したときに通知されるコンポーネントのリストから削除します。- パラメータ:
listener- このRowSetオブジェクトのリスナーとして登録されているコンポーネント- 関連項目:
addRowSetListener(javax.sql.RowSetListener)
-
setSQLXML
void setSQLXML(int parameterIndex, SQLXML xmlObject) throws SQLException指定されたパラメータを指定されたjava.sql.SQLXMLオブジェクトに設定します。 データベースに送るときに、ドライバはこれをSQLXML値に変換します。- パラメータ:
parameterIndex- 最初のパラメータのインデックスは1、2番目のパラメータのインデックスは2、... となるxmlObject- SQLXML値をマッピングするSQLXMLオブジェクト- 例外:
SQLException- データベース・アクセス・エラーが発生した場合、このメソッドがクローズされた結果セットで呼び出された場合、SQLXMLオブジェクト用のjava.xml.transform.Result、Writer、またはOutputStreamがクローズされていない場合、あるいはXML値の処理中にエラーが発生した場合。 この例外のgetCauseメソッドにより、より詳細な例外が提供されることがある(たとえばストリームに有効なXMLが含まれていない場合)。- 導入されたバージョン:
- 1.6
-
setSQLXML
void setSQLXML(String parameterName, SQLXML xmlObject) throws SQLException
指定されたパラメータを指定されたjava.sql.SQLXMLオブジェクトに設定します。 データベースに送るときに、ドライバはこれをSQL XML値に変換します。- パラメータ:
parameterName- パラメータの名前xmlObject-SQL XML値をマッピングするSQLXMLオブジェクト- 例外:
SQLException- データベース・アクセス・エラーが発生した場合、このメソッドがクローズされた結果セットで呼び出された場合、SQLXMLオブジェクト用のjava.xml.transform.Result、Writer、またはOutputStreamがクローズされていない場合、あるいはXML値の処理中にエラーが発生した場合。 この例外のgetCauseメソッドにより、より詳細な例外が提供されることがある(たとえばストリームに有効なXMLが含まれていない場合)。- 導入されたバージョン:
- 1.6
-
setRowId
void setRowId(int parameterIndex, RowId x) throws SQLException指定されたパラメータを指定されたjava.sql.RowIdオブジェクトに設定します。 データベースに送るときに、ドライバはこれをSQLROWID値に変換します。- パラメータ:
parameterIndex- 最初のパラメータは1、2番目のパラメータは2、... となるx- パラメータ値- 例外:
SQLException- データベース・アクセス・エラーが発生した場合- 導入されたバージョン:
- 1.6
-
setRowId
void setRowId(String parameterName, RowId x) throws SQLException
指定されたパラメータを指定されたjava.sql.RowIdオブジェクトに設定します。 データベースに送るときに、ドライバはこれをSQLROWIDに変換します。- パラメータ:
parameterName- パラメータの名前x- パラメータ値- 例外:
SQLException- データベース・アクセス・エラーが発生した場合- 導入されたバージョン:
- 1.6
-
setNString
void setNString(int parameterIndex, String value) throws SQLException指定されたパラメータを指定されたStringオブジェクトに設定します。 データベースに送るときに、ドライバはこれをSQLNCHAR、NVARCHAR、またはLONGNVARCHAR値(ドライバのNVARCHAR値に関する制限に関する引数のサイズに依存)に変換します。- パラメータ:
parameterIndex- 最初のパラメータのインデックスは1、2番目のパラメータのインデックスは2、... となるvalue- パラメータ値- 例外:
SQLException- ドライバが各国文字セットをサポートしない場合、ドライバがデータ変換エラーが発生した可能性を検出できる場合、またはデータベース・アクセス・エラーが発生した場合- 導入されたバージョン:
- 1.6
-
setNString
void setNString(String parameterName, String value) throws SQLException
指定されたパラメータを指定されたStringオブジェクトに設定します。 ドライバはこれをSQLNCHAR、NVARCHAR、またはLONGNVARCHARに変換します。- パラメータ:
parameterName- 設定される列の名前value- パラメータ値- 例外:
SQLException- ドライバが各国文字セットをサポートしない場合、ドライバがデータ変換エラーが発生した可能性を検出できる場合、またはデータベース・アクセス・エラーが発生した場合- 導入されたバージョン:
- 1.6
-
setNCharacterStream
void setNCharacterStream(int parameterIndex, Reader value, long length) throws SQLException指定されたパラメータをReaderオブジェクトに設定します。Readerは、ファイルの終わりに達するまでデータを読み込みます。 ドライバは、必要に応じて、Javaの文字表現をデータベース内の各国文字セットに変換します。- パラメータ:
parameterIndex- 最初のパラメータのインデックスは1、2番目のパラメータのインデックスは2、... となるvalue- パラメータ値length- パラメータ・データ内の文字数。- 例外:
SQLException- ドライバが各国文字セットをサポートしない場合、ドライバがデータ変換エラーが発生した可能性を検出できる場合、またはデータベース・アクセス・エラーが発生した場合- 導入されたバージョン:
- 1.6
-
setNCharacterStream
void setNCharacterStream(String parameterName, Reader value, long length) throws SQLException
指定されたパラメータをReaderオブジェクトに設定します。Readerは、ファイルの終わりに達するまでデータを読み込みます。 ドライバは、必要に応じて、Javaの文字表現をデータベース内の各国文字セットに変換します。- パラメータ:
parameterName- 設定される列の名前value- パラメータ値length- パラメータ・データ内の文字数。- 例外:
SQLException- ドライバが各国文字セットをサポートしない場合、ドライバがデータ変換エラーが発生した可能性を検出できる場合、またはデータベース・アクセス・エラーが発生した場合- 導入されたバージョン:
- 1.6
-
setNCharacterStream
void setNCharacterStream(String parameterName, Reader value) throws SQLException
指定されたパラメータをReaderオブジェクトに設定します。Readerは、ファイルの終わりに達するまでデータを読み込みます。 ドライバは、必要に応じて、Javaの文字表現をデータベース内の各国文字セットに変換します。注: このストリーム・オブジェクトは、標準のJavaストリーム・オブジェクト、または標準インタフェースを実装する独自のサブクラスのどちらでもかまいません。
注: lengthパラメータを使用するバージョンの
setNCharacterStreamを使用する方が効率的かどうかを判断するには、JDBCドライバのドキュメントを参照してください。- パラメータ:
parameterName- パラメータの名前value- パラメータ値- 例外:
SQLException- ドライバが各国文字セットをサポートしない場合、ドライバがデータ変換エラーが発生した可能性を検出できる場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatement上で呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
setNClob
void setNClob(String parameterName, NClob value) throws SQLException
指定されたパラメータをjava.sql.NClobオブジェクトに設定します。 このオブジェクトは、java.sql.NClobインタフェースを実装します。 このNClobオブジェクトは、SQLNCLOBにマッピングされます。- パラメータ:
parameterName- 設定される列の名前value- パラメータ値- 例外:
SQLException- ドライバが各国文字セットをサポートしない場合、ドライバがデータ変換エラーが発生した可能性を検出できる場合、またはデータベース・アクセス・エラーが発生した場合- 導入されたバージョン:
- 1.6
-
setNClob
void setNClob(String parameterName, Reader reader, long length) throws SQLException
指定されたパラメータをReaderオブジェクトに設定します。Readerには、長さで指定された文字数が含まれていなければなりません。それ以外の場合は、CallableStatementが実行されるときにSQLExceptionが生成されます。 このメソッドは、setCharacterStream (int, Reader, int)メソッドと異なり、パラメータ値をNCLOBとしてサーバーに送信するべきであることをドライバに通知します。setCharacterStreamメソッドを使用すると、ドライバは、パラメータ・データをLONGNVARCHARとNCLOBのどちらとしてサーバーに送信するかを判断するために余計な作業を行う必要がある可能性があります。- パラメータ:
parameterName- 設定されるパラメータの名前。reader- パラメータ値に設定されるデータを含むオブジェクト。length- パラメータ・データ内の文字数。- 例外:
SQLException- parameterIndexがSQL文のパラメータ・マーカーと対応していない場合、長さとしてゼロ未満の値が指定された場合、ドライバが各国文字セットをサポートしない場合、ドライバがデータ変換エラーが発生した可能性を検出できる場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatement上で呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
setNClob
void setNClob(String parameterName, Reader reader) throws SQLException
指定されたパラメータをReaderオブジェクトに設定します。 このメソッドは、setCharacterStream (int, Reader)メソッドと異なり、パラメータ値をNCLOBとしてサーバーに送信しなければならないことをドライバに通知します。setCharacterStreamメソッドを使用すると、ドライバは、パラメータ・データをLONGNVARCHARとNCLOBのどちらとしてサーバーに送信するかを判断するために余計な作業を行う必要がある可能性があります。注: lengthパラメータを使用するバージョンの
setNClobを使用する方が効率的かどうかを判断するには、JDBCドライバのドキュメントを参照してください。- パラメータ:
parameterName- パラメータの名前reader- パラメータ値に設定されるデータを含むオブジェクト。- 例外:
SQLException- ドライバが各国文字セットをサポートしない場合、ドライバがデータ変換エラーが発生した可能性を検出できる場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatement上で呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
setNClob
void setNClob(int parameterIndex, Reader reader, long length) throws SQLException指定されたパラメータをReaderオブジェクトに設定します。Readerには、長さで指定された文字数が含まれていなければなりません。それ以外の場合は、PreparedStatementが実行されるときにSQLExceptionが生成されます。 このメソッドは、setCharacterStream (int, Reader, int)メソッドと異なり、パラメータ値をNCLOBとしてサーバーに送信するべきであることをドライバに通知します。setCharacterStreamメソッドを使用すると、ドライバは、パラメータ・データをLONGNVARCHARとNCLOBのどちらとしてサーバーに送信するべきかを判断するために余計な作業を行う必要がある可能性があります。- パラメータ:
parameterIndex- 最初のパラメータのインデックスは1、2番目のパラメータのインデックスは2、... となるreader- パラメータ値に設定されるデータを含むオブジェクト。length- パラメータ・データ内の文字数。- 例外:
SQLException- parameterIndexがSQL文のパラメータ・マーカーと対応していない場合、長さとしてゼロ未満の値が指定された場合、ドライバが各国文字セットをサポートしない場合、ドライバがデータ変換エラーが発生した可能性を検出できる場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたPreparedStatement上で呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
setNClob
void setNClob(int parameterIndex, NClob value) throws SQLException指定されたパラメータをjava.sql.NClobオブジェクトに設定します。 データベースに送るときに、ドライバはこれをSQLNCLOB値に変換します。- パラメータ:
parameterIndex- 最初のパラメータのインデックスは1、2番目のパラメータのインデックスは2、... となるvalue- パラメータ値- 例外:
SQLException- ドライバが各国文字セットをサポートしない場合、ドライバがデータ変換エラーが発生した可能性を検出できる場合、またはデータベース・アクセス・エラーが発生した場合- 導入されたバージョン:
- 1.6
-
setNClob
void setNClob(int parameterIndex, Reader reader) throws SQLException指定されたパラメータをReaderオブジェクトに設定します。 このメソッドは、setCharacterStream (int, Reader)メソッドと異なり、パラメータ値をNCLOBとしてサーバーに送信しなければならないことをドライバに通知します。setCharacterStreamメソッドを使用すると、ドライバは、パラメータ・データをLONGNVARCHARとNCLOBのどちらとしてサーバーに送信するべきかを判断するために余計な作業を行う必要がある可能性があります。注: lengthパラメータを使用するバージョンの
setNClobを使用する方が効率的かどうかを判断するには、JDBCドライバのドキュメントを参照してください。- パラメータ:
parameterIndex- 最初のパラメータのインデックスは1、2番目のパラメータのインデックスは2、... となるreader- パラメータ値に設定されるデータを含むオブジェクト。- 例外:
SQLException- parameterIndexがSQL文のパラメータ・マーカーに対応しない場合、ドライバが各国の文字セットをサポートしない場合、ドライバがデータ変換エラーが発生したことを検出できる場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたPreparedStatementで呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
setURL
void setURL(int parameterIndex, URL x) throws SQLException指定されたパラメータを、指定されたjava.net.URL値に設定します。 データベースに送るときに、ドライバはこれをSQLDATALINK値に変換します。- パラメータ:
parameterIndex- 最初のパラメータは1、2番目のパラメータは2、... となるx- 設定されるjava.net.URLオブジェクト- 例外:
SQLException- データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたPreparedStatementについて呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.4
-
-