モジュール java.sql.rowset

パッケージ javax.sql.rowset

クラスBaseRowSet

java.lang.Object

javax.sql.rowset.BaseRowSet

すべての実装されたインタフェース:

Serializable, Cloneable

public abstract class BaseRowSet extends Object implements Serializable, Cloneable

RowSetオブジェクトとその基本機能を提供するabstractクラスです。 基本機能には、すべてのJavaBeansコンポーネントが実装する必要があるプロパティの設定およびイベント通知の送信が含まれます。

1.0 概要

BaseRowSetクラスはすべてのRowSet実装の中核機能を提供しますが、どの標準実装でもベンダー固有の標準実装を提供するため、このクラスと1つ以上のRowSetインタフェースを使用することができます。 より明確な言い方をするなら、どの実装でも必ず、RowSetインタフェース(JdbcRowSet、CachedRowSet、JoinRowSet、FilteredRowSetまたはWebRowSet)を1つ以上実装する必要があります。 つまり、BaseRowSetクラスを拡張する実装では必ず、いずれかのRowSetインタフェースも実装する必要があります。

BaseRowSetクラスは次の機能を提供します。

• プロパティ
  • 現在のプロパティを格納するフィールド
  • プロパティを取得および設定するメソッド
• イベント通知
• RowSetオブジェクトのコマンドにパラメータを設定する設定メソッドの完全なセット
• ストリーム
  • ストリーム・インスタンスを格納するフィールド
  • ストリームの型を示す定数

2.0 プロパティの設定

どの行セットも必ず一連のプロパティを保持しますが、それらのプロパティは通常、ツールを使用して設定されます。 行セットに含まれるプロパティの数や種類は、RowSet実装の処理内容やデータの取得方法によって異なります。 たとえば、ResultSetオブジェクトからデータを取得する行セットでは、データベース接続に必要なプロパティを設定する必要があります。 DriverManager機能を使用して接続を行うRowSetオブジェクトでは、適切なドライバを識別するJDBC URLのプロパティを設定する必要があるほか、ユーザー名とパスワードを提供するプロパティも設定する必要があります。 一方、推奨の方法であるDataSourceオブジェクトを使用して接続を行う行セットでは、JDBC URLのプロパティを設定する必要はありません。 かわりに、データ・ソースの論理名のプロパティ、およびユーザー名とパスワードのプロパティを設定する必要があります。

NOTE: 接続にDataSourceオブジェクトを使用するには、Java Naming and Directory Interface (JNDI) APIを使用するネーミング・サービスにDataSourceオブジェクトが登録されている必要があります。 登録は通常、システム管理者が行います。

3.0 コマンドとコマンド・パラメータの設定

行セットは、リレーショナル・データベースからデータを取得すると、ResultSetオブジェクトを生成するコマンド(クエリー)を実行します。 このクエリーは、RowSetオブジェクトのコマンド・プロパティに設定されるコマンドです。 行セットは、ResultSetオブジェクトからデータを読み込んで、自身にデータを移植します。 クエリーに未設定の値のプレースホルダーが含まれている場合、BaseRowSet設定メソッドを使って、これらの値を設定できます。 どの設定メソッドでも、必要に応じてnull値を設定できます。

次のコードの抜粋は、CachedRowSetオブジェクトcrsにコマンド・プロパティを設定する方法を示しています。 ツールを使ってプロパティを設定する場合、このコードを使用します。

    crs.setCommand("SELECT FIRST_NAME, LAST_NAME, ADDRESS FROM CUSTOMERS" +
                   "WHERE CREDIT_LIMIT > ? AND REGION = ?");
 

この例ではCREDIT_LIMITとREGIONの値がプレースホルダー・パラメータであり、疑問符(?)で示されています。 最初の疑問符はパラメータ番号1、2番目の疑問符はパラメータ番号2のプレースホルダー(以下同様)です。 クエリーを実行するためには、あらかじめプレースホルダー・パラメータを設定しておく必要があります。 BaseRowSetクラスは、プレースホルダー・パラメータの設定に必要な設定メソッドを提供します。この設定メソッドは、PreparedStatementインタフェースがデータ型の値を設定するために提供するメソッドとよく似ています。 RowSetオブジェクトは、パラメータ値を内部で格納します。このオブジェクトのexecuteメソッドは、格納されたパラメータ値を内部で利用して、実行するDBMSにコマンドを送信する前にプレースホルダー・パラメータの値を設定します。

次のコードの抜粋は、先ほどの例で、クエリー内の2つのパラメータを設定する方法を示しています。

    crs.setInt(1, 5000);
    crs.setString(2, "West");
 

この時点でexecuteメソッドを呼び出すとすると、DBMSに送信されるクエリーは次のようになります。

    "SELECT FIRST_NAME, LAST_NAME, ADDRESS FROM CUSTOMERS" +
                   "WHERE CREDIT_LIMIT > 5000 AND REGION = 'West'"
 

ノート: Array、Clob、BlobおよびRefオブジェクトをコマンド・パラメータとして設定すると、これらの値はそれぞれSerialArray、SerialClob、SerialBlob、およびSerialRefオブジェクトとして保存されます。

4.0 内部のパラメータ処理

ノート: BaseRowSetクラスは、プロパティを設定する設定メソッドと、プレースホルダー・パラメータを設定する設定メソッドを提供します。 このセクションでは、プレースホルダー・パラメータを設定する設定メソッドについて説明します。

BaseRowSet設定メソッドで設定されたプレースホルダー・パラメータは、内部のHashtableオブジェクトにオブジェクトとして格納されます。 プリミティブはObject型として格納されます。 たとえば、byteはByteオブジェクト、intはIntegerオブジェクトとして格納されます。 executeメソッドが呼び出されると、Hashtableオブジェクト内の値が、コマンド内の適切なプレースホルダー・パラメータに代入されます。

getParamsメソッドを呼び出すと、Hashtableオブジェクトに格納された値がObjectインスタンスの配列として返されます。 この配列内の要素は、単純なObjectインスタンスかObject型の配列になります。 配列内の要素がObjectになるか配列になるかは、使用する設定メソッドによって異なります。

プレースホルダー・パラメータを設定するほとんどのメソッドは、2つのパラメータを取ります。第1のパラメータで設定するプレースホルダー・パラメータを指定し、第2のパラメータで設定する値を指定します。 該当メソッドには、setInt、setString、setBoolean、setLongなどがあります。 これらのメソッドを呼び出したあと、getParamsを呼び出すと、設定された値から成る配列が返されます。 配列内の各値は、設定された値を表すObjectインスタンスになります。 配列内の値の並び順は、設定メソッドに渡されるint (第1のパラメータ)によって決定されます。 配列内の値は、設定メソッドに渡される値(第2のパラメータ)になります。 つまり、配列内の第1の要素が、RowSetオブジェクトのコマンドで第1のプレースホルダー・パラメータに設定されます。 配列内の第2の要素が、第2のプレースホルダー・パラメータに設定される(以下同様)ということになります。

設定する値以外に、ドライバとDBMSの情報を送信する設定メソッドもあります。 このような設定メソッドの使用後にgetParamsメソッドを呼び出すと、追加情報を格納するため、配列内の要素自体が配列になります。 このような設定メソッドの特例として、一方のバージョンがパラメータを2つしか取らないsetNullメソッドがあります(setNull(int parameterIndex, int SqlType))。 ただし、このメソッドも、ドライバとDBMSに渡す情報を格納するため、配列を必要とします。 この配列内の第1の要素は、設定する値nullになります。第2の要素は、sqlTypeに代入されるintであり、nullに設定されるSQL値の型を示します。 この情報は、一部のDBMSでは必須です。したがって、アプリケーションの移植性を確保するためには、この情報が必須になります。 もう一方のバージョンは、nullに設定する値がユーザー定義型であるときに使用するためのものです。 この場合も、3つのパラメータ(setNull(int parameterIndex, int sqlType, String typeName))を使用し、ドライバとDBMSに渡す情報を格納する配列が必要になります。 この配列の最初の2つの要素は、最初のバージョンのsetNullの場合と同じです。 第3の要素typeNameは、ユーザー定義型のSQL名を指定します。 その他の設定メソッドと同じく、設定するプレースホルダー・パラメータの数は、getParamsによって返される配列内の要素の位置で表されます。 たとえば、setNullのパラメータが2の場合、getParamsによって返される配列内の第2の要素は、2 - 3個の要素から成る配列になります。

setObjectやsetDateをはじめとする一部のメソッドは、2つ以上のパラメータと、ドライバまたはDBMSに情報を提供する追加のパラメータを取る場合があります。 たとえば、setDateメソッド、setTimeメソッド、setTimestampメソッドは、3番目のパラメータとしてCalendarオブジェクトを取ることができます。 DBMSにタイムゾーン情報が格納されていない場合、ドライバはCalendarオブジェクトを使用して、設定するDateオブジェクト、TimeオブジェクトまたはTimestampオブジェクトを作成します。 追加情報を提供するその他のメソッドと同様に、getParamsから返される配列内の要素は、単純なObjectインスタンスではなく、配列になります。

setAsciiStream、setBinaryStream、setCharacterStream、setUnicodeStreamの各メソッド(非推奨。アプリケーションは、これらのかわりにgetCharacterStreamを使用するべきである)は、3つのパラメータを取ります。したがって、この場合も、getParamsから返される配列内の要素は配列になります。 これらの設定メソッドは、配列内に、パラメータによって提供される情報だけでなく、設定するストリームの型を示すBaseRowSet定数が含まれているという点で、その他の設定メソッドと異なっています。

ノート: getParamsメソッドは、このクラスを拡張するRowSet実装によって内部で呼び出されます。通常、アプリケーション・プログラマによって直接呼び出されることはありません。

5.0 イベント通知

BaseRowSetクラスは、行セットにイベント通知メカニズムを提供します。 このクラスには、listenersフィールド、リスナーの追加と削除を行うメソッド、リスナーに変更を通知するメソッドが含まれます。

リスナーは、RowSetListenerインタフェースを実装するオブジェクトです。 RowSetオブジェクトのリスナー・リストに追加されたリスナーは、そのRowSetオブジェクトで発生したイベントの通知を受けます。 イベントの発生通知を受けたときのオブジェクトの動作は、各リスナーのRowSetListenerメソッドの実装によって定義されます。

RowSetオブジェクトで発生する可能性があるイベントは、次の3種類です。

1. カーソルの移動
2. 個々の行の変更(更新、削除、または挿入)
3. RowSetオブジェクト全体の内容の変更

通知に使用されるBaseRowSetメソッドは、発生したイベントの型を示します。 たとえば、notifyRowChangedメソッドは、行が更新、削除、または挿入されたことを示します。 各通知メソッドは、イベントの発生元のRowSetオブジェクトを特定するためにリスナーに渡される、RowSetEventオブジェクトを作成します。 リスナーがこの情報を利用して何を行うか(何も行わない場合もある)は、リスナーの実装によって異なります。

6.0 デフォルトの動作

デフォルトのBaseRowSetオブジェクトの初期化のときの開始値は、一定ではありません。 BaseRowSetクラスを拡張するデフォルトのRowSetインスタンスには、次の特徴があります。

• スクロール可能なカーソルを使用し、その他のユーザーによる変更を表示しない。
• 更新可能。
• 削除された行は表示しない。
• ドライバがRowSetオブジェクトのコマンド実行に費やす時間に制限はない。
• 含むことのできる行数に制限はない。
• 列内のバイト数に制限はない。 ノート: ただし、次の型の値を格納する列には、バイト数の制限が課される: BINARY、VARBINARY、LONGVARBINARY、CHAR、VARCHAR、およびLONGVARCHAR。
• 未確定のデータは表示しない(「ダーティ」読取りになる)。
• エスケープ処理が有効。
• 接続の型マップはnullに設定されている。
• RowSetオブジェクトのコマンド内のプレースホルダー・パラメータに設定された値を格納するため、空のVectorオブジェクトが用意されている。

適切な値が異なる場合、アプリケーションは、その値を明示的に設定する必要があります。 たとえば、次のコードは、CachedRowSetオブジェクトcrsに最大行数500を設定します。

    crs.setMaxRows(500);
 

このBaseRowSetクラスの拡張に実装されたメソッドは、定義済みのアサーションに対する違反があった場合、SQLExceptionオブジェクトをスローする必要があります。 そのため、このメソッドは、クラスの拡張によってBaseRowSetメソッドがオーバーライドされ、再実装されたあと、接続の問題または配下のデータ・ソースの問題が検出された場合も、SQLExceptionオブジェクトをスローする可能性があります。

導入されたバージョン:

1.5

関連項目:

• 直列化された形式

フィールドのサマリー

フィールド

修飾子と型	フィールド	説明
static final int	ASCII_STREAM_PARAM	ASCIIストリームのパラメータを持つRowSetReaderImplオブジェクトを示す定数です。
protected InputStream	asciiStream	メソッドgetAsciiStreamによって返されたInputStreamオブジェクトであり、ResultSetインタフェースで指定されています。
static final int	BINARY_STREAM_PARAM	バイナリ・ストリームのパラメータを持つRowSetReaderImplオブジェクトを示す定数です。
protected InputStream	binaryStream	メソッドgetBinaryStreamによって返されたInputStreamオブジェクトであり、ResultSetインタフェースで指定されています。
protected Reader	charStream	メソッドgetCharacterStreamによって返されたReaderオブジェクトであり、ResultSetインタフェースで指定されています。
static final int	UNICODE_STREAM_PARAM	Unicodeストリームのパラメータを持つRowSetReaderImplオブジェクトを示す定数です。
protected InputStream	unicodeStream	メソッドgetUnicodeStreamによって返されたInputStreamオブジェクトであり、ResultSetインタフェースで指定されています。

コンストラクタのサマリー

コンストラクタ

コンストラクタ	説明
BaseRowSet()	デフォルトのVectorオブジェクトを使用して初期化を実行し、listenersフィールド用の新しいBaseRowSetオブジェクトを作成します。

メソッドのサマリー

修飾子と型	メソッド	説明
void	addRowSetListener(RowSetListener listener)	リスナーは、このRowSetオブジェクトでイベントが発生するたびに通知を受けます。
void	clearParameters()	このRowSetオブジェクトのコマンドの実行時に設定される、このRowSetオブジェクトのパラメータの内部表現に含まれる現在のパラメータ値をすべてクリアします。
String	getCommand()	このRowSetオブジェクトのコマンドになっているSQLクエリーを取得します。
int	getConcurrency()	このRowSetオブジェクトの並行処理を返します。
String	getDataSourceName()	Java Naming and Directory Interface (JNDI) APIを使用するネーム・サービスに提供されるとjavax.sql.DataSourceオブジェクトを取得する論理名を返します。
boolean	getEscapeProcessing()	このRowSetオブジェクトでエスケープ処理が有効になっているかどうかを確認します。
int	getFetchDirection()	このRowSetオブジェクトの現在のフェッチ方向の設定を取得します。
int	getFetchSize()	このRowSetオブジェクトのフェッチ・サイズを返します。
int	getMaxFieldSize()	このRowSetオブジェクト内の列の値として使用可能な最大バイト数を取得します。
int	getMaxRows()	このRowSetオブジェクトに含めることのできる最大行数を取得します。
Object[]	getParams()	このRowSetオブジェクトのコマンドに設定されたパラメータ値(オブジェクトとプリミティブ)を含む配列を取得し、すべてのパラメータが設定されていない場合はSQLExceptionオブジェクトをスローします。
String	getPassword()	このRowSetオブジェクトのデータベース接続を作成するために使用するパスワードを返します。
int	getQueryTimeout()	ドライバがクエリーの実行を待つ最大秒数を取得します。
boolean	getShowDeleted()	削除マークが付けられた行を現在の行とともに表示するかどうかを示すbooleanを取得します。
int	getTransactionIsolation()	このRowSetオブジェクトの接続のトランザクション遮断プロパティを返します。
int	getType()	このRowSetオブジェクトの型を返します。
Map<String,Class<?>>	getTypeMap()	このRowSetオブジェクトのConnectionオブジェクトに関連付けられた型マップを取得します。
String	getUrl()	JDBCテクノロジを使用可能なドライバを使って、このRowSetオブジェクトのjavax.sql.Readerオブジェクトがリレーショナル・データベースとの接続を作成するために使用するJDBC URLを取得します。
String	getUsername()	データベース接続の作成に使用するユーザー名を返します。
protected void	initParams()	BaseRowSetインスタンスの標準機能を使ってJDBC RowSet実装を起動するために必要な内部での構成および初期化を実行します。
boolean	isReadOnly()	このRowSetオブジェクトが読取り専用であるかどうかを示すbooleanを返します。
protected void	notifyCursorMoved()	このRowSetオブジェクトに登録されているすべてのリスナーに、カーソルが移動したことを通知します。
protected void	notifyRowChanged()	このRowSetオブジェクトに登録されているすべてのリスナーに、行が変更されたことを通知します。
protected void	notifyRowSetChanged()	このRowSetオブジェクトに登録されているすべてのリスナーに、コンテンツ全体が変更されたことを通知します。
void	removeRowSetListener(RowSetListener listener)	このRowSetオブジェクトのリスナー・リストから指定されたオブジェクトを削除します。
void	setArray(int parameterIndex, Array array)	指定されたパラメータをJavaプログラミング言語のArrayオブジェクトに設定します。
void	setAsciiStream(int parameterIndex, InputStream x)	このRowSetオブジェクトのコマンド内の指定されたパラメータを、指定された入力ストリームに設定します。
void	setAsciiStream(int parameterIndex, InputStream x, int length)	指定されたパラメータを、指定されたバイト数を持つ指定されたjava.io.InputStreamオブジェクトに設定します。
void	setAsciiStream(String parameterName, InputStream x)	指定されたパラメータを指定された入力ストリームに設定します。
void	setAsciiStream(String parameterName, InputStream x, int length)	指定されたパラメータを、指定されたバイト数を持つ指定された入力ストリームに設定します。
void	setBigDecimal(int parameterIndex, BigDecimal x)	指定されたパラメータを、指定されたjava.lang.BigDecimal値に設定します。
void	setBigDecimal(String parameterName, BigDecimal x)	指定されたパラメータを、指定されたjava.math.BigDecimal値に設定します。
void	setBinaryStream(int parameterIndex, InputStream x)	このRowSetオブジェクトのコマンド内の指定されたパラメータを、指定された入力ストリームに設定します。
void	setBinaryStream(int parameterIndex, InputStream x, int length)	指定されたパラメータを、指定されたバイト数を持つ指定されたjava.io.InputStreamオブジェクトに設定します。
void	setBinaryStream(String parameterName, InputStream x)	指定されたパラメータを指定された入力ストリームに設定します。
void	setBinaryStream(String parameterName, InputStream x, int length)	指定されたパラメータを、指定されたバイト数を持つ指定された入力ストリームに設定します。
void	setBlob(int parameterIndex, InputStream inputStream)	指定されたパラメータをInputStreamオブジェクトに設定します。
void	setBlob(int parameterIndex, InputStream inputStream, long length)	指定されたパラメータをInputStreamオブジェクトに設定します。
void	setBlob(int parameterIndex, Blob x)	指定されたパラメータを、指定されたJavaプログラミング言語のBlobオブジェクトに設定します。
void	setBlob(String parameterName, InputStream inputStream)	指定されたパラメータをInputStreamオブジェクトに設定します。
void	setBlob(String parameterName, InputStream inputStream, long length)	指定されたパラメータをInputStreamオブジェクトに設定します。
void	setBlob(String parameterName, Blob x)	指定されたパラメータを指定されたjava.sql.Blobオブジェクトに設定します。
void	setBoolean(int parameterIndex, boolean x)	指定されたパラメータを、指定されたJavaプログラミング言語のbooleanに設定します。
void	setBoolean(String parameterName, boolean x)	指定されたパラメータを指定されたJavaのboolean値に設定します。
void	setByte(int parameterIndex, byte x)	指定されたパラメータを、指定されたJavaプログラミング言語のbyteに設定します。
void	setByte(String parameterName, byte x)	指定されたパラメータを指定されたJavaのbyte値に設定します。
void	setBytes(int parameterIndex, byte[] x)	指定されたパラメータを、指定されたバイト配列に設定します。
void	setBytes(String parameterName, byte[] x)	指定されたパラメータを指定されたJavaのバイト配列に設定します。
void	setCharacterStream(int parameterIndex, Reader reader)	このRowSetオブジェクトのコマンド内の指定されたパラメータを、指定されたReaderオブジェクトに設定します。
void	setCharacterStream(int parameterIndex, Reader reader, int length)	指定されたパラメータを、指定されたバイト数を持つjava.io.Readerオブジェクトに設定します。
void	setCharacterStream(String parameterName, Reader reader)	指定されたパラメータを指定されたReaderオブジェクトに設定します。
void	setCharacterStream(String parameterName, Reader reader, int length)	指定されたパラメータを、指定された文字数である指定されたReaderオブジェクトに設定します。
void	setClob(int parameterIndex, Reader reader)	指定されたパラメータをReaderオブジェクトに設定します。
void	setClob(int parameterIndex, Reader reader, long length)	指定されたパラメータをReaderオブジェクトに設定します。
void	setClob(int parameterIndex, Clob x)	指定されたパラメータを、指定されたJavaプログラミング言語のClobオブジェクトに設定します。
void	setClob(String parameterName, Reader reader)	指定されたパラメータをReaderオブジェクトに設定します。
void	setClob(String parameterName, Reader reader, long length)	指定されたパラメータをReaderオブジェクトに設定します。
void	setClob(String parameterName, Clob x)	指定されたパラメータを指定されたjava.sql.Clobオブジェクトに設定します。
void	setCommand(String cmd)	このRowSetオブジェクトのcommandプロパティとして指定のStringオブジェクトを設定し、パラメータがある場合は、以前のコマンド用に設定されたものなのでクリアします。
void	setConcurrency(int concurrency)	このRowSetオブジェクトの並行性を指定された並行性に設定します。
void	setDataSourceName(String name)	このRowSetオブジェクトのDataSource nameプロパティとして指定の論理名を設定し、このRowSetオブジェクトのUrlプロパティをnullに設定します。
void	setDate(int parameterIndex, Date x)	指定されたパラメータを、指定されたjava.sql.Date値に設定します。
void	setDate(int parameterIndex, Date x, Calendar cal)	指定されたパラメータを指定されたjava.sql.Dateオブジェクトに設定します。
void	setDate(String parameterName, Date x)	アプリケーションを実行している仮想マシンのデフォルトのタイムゾーンを使用して、指定されたパラメータを指定されたjava.sql.Date値に設定します。
void	setDate(String parameterName, Date x, Calendar cal)	指定されたCalendarオブジェクトを使用して、指定されたパラメータを指定されたjava.sql.Date値に設定します。
void	setDouble(int parameterIndex, double x)	指定されたパラメータを、指定されたJavaプログラミング言語のdoubleに設定します。
void	setDouble(String parameterName, double x)	指定されたパラメータを指定されたJavaのdouble値に設定します。
void	setEscapeProcessing(boolean enable)	データベースにSQL文を送信する前に、ドライバがエスケープ構文をスキャンしてエスケープ置換を行うかどうかを示す指定のbooleanに設定します。
void	setFetchDirection(int direction)	このRowSetオブジェクト内の行が処理される方向について、ドライバにパフォーマンス・ヒントを与えます。
void	setFetchSize(int rows)	このRowSetオブジェクトのフェッチ・サイズとして、指定の行数を設定します。
void	setFloat(int parameterIndex, float x)	指定されたパラメータを、指定されたJavaプログラミング言語のfloatに設定します。
void	setFloat(String parameterName, float x)	指定されたパラメータを指定されたJavaのfloat値に設定します。
void	setInt(int parameterIndex, int x)	指定されたパラメータを、指定されたJavaプログラミング言語のint値に設定します。
void	setInt(String parameterName, int x)	指定されたパラメータを指定されたJavaのint値に設定します。
void	setLong(int parameterIndex, long x)	指定されたパラメータを、指定されたJavaプログラミング言語のlongに設定します。
void	setLong(String parameterName, long x)	指定されたパラメータを指定されたJavaのlong値に設定します。
void	setMaxFieldSize(int max)	このRowSetオブジェクト内の列の値として使用可能な最大バイト数を、指定した値に設定します。
void	setMaxRows(int max)	このRowSetオブジェクトに含めることのできる最大の行数を、指定した値に設定します。
void	setNCharacterStream(int parameterIndex, Reader value)	このRowSetオブジェクトのコマンド内の指定されたパラメータを、Readerオブジェクトに設定します。
void	setNCharacterStream(int parameterIndex, Reader value, long length)	指定されたパラメータをReaderオブジェクトに設定します。
void	setNCharacterStream(String parameterName, Reader value)	指定されたパラメータをReaderオブジェクトに設定します。
void	setNCharacterStream(String parameterName, Reader value, long length)	指定されたパラメータをReaderオブジェクトに設定します。
void	setNClob(int parameterIndex, Reader reader)	指定されたパラメータをReaderオブジェクトに設定します。
void	setNClob(int parameterIndex, Reader reader, long length)	指定されたパラメータをReaderオブジェクトに設定します。
void	setNClob(int parameterIndex, NClob value)	指定されたパラメータをjava.sql.NClobオブジェクトに設定します。
void	setNClob(String parameterName, Reader reader)	指定されたパラメータをReaderオブジェクトに設定します。
void	setNClob(String parameterName, Reader reader, long length)	指定されたパラメータをReaderオブジェクトに設定します。
void	setNClob(String parameterName, NClob value)	指定されたパラメータをjava.sql.NClobオブジェクトに設定します。
void	setNString(int parameterIndex, String value)	指定されたパラメータを指定されたStringオブジェクトに設定します。
void	setNString(String parameterName, String value)	指定されたパラメータを指定されたStringオブジェクトに設定します。
void	setNull(int parameterIndex, int sqlType)	指定されたパラメータをSQL NULLに設定します。
void	setNull(int parameterIndex, int sqlType, String typeName)	指定されたパラメータをSQL NULLに設定します。
void	setNull(String parameterName, int sqlType)	指定されたパラメータをSQL NULLに設定します。
void	setNull(String parameterName, int sqlType, String typeName)	指定されたパラメータをSQL NULLに設定します。
void	setObject(int parameterIndex, Object x)	指定されたパラメータを、指定されたJavaプログラミング言語のObject値に設定します。
void	setObject(int parameterIndex, Object x, int targetSqlType)	指定されたパラメータの値を、指定されたObject値で設定します。
void	setObject(int parameterIndex, Object x, int targetSqlType, int scale)	指定されたパラメータを、指定されたJavaプログラミング言語のObject値に設定します。
void	setObject(String parameterName, Object x)	指定されたパラメータの値を、指定されたオブジェクトで設定します。
void	setObject(String parameterName, Object x, int targetSqlType)	指定されたパラメータの値を、指定されたオブジェクトで設定します。
void	setObject(String parameterName, Object x, int targetSqlType, int scale)	指定されたパラメータの値を、指定されたオブジェクトで設定します。
void	setPassword(String pass)	このRowSetオブジェクトのデータベース接続を作成するために使用するパスワードとして、指定のStringオブジェクトを設定します。
void	setQueryTimeout(int seconds)	ドライバがクエリーの実行を待つ最大秒数を設定します。
void	setReadOnly(boolean value)	このRowSetオブジェクトのreadOnlyプロパティとしてbooleanを設定します。
void	setRef(int parameterIndex, Ref ref)	指定されたパラメータを、指定されたJavaプログラミング言語のRefオブジェクトに設定します。
void	setRowId(int parameterIndex, RowId x)	指定されたパラメータを指定されたjava.sql.RowIdオブジェクトに設定します。
void	setRowId(String parameterName, RowId x)	指定されたパラメータを指定されたjava.sql.RowIdオブジェクトに設定します。
void	setShort(int parameterIndex, short x)	指定されたパラメータを、指定されたJavaプログラミング言語のshortに設定します。
void	setShort(String parameterName, short x)	指定されたパラメータを指定されたJavaのshort値に設定します。
void	setShowDeleted(boolean value)	showDeletedプロパティとして、削除マーク付きの行を現在の行とともに表示するかどうかを指定するbooleanを設定します。
void	setSQLXML(int parameterIndex, SQLXML xmlObject)	指定されたパラメータを指定されたjava.sql.SQLXMLオブジェクトに設定します。
void	setSQLXML(String parameterName, SQLXML xmlObject)	指定されたパラメータを指定されたjava.sql.SQLXMLオブジェクトに設定します。
void	setString(int parameterIndex, String x)	指定されたパラメータを、指定されたString値に設定します。
void	setString(String parameterName, String x)	指定されたパラメータを指定されたJavaのString値に設定します。
void	setTime(int parameterIndex, Time x)	指定されたパラメータを、指定されたjava.sql.Time値に設定します。
void	setTime(int parameterIndex, Time x, Calendar cal)	指定されたパラメータを指定されたjava.sql.Timeオブジェクトに設定します。
void	setTime(String parameterName, Time x)	指定されたパラメータを、指定されたjava.sql.Time値に設定します。
void	setTime(String parameterName, Time x, Calendar cal)	指定されたCalendarオブジェクトを使用して、指定されたパラメータを指定されたjava.sql.Time値に設定します。
void	setTimestamp(int parameterIndex, Timestamp x)	指定されたパラメータを、指定されたjava.sql.Timestamp値に設定します。
void	setTimestamp(int parameterIndex, Timestamp x, Calendar cal)	指定されたパラメータを指定されたjava.sql.Timestampオブジェクトに設定します。
void	setTimestamp(String parameterName, Timestamp x)	指定されたパラメータを、指定されたjava.sql.Timestamp値に設定します。
void	setTimestamp(String parameterName, Timestamp x, Calendar cal)	指定されたCalendarオブジェクトを使用して、指定されたパラメータを指定されたjava.sql.Timestamp値に設定します。
void	setTransactionIsolation(int level)	このJDBC RowSetオブジェクトのトランザクション遮断プロパティとして、指定の定数を設定します。
void	setType(int type)	このRowSetオブジェクトに特定の型を設定します。
void	setTypeMap(Map<String,Class<?>> map)	このRowSetオブジェクトのConnectionオブジェクトに関連付けられた型マップとして、指定のjava.util.Mapオブジェクトをインストールします。
void	setUnicodeStream(int parameterIndex, InputStream x, int length)	非推奨。 代わりにgetCharacterStreamを使用してください。
void	setUrl(String url)	このRowSetオブジェクトのUrlプロパティとして指定のStringオブジェクトを設定し、dataSource nameプロパティをnullに設定します。
void	setURL(int parameterIndex, URL x)	指定されたパラメータを、指定されたjava.net.URL値に設定します。
void	setUsername(String name)	このRowSetオブジェクトのusernameプロパティとして、指定のユーザー名を設定します。

クラス java.lang.Objectで宣言されたメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

フィールド詳細

UNICODE_STREAM_PARAM

public static final int UNICODE_STREAM_PARAM

Unicodeストリームのパラメータを持つRowSetReaderImplオブジェクトを示す定数です。 このRowSetReaderImplオブジェクトは、SyncFactory staticファクトリSPIメカニズムで定義されたabstractクラスSyncProviderの拡張として提供されます。

関連項目:

• 定数フィールド値

BINARY_STREAM_PARAM

public static final int BINARY_STREAM_PARAM

バイナリ・ストリームのパラメータを持つRowSetReaderImplオブジェクトを示す定数です。 RowSetReaderImplオブジェクトは、SyncFactory staticファクトリSPIメカニズムで定義されたabstractクラスSyncProviderの拡張として提供されます。

関連項目:

• 定数フィールド値

ASCII_STREAM_PARAM

public static final int ASCII_STREAM_PARAM

ASCIIストリームのパラメータを持つRowSetReaderImplオブジェクトを示す定数です。 RowSetReaderImplオブジェクトは、SyncFactory staticファクトリSPIメカニズムで定義されたabstractクラスSyncProviderの拡張として提供されます。

関連項目:

• 定数フィールド値

binaryStream

protected InputStream binaryStream

メソッドgetBinaryStreamによって返されたInputStreamオブジェクトであり、ResultSetインタフェースで指定されています。

unicodeStream

protected InputStream unicodeStream

メソッドgetUnicodeStreamによって返されたInputStreamオブジェクトであり、ResultSetインタフェースで指定されています。

asciiStream

protected InputStream asciiStream

メソッドgetAsciiStreamによって返されたInputStreamオブジェクトであり、ResultSetインタフェースで指定されています。

charStream

protected Reader charStream

メソッドgetCharacterStreamによって返されたReaderオブジェクトであり、ResultSetインタフェースで指定されています。

コンストラクタの詳細

BaseRowSet

public BaseRowSet()

デフォルトのVectorオブジェクトを使用して初期化を実行し、listenersフィールド用の新しいBaseRowSetオブジェクトを作成します。 初期化時に使用されるその他のデフォルト値は、このクラスのクラス・コメントのセクション6.0に記載されています。

メソッドの詳細

initParams

protected void initParams()

BaseRowSetインスタンスの標準機能を使ってJDBC RowSet実装を起動するために必要な内部での構成および初期化を実行します。 すべてのパラメータを正しく初期化するには、RowSetオブジェクトがインスタンス化された後でこのメソッドが呼び出されるべきです。 このメソッドは、決してアプリケーションによって呼び出されるべきではなく、このクラスを拡張したRowSet実装から呼び出されます。

addRowSetListener

public void addRowSetListener(RowSetListener listener)

リスナーは、このRowSetオブジェクトでイベントが発生するたびに通知を受けます。

リスナーは、たとえば、現在のRowSetオブジェクトの状態を正確に反映するために更新する必要がある表やグラフです。

ノート: RowSetListenerオブジェクトがnullの場合、このメソッドは通知なしでnull値を破棄し、リスナーのセットにnull参照を追加しません。

ノート: リスナーがすでに設定されていて、新しいRowSetListenerインスタンスが、このRowSetからイベント通知を受け取るためにすでに登録されているリスナーのセットに追加されている場合。

パラメータ:

listener - javax.sql.RowSetListenerインタフェースを実装し、このRowSetオブジェクトでイベントが発生したときに通知を受けるオブジェクト。nullの場合もある。

関連項目:

• removeRowSetListener(javax.sql.RowSetListener)

removeRowSetListener

public void removeRowSetListener(RowSetListener listener)

このRowSetオブジェクトのリスナー・リストから指定されたオブジェクトを削除します。 登録済みのリスナー以外が引数として指定された場合、このメソッドは何も行いません。 ノート: RowSetListenerオブジェクトがnullの場合、このメソッドは通知なしでnull値を破棄します。

パラメータ:

listener - このRowSetオブジェクトのリスナー・リストに含まれるRowSetListenerオブジェクト

関連項目:

• addRowSetListener(javax.sql.RowSetListener)

notifyCursorMoved

protected void notifyCursorMoved() throws SQLException

このRowSetオブジェクトに登録されているすべてのリスナーに、カーソルが移動したことを通知します。

アプリケーションがカーソルを移動するメソッドを呼び出すと、呼び出されたメソッドはカーソルを移動し、このメソッドを内部で呼び出します。 アプリケーションがこのメソッドを直接呼び出すことはありません。

例外:

SQLException - BaseRowSet abstractクラスを拡張するクラスがRowSetインタフェースまたはそのサブインタフェースを実装していない場合。

notifyRowChanged

protected void notifyRowChanged() throws SQLException

このRowSetオブジェクトに登録されているすべてのリスナーに、行が変更されたことを通知します。

アプリケーションが、行を変更するメソッド(CachedRowSetメソッドinsertRow、updateRow、deleteRowなど)を呼び出すと、呼び出されたメソッドは内部でnotifyRowChangedを呼び出します。 アプリケーションがこのメソッドを直接呼び出すことはありません。

例外:

SQLException - BaseRowSet abstractクラスを拡張するクラスがRowSetインタフェースまたはそのサブインタフェースを実装していない場合。

notifyRowSetChanged

protected void notifyRowSetChanged() throws SQLException

このRowSetオブジェクトに登録されているすべてのリスナーに、コンテンツ全体が変更されたことを通知します。

アプリケーションがRowSetオブジェクトのコンテンツ全体を変更するメソッド(CachedRowSetメソッドexecute、populate、restoreOriginal、releaseなど)を呼び出すと、呼び出されたメソッドは内部で直接的または間接的にnotifyRowSetChangedを呼び出します。 アプリケーションがこのメソッドを直接呼び出すことはありません。

例外:

SQLException - BaseRowSet abstractクラスを拡張するクラスがRowSetインタフェースまたはそのサブインタフェースを実装していない場合。

getCommand

public String getCommand()

このRowSetオブジェクトのコマンドになっているSQLクエリーを取得します。 コマンド・プロパティには、このRowSetオブジェクトを生成するために実行されるクエリーが含まれます。

このメソッドから返されるSQLクエリーは、RowSetメソッド(execute、populateなど)によって使用されます。これらのメソッドは、BaseRowSet abstractクラスを拡張するあらゆるクラスに実装可能であり、標準JSR-114 RowSetインタフェースを1個以上実装します。

RowSetオブジェクトのリーダーは、コマンドを使って、ResultSetオブジェクトを取得します。 次に、ResultSetオブジェクトからデータを読み取り、このデータを使ってこのRowSetオブジェクトを生成します。

commandプロパティのデフォルト値はnullです。

戻り値:

このRowSetオブジェクトのcommandプロパティの値を示すString。nullの場合もある

関連項目:

• setCommand(java.lang.String)

setCommand

public void setCommand(String cmd) throws SQLException

このRowSetオブジェクトのcommandプロパティとして指定のStringオブジェクトを設定し、パラメータがある場合は、以前のコマンド用に設定されたものなのでクリアします。

RowSetオブジェクトがコマンドをサポートしないソース(スプレッドシート、その他の表形式のファイル)からデータを取得する場合、commandプロパティは不要です。 つまり、このプロパティはオプションであり、nullの場合もあります。

パラメータ:

cmd - このRowSetオブジェクトのcommandプロパティとして設定されるSQLクエリーを含むStringオブジェクト。nullの場合もあるが、空文字列にはならない

例外:

SQLException - コマンドの値として空文字列が提供された場合

関連項目:

• getCommand()

getUrl

public String getUrl() throws SQLException

JDBCテクノロジを使用可能なドライバを使って、このRowSetオブジェクトのjavax.sql.Readerオブジェクトがリレーショナル・データベースとの接続を作成するために使用するJDBC URLを取得します。

配下のデータ・ソースがSQLデータ・ソースでない場合(スプレッドシートやXMLデータ・ソースの場合)、Urlプロパティはnullになります。

戻り値:

このRowSetオブジェクトの接続を確立するために使用されるJDBC URLを含むStringオブジェクト。設定しない場合、null (デフォルト値)になる

例外:

SQLException - URL値の取得中にエラーが発生した場合

関連項目:

• setUrl(java.lang.String)

setUrl

public void setUrl(String url) throws SQLException

このRowSetオブジェクトのUrlプロパティとして指定のStringオブジェクトを設定し、dataSource nameプロパティをnullに設定します。 Urlプロパティは、JDBCテクノロジを使用可能なドライバ(JDBCドライバ)とDriverManagerを使って接続を作成するときに使用するJDBC URLです。 特定のドライバ用の正しいJDBC URLは、ドライバのマニュアルに記載されています。 JDBC URLがどのように形成されるかについてのガイドラインはありますが、ドライバ・ベンダーは0 (空の文字列)の長さを持つオブジェクト以外のStringオブジェクトを指定できます。

DriverManagerではなくDataSourceオブジェクトを使って接続を確立した場合、Urlプロパティの設定はオプションになります。 ドライバは、URLプロパティかdataSourceNameプロパティ(最近指定されたもの)を使って接続を作成します。 JDBC URLを使用する場合、アプリケーションは、RowSetオブジェクトを使ってデータベースに接続する前に、JDBC URLを受け入れるJDBCドライバをロードする必要があります。 RowSetオブジェクトは、データの読み取りまたは書込みを行うため、内部でURLを使用してデータベース接続を作成します。

パラメータ:

url - このRowSetオブジェクトのデータベース接続を確立するために使用されるJDBC URLを含むStringオブジェクト。nullの場合もあるが、空文字列にはならない

例外:

SQLException - Urlプロパティの設定時にエラーが発生した場合、または長さ0 (空文字列)のパラメータが提供された場合

関連項目:

• getUrl()

getDataSourceName

public String getDataSourceName()

Java Naming and Directory Interface (JNDI) APIを使用するネーム・サービスに提供されるとjavax.sql.DataSourceオブジェクトを取得する論理名を返します。 このDataSourceオブジェクトを使って、このオブジェクトが示すデータ・ソースとの接続を確立することができます。

ユーザーは、urlまたはdata source nameプロパティのいずれかを設定する必要があります。 ドライバは、接続を確立するために一番最近設定されたプロパティ・セットを使用します。

戻り値:

接続の作成に使用するDataSourceオブジェクトを識別するStringオブジェクト。論理名が設定されていない場合、nullを返す。

関連項目:

• setDataSourceName(java.lang.String)

setDataSourceName

public void setDataSourceName(String name) throws SQLException

このRowSetオブジェクトのDataSource nameプロパティとして指定の論理名を設定し、このRowSetオブジェクトのUrlプロパティをnullに設定します。 JNDIネーム・サービス内でこの名前がDataSourceオブジェクトにバインドされていないと、アプリケーション内でその名前を使用してルックアップを行い、バインドされたDataSourceオブジェクトを取得できません。 その後、DataSourceオブジェクトを使用してこのオブジェクトが表すデータ・ソースへの接続を確立できます。

ユーザーは、UrlプロパティとdataSourceNameプロパティのいずれかを設定する必要があります。 両方のプロパティを設定した場合、ドライバは、最近設定されたプロパティを使用します。

パラメータ:

name - 名前を持つStringオブジェクト。JNDIテクノロジベースのネーム・サービスにこの名前を渡すことにより、接続の取得に使用するDataSourceオブジェクトを取得できる。nullでもよいが、空の文字列は不可

例外:

SQLException - DataSource名として空文字列が指定された場合

関連項目:

• getDataSourceName()

getUsername

public String getUsername()

データベース接続の作成に使用するユーザー名を返します。 usernameプロパティは直列化されないので、実行時、executeメソッドの呼出しの前に設定されます。

戻り値:

接続を作成するためにデータ・ソースに提供されるユーザー名を含むStringオブジェクト。設定しない場合、null (デフォルト値)になる

関連項目:

• setUsername(java.lang.String)

setUsername

public void setUsername(String name)

このRowSetオブジェクトのusernameプロパティとして、指定のユーザー名を設定します。 usernameプロパティは直列化されないので、実行時、executeメソッドの呼出しの前に設定されます。

パラメータ:

name - 接続を作成するためにデータ・ソースに提供されるユーザー名を含むStringオブジェクト。 nullも指定できる。

関連項目:

• getUsername()

getPassword

public String getPassword()

このRowSetオブジェクトのデータベース接続を作成するために使用するパスワードを返します。 passwordプロパティは直列化されないので、実行時、executeメソッドの呼出しの前に設定されます。 デフォルト値はnull

戻り値:

接続を作成する際データベースに提供する必要があるパスワードを表すStringオブジェクト

関連項目:

• setPassword(java.lang.String)

setPassword

public void setPassword(String pass)

このRowSetオブジェクトのデータベース接続を作成するために使用するパスワードとして、指定のStringオブジェクトを設定します。 passwordプロパティは直列化されないので、実行時、executeメソッドの呼出しの前に設定されます。

パラメータ:

pass - 接続を作成する際データベースに提供されるパスワードを表すStringオブジェクト。 nullも指定できる。

関連項目:

• getPassword()

setType

public void setType(int type) throws SQLException

このRowSetオブジェクトに特定の型を設定します。 デフォルトの型はResultSet.TYPE_SCROLL_INSENSITIVEです。

パラメータ:

type - 次の定数のいずれか。ResultSet.TYPE_FORWARD_ONLY、ResultSet.TYPE_SCROLL_INSENSITIVE、またはResultSet.TYPE_SCROLL_SENSITIVE

例外:

SQLException - パラメータとして次の定数以外が提供された場合。ResultSet.TYPE_FORWARD_ONLYまたはResultSet.TYPE_SCROLL_INSENSITIVE ResultSet.TYPE_SCROLL_SENSITIVE

関連項目:

• getConcurrency()
• getType()

getType

public int getType() throws SQLException

このRowSetオブジェクトの型を返します。 型は、最初、RowSetオブジェクトを作成した文によって決定されます。 RowSetオブジェクトは、いつでもsetTypeメソッドを呼び出して型を変更できます。 デフォルトはTYPE_SCROLL_INSENSITIVEです。

戻り値:

このJDBC RowSetオブジェクトの型。次のいずれかでなければならない。ResultSet.TYPE_FORWARD_ONLY、ResultSet.TYPE_SCROLL_INSENSITIVE、またはResultSet.TYPE_SCROLL_SENSITIVE

例外:

SQLException - このRowSetオブジェクトの型の取得時にエラーが発生した場合

関連項目:

• setType(int)

setConcurrency

public void setConcurrency(int concurrency) throws SQLException

このRowSetオブジェクトの並行性を指定された並行性に設定します。 接続されている場合でも接続されていない場合でも、RowSetオブジェクトのデフォルトの並行性はResultSet.CONCUR_UPDATABLEです。ただし、このメソッドは、並行性を変更したいときいつでも呼び出すことができます。

パラメータ:

concurrency - 次の定数のいずれか。ResultSet.CONCUR_READ_ONLYまたはResultSet.CONCUR_UPDATABLE

例外:

SQLException - パラメータとして次の定数以外が提供された場合。ResultSet.CONCUR_UPDATABLEまたはResultSet.CONCUR_READ_ONLY

関連項目:

• getConcurrency()
• isReadOnly()

isReadOnly

public boolean isReadOnly()

このRowSetオブジェクトが読取り専用であるかどうかを示すbooleanを返します。 読取り専用のRowSetオブジェクトを更新しようとすると、SQLExceptionがスローされます。 デフォルトでは、更新が可能であれば、行セットの更新も可能です。

戻り値:

このRowSetオブジェクトを更新できない場合はtrue、そうでない場合はfalse

関連項目:

• setConcurrency(int)
• setReadOnly(boolean)

setReadOnly

public void setReadOnly(boolean value)

このRowSetオブジェクトのreadOnlyプロパティとしてbooleanを設定します。

パラメータ:

value - このRowSetオブジェクトが読取り専用の場合はtrue、更新可能な場合はfalse

getTransactionIsolation

public int getTransactionIsolation()

このRowSetオブジェクトの接続のトランザクション遮断プロパティを返します。 このプロパティは、トランザクション用として要求されたトランザクション遮断レベルを表します。

RowSet実装(未接続の環境で動作するCachedRowSetなど)には、SyncProviderオブジェクトにより、補足ロックやデータの整合性のオプションが提供されます。 次のオプションは、接続済みRowSetオブジェクト(JdbcRowSetオブジェクト)専用です。

戻り値:

次の定数のいずれか。Connection.TRANSACTION_NONE、Connection.TRANSACTION_READ_UNCOMMITTED、Connection.TRANSACTION_READ_COMMITTED、Connection.TRANSACTION_REPEATABLE_READ、またはConnection.TRANSACTION_SERIALIZABLE

関連項目:

• SyncFactory
• SyncProvider
• setTransactionIsolation(int)

setTransactionIsolation

public void setTransactionIsolation(int level) throws SQLException

このJDBC RowSetオブジェクトのトランザクション遮断プロパティとして、指定の定数を設定します。 DBMSは、可能な場合は、このトランザクション遮断レベルを使用します。

RowSet実装(未接続の環境で動作するCachedRowSetなど)には、使用するSyncProviderオブジェクトにより、補足ロックやデータの整合性のオプションが提供されます。 次のオプションは、接続済みRowSetオブジェクト(JdbcRowSetオブジェクト)専用です。

パラメータ:

level - 次の昇順でリストされた定数のいずれか。Connection.TRANSACTION_NONE、Connection.TRANSACTION_READ_UNCOMMITTED、Connection.TRANSACTION_READ_COMMITTED、Connection.TRANSACTION_REPEATABLE_READ、またはConnection.TRANSACTION_SERIALIZABLE

例外:

SQLException - 指定のパラメータがConnection定数でない場合

関連項目:

• SyncFactory
• SyncProvider
• getTransactionIsolation()

getTypeMap

public Map<String,Class<?>> getTypeMap()

このRowSetオブジェクトのConnectionオブジェクトに関連付けられた型マップを取得します。

JDBC 3.0 APIをサポートするドライバは、型マップが関連付けられたConnectionオブジェクトを作成します。 この型マップは、初期状態では空ですが、1つ以上の完全修飾SQL名と、指定のSQL値のマップ先クラスを示すClassオブジェクトを含めることができます。 その他の代替となる型マップが存在しない場合、カスタム型マッピングには、接続の型マップで指定された型マッピングが使用されます。

カスタム・マッピングを実行できるメソッドに、明示的に型マップを提供した場合、この型マップは接続の型マップより優先されます。

戻り値:

java.util.Mapオブジェクト。RowSetオブジェクトの接続に使用する型マップ

setTypeMap

public void setTypeMap(Map<String,Class<?>> map)

このRowSetオブジェクトのConnectionオブジェクトに関連付けられた型マップとして、指定のjava.util.Mapオブジェクトをインストールします。 メソッドに別の型マップが明示的に指定されないかぎり、この型マップに示されたカスタム・マッピングが使用されます。明示的に指定された場合、その指定された型マップが使用されます。

パラメータ:

map - ユーザー定義型(UDT)のSQL型名とJavaプログラミング言語のクラスのマッピングを含むjava.util.Mapオブジェクト。 Mapオブジェクトの各エントリは、UDTの完全修飾SQL名と、そのUDTのSQLData実装のClassオブジェクトで構成される。 nullも可。

getMaxFieldSize

public int getMaxFieldSize() throws SQLException

このRowSetオブジェクト内の列の値として使用可能な最大バイト数を取得します。 ただし、次の型の値を格納する列には、バイト数の制限が課される: BINARY、VARBINARY、LONGVARBINARY、CHAR、VARCHAR、およびLONGVARCHAR。 制限値を超えたデータは通知なしに破棄されます。

戻り値:

現在の最大列サイズ制限値を示すint。0は制限がないことを表す

例外:

SQLException - 最大列サイズ制限値の決定時に内部でエラーが発生した場合

setMaxFieldSize

public void setMaxFieldSize(int max) throws SQLException

このRowSetオブジェクト内の列の値として使用可能な最大バイト数を、指定した値に設定します。 ただし、次の型の値を格納する列には、バイト数の制限が課される: BINARY、VARBINARY、LONGVARBINARY、CHAR、VARCHAR、およびLONGVARCHAR。 制限値を超えたデータは通知なしに破棄されます。 移植性を高めるため、256より大きい値を使用することをお勧めします。

パラメータ:

max - 新しい最大列サイズ制限値を示すint。0は制限がないことを表す

例外:

SQLException - (1)最大列サイズ制限値の設定時に内部エラーが発生した場合、(2) 0より小さいサイズが設定された場合

getMaxRows

public int getMaxRows() throws SQLException

このRowSetオブジェクトに含めることのできる最大行数を取得します。 制限値を超えた行は通知なしに除外されます。

戻り値:

現在の最大行数を示すint。0は制限がないことを表す

例外:

SQLException - Rowsetオブジェクトに含めることができる最大行数の決定時に内部でエラーが発生した場合

setMaxRows

public void setMaxRows(int max) throws SQLException

このRowSetオブジェクトに含めることのできる最大の行数を、指定した値に設定します。 制限値を超えた行は通知なしに除外されます。

パラメータ:

max - 現在の最大行数を示すint。0は制限がないことを表す

例外:

SQLException - JDBC RowSetオブジェクトに含めることができる最大行数の設定時に内部でエラーが発生した場合、maxに0より小さい値が指定された場合、またはmaxにRowSetのfetchSizeより小さい値が指定された場合

setEscapeProcessing

public void setEscapeProcessing(boolean enable) throws SQLException

データベースにSQL文を送信する前に、ドライバがエスケープ構文をスキャンしてエスケープ置換を行うかどうかを示す指定のbooleanに設定します。 デフォルトでは、ドライバはエスケープ処理を行います。

ノート: PreparedStatementオブジェクトは、通常呼び出す前に構文解析されているので、用意された文に対しエスケープ処理を無効にしても効果はありません。

パラメータ:

enable - エスケープ処理を有効にする場合はtrue、無効にする場合はfalse

例外:

SQLException - 配下のJDBCテクノロジを使用可能なドライバがエスケープ構文を処理するように設定している途中でエラーが発生した場合

getQueryTimeout

public int getQueryTimeout() throws SQLException

ドライバがクエリーの実行を待つ最大秒数を取得します。 この制限時間を経過すると、SQLExceptionがスローされます。

戻り値:

現在のクエリー・タイムアウトの制限値(秒数)。ゼロは無制限を意味する

例外:

SQLException - クエリー・タイムアウト値の決定時にエラーが発生した場合

setQueryTimeout

public void setQueryTimeout(int seconds) throws SQLException

ドライバがクエリーの実行を待つ最大秒数を設定します。 この制限時間を経過すると、SQLExceptionがスローされます。

パラメータ:

seconds - 新しいクエリー・タイムアウトの制限値の秒数。ゼロは無制限を意味する。ゼロより小さい値は使用できない

例外:

SQLException - クエリー・タイムアウト値の設定時にエラーが発生した場合、またはクエリー・タイムアウト値が0より小さい場合

getShowDeleted

public boolean getShowDeleted() throws SQLException

削除マークが付けられた行を現在の行とともに表示するかどうかを示すbooleanを取得します。 デフォルト値はfalseです。

ノート: 削除された行の表示を許可すると、一部のメソッドの動作が複雑になります。 ただし、この機能を活用する必要が生じるのは高度なアプリケーションだけなので、ほとんどのRowSetオブジェクト・ユーザーは単純にこの余分な詳細を無視してかまいません。

戻り値:

削除された行を表示する場合はtrue、そうでない場合はfalse

例外:

SQLException - 削除された行を表示するかどうかを決定している途中でエラーが発生した場合

関連項目:

• setShowDeleted(boolean)

setShowDeleted

public void setShowDeleted(boolean value) throws SQLException

showDeletedプロパティとして、削除マーク付きの行を現在の行とともに表示するかどうかを指定するbooleanを設定します。

パラメータ:

value - 削除された行を表示する場合はtrue、そうでない場合はfalse

例外:

SQLException - 削除された行を表示するかどうかを設定している途中でエラーが発生した場合

関連項目:

• getShowDeleted()

getEscapeProcessing

public boolean getEscapeProcessing() throws SQLException

このRowSetオブジェクトでエスケープ処理が有効になっているかどうかを確認します。

戻り値:

エスケープ処理が有効な場合はtrue、そうでない場合はfalse

例外:

SQLException - エスケープ処理の有効または無効を決定している途中でエラーが発生した場合、または内部エスケープ処理トリガーが有効になっていない場合

setFetchDirection

public void setFetchDirection(int direction) throws SQLException

このRowSetオブジェクト内の行が処理される方向について、ドライバにパフォーマンス・ヒントを与えます。 このヒントは、無視されることもあります。

RowSetオブジェクトは、データの取得先のResultSetオブジェクトのデフォルト・プロパティを継承します。 ResultSetオブジェクトのデフォルトのフェッチ方向は、このオブジェクトを作成したStatementによって設定されます。

このメソッドは、JDBCドライバを使ってデータベースに接続されているRowSetオブジェクトだけに適用されます。

RowSetオブジェクトは、このメソッドを使って、いつでもフェッチ方向の設定を変更できます。

パラメータ:

direction - ResultSet.FETCH_FORWARD、ResultSet.FETCH_REVERSE、ResultSet.FETCH_UNKNOWNのいずれか

例外:

SQLException - (1) RowSetの型がTYPE_FORWARD_ONLYであり、FETCH_FORWARD以外のフェッチ方向が指定された場合、(2)フェッチ方向が次のいずれでもない場合。ResultSet.FETCH_FORWARD、ResultSet.FETCH_REVERSE、またはResultSet.FETCH_UNKNOWNのいずれか

関連項目:

• getFetchDirection()

getFetchDirection

public int getFetchDirection() throws SQLException

このRowSetオブジェクトの現在のフェッチ方向の設定を取得します。 デフォルトの型はResultSet.FETCH_FORWARD

戻り値:

ResultSet.FETCH_FORWARD、ResultSet.FETCH_REVERSE、ResultSet.FETCH_UNKNOWNのいずれか

例外:

SQLException - 行をフェッチする現在のフェッチ方向を決定している途中でエラーが発生した場合

関連項目:

• setFetchDirection(int)

setFetchSize

public void setFetchSize(int rows) throws SQLException

このRowSetオブジェクトのフェッチ・サイズとして、指定の行数を設定します。 フェッチ・サイズは、JDBCテクノロジを使用可能なドライバ(JDBCドライバ)に、このRowSetオブジェクトがより多くの行を必要とするときデータベースからフェッチされる行数を示すヒントとなります。 フェッチ・サイズとしてゼロが指定された場合、ドライバは値を無視し、最適なフェッチ・サイズを独自に推測します。

RowSetオブジェクトは、データの取得先のResultSetオブジェクトのデフォルト・プロパティを継承します。 ResultSetオブジェクトのデフォルトのフェッチ・サイズは、このオブジェクトを作成したStatementによって設定されます。

このメソッドは、JDBCドライバを使ってデータベースに接続されているRowSetオブジェクトだけに適用されます。 JdbcRowSetのように、RowSet実装が接続されている場合は、配下のJDBCドライバに対して直接的な影響を及ぼします。

RowSetオブジェクトは、このメソッドを使って、いつでもフェッチ・サイズの設定を変更できます。

CachedRowSetなどのRowSet実装は、未接続環境で動作します。この場合、使用されるSyncProviderオブジェクトは、フェッチ・サイズを利用してデータ・ソースをポーリングし、フェッチ・サイズを超えない範囲で行数を取得します。この行数は、元のクエリーから返される実際の行数のサブセットになります。 これは、未接続のRowSetオブジェクトで採用された特定のSyncProviderオブジェクトによって決まる実装上の差異です。

パラメータ:

rows - フェッチされる行数。0の場合、ドライバが最適フェッチ・サイズを決定する。0より小さい値と、このRowSetオブジェクトに許可された最大行数(getMaxRows()メソッドの呼出しによって返される値)を超える値は指定できない

例外:

SQLException - 指定されたフェッチ・サイズが0より小さい場合、または最大行数を超過した場合

関連項目:

• getFetchSize()

getFetchSize

public int getFetchSize() throws SQLException

このRowSetオブジェクトのフェッチ・サイズを返します。 デフォルト値はゼロです。

戻り値:

このRowSetオブジェクトがデータベースからより多くの行を取得する必要がある場合に、フェッチ・サイズとして提示される行数

例外:

SQLException - 現在のフェッチ・サイズ内で行数の決定中にエラーが発生した場合

関連項目:

• setFetchSize(int)

getConcurrency

public int getConcurrency() throws SQLException

このRowSetオブジェクトの並行処理を返します。 RowSetオブジェクトが接続されている場合も、未接続の場合も、デフォルト値はCONCUR_UPDATABLEです。

アプリケーションは、いつでもsetConcurrencyメソッドを呼び出して、RowSetオブジェクトの並行性を変更できます。

戻り値:

このRowSetオブジェクトの並行性の型。次のいずれかでなければならない。ResultSet.CONCUR_READ_ONLYまたはResultSet.CONCUR_UPDATABLE

例外:

SQLException - このRowSetオブジェクトの並行性の取得時にエラーが発生した場合

関連項目:

• setConcurrency(int)
• isReadOnly()

setNull

public void setNull(int parameterIndex, int sqlType) throws SQLException

指定されたパラメータをSQL NULLに設定します。 パラメータのSQL型は、java.sql.Typesで定義された型コードの1つを使用して指定する必要があります。 このSQL型は、2番目のパラメータに指定されます。

2番目のパラメータは、DBMSに対して、NULLに設定される値のデータ型を通知します。 この情報は一部のDBMSで必要とされるため、コードの移植性を向上させるためには、この情報が必要となります。

このメソッドで設定されたパラメータ値は内部で格納され、executeメソッドの呼出し時に、このRowSetオブジェクトのコマンド内の適切なパラメータとして提供されます。 execute、populateなどのメソッドは、このクラスを拡張し、標準JSR-114 RowSetインタフェースを1つ以上実装するクラスで提供される必要があります。

ノート: JdbcRowSetはpopulateメソッドを必要としません。このメソッドは、このクラス内に定義されていません。

このバージョンのsetNullを呼び出した後でメソッドgetParamsを呼び出すと、設定されたパラメータ値を含むObject配列が返されます。 その配列内で、このメソッドで設定された値を表す要素はそれ自体が配列になります。 その配列の最初の要素はnullです。 2番目の要素は、sqlTypeに設定された値です。 パラメータ番号はメソッドgetParamsから返される配列内での要素の位置によって示され、最初の要素は最初のプレースホルダー・パラメータの値、2番目の要素は2番目のプレースホルダー・パラメータの値、といった具合になります。 言い換えると、2番目のプレースホルダー・パラメータをnullに設定する場合、その値を含む配列は、getParamsから返される配列内の2番目の要素になります。

配列内の要素の番号付けはゼロから開始されるので、プレースホルダー番号parameterIndexに対応する配列要素はparameterIndex -1になります。

パラメータ:

parameterIndex - このRowSetオブジェクトのコマンド内の、設定対象となるプレースホルダー・パラメータの順序番号。 最初のパラメータが1、2番目のパラメータが2、といった具合になる。1以上でなければいけない

sqlType - Typesクラス内に定義されたSQL型コードを表すint。 非標準のsqlTypeが提供された場合、このメソッドはSQLExceptionをスローしない。 この動作により、非標準のSQL型が暗黙的にサポートされる。

例外:

SQLException - データベース・アクセス・エラーが発生した場合、または指定されたパラメータ・インデックスが範囲外である場合

関連項目:

• getParams()

setNull

public void setNull(int parameterIndex, int sqlType, String typeName) throws SQLException

指定されたパラメータをSQL NULLに設定します。 このバージョンのメソッドsetNullはユーザー定義パラメータおよびREFパラメータを対象としていますが、このメソッドは任意のJDBC型のnullパラメータを設定するために使用できます。 ユーザー定義型は次のとおりです。STRUCT、DISTINCT、JAVA_OBJECTおよび名前付き配列型。

ノート: 移植性を実現するためには、アプリケーションはNULLのユーザー定義パラメータまたはREFパラメータを指定するときにSQL型コードおよび完全修飾SQL型名を指定しなければいけません。 ユーザー定義型の場合、名前はパラメータ自体の型名です。 REFパラメータの場合、名前は参照される型の型名です。 JDBCテクノロジを使用可能なドライバが型コードまたは型名の情報を必要としない場合、それは無視されます。

パラメータがユーザー定義型またはREF型でない場合は、指定したtypeNameパラメータは無視されます。

このメソッドで設定されたパラメータ値は内部で格納され、executeメソッドの呼出し時に、このRowSetオブジェクトのコマンド内の適切なパラメータとして提供されます。 execute、populateなどのメソッドは、このクラスを拡張し、標準JSR-114 RowSetインタフェースを1つ以上実装するクラスで提供される必要があります。

ノート: JdbcRowSetはpopulateメソッドを必要としません。このメソッドは、このクラス内に定義されていません。

このバージョンのsetNullを呼び出した後でメソッドgetParamsを呼び出すと、設定されたパラメータ値を含むObject配列が返されます。 その配列内で、このメソッドで設定された値を表す要素はそれ自体が配列になります。 その配列の最初の要素はnullです。 2番目の要素はsqlTypeに設定された値、3番目の要素はtypeNameに設定された値です。 パラメータ番号はメソッドgetParamsから返される配列内での要素の位置によって示され、最初の要素は最初のプレースホルダー・パラメータの値、2番目の要素は2番目のプレースホルダー・パラメータの値、といった具合になります。 言い換えると、2番目のプレースホルダー・パラメータをnullに設定する場合、その値を含む配列は、getParamsから返される配列内の2番目の要素になります。

配列内の要素の番号付けはゼロから開始されるので、プレースホルダー番号parameterIndexに対応する配列要素はparameterIndex -1になります。

パラメータ:

parameterIndex - このRowSetオブジェクトのコマンド内の、設定対象となるプレースホルダー・パラメータの順序番号。 最初のパラメータが1、2番目のパラメータが2、といった具合になる。1以上でなければいけない

sqlType - java.sql.Typesからの値

typeName - SQLユーザー定義型の完全修飾名。パラメータがユーザー定義型でもREF値でもない場合は無視される

例外:

SQLException - エラーが発生した場合、または指定されたパラメータ・インデックスが範囲外である場合

関連項目:

• getParams()

setBoolean

public void setBoolean(int parameterIndex, boolean x) throws SQLException

指定されたパラメータを、指定されたJavaプログラミング言語のbooleanに設定します。 データベースに送るときに、ドライバはこれをSQL BIT値に変換します。

このメソッドで設定されたパラメータ値は内部で格納され、executeメソッドの呼出し時に、このRowSetオブジェクトのコマンド内の適切なパラメータとして提供されます。 execute、populateなどのメソッドは、このクラスを拡張し、標準JSR-114 RowSetインタフェースを1つ以上実装するクラスで提供される必要があります。

ノート: JdbcRowSetはpopulateメソッドを必要としません。このメソッドは、このクラス内に定義されていません。

パラメータ:

parameterIndex - このRowSetオブジェクトのコマンド内の、設定対象となるプレースホルダー・パラメータの順序番号。 最初のパラメータが1、2番目のパラメータが2、といった具合になる。1以上でなければいけない

x - パラメータ値

例外:

SQLException - エラーが発生した場合、またはパラメータ・インデックスが範囲外である場合

関連項目:

• getParams()

setByte

public void setByte(int parameterIndex, byte x) throws SQLException

指定されたパラメータを、指定されたJavaプログラミング言語のbyteに設定します。 データベースに送るときに、ドライバはこれをSQL TINYINT値に変換します。

このメソッドで設定されたパラメータ値は内部で格納され、executeメソッドの呼出し時に、このRowSetオブジェクトのコマンド内の適切なパラメータとして提供されます。 execute、populateなどのメソッドは、このクラスを拡張し、標準JSR-114 RowSetインタフェースを1つ以上実装するクラスで提供される必要があります。

ノート: JdbcRowSetはpopulateメソッドを必要としません。このメソッドは、このクラス内に定義されていません。

パラメータ:

parameterIndex - このRowSetオブジェクトのコマンド内の、設定対象となるプレースホルダー・パラメータの順序番号。 最初のパラメータが1、2番目のパラメータが2、といった具合になる。1以上でなければいけない

x - パラメータ値

例外:

SQLException - エラーが発生した場合、またはパラメータ・インデックスが範囲外である場合

関連項目:

• getParams()

setShort

public void setShort(int parameterIndex, short x) throws SQLException

指定されたパラメータを、指定されたJavaプログラミング言語のshortに設定します。 データベースに送るときに、ドライバはこれをSQL SMALLINT値に変換します。

このメソッドで設定されたパラメータ値は内部で格納され、executeメソッドの呼出し時に、このRowSetオブジェクトのコマンド内の適切なパラメータとして提供されます。 execute、populateなどのメソッドは、このクラスを拡張し、標準JSR-114 RowSetインタフェースを1つ以上実装するクラスで提供される必要があります。

ノート: JdbcRowSetはpopulateメソッドを必要としません。このメソッドは、このクラス内に定義されていません。

パラメータ:

parameterIndex - このRowSetオブジェクトのコマンド内の、設定対象となるプレースホルダー・パラメータの順序番号。 最初のパラメータが1、2番目のパラメータが2、といった具合になる。1以上でなければいけない

x - パラメータ値

例外:

SQLException - エラーが発生した場合、またはパラメータ・インデックスが範囲外である場合

関連項目:

• getParams()

setInt

public void setInt(int parameterIndex, int x) throws SQLException

指定されたパラメータを、指定されたJavaプログラミング言語のint値に設定します。 データベースに送るときに、ドライバはこれをSQL INTEGER値に変換します。

このメソッドで設定されたパラメータ値は内部で格納され、executeメソッドの呼出し時に、このRowSetオブジェクトのコマンド内の適切なパラメータとして提供されます。 execute、populateなどのメソッドは、このクラスを拡張し、標準JSR-114 RowSetインタフェースを1つ以上実装するクラスで提供される必要があります。

ノート: JdbcRowSetはpopulateメソッドを必要としません。このメソッドは、このクラス内に定義されていません。

パラメータ:

parameterIndex - このRowSetオブジェクトのコマンド内の、設定対象となるプレースホルダー・パラメータの順序番号。 最初のパラメータが1、2番目のパラメータが2、といった具合になる。1以上でなければいけない

x - パラメータ値

例外:

SQLException - エラーが発生した場合、またはパラメータ・インデックスが範囲外である場合

関連項目:

• getParams()

setLong

public void setLong(int parameterIndex, long x) throws SQLException

指定されたパラメータを、指定されたJavaプログラミング言語のlongに設定します。 データベースに送るときに、ドライバはこれをSQL BIGINT値に変換します。

このメソッドで設定されたパラメータ値は内部で格納され、executeメソッドの呼出し時に、このRowSetオブジェクトのコマンド内の適切なパラメータとして提供されます。 execute、populateなどのメソッドは、このクラスを拡張し、標準JSR-114 RowSetインタフェースを1つ以上実装するクラスで提供される必要があります。

ノート: JdbcRowSetはpopulateメソッドを必要としません。このメソッドは、このクラス内に定義されていません。

パラメータ:

parameterIndex - このRowSetオブジェクトのコマンド内の、設定対象となるプレースホルダー・パラメータの順序番号。 最初のパラメータが1、2番目のパラメータが2、といった具合になる。1以上でなければいけない

x - パラメータ値

例外:

SQLException - エラーが発生した場合、またはパラメータ・インデックスが範囲外である場合

関連項目:

• getParams()

setFloat

public void setFloat(int parameterIndex, float x) throws SQLException

指定されたパラメータを、指定されたJavaプログラミング言語のfloatに設定します。 データベースに送るときに、ドライバはこれをSQL FLOAT値に変換します。

このメソッドで設定されたパラメータ値は内部で格納され、executeメソッドの呼出し時に、このRowSetオブジェクトのコマンド内の適切なパラメータとして提供されます。 execute、populateなどのメソッドは、このクラスを拡張し、標準JSR-114 RowSetインタフェースを1つ以上実装するクラスで提供される必要があります。

ノート: JdbcRowSetはpopulateメソッドを必要としません。このメソッドは、このクラス内に定義されていません。

パラメータ:

parameterIndex - このRowSetオブジェクトのコマンド内の、設定対象となるプレースホルダー・パラメータの順序番号。 最初のパラメータが1、2番目のパラメータが2、といった具合になる。1以上でなければいけない

x - パラメータ値

例外:

SQLException - エラーが発生した場合、またはパラメータ・インデックスが範囲外である場合

関連項目:

• getParams()

setDouble

public void setDouble(int parameterIndex, double x) throws SQLException

指定されたパラメータを、指定されたJavaプログラミング言語のdoubleに設定します。 データベースに送るときに、ドライバはこれをSQL DOUBLE値に変換します。

このメソッドで設定されたパラメータ値は内部で格納され、executeメソッドの呼出し時に、このRowSetオブジェクトのコマンド内の適切なパラメータとして提供されます。 execute、populateなどのメソッドは、このクラスを拡張し、標準JSR-114 RowSetインタフェースを1つ以上実装するクラスで提供される必要があります。

ノート: JdbcRowSetはpopulateメソッドを必要としません。このメソッドは、このクラス内に定義されていません。

パラメータ:

parameterIndex - このRowSetオブジェクトのコマンド内の、設定対象となるプレースホルダー・パラメータの順序番号。 最初のパラメータが1、2番目のパラメータが2、といった具合になる。1以上でなければいけない

x - パラメータ値

例外:

SQLException - エラーが発生した場合、またはパラメータ・インデックスが範囲外である場合

関連項目:

• getParams()

setBigDecimal

public void setBigDecimal(int parameterIndex, BigDecimal x) throws SQLException

指定されたパラメータを、指定されたjava.lang.BigDecimal値に設定します。 データベースに送るときに、ドライバはこれをSQL NUMERIC値に変換します。

このメソッドで設定されたパラメータ値は内部で格納され、executeメソッドの呼出し時に、このRowSetオブジェクトのコマンド内の適切なパラメータとして提供されます。 execute、populateなどのメソッドは、このクラスを拡張し、標準JSR-114 RowSetインタフェースを1つ以上実装するクラスで提供される必要があります。

ノート: JdbcRowSetはpopulateメソッドを必要としません。このメソッドは、このクラス内に定義されていません。

パラメータ:

parameterIndex - このRowSetオブジェクトのコマンド内の、設定対象となるプレースホルダー・パラメータの順序番号。 最初のパラメータが1、2番目のパラメータが2、といった具合になる。1以上でなければいけない

x - パラメータ値

例外:

SQLException - エラーが発生した場合、またはパラメータ・インデックスが範囲外である場合

関連項目:

• getParams()

setString

public void setString(int parameterIndex, String x) throws SQLException

指定されたパラメータを、指定されたString値に設定します。 データベースに送るときに、ドライバはこれをSQL VARCHARまたはLONGVARCHAR値(ドライバのVARCHAR値の制限に対する引数のサイズに依存)に変換します。

このメソッドで設定されたパラメータ値は内部で格納され、executeメソッドの呼出し時に、このRowSetオブジェクトのコマンド内の適切なパラメータとして提供されます。 execute、populateなどのメソッドは、このクラスを拡張し、標準JSR-114 RowSetインタフェースを1つ以上実装するクラスで提供される必要があります。

ノート: JdbcRowSetはpopulateメソッドを必要としません。このメソッドは、このクラス内に定義されていません。

パラメータ:

parameterIndex - このRowSetオブジェクトのコマンド内の、設定対象となるプレースホルダー・パラメータの順序番号。 最初のパラメータが1、2番目のパラメータが2、といった具合になる。1以上でなければいけない

x - パラメータ値

例外:

SQLException - エラーが発生した場合、またはパラメータ・インデックスが範囲外である場合

関連項目:

• getParams()

setBytes

public void setBytes(int parameterIndex, byte[] x) throws SQLException

指定されたパラメータを、指定されたバイト配列に設定します。 データベースに送るときに、ドライバはこれをSQL VARBINARYまたはLONGVARBINARY値(ドライバのVARBINARY値の制限に対する引数のサイズに依存)に変換します。

このメソッドで設定されたパラメータ値は内部で格納され、executeメソッドの呼出し時に、このRowSetオブジェクトのコマンド内の適切なパラメータとして提供されます。 execute、populateなどのメソッドは、このクラスを拡張し、標準JSR-114 RowSetインタフェースを1つ以上実装するクラスで提供される必要があります。

ノート: JdbcRowSetはpopulateメソッドを必要としません。このメソッドは、このクラス内に定義されていません。

パラメータ:

parameterIndex - このRowSetオブジェクトのコマンド内の、設定対象となるプレースホルダー・パラメータの順序番号。 最初のパラメータが1、2番目のパラメータが2、といった具合になる。1以上でなければいけない

x - パラメータ値

例外:

SQLException - エラーが発生した場合、またはパラメータ・インデックスが範囲外である場合

関連項目:

• getParams()

setDate

public void setDate(int parameterIndex, Date x) throws SQLException

指定されたパラメータを、指定されたjava.sql.Date値に設定します。 データベースに送るときに、ドライバはこれをSQL DATE値に変換します。

このメソッドで設定されたパラメータ値は内部で格納され、executeメソッドの呼出し時に、このRowSetオブジェクトのコマンド内の適切なパラメータとして提供されます。 execute、populateなどのメソッドは、このクラスを拡張し、標準JSR-114 RowSetインタフェースを1つ以上実装するクラスで提供される必要があります。

ノート: JdbcRowSetはpopulateメソッドを必要としません。このメソッドは、このクラス内に定義されていません。

このバージョンのsetDateを呼び出したあと、getParamsメソッドを呼び出すと、プレースホルダー・パラメータ番号parameterIndex (2番目のパラメータとして提供されるDateオブジェクト)に設定される値の配列が返されます。 配列内の要素の番号付けはゼロから開始されるので、プレースホルダー番号parameterIndexに対応する配列要素はparameterIndex -1になります。

パラメータ:

parameterIndex - このRowSetオブジェクトのコマンド内の、設定対象となるプレースホルダー・パラメータの順序番号。 最初のパラメータが1、2番目のパラメータが2、といった具合になる。1以上でなければいけない

x - パラメータ値

例外:

SQLException - エラーが発生した場合、またはパラメータ・インデックスが範囲外である場合

関連項目:

• getParams()

setTime

public void setTime(int parameterIndex, Time x) throws SQLException

指定されたパラメータを、指定されたjava.sql.Time値に設定します。 データベースに送るときに、ドライバはこれをSQL TIME値に変換します。

このメソッドで設定されたパラメータ値は内部で格納され、executeメソッドの呼出し時に、このRowSetオブジェクトのコマンド内の適切なパラメータとして提供されます。 execute、populateなどのメソッドは、このクラスを拡張し、標準JSR-114 RowSetインタフェースを1つ以上実装するクラスで提供される必要があります。

ノート: JdbcRowSetはpopulateメソッドを必要としません。このメソッドは、このクラス内に定義されていません。

このバージョンのsetTimeメソッドを呼び出したあと、getParamsメソッドを呼び出すと、設定されたパラメータの配列が返されます。 このメソッドの2番目のパラメータとして設定されたTimeオブジェクトが、プレースホルダー・パラメータ番号parameterIndexのパラメータとして設定されます。

配列内の要素の番号付けはゼロから開始されるので、プレースホルダー番号parameterIndexに対応する配列要素はparameterIndex -1になります。

パラメータ:

parameterIndex - このRowSetオブジェクトのコマンド内の、設定対象となるプレースホルダー・パラメータの順序番号。 最初のパラメータが1、2番目のパラメータが2、といった具合になる。1以上でなければいけない

x - java.sql.Timeオブジェクト。プレースホルダー・パラメータparameterIndexの値として設定される

例外:

SQLException - エラーが発生した場合、またはパラメータ・インデックスが範囲外である場合

関連項目:

• getParams()

setTimestamp

public void setTimestamp(int parameterIndex, Timestamp x) throws SQLException

指定されたパラメータを、指定されたjava.sql.Timestamp値に設定します。 データベースに送るときに、ドライバはこれをSQL TIMESTAMP値に変換します。

このメソッドで設定されたパラメータ値は内部で格納され、executeメソッドの呼出し時に、このRowSetオブジェクトのコマンド内の適切なパラメータとして提供されます。 execute、populateなどのメソッドは、このクラスを拡張し、標準JSR-114 RowSetインタフェースを1つ以上実装するクラスで提供される必要があります。

ノート: JdbcRowSetはpopulateメソッドを必要としません。このメソッドは、このクラス内に定義されていません。

このバージョンのsetTimestampを呼び出したあと、getParamsメソッドを呼び出すと、プレースホルダー・パラメータ番号parameterIndex (このメソッドの2番目のパラメータとして提供されるTimestampオブジェクト)に設定される値の配列が返されます。 配列内の要素の番号付けはゼロから開始されるので、プレースホルダー番号parameterIndexに対応する配列要素はparameterIndex -1になります。

パラメータ:

parameterIndex - このRowSetオブジェクトのコマンド内の、設定対象となるプレースホルダー・パラメータの順序番号。 最初のパラメータが1、2番目のパラメータが2、といった具合になる。1以上でなければいけない

x - java.sql.Timestampオブジェクト

例外:

SQLException - エラーが発生した場合、またはパラメータ・インデックスが範囲外である場合

関連項目:

• getParams()

setAsciiStream

public void setAsciiStream(int parameterIndex, InputStream x, int length) throws SQLException

指定されたパラメータを、指定されたバイト数を持つ指定されたjava.io.InputStreamオブジェクトに設定します。 ストリームの内容が読み取られ、データベースに送信されます。 読み取られ、データベースに送信されるバイト数がlengthに一致していない場合、このメソッドはSQLExceptionオブジェクトをスローします。

LONGVARCHARパラメータに非常に大きなASCII値が入力されるときには、java.io.InputStreamオブジェクトを介して送るのが現実的です。 JDBCテクノロジを使用可能なドライバは、ファイルの終わりに達するまで必要に応じてストリームからデータを読み込みます。 ドライバは、必要に応じて、ASCIIからデータベースのCHAR形式への変換を行います。

ノート: このストリーム・オブジェクトは、標準のJavaストリーム・オブジェクト、または標準インタフェースを実装する独自のサブクラスのどちらでもかまいません。

このメソッドで設定されたパラメータ値は内部で格納され、executeメソッドの呼出し時に、このRowSetオブジェクトのコマンド内の適切なパラメータとして提供されます。 execute、populateなどのメソッドは、このクラスを拡張し、標準JSR-114 RowSetインタフェースを1つ以上実装するクラスで提供される必要があります。

ノート: JdbcRowSetはpopulateメソッドを必要としません。このメソッドは、このクラス内に定義されていません。

setAsciiStreamを呼び出した後でメソッドgetParamsを呼び出すと、設定されたパラメータ値を含む配列が返されます。 その配列内で、このメソッドで設定された値を表す要素はそれ自体が配列になります。 その配列の最初の要素は、指定されたjava.io.InputStreamオブジェクトです。 2番目の要素は、lengthに設定された値です。 3番目の要素は、このメソッドに渡されたストリームがASCIIストリームであることを指定する、BaseRowSetの内部定数です。 パラメータ番号はメソッドgetParamsから返される配列内での要素の位置によって示され、最初の要素は最初のプレースホルダー・パラメータの値、2番目の要素は2番目のプレースホルダー・パラメータの値、といった具合になります。 言い換えると、設定する入力ストリームが2番目のプレースホルダー・パラメータの値である場合、その値を含む配列は、getParamsから返される配列内の2番目の要素になります。

配列内の要素の番号付けはゼロから開始されるので、プレースホルダー・パラメータ番号parameterIndexに対応する配列要素番号はparameterIndex -1になります。

パラメータ:

parameterIndex - このRowSetオブジェクトのコマンド内の、設定対象となるプレースホルダー・パラメータの順序番号。 最初のパラメータが1、2番目のパラメータが2、といった具合になる。1以上でなければいけない

x - ASCIIパラメータ値を含むJava入力ストリーム

length - ストリームのバイト数。 ドライバからDBMSに送信されるバイト数に一致する。バイト長0以下は未定義だが、配下のJDBCドライバで無効な長さ例外がスローされる。

例外:

SQLException - エラーが発生した場合、パラメータ・インデックスが範囲外の場合、またはデータ・ソースに接続した場合は、ドライバによって読み取られデータベースに送信されるバイト数がlengthに指定されたバイト数と一致しない

関連項目:

• getParams()

setAsciiStream

public 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

setBinaryStream

public void setBinaryStream(int parameterIndex, InputStream x, int length) throws SQLException

指定されたパラメータを、指定されたバイト数を持つ指定されたjava.io.InputStreamオブジェクトに設定します。 ストリームの内容が読み取られ、データベースに送信されます。 読み取られ、データベースに送信されるバイト数がlengthに一致していない場合、このメソッドはSQLExceptionオブジェクトをスローします。

LONGVARBINARYパラメータに非常に大きなバイナリ値が入力されるときには、java.io.InputStreamオブジェクトを介して送るのが現実的です。 JDBCテクノロジを使用可能なドライバは、ファイルの終わりに達するまで必要に応じてストリームからデータを読み込みます。

ノート: このストリーム・オブジェクトは、標準のJavaストリーム・オブジェクト、または標準インタフェースを実装する独自のサブクラスのどちらでもかまいません。

このメソッドで設定されたパラメータ値は内部で格納され、executeメソッドの呼出し時に、このRowSetオブジェクトのコマンド内の適切なパラメータとして提供されます。 execute、populateなどのメソッドは、このクラスを拡張し、標準JSR-114 RowSetインタフェースを1つ以上実装するクラスで提供される必要があります。

ノート: JdbcRowSetはpopulateメソッドを必要としません。このメソッドは、このクラス内に定義されていません。

setBinaryStreamを呼び出した後でメソッドgetParamsを呼び出すと、設定されたパラメータ値を含む配列が返されます。 その配列内で、このメソッドで設定された値を表す要素はそれ自体が配列になります。 その配列の最初の要素は、指定されたjava.io.InputStreamオブジェクトです。 2番目の要素は、lengthに設定された値です。 3番目の要素は、このメソッドに渡されたストリームがバイナリ・ストリームであることを指定する、BaseRowSetの内部定数です。 パラメータ番号はメソッドgetParamsから返される配列内での要素の位置によって示され、最初の要素は最初のプレースホルダー・パラメータの値、2番目の要素は2番目のプレースホルダー・パラメータの値、といった具合になります。 言い換えると、設定する入力ストリームが2番目のプレースホルダー・パラメータの値である場合、その値を含む配列は、getParamsから返される配列内の2番目の要素になります。

配列内の要素の番号付けはゼロから開始されるので、プレースホルダー・パラメータ番号parameterIndexに対応する配列要素番号はparameterIndex -1になります。

パラメータ:

parameterIndex - このRowSetオブジェクトのコマンド内の、設定対象となるプレースホルダー・パラメータの順序番号。 最初のパラメータが1、2番目のパラメータが2、といった具合になる。1以上でなければいけない

x - 設定されるバイナリ値を含む入力ストリーム

length - ストリームのバイト数。バイト長0以下は未定義だが、配下のJDBCドライバで無効な長さ例外がスローされる。

例外:

SQLException - エラーが発生した場合、パラメータ・インデックスが範囲外の場合、またはデータ・ソースに接続した場合は、ドライバによって読み取られデータベースに送信されるバイト数がlengthに指定されたバイト数と一致しない

関連項目:

• getParams()

setBinaryStream

public 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

setUnicodeStream

@Deprecated public void setUnicodeStream(int parameterIndex, InputStream x, int length) throws SQLException

非推奨。

代わりにgetCharacterStreamを使用してください。

指定されたパラメータを、指定されたバイト数を持つ指定されたjava.io.InputStreamオブジェクトに設定します。 ストリームの内容が読み取られ、データベースに送信されます。 読み取られ、データベースに送信されるバイト数がlengthに一致していない場合、このメソッドはSQLExceptionをスローします。

LONGVARCHARパラメータに非常に大きなUnicode値が入力されるときには、java.io.InputStreamオブジェクトを介して送るのが現実的です。 JDBCテクノロジを使用可能なドライバは、ファイルの終わりに達するまで必要に応じてストリームからデータを読み込みます。 ドライバは、必要に応じて、UnicodeからデータベースのCHAR形式への変換を行います。 Unicodeストリームのバイト形式は、Java仮想マシン仕様に定義されているとおりJava UTF-8である必要があります。

ノート: このストリーム・オブジェクトは、標準のJavaストリーム・オブジェクト、または標準インタフェースを実装する独自のサブクラスのどちらでもかまいません。

このメソッドは非推奨です。代わりにgetCharacterStreamメソッドを使用してください。

このメソッドで設定されたパラメータ値は内部で格納され、executeメソッドの呼出し時に、このRowSetオブジェクトのコマンド内の適切なパラメータとして提供されます。 setUnicodeStreamを呼び出した後でメソッドgetParamsを呼び出すと、設定されたパラメータ値を含む配列が返されます。 その配列内で、このメソッドで設定された値を表す要素はそれ自体が配列になります。 その配列の最初の要素は、指定されたjava.io.InputStreamオブジェクトです。 2番目の要素は、lengthに設定された値です。 3番目の要素は、このメソッドに渡されたストリームがUnicodeストリームであることを指定する、BaseRowSetの内部定数です。 パラメータ番号はメソッドgetParamsから返される配列内での要素の位置によって示され、最初の要素は最初のプレースホルダー・パラメータの値、2番目の要素は2番目のプレースホルダー・パラメータの値、といった具合になります。 言い換えると、設定する入力ストリームが2番目のプレースホルダー・パラメータの値である場合、その値を含む配列は、getParamsから返される配列内の2番目の要素になります。

配列内の要素の番号付けはゼロから開始されるので、プレースホルダー・パラメータ番号parameterIndexに対応する配列要素番号はparameterIndex -1になります。

パラメータ:

parameterIndex - このRowSetオブジェクトのコマンド内の、設定対象となるプレースホルダー・パラメータの順序番号。 最初のパラメータが1、2番目のパラメータが2、といった具合になる。1以上でなければいけない

x - UNICODEパラメータ値を含むjava.io.InputStreamオブジェクト

length - 入力ストリームのバイト数

例外:

SQLException - エラーが発生した場合、パラメータ・インデックスが範囲外の場合、またはデータ・ソースに接続した場合は、ドライバによって読み取られデータベースに送信されるバイト数がlengthに指定されたバイト数と一致しない場合

関連項目:

• getParams()

setCharacterStream

public void setCharacterStream(int parameterIndex, Reader reader, int length) throws SQLException

指定されたパラメータを、指定されたバイト数を持つjava.io.Readerオブジェクトに設定します。 リーダーの内容が読み取られ、データベースに送信されます。 読み取られ、データベースに送信されるバイト数がlengthに一致していない場合、このメソッドはSQLExceptionをスローします。

LONGVARCHARパラメータに非常に大きなUnicode値が入力されるときには、Readerオブジェクトを介して送るのが現実的です。 JDBCテクノロジを使用可能なドライバは、ファイルの終わりに達するまで必要に応じてストリームからデータを読み込みます。 ドライバは、必要に応じて、UnicodeからデータベースのCHAR形式への変換を行います。 Unicodeストリームのバイト形式は、Java仮想マシン仕様に定義されているとおりJava UTF-8である必要があります。

ノート: このストリーム・オブジェクトは、標準のJavaストリーム・オブジェクト、または標準インタフェースを実装する独自のサブクラスのどちらでもかまいません。

このメソッドで設定されたパラメータ値は内部で格納され、executeメソッドの呼出し時に、このRowSetオブジェクトのコマンド内の適切なパラメータとして提供されます。 execute、populateなどのメソッドは、このクラスを拡張し、標準JSR-114 RowSetインタフェースを1つ以上実装するクラスで提供される必要があります。

ノート: JdbcRowSetはpopulateメソッドを必要としません。このメソッドは、このクラス内に定義されていません。

setCharacterStreamを呼び出した後でメソッドgetParamsを呼び出すと、設定されたパラメータ値を含む配列が返されます。 その配列内で、このメソッドで設定された値を表す要素はそれ自体が配列になります。 その配列の最初の要素は、指定されたjava.io.Readerオブジェクトです。 2番目の要素は、lengthに設定された値です。 パラメータ番号はメソッドgetParamsから返される配列内での要素の位置によって示され、最初の要素は最初のプレースホルダー・パラメータの値、2番目の要素は2番目のプレースホルダー・パラメータの値、といった具合になります。 言い換えると、設定するリーダーが2番目のプレースホルダー・パラメータの値である場合、その値を含む配列は、getParamsから返される配列内の2番目の要素になります。

配列内の要素の番号付けはゼロから開始されるので、プレースホルダー・パラメータ番号parameterIndexに対応する配列要素番号はparameterIndex -1になります。

パラメータ:

parameterIndex - このRowSetオブジェクトのコマンド内の、設定対象となるプレースホルダー・パラメータの順序番号。 最初のパラメータが1、2番目のパラメータが2、といった具合になる。1以上でなければいけない

reader - Unicodeデータを格納するReaderオブジェクト

length - ストリーム内の文字数。文字長0以下は未定義だが、配下のJDBCドライバで無効な長さ例外がスローされる。

例外:

SQLException - エラーが発生した場合、パラメータ・インデックスが範囲外の場合、またはデータ・ソースに接続した場合は、ドライバによって読み取られデータベースに送信されるバイト数がlengthに指定されたバイト数と一致しない

関連項目:

• getParams()

setCharacterStream

public 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

setObject

public void setObject(int parameterIndex, Object x, int targetSqlType, int scale) throws SQLException

指定されたパラメータを、指定されたJavaプログラミング言語のObject値に設定します。 2番目のパラメータはObject型である必要があります。 整数値の場合は等価なjava.langオブジェクトを使用する必要があります。 たとえばintに対してIntegerクラスのインスタンスを使用します。

ドライバは、このオブジェクトをデータベースに送信する前に、指定されたターゲットのSQL型に変換します。 オブジェクトがSQLDataを実装するクラスのカスタム・マッピングを持つ場合、ドライバはSQLData.writeSQLメソッドを呼び出して、オブジェクトをSQLデータ・ストリームに書き込む必要があります。 また、オブジェクトがRef、Blob、Clob、Struct、またはArrayを実装するクラスのオブジェクトである場合、ドライバはこのオブジェクトを対応するSQL型の値としてデータベースに渡す必要があります。

このメソッドは、データベース固有の抽象データ型を渡すために使用することに注意してください。

このメソッドで設定されたパラメータ値は内部で格納され、executeメソッドの呼出し時に、このRowSetオブジェクトのコマンド内の適切なパラメータとして提供されます。 execute、populateなどのメソッドは、このクラスを拡張し、標準JSR-114 RowSetインタフェースを1つ以上実装するクラスで提供される必要があります。

ノート: JdbcRowSetはpopulateメソッドを必要としません。このメソッドは、このクラス内に定義されていません。

このバージョンのsetObjectを呼び出した後でメソッドgetParamsを呼び出すと、設定されたパラメータ値を含む配列が返されます。 その配列内で、このメソッドで設定された値を表す要素はそれ自体が配列になります。 その配列の最初の要素は指定されたObjectインスタンス、2番目の要素はtargetSqlTypeに設定された値になります。 3番目の要素はscaleに設定された値になりますが、設定対象のオブジェクトの型がjava.sql.Types.NUMERIC、java.sql.Types.DECIMALのどちらでもない場合、ドライバはその値を無視します。 パラメータ番号はメソッドgetParamsから返される配列内での要素の位置によって示され、最初の要素は最初のプレースホルダー・パラメータの値、2番目の要素は2番目のプレースホルダー・パラメータの値、といった具合になります。 言い換えると、設定するオブジェクトが2番目のプレースホルダー・パラメータの値である場合、その値を含む配列は、getParamsから返される配列内の2番目の要素になります。

配列内の要素の番号付けはゼロから開始されるので、プレースホルダー・パラメータ番号parameterIndexに対応する配列要素番号はparameterIndex -1になります。

パラメータ:

parameterIndex - このRowSetオブジェクトのコマンド内の、設定対象となるプレースホルダー・パラメータの順序番号。 最初のパラメータが1、2番目のパラメータが2、といった具合になる。1以上でなければいけない

x - 入力パラメータ値を含むObject。Object型でなければならない

targetSqlType - データベースに送られる(java.sql.Typesで定義される) SQL型。 scale引数で、さらにこの型を限定できる。 非標準のtargetSqlTypeが提供された場合、このメソッドはSQLExceptionをスローしない。 この動作により、非標準のSQL型が暗黙的にサポートされる。

scale - java.sql.Types.DECIMALやjava.sql.Types.NUMERIC型では、小数点以下の桁数。 ほかのすべての型では、この値は無視される。

例外:

SQLException - エラーが発生した場合、またはパラメータ・インデックスが範囲外である場合

関連項目:

• getParams()

setObject

public void setObject(int parameterIndex, Object x, int targetSqlType) throws SQLException

指定されたパラメータの値を、指定されたObject値で設定します。 このメソッドは、setObject(int parameterIndex, Object x, int targetSqlType, int scale)に似ていますが、scaleに0を仮定している点が異なります。

このメソッドで設定されたパラメータ値は内部で格納され、executeメソッドの呼出し時に、このRowSetオブジェクトのコマンド内の適切なパラメータとして提供されます。 execute、populateなどのメソッドは、このクラスを拡張し、標準JSR-114 RowSetインタフェースを1つ以上実装するクラスで提供される必要があります。

ノート: JdbcRowSetはpopulateメソッドを必要としません。このメソッドは、このクラス内に定義されていません。

このバージョンのsetObjectを呼び出した後でメソッドgetParamsを呼び出すと、設定されたパラメータ値を含む配列が返されます。 その配列内で、このメソッドで設定された値を表す要素はそれ自体が配列になります。 その配列の最初の要素は、指定されたObjectインスタンスです。 2番目の要素は、targetSqlTypeに設定された値です。 パラメータ番号はメソッドgetParamsから返される配列内での要素の位置によって示され、最初の要素は最初のプレースホルダー・パラメータの値、2番目の要素は2番目のプレースホルダー・パラメータの値、といった具合になります。 言い換えると、設定するオブジェクトが2番目のプレースホルダー・パラメータの値である場合、その値を含む配列は、getParamsから返される配列内の2番目の要素になります。

配列内の要素の番号付けはゼロから開始されるので、プレースホルダー・パラメータ番号parameterIndexに対応する配列要素番号はparameterIndex -1になります。

パラメータ:

parameterIndex - このRowSetオブジェクトのコマンド内の、設定対象となるプレースホルダー・パラメータの順序番号。 最初のパラメータが1、2番目のパラメータが2、といった具合になる。1以上でなければいけない

x - 入力パラメータ値を含むObject。Object型でなければならない

targetSqlType - データベースに送られる(java.sql.Typesで定義される) SQL型。 非標準のtargetSqlTypeが提供された場合、このメソッドはSQLExceptionをスローしない。 この動作により、非標準のSQL型が暗黙的にサポートされる。

例外:

SQLException - エラーが発生した場合、またはパラメータ・インデックスが範囲外である場合

関連項目:

• getParams()

setObject

public void setObject(int parameterIndex, Object x) throws SQLException

指定されたパラメータを、指定されたJavaプログラミング言語のObject値に設定します。 2番目のパラメータはObject型である必要があります。 整数値の場合は等価なjava.langオブジェクトを使用する必要があります。 たとえばintに対してIntegerクラスのインスタンスを使用します。

JDBC仕様には、Java Object型とSQL型の標準マッピングが定義されています。 ドライバは、この標準マッピングを使って、指定されたオブジェクトをデータベースへ送信する前に、対応するSQL型に変換します。 オブジェクトがSQLDataを実装するクラスのカスタム・マッピングを持つ場合、ドライバはSQLData.writeSQLメソッドを呼び出して、オブジェクトをSQLデータ・ストリームに書き込む必要があります。

また、オブジェクトがRef、Blob、Clob、Struct、またはArrayを実装するクラスのオブジェクトである場合、ドライバはこのオブジェクトを対応するSQL型の値としてデータベースに渡す必要があります。

たとえば、オブジェクトが1個以上のインタフェースを複数実装するクラスであるなど、あいまいさがある場合、このメソッドは例外をスローします。

このメソッドは、データベース固有の抽象データ型を渡すために使用することに注意してください。

このメソッドで設定されたパラメータ値は内部で格納され、executeメソッドの呼出し時に、このRowSetオブジェクトのコマンド内の適切なパラメータとして提供されます。 execute、populateなどのメソッドは、このクラスを拡張し、標準JSR-114 RowSetインタフェースを1つ以上実装するクラスで提供される必要があります。

ノート: JdbcRowSetはpopulateメソッドを必要としません。このメソッドは、このクラス内に定義されていません。

このメソッドを呼び出した後でメソッドgetParamsを呼び出すと、現在のコマンド・パラメータのオブジェクト配列が返されますが、その配列には、プレースホルダー・パラメータ番号parameterIndexに設定されたObjectが含まれます。 配列内の要素の番号付けはゼロから開始されるので、プレースホルダー・パラメータ番号parameterIndexに対応する配列要素番号はparameterIndex -1になります。

パラメータ:

parameterIndex - このRowSetオブジェクトのコマンド内の、設定対象となるプレースホルダー・パラメータの順序番号。 最初のパラメータが1、2番目のパラメータが2、といった具合になる。1以上でなければいけない

x - 入力パラメータ値を含むオブジェクト

例外:

SQLException - エラーが発生した場合、パラメータ・インデックスが範囲外である場合、または設定されるオブジェクトの実装にあいまいさがある場合

関連項目:

• getParams()

setRef

public void setRef(int parameterIndex, Ref ref) throws SQLException

指定されたパラメータを、指定されたJavaプログラミング言語のRefオブジェクトに設定します。 データベースに送るときに、ドライバはこれをSQL REF値に変換します。 内部的には、Refは直列化可能性を確保するため、SerialRefで表されます。

このメソッドで設定されたパラメータ値は内部で格納され、executeメソッドの呼出し時に、このRowSetオブジェクトのコマンド内の適切なパラメータとして提供されます。 execute、populateなどのメソッドは、このクラスを拡張し、標準JSR-114 RowSetインタフェースを1つ以上実装するクラスで提供される必要があります。

ノート: JdbcRowSetはpopulateメソッドを必要としません。このメソッドは、このクラス内に定義されていません。

このメソッドを呼び出した後でメソッドgetParamsを呼び出すと、現在のコマンド・パラメータのオブジェクト配列が返されますが、その配列には、プレースホルダー・パラメータ番号parameterIndexに設定されたRefオブジェクトが含まれます。 配列内の要素の番号付けはゼロから開始されるので、プレースホルダー・パラメータ番号parameterIndexに対応する配列要素番号はparameterIndex -1になります。

パラメータ:

parameterIndex - このRowSetオブジェクトのコマンド内の、設定対象となるプレースホルダー・パラメータの順序番号。 最初のパラメータが1、2番目のパラメータが2、といった具合になる。1以上でなければいけない

ref - SQL REF値を表すRefオブジェクト。nullは不可

例外:

SQLException - エラーが発生した場合、またはパラメータ・インデックスが範囲外であるか、Refオブジェクトがnullの場合、またはRefオブジェクトがnullの基底型名を返した場合。

関連項目:

• getParams()
• SerialRef

setBlob

public void setBlob(int parameterIndex, Blob x) throws SQLException

指定されたパラメータを、指定されたJavaプログラミング言語のBlobオブジェクトに設定します。 データベースに送るときに、ドライバはこれをSQL BLOB値に変換します。 内部的には、Blobは直列化可能性を確保するため、SerialBlobで表されます。

このメソッドで設定されたパラメータ値は内部で格納され、executeメソッドの呼出し時に、このRowSetオブジェクトのコマンド内の適切なパラメータとして提供されます。 execute、populateなどのメソッドは、このクラスを拡張し、標準JSR-114 RowSetインタフェースを1つ以上実装するクラスで提供される必要があります。 ノート: JdbcRowSetはpopulateメソッドを必要としません。このメソッドは、このクラス内に定義されていません。

このメソッドを呼び出した後でメソッドgetParamsを呼び出すと、現在のコマンド・パラメータのオブジェクト配列が返されますが、その配列には、プレースホルダー・パラメータ番号parameterIndexに設定されたBlobオブジェクトが含まれます。 配列内の要素の番号付けはゼロから開始されるので、プレースホルダー・パラメータ番号parameterIndexに対応する配列要素番号はparameterIndex -1になります。

パラメータ:

parameterIndex - このRowSetオブジェクトのコマンド内の、設定対象となるプレースホルダー・パラメータの順序番号。 最初のパラメータが1、2番目のパラメータが2、といった具合になる。1以上でなければいけない

x - SQL BLOB値を表すBlobオブジェクト

例外:

SQLException - エラーが発生した場合、またはパラメータ・インデックスが範囲外である場合

関連項目:

• getParams()
• SerialBlob

setClob

public void setClob(int parameterIndex, Clob x) throws SQLException

指定されたパラメータを、指定されたJavaプログラミング言語のClobオブジェクトに設定します。 データベースに送るときに、ドライバはこれをSQL CLOB値に変換します。 内部的には、Clobは直列化可能性を確保するため、SerialClobで表されます。

このメソッドで設定されたパラメータ値は内部で格納され、executeメソッドの呼出し時に、このRowSetオブジェクトのコマンド内の適切なパラメータとして提供されます。 execute、populateなどのメソッドは、このクラスを拡張し、標準JSR-114 RowSetインタフェースを1つ以上実装するクラスで提供される必要があります。

ノート: JdbcRowSetはpopulateメソッドを必要としません。このメソッドは、このクラス内に定義されていません。

このメソッドを呼び出した後でメソッドgetParamsを呼び出すと、現在のコマンド・パラメータのオブジェクト配列が返されますが、その配列には、プレースホルダー・パラメータ番号parameterIndexに設定されたClobオブジェクトが含まれます。 配列内の要素の番号付けはゼロから開始されるので、プレースホルダー・パラメータ番号parameterIndexに対応する配列要素番号はparameterIndex -1になります。

パラメータ:

parameterIndex - このRowSetオブジェクトのコマンド内の、設定対象となるプレースホルダー・パラメータの順序番号。 最初のパラメータが1、2番目のパラメータが2、といった具合になる。1以上でなければいけない

x - SQL CLOB値を表すClobオブジェクト。nullは不可

例外:

SQLException - エラーが発生した場合、パラメータ・インデックスが範囲外である場合、またはClobがnullの場合

関連項目:

• getParams()
• SerialBlob

setArray

public void setArray(int parameterIndex, Array array) throws SQLException

指定されたパラメータをJavaプログラミング言語のArrayオブジェクトに設定します。 データベースに送るときに、ドライバはこれをSQL ARRAY値に変換します。 内部的には、Arrayは直列化可能性を確保するため、SerialArrayで表されます。

このメソッドで設定されたパラメータ値は内部で格納され、executeメソッドの呼出し時に、このRowSetオブジェクトのコマンド内の適切なパラメータとして提供されます。 execute、populateなどのメソッドは、このクラスを拡張し、標準JSR-114 RowSetインタフェースを1つ以上実装するクラスで提供される必要があります。

ノート: JdbcRowSetはpopulateメソッドを必要としません。このメソッドは、このクラス内に定義されていません。

このメソッドを呼び出した後でメソッドgetParamsを呼び出すと、現在のコマンド・パラメータのオブジェクト配列が返されますが、その配列には、プレースホルダー・パラメータ番号parameterIndexに設定されたArrayオブジェクトが含まれます。 配列内の要素の番号付けはゼロから開始されるので、プレースホルダー・パラメータ番号parameterIndexに対応する配列要素番号はparameterIndex -1になります。

パラメータ:

parameterIndex - このRowSetオブジェクトのコマンド内の、設定対象となるプレースホルダー・パラメータの順序番号。 最初のパラメータが1、2番目のパラメータが2、といった具合になる。1以上でなければいけない

array - SQL ARRAY値を表すArrayオブジェクト。nullは不可。 このメソッドに渡されるArrayオブジェクトは、すべてのgetArray()メソッド呼出しでnull以外のObjectを返す必要があります。 値がnullの場合はSQLExceptionがスローされます。

例外:

SQLException - エラーが発生した場合、パラメータ・インデックスが範囲外である場合、またはARRAYがnullの場合

関連項目:

• getParams()
• SerialArray

setDate

public void setDate(int parameterIndex, Date x, Calendar cal) throws SQLException

指定されたパラメータを指定されたjava.sql.Dateオブジェクトに設定します。 DBMSにタイムゾーン情報が格納されていない場合、ドライバは指定されたCalendarオブジェクトを使用して、SQL DATE値を作成し、これをデータベースに送ります。 Calendarオブジェクトを使用する場合、ドライバはカスタム・タイムゾーンを考慮して日付を計算できます。 Calendarオブジェクトを指定しない場合、ドライバは、アプリケーションを実行している仮想マシンのタイムゾーンを使用します。

このメソッドで設定されたパラメータ値は内部で格納され、executeメソッドの呼出し時に、このRowSetオブジェクトのコマンド内の適切なパラメータとして提供されます。 execute、populateなどのメソッドは、このクラスを拡張し、標準JSR-114 RowSetインタフェースを1つ以上実装するクラスで提供される必要があります。

ノート: JdbcRowSetはpopulateメソッドを必要としません。このメソッドは、このクラス内に定義されていません。

このバージョンのsetDateを呼び出した後でメソッドgetParamsを呼び出すと、設定されたパラメータ値を含む配列が返されます。 その配列内で、このメソッドで設定された値を表す要素はそれ自体が配列になります。 その配列の最初の要素は、指定されたjava.sql.Dateオブジェクトです。 2番目の要素は、calに設定された値です。 パラメータ番号はメソッドgetParamsから返される配列内での要素の位置によって示され、最初の要素は最初のプレースホルダー・パラメータの値、2番目の要素は2番目のプレースホルダー・パラメータの値、といった具合になります。 言い換えると、設定する日付が2番目のプレースホルダー・パラメータの値である場合、その値を含む配列は、getParamsから返される配列内の2番目の要素になります。

配列内の要素の番号付けはゼロから開始されるので、プレースホルダー番号parameterIndexに対応する配列要素はparameterIndex -1になります。

パラメータ:

parameterIndex - このRowSetオブジェクトのコマンド内の、設定対象となるプレースホルダー・パラメータの順序番号。 最初のパラメータが1、2番目のパラメータが2、といった具合になる。1以上でなければいけない

x - SQL DATE値を表すjava.sql.Dateオブジェクト

cal - 日付を作成するために使用するjava.util.Calendarオブジェクト

例外:

SQLException - エラーが発生した場合、またはパラメータ・インデックスが範囲外である場合

関連項目:

• getParams()

setTime

public void setTime(int parameterIndex, Time x, Calendar cal) throws SQLException

指定されたパラメータを指定されたjava.sql.Timeオブジェクトに設定します。 データベースに送るときに、ドライバはこれをSQL TIME値に変換します。

DBMSにタイムゾーン情報が格納されていない場合、ドライバは指定されたCalendarオブジェクトを使用して、SQL TIME値を作成し、これをデータベースに送ります。 Calendarオブジェクトを使用する場合、ドライバはカスタム・タイムゾーンを考慮して日付を計算できます。 Calendarオブジェクトを指定しない場合、ドライバは、アプリケーションを実行している仮想マシンのタイムゾーンを使用します。

このメソッドで設定されたパラメータ値は内部で格納され、executeメソッドの呼出し時に、このRowSetオブジェクトのコマンド内の適切なパラメータとして提供されます。 execute、populateなどのメソッドは、このクラスを拡張し、標準JSR-114 RowSetインタフェースを1つ以上実装するクラスで提供される必要があります。

ノート: JdbcRowSetはpopulateメソッドを必要としません。このメソッドは、このクラス内に定義されていません。

このバージョンのsetTimeを呼び出した後でメソッドgetParamsを呼び出すと、設定されたパラメータ値を含む配列が返されます。 その配列内で、このメソッドで設定された値を表す要素はそれ自体が配列になります。 その配列の最初の要素は、指定されたjava.sql.Timeオブジェクトです。 2番目の要素は、calに設定された値です。 パラメータ番号はメソッドgetParamsから返される配列内での要素の位置によって示され、最初の要素は最初のプレースホルダー・パラメータの値、2番目の要素は2番目のプレースホルダー・パラメータの値、といった具合になります。 言い換えると、設定する時間が2番目のプレースホルダー・パラメータの値である場合、その値を含む配列は、getParamsから返される配列内の2番目の要素になります。

配列内の要素の番号付けはゼロから開始されるので、プレースホルダー番号parameterIndexに対応する配列要素はparameterIndex -1になります。

パラメータ:

parameterIndex - このRowSetオブジェクトのコマンド内の、設定対象となるプレースホルダー・パラメータの順序番号。 最初のパラメータが1、2番目のパラメータが2、といった具合になる。1以上でなければいけない

x - java.sql.Timeオブジェクト

cal - ドライバが時間を作成するために使用するjava.util.Calendarオブジェクト

例外:

SQLException - エラーが発生した場合、またはパラメータ・インデックスが範囲外である場合

関連項目:

• getParams()

setTimestamp

public void setTimestamp(int parameterIndex, Timestamp x, Calendar cal) throws SQLException

指定されたパラメータを指定されたjava.sql.Timestampオブジェクトに設定します。 データベースに送るときに、ドライバはこれをSQL TIMESTAMP値に変換します。

DBMSにタイムゾーン情報が格納されていない場合、ドライバは指定されたCalendarオブジェクトを使用して、SQL TIMESTAMP値を作成し、これをデータベースに送ります。 Calendarオブジェクトを使用する場合、ドライバはカスタム・タイムゾーンを考慮してタイムスタンプを計算できます。 Calendarオブジェクトを指定しない場合、ドライバは、アプリケーションを実行している仮想マシンのタイムゾーンを使用します。

このメソッドで設定されたパラメータ値は内部で格納され、executeメソッドの呼出し時に、このRowSetオブジェクトのコマンド内の適切なパラメータとして提供されます。 execute、populateなどのメソッドは、このクラスを拡張し、標準JSR-114 RowSetインタフェースを1つ以上実装するクラスで提供される必要があります。

ノート: JdbcRowSetはpopulateメソッドを必要としません。このメソッドは、このクラス内に定義されていません。

このバージョンのsetTimestampを呼び出した後でメソッドgetParamsを呼び出すと、設定されたパラメータ値を含む配列が返されます。 その配列内で、このメソッドで設定された値を表す要素はそれ自体が配列になります。 その配列の最初の要素は、指定されたjava.sql.Timestampオブジェクトです。 2番目の要素は、calに設定された値です。 パラメータ番号はメソッドgetParamsから返される配列内での要素の位置によって示され、最初の要素は最初のプレースホルダー・パラメータの値、2番目の要素は2番目のプレースホルダー・パラメータの値、といった具合になります。 言い換えると、設定するタイムスタンプが2番目のプレースホルダー・パラメータの値である場合、その値を含む配列は、getParamsから返される配列内の2番目の要素になります。

配列内の要素の番号付けはゼロから開始されるので、プレースホルダー番号parameterIndexに対応する配列要素はparameterIndex -1になります。

パラメータ:

parameterIndex - このRowSetオブジェクトのコマンド内の、設定対象となるプレースホルダー・パラメータの順序番号。 最初のパラメータが1、2番目のパラメータが2、といった具合になる。1以上でなければいけない

x - java.sql.Timestampオブジェクト

cal - ドライバがタイムスタンプを作成するために使用するjava.util.Calendarオブジェクト

例外:

SQLException - エラーが発生した場合、またはパラメータ・インデックスが範囲外である場合

関連項目:

• getParams()

clearParameters

public void clearParameters() throws SQLException

このRowSetオブジェクトのコマンドの実行時に設定される、このRowSetオブジェクトのパラメータの内部表現に含まれる現在のパラメータ値をすべてクリアします。

通常、このRowSetオブジェクトのコマンド内で再利用できるように、パラメータ値は有効なままです。 設定メソッドを使ってパラメータ値を設定すると、指定されたパラメータの値は自動的にクリアされ、新しく指定された値で置き換えられます。

このメソッドは、setCommandメソッドによって内部で呼び出され、以前のコマンドに設定されたすべてのパラメータをクリアします。

このメソッドは、RowSetオブジェクトのスキーマを確保する点で、initParamsメソッドとは異なります。

例外:

SQLException - パラメータのクリア時にエラーが発生した場合

getParams

public Object[] getParams() throws SQLException

このRowSetオブジェクトのコマンドに設定されたパラメータ値(オブジェクトとプリミティブ)を含む配列を取得し、すべてのパラメータが設定されていない場合はSQLExceptionオブジェクトをスローします。 コマンドがDBMSに送信され、実行される前に、これらのパラメータは、BaseRowSetクラスを拡張するRowSet実装のコマンドであるPreparedStatementオブジェクト内のプレースホルダー・パラメータで置き換えられます。

返される配列内の各要素は、設定メソッドに提供されるパラメータの値を含むObjectインスタンスになります。 要素の順番は、parameterIndexの値によって決定されます。 設定メソッドがパラメータ・インデックスと設定される値(通常null)だけを取る場合、配列要素には、設定される値(Objectで表される)が含まれます。 追加パラメータがある場合、配列要素自体が、設定される値と、設定メソッドに提供される追加パラメータ値を含む配列になります。 メソッドがストリームを設定する場合、配列要素には、メソッドに提供されるストリームの型が含まれます。 これらの追加パラメータは、ドライバまたはDBMSを対象としており、使用してもしなくてもかまいません。

ノート: Array型、Blob型、Clob型、およびRef型の格納されたパラメータ値は、それぞれSerialArray、SerialBlob、SerialClob、SerialRefで返されます。

戻り値:

このRowSetオブジェクトのコマンドで設定されるパラメータ値を含むObjectインスタンスの配列。パラメータが何も設定されていない場合は空の配列

例外:

SQLException - このRowSetオブジェクトのパラメータのオブジェクト配列の取得中にエラーが発生した場合、またはパラメータが何も設定されていない場合

setNull

public void setNull(String parameterName, int sqlType) throws SQLException

指定されたパラメータをSQL NULLに設定します。

ノート: パラメータのSQLの型を指定する必要があります。

パラメータ:

parameterName - パラメータの名前

sqlType - java.sql.Typesで定義されるSQL型コード

例外:

SQLException - データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementについて呼び出された場合

SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合

setNull

public void setNull(String parameterName, int sqlType, String typeName) throws SQLException

指定されたパラメータをSQL NULLに設定します。 ユーザー定義型およびREF型のパラメータでは、このバージョンのsetNullメソッドを使用するべきです。 ユーザー定義型の例には、STRUCT、DISTINCT、JAVA_OBJECT、および名前付き配列があります。

ノート: 移植性を実現するためには、アプリケーションはNULLのユーザー定義パラメータまたはREFパラメータを指定するときにSQL型コードおよび完全修飾SQL型名を指定しなければいけません。 ユーザー定義型の場合、名前はパラメータ自体の型名です。 REFパラメータの場合、名前は参照される型の型名です。 JDBCドライバが型コードまたは型名の情報を必要としない場合、それは無視されます。 ユーザー定義パラメータおよびREFパラメータを対象としていますが、このメソッドは任意のJDBC型のnullパラメータを設定するために使用できます。 パラメータがユーザー定義の型またはREF型を持たない場合、指定されたtypeNameは無視されます。

パラメータ:

parameterName - パラメータの名前

sqlType - java.sql.Typesからの値

typeName - SQLユーザー定義型の完全修飾名。パラメータがユーザー定義型でもSQL REF値でもない場合は無視される

例外:

SQLException - データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementについて呼び出された場合

SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合

setBoolean

public void setBoolean(String parameterName, boolean x) throws SQLException

指定されたパラメータを指定されたJavaのboolean値に設定します。 データベースに送るときに、ドライバはこれをSQL BITまたはBOOLEAN値に変換します。

パラメータ:

parameterName - パラメータの名前

x - パラメータ値

例外:

SQLException - データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementについて呼び出された場合

SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合

関連項目:

• getParams()

setByte

public void setByte(String parameterName, byte x) throws SQLException

指定されたパラメータを指定されたJavaのbyte値に設定します。 データベースに送るときに、ドライバはこれをSQL TINYINT値に変換します。

パラメータ:

parameterName - パラメータの名前

x - パラメータ値

例外:

SQLException - データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementについて呼び出された場合

SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合

関連項目:

• getParams()

setShort

public void setShort(String parameterName, short x) throws SQLException

指定されたパラメータを指定されたJavaのshort値に設定します。 データベースに送るときに、ドライバはこれをSQL SMALLINT値に変換します。

パラメータ:

parameterName - パラメータの名前

x - パラメータ値

例外:

SQLException - データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementについて呼び出された場合

SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合

関連項目:

• getParams()

setInt

public void setInt(String parameterName, int x) throws SQLException

指定されたパラメータを指定されたJavaのint値に設定します。 データベースに送るときに、ドライバはこれをSQL INTEGER値に変換します。

パラメータ:

parameterName - パラメータの名前

x - パラメータ値

例外:

SQLException - データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementについて呼び出された場合

SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合

関連項目:

• getParams()

setLong

public void setLong(String parameterName, long x) throws SQLException

指定されたパラメータを指定されたJavaのlong値に設定します。 データベースに送るときに、ドライバはこれをSQL BIGINT値に変換します。

パラメータ:

parameterName - パラメータの名前

x - パラメータ値

例外:

SQLException - データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementについて呼び出された場合

SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合

関連項目:

• getParams()

setFloat

public void setFloat(String parameterName, float x) throws SQLException

指定されたパラメータを指定されたJavaのfloat値に設定します。 データベースに送るときに、ドライバはこれをSQL FLOAT値に変換します。

パラメータ:

parameterName - パラメータの名前

x - パラメータ値

例外:

SQLException - データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementについて呼び出された場合

SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合

関連項目:

• getParams()

setDouble

public void setDouble(String parameterName, double x) throws SQLException

指定されたパラメータを指定されたJavaのdouble値に設定します。 データベースに送るときに、ドライバはこれをSQL DOUBLE値に変換します。

パラメータ:

parameterName - パラメータの名前

x - パラメータ値

例外:

SQLException - データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementについて呼び出された場合

SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合

関連項目:

• getParams()

setBigDecimal

public void setBigDecimal(String parameterName, BigDecimal x) throws SQLException

指定されたパラメータを、指定されたjava.math.BigDecimal値に設定します。 データベースに送るときに、ドライバはこれをSQL NUMERIC値に変換します。

パラメータ:

parameterName - パラメータの名前

x - パラメータ値

例外:

SQLException - データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementについて呼び出された場合

SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合

関連項目:

• getParams()

setString

public void setString(String parameterName, String x) throws SQLException

指定されたパラメータを指定されたJavaのString値に設定します。 データベースに送るときに、ドライバはこれをSQL VARCHARまたはLONGVARCHAR値(ドライバのVARCHAR値の制限に対する引数のサイズに依存)に変換します。

パラメータ:

parameterName - パラメータの名前

x - パラメータ値

例外:

SQLException - データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementについて呼び出された場合

SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合

関連項目:

• getParams()

setBytes

public void setBytes(String parameterName, byte[] x) throws SQLException

指定されたパラメータを指定されたJavaのバイト配列に設定します。 データベースに送るときに、ドライバはこれをSQL VARBINARYまたはLONGVARBINARY (ドライバのVARBINARY値の制限に対する引数のサイズに依存)に変換します。

パラメータ:

parameterName - パラメータの名前

x - パラメータ値

例外:

SQLException - データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementについて呼び出された場合

SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合

関連項目:

• getParams()

setTimestamp

public void setTimestamp(String parameterName, Timestamp x) throws SQLException

指定されたパラメータを、指定されたjava.sql.Timestamp値に設定します。 データベースに送るときに、ドライバはこれをSQL TIMESTAMP値に変換します。

パラメータ:

parameterName - パラメータの名前

x - パラメータ値

例外:

SQLException - データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementについて呼び出された場合

SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合

関連項目:

• getParams()

setAsciiStream

public 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ドライバがこのメソッドをサポートしない場合

setBinaryStream

public void setBinaryStream(String parameterName, InputStream x, int length) throws SQLException

指定されたパラメータを、指定されたバイト数を持つ指定された入力ストリームに設定します。 LONGVARBINARYパラメータに非常に大きなバイナリ値が入力されるときには、java.io.InputStreamオブジェクトを介して送るのが現実的です。 ファイルの終わりに達するまで必要に応じてストリームからデータが読み込まれます。

ノート: このストリーム・オブジェクトは、標準のJavaストリーム・オブジェクト、または標準インタフェースを実装する独自のサブクラスのどちらでもかまいません。

パラメータ:

parameterName - パラメータの名前

x - バイナリ・パラメータ値を含むJava入力ストリーム

length - ストリームのバイト数

例外:

SQLException - データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementについて呼び出された場合

SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合

setCharacterStream

public 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ドライバがこのメソッドをサポートしない場合

setAsciiStream

public 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

public 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

public 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

public 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

public 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ドライバがこのデータ型をサポートしていない場合

関連項目:

• Types
• getParams()

setObject

public 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ドライバがこのデータ型をサポートしていない場合

関連項目:

• getParams()

setObject

public 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ドライバがこのメソッドをサポートしない場合

関連項目:

• getParams()

setBlob

public 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

public 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

public 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

public void setBlob(String parameterName, Blob x) throws SQLException

指定されたパラメータを指定されたjava.sql.Blobオブジェクトに設定します。 データベースに送るときに、ドライバはこれをSQL BLOB値に変換します。

パラメータ:

parameterName - パラメータの名前

x - SQL BLOB値をマッピングするBlobオブジェクト

例外:

SQLException - データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementについて呼び出された場合

SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合

導入されたバージョン:

1.6

setBlob

public 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

public void setClob(int parameterIndex, Reader reader, long length) throws SQLException

指定されたパラメータをReaderオブジェクトに設定します。 readerには、lengthで指定された文字数が含まれている必要があります。そうでない場合、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

public 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

public void setClob(String parameterName, Reader reader, long length) throws SQLException

指定されたパラメータをReaderオブジェクトに設定します。 readerには、lengthで指定された文字数が含まれている必要があります。そうでない場合、CallableStatementの実行時にSQLExceptionが生成されます。 このメソッドは、setCharacterStream (int, Reader, int)メソッドと異なり、パラメータ値をCLOBとしてサーバーに送信するべきであることをドライバに通知します。 setCharacterStreamメソッドを使用すると、ドライバは、パラメータ・データをLONGVARCHARとCLOBのどちらとしてサーバーに送信するかを判断するために余計な作業を行う必要がある可能性があります。

パラメータ:

parameterName - 設定されるパラメータの名前。

reader - パラメータ値に設定されるデータを含むオブジェクト。

length - パラメータ・データ内の文字数。

例外:

SQLException - parameterIndexがSQL文のパラメータ・マーカーと対応していない場合、長さとしてゼロ未満の値が指定された場合、データベース・アクセス・エラーが発生した場合、このメソッドがクローズされたCallableStatementで呼び出された場合

SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合

導入されたバージョン:

1.6

setClob

public void setClob(String parameterName, Clob x) throws SQLException

指定されたパラメータを指定されたjava.sql.Clobオブジェクトに設定します。 データベースに送るときに、ドライバはこれをSQL CLOB値に変換します。

パラメータ:

parameterName - パラメータの名前

x - SQL CLOB値をマッピングするClobオブジェクト

例外:

SQLException - データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementについて呼び出された場合

SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合

導入されたバージョン:

1.6

setClob

public 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

setDate

public void setDate(String parameterName, Date x) throws SQLException

アプリケーションを実行している仮想マシンのデフォルトのタイムゾーンを使用して、指定されたパラメータを指定されたjava.sql.Date値に設定します。 データベースに送るときに、ドライバはこれをSQL DATE値に変換します。

パラメータ:

parameterName - パラメータの名前

x - パラメータ値

例外:

SQLException - データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementについて呼び出された場合

SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合

関連項目:

• getParams()

setDate

public void setDate(String parameterName, Date x, Calendar cal) throws SQLException

指定されたCalendarオブジェクトを使用して、指定されたパラメータを指定されたjava.sql.Date値に設定します。 ドライバはCalendarオブジェクトを使用してSQL DATE値を作成し、続いてそれをデータベースに送ります。 Calendarオブジェクトを使用すると、ドライバはカスタム・タイムゾーンを考慮して日付を計算できます。 Calendarオブジェクトを指定しない場合、ドライバは、アプリケーションを実行している仮想マシンのタイムゾーンであるデフォルトのタイムゾーンを使用します。

パラメータ:

parameterName - パラメータの名前

x - パラメータ値

cal - ドライバが日付を作成するために使用するCalendarオブジェクト

例外:

SQLException - データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementについて呼び出された場合

SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合

関連項目:

• getParams()

setTime

public void setTime(String parameterName, Time x) throws SQLException

指定されたパラメータを、指定されたjava.sql.Time値に設定します。 データベースに送るときに、ドライバはこれをSQL TIME値に変換します。

パラメータ:

parameterName - パラメータの名前

x - パラメータ値

例外:

SQLException - データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementについて呼び出された場合

SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合

関連項目:

• getParams()

setTime

public void setTime(String parameterName, Time x, Calendar cal) throws SQLException

指定されたCalendarオブジェクトを使用して、指定されたパラメータを指定されたjava.sql.Time値に設定します。 ドライバはCalendarオブジェクトを使用してSQL TIME値を作成し、続いてそれをデータベースに送ります。 Calendarオブジェクトを使用すると、ドライバはカスタム・タイムゾーンを考慮して時間を計算できます。 Calendarオブジェクトを指定しない場合、ドライバは、アプリケーションを実行している仮想マシンのタイムゾーンであるデフォルトのタイムゾーンを使用します。

パラメータ:

parameterName - パラメータの名前

x - パラメータ値

cal - ドライバが時間を作成するために使用するCalendarオブジェクト

例外:

SQLException - データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementについて呼び出された場合

SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合

関連項目:

• getParams()

setTimestamp

public void setTimestamp(String parameterName, Timestamp x, Calendar cal) throws SQLException

指定されたCalendarオブジェクトを使用して、指定されたパラメータを指定されたjava.sql.Timestamp値に設定します。 ドライバはCalendarオブジェクトを使用してSQL TIMESTAMP値を作成し、続いてそれをデータベースに送ります。 Calendarオブジェクトを使用すると、ドライバはカスタム・タイムゾーンを考慮してタイムスタンプを計算できます。 Calendarオブジェクトを指定しない場合、ドライバは、アプリケーションを実行している仮想マシンのタイムゾーンであるデフォルトのタイムゾーンを使用します。

パラメータ:

parameterName - パラメータの名前

x - パラメータ値

cal - ドライバがタイムスタンプを作成するために使用するCalendarオブジェクト

例外:

SQLException - データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementについて呼び出された場合

SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合

関連項目:

• getParams()

setSQLXML

public void setSQLXML(int parameterIndex, SQLXML xmlObject) throws SQLException

指定されたパラメータを指定されたjava.sql.SQLXMLオブジェクトに設定します。 データベースに送るときに、ドライバはこれをSQL XML値に変換します。

パラメータ:

parameterIndex - 最初のパラメータのインデックスは1、2番目のパラメータのインデックスは2、... となる

xmlObject - SQL XML値をマッピングするSQLXMLオブジェクト

例外:

SQLException - データベース・アクセス・エラーが発生した場合、このメソッドがクローズされた結果セットで呼び出された場合、SQLXMLオブジェクト用のjava.xml.transform.Result、Writer、またはOutputStreamがクローズされていない場合、あるいはXML値の処理中にエラーが発生した場合。 この例外のgetCauseメソッドにより、より詳細な例外が提供されることがある(たとえばストリームに有効なXMLが含まれていない場合)。

SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合

導入されたバージョン:

1.6

setSQLXML

public 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が含まれていない場合)。

SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合

導入されたバージョン:

1.6

setRowId

public void setRowId(int parameterIndex, RowId x) throws SQLException

指定されたパラメータを指定されたjava.sql.RowIdオブジェクトに設定します。 データベースに送るときに、ドライバはこれをSQL ROWID値に変換します。

パラメータ:

parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる

x - パラメータ値

例外:

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

SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合

導入されたバージョン:

1.6

setRowId

public void setRowId(String parameterName, RowId x) throws SQLException

指定されたパラメータを指定されたjava.sql.RowIdオブジェクトに設定します。 データベースに送るときに、ドライバはこれをSQL ROWIDに変換します。

パラメータ:

parameterName - パラメータの名前

x - パラメータ値

例外:

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

SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合

導入されたバージョン:

1.6

setNString

public void setNString(int parameterIndex, String value) throws SQLException

指定されたパラメータを指定されたStringオブジェクトに設定します。 データベースに送るときに、ドライバはこれをSQL NCHAR、NVARCHAR、またはLONGNVARCHAR値(ドライバのNVARCHAR値に関する制限に関する引数のサイズに依存)に変換します。

パラメータ:

parameterIndex - 最初のパラメータのインデックスは1、2番目のパラメータのインデックスは2、... となる

value - パラメータ値

例外:

SQLException - ドライバが各国文字セットをサポートしない場合、ドライバがデータ変換エラーが発生した可能性を検出できる場合、またはデータベース・アクセス・エラーが発生した場合

SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合

導入されたバージョン:

1.6

setNString

public void setNString(String parameterName, String value) throws SQLException

指定されたパラメータを指定されたStringオブジェクトに設定します。 ドライバはこれをSQL NCHAR、NVARCHAR、またはLONGNVARCHARに変換します。

パラメータ:

parameterName - 設定される列の名前

value - パラメータ値

例外:

SQLException - ドライバが各国文字セットをサポートしない場合、ドライバがデータ変換エラーが発生した可能性を検出できる場合、またはデータベース・アクセス・エラーが発生した場合

SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合

導入されたバージョン:

1.6

setNCharacterStream

public void setNCharacterStream(int parameterIndex, Reader value, long length) throws SQLException

指定されたパラメータをReaderオブジェクトに設定します。 Readerは、ファイルの終わりに達するまでデータを読み込みます。 ドライバは、必要に応じて、Javaの文字表現をデータベース内の各国文字セットに変換します。

パラメータ:

parameterIndex - 最初のパラメータのインデックスは1、2番目のパラメータのインデックスは2、... となる

value - パラメータ値

length - パラメータ・データ内の文字数。

例外:

SQLException - ドライバが各国文字セットをサポートしない場合、ドライバがデータ変換エラーが発生した可能性を検出できる場合、またはデータベース・アクセス・エラーが発生した場合

SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合

導入されたバージョン:

1.6

setNCharacterStream

public void setNCharacterStream(String parameterName, Reader value, long length) throws SQLException

指定されたパラメータをReaderオブジェクトに設定します。 Readerは、ファイルの終わりに達するまでデータを読み込みます。 ドライバは、必要に応じて、Javaの文字表現をデータベース内の各国文字セットに変換します。

パラメータ:

parameterName - 設定される列の名前

value - パラメータ値

length - パラメータ・データ内の文字数。

例外:

SQLException - ドライバが各国文字セットをサポートしない場合、ドライバがデータ変換エラーが発生した可能性を検出できる場合、またはデータベース・アクセス・エラーが発生した場合

SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合

導入されたバージョン:

1.6

setNCharacterStream

public void setNCharacterStream(String parameterName, Reader value) throws SQLException

指定されたパラメータをReaderオブジェクトに設定します。 Readerは、ファイルの終わりに達するまでデータを読み込みます。 ドライバは、必要に応じて、Javaの文字表現をデータベース内の各国文字セットに変換します。

ノート: このストリーム・オブジェクトは、標準のJavaストリーム・オブジェクト、または標準インタフェースを実装する独自のサブクラスのどちらでもかまいません。

ノート: lengthパラメータを使用するバージョンのsetNCharacterStreamを使用する方が効率的かどうかを判断するには、JDBCドライバのドキュメントを参照してください。

パラメータ:

parameterName - パラメータの名前

value - パラメータ値

例外:

SQLException - ドライバが各国文字セットをサポートしない場合、ドライバがデータ変換エラーが発生した可能性を検出できる場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatement上で呼び出された場合

SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合

導入されたバージョン:

1.6

setNClob

public void setNClob(String parameterName, NClob value) throws SQLException

指定されたパラメータをjava.sql.NClobオブジェクトに設定します。 このオブジェクトは、java.sql.NClobインタフェースを実装します。 このNClobオブジェクトは、SQL NCLOBにマッピングされます。

パラメータ:

parameterName - 設定される列の名前

value - パラメータ値

例外:

SQLException - ドライバが各国文字セットをサポートしない場合、ドライバがデータ変換エラーが発生した可能性を検出できる場合、またはデータベース・アクセス・エラーが発生した場合

SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合

導入されたバージョン:

1.6

setNClob

public void setNClob(String parameterName, Reader reader, long length) throws SQLException

指定されたパラメータをReaderオブジェクトに設定します。 readerには、lengthで指定された文字数が含まれている必要があります。そうでない場合、CallableStatementの実行時にSQLExceptionが生成されます。 このメソッドは、setCharacterStream (int, Reader, int)メソッドと異なり、パラメータ値をNCLOBとしてサーバーに送信するべきであることをドライバに通知します。 setCharacterStreamメソッドを使用すると、ドライバは、パラメータ・データをLONGNVARCHARとNCLOBのどちらとしてサーバーに送信するかを判断するために余計な作業を行う必要がある可能性があります。

パラメータ:

parameterName - 設定されるパラメータの名前。

reader - パラメータ値に設定されるデータを含むオブジェクト。

length - パラメータ・データ内の文字数。

例外:

SQLException - parameterIndexがSQL文のパラメータ・マーカーと対応していない場合、長さとしてゼロ未満の値が指定された場合、ドライバが各国文字セットをサポートしない場合、ドライバがデータ変換エラーが発生した可能性を検出できる場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatement上で呼び出された場合

SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合

導入されたバージョン:

1.6

setNClob

public 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

public void setNClob(int parameterIndex, Reader reader, long length) throws SQLException

指定されたパラメータをReaderオブジェクトに設定します。 readerには、lengthで指定された文字数が含まれている必要があります。そうでない場合、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

public void setNClob(int parameterIndex, NClob value) throws SQLException

指定されたパラメータをjava.sql.NClobオブジェクトに設定します。 データベースに送るときに、ドライバはこれをSQL NCLOB値に変換します。

パラメータ:

parameterIndex - 最初のパラメータのインデックスは1、2番目のパラメータのインデックスは2、... となる

value - パラメータ値

例外:

SQLException - ドライバが各国文字セットをサポートしない場合、ドライバがデータ変換エラーが発生した可能性を検出できる場合、またはデータベース・アクセス・エラーが発生した場合

SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合

導入されたバージョン:

1.6

setNClob

public 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

public void setURL(int parameterIndex, URL x) throws SQLException

指定されたパラメータを、指定されたjava.net.URL値に設定します。 データベースに送るときに、ドライバはこれをSQL DATALINK値に変換します。

パラメータ:

parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる

x - 設定されるjava.net.URLオブジェクト

例外:

SQLException - データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたPreparedStatementについて呼び出された場合

SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合