public abstract class BaseRowSet extends Object implements Serializable, Cloneable
RowSetオブジェクトとその基本機能を提供するabstractクラスです。基本機能には、すべてのJavaBeans™コンポーネントが実装する必要のあるプロパティ保持やイベント通知送信などがあります。
BaseRowSetクラスはすべてのRowSet実装の中核機能を提供しますが、どの標準実装でもベンダー固有の標準実装を提供するため、このクラスと1つ以上のRowSetインタフェースを使用することができます。より明確な言い方をするなら、どの実装でも必ず、RowSetインタフェース(JdbcRowSet、CachedRowSet、JoinRowSet、FilteredRowSetまたはWebRowSet)を1つ以上実装する必要があります。つまり、BaseRowSetクラスを拡張する実装では必ず、いずれかのRowSetインタフェースも実装する必要があります。
BaseRowSetクラスは次の機能を提供します。
RowSetオブジェクトのコマンドにパラメータを設定する設定メソッドの完全なセット
RowSet実装の処理内容やデータの取得方法によって異なります。たとえば、ResultSetオブジェクトからデータを取得する行セットでは、データベース接続に必要なプロパティを設定する必要があります。DriverManager機能を使用して接続を行うRowSetオブジェクトでは、適切なドライバを識別するJDBC URLのプロパティを設定する必要があるほか、ユーザー名とパスワードを提供するプロパティも設定する必要があります。一方、推奨の方法であるDataSourceオブジェクトを使用して接続を行う行セットでは、JDBC URLのプロパティを設定する必要はありません。かわりに、データ・ソースの論理名のプロパティ、およびユーザー名とパスワードのプロパティを設定する必要があります。
注: DataSourceオブジェクトを使用して接続を作成する場合は、Java Naming and Directory Interface™ (JNDI) APIを使用するネーム・サービスに、DataSourceオブジェクトを登録する必要があります。登録は通常、システム管理者が行います。
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オブジェクトとして保存されます。
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実装によって内部で呼び出されます。通常、アプリケーション・プログラマによって直接呼び出されることはありません。
BaseRowSetクラスは、行セットにイベント通知メカニズムを提供します。このクラスには、listenersフィールド、リスナーの追加と削除を行うメソッド、リスナーに変更を通知するメソッドが含まれます。
リスナーは、RowSetListenerインタフェースを実装するオブジェクトです。RowSetオブジェクトのリスナー・リストに追加されたリスナーは、そのRowSetオブジェクトで発生したイベントの通知を受けます。イベントの発生通知を受けたときのオブジェクトの動作は、各リスナーのRowSetListenerメソッドの実装によって定義されます。
RowSetオブジェクトで発生する可能性があるイベントは、次の3種類です。
RowSetオブジェクト全体の内容の変更
通知に使用されるBaseRowSetメソッドは、発生したイベントの型を示します。たとえば、notifyRowChangedメソッドは、行が更新、削除、または挿入されたことを示します。各通知メソッドは、イベントの発生元のRowSetオブジェクトを特定するためにリスナーに渡される、RowSetEventオブジェクトを作成します。リスナーがこの情報を利用して何を行うか(何も行わない場合もある)は、リスナーの実装によって異なります。
BaseRowSetオブジェクトの初期化のときの開始値は、一定ではありません。BaseRowSetクラスを拡張するデフォルトのRowSetインスタンスには、次の特徴があります。
RowSetオブジェクトのコマンド実行に費やす時間に制限はない。
BINARY、VARBINARY、LONGVARBINARY、CHAR、VARCHAR、およびLONGVARCHAR。
nullに設定されている。
RowSetオブジェクトのコマンド内のプレースホルダー・パラメータに設定された値を格納するため、空のVectorオブジェクトが用意されている。
適切な値が異なる場合、アプリケーションは、その値を明示的に設定する必要があります。たとえば、次のコードは、CachedRowSetオブジェクトcrsに最大行数500を設定します。
crs.setMaxRows(500);
このBaseRowSetクラスの拡張に実装されたメソッドは、定義済みのアサーションに対する違反があった場合、SQLExceptionオブジェクトをスローする必要があります。そのため、このメソッドは、クラスの拡張によってBaseRowSetメソッドがオーバーライドされ、再実装されたあと、接続の問題または配下のデータ・ソースの問題が検出された場合も、SQLExceptionオブジェクトをスローする可能性があります。| 修飾子と型 | フィールドと説明 |
|---|---|
static int |
ASCII_STREAM_PARAM
ASCIIストリームのパラメータを持つ
RowSetReaderImplオブジェクトを示す定数です。 |
protected InputStream |
asciiStream
メソッド
getAsciiStreamによって返されたInputStreamオブジェクトであり、ResultSetインタフェースで指定されています。 |
static int |
BINARY_STREAM_PARAM
バイナリ・ストリームのパラメータを持つ
RowSetReaderImplオブジェクトを示す定数です。 |
protected InputStream |
binaryStream
メソッド
getBinaryStreamによって返されたInputStreamオブジェクトであり、ResultSetインタフェースで指定されています。 |
protected Reader |
charStream
メソッド
getCharacterStreamによって返されたReaderオブジェクトであり、ResultSetインタフェースで指定されています。 |
static 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, Blob x)
指定されたパラメータを、指定されたJavaプログラミング言語の
Blobオブジェクトに設定します。 |
void |
setBlob(int parameterIndex, InputStream inputStream)
指定されたパラメータを
InputStreamオブジェクトに設定します。 |
void |
setBlob(int parameterIndex, InputStream inputStream, long length)
指定されたパラメータを
InputStreamオブジェクトに設定します。 |
void |
setBlob(String parameterName, Blob x)
指定されたパラメータを指定された
java.sql.Blobオブジェクトに設定します。 |
void |
setBlob(String parameterName, InputStream inputStream)
指定されたパラメータを
InputStreamオブジェクトに設定します。 |
void |
setBlob(String parameterName, InputStream inputStream, long length)
指定されたパラメータを
InputStreamオブジェクトに設定します。 |
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, Clob x)
指定されたパラメータを、指定されたJavaプログラミング言語の
Clobオブジェクトに設定します。 |
void |
setClob(int parameterIndex, Reader reader)
指定されたパラメータを
Readerオブジェクトに設定します。 |
void |
setClob(int parameterIndex, Reader reader, long length)
指定されたパラメータを
Readerオブジェクトに設定します。 |
void |
setClob(String parameterName, Clob x)
指定されたパラメータを指定された
java.sql.Clobオブジェクトに設定します。 |
void |
setClob(String parameterName, Reader reader)
指定されたパラメータを
Readerオブジェクトに設定します。 |
void |
setClob(String parameterName, Reader reader, long length)
指定されたパラメータを
Readerオブジェクトに設定します。 |
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, NClob value)
指定されたパラメータを
java.sql.NClobオブジェクトに設定します。 |
void |
setNClob(int parameterIndex, Reader reader)
指定されたパラメータを
Readerオブジェクトに設定します。 |
void |
setNClob(int parameterIndex, Reader reader, long length)
指定されたパラメータを
Readerオブジェクトに設定します。 |
void |
setNClob(String parameterName, NClob value)
指定されたパラメータを
java.sql.NClobオブジェクトに設定します。 |
void |
setNClob(String parameterName, Reader reader)
指定されたパラメータを
Readerオブジェクトに設定します。 |
void |
setNClob(String parameterName, Reader reader, long length)
指定されたパラメータを
Readerオブジェクトに設定します。 |
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(int parameterIndex, URL x)
指定されたパラメータを、指定された
java.net.URL値に設定します。 |
void |
setUrl(String url)
この
RowSetオブジェクトのUrlプロパティとして指定のStringオブジェクトを設定し、dataSource nameプロパティをnullに設定します。 |
void |
setUsername(String name)
この
RowSetオブジェクトのusernameプロパティとして、指定のユーザー名を設定します。 |
public static final int UNICODE_STREAM_PARAM
RowSetReaderImplオブジェクトを示す定数です。このRowSetReaderImplオブジェクトは、SyncFactory staticファクトリSPIメカニズムで定義されたabstractクラスSyncProviderの拡張として提供されます。public static final int BINARY_STREAM_PARAM
RowSetReaderImplオブジェクトを示す定数です。RowSetReaderImplオブジェクトは、SyncFactory staticファクトリSPIメカニズムで定義されたabstractクラスSyncProviderの拡張として提供されます。public static final int ASCII_STREAM_PARAM
RowSetReaderImplオブジェクトを示す定数です。RowSetReaderImplオブジェクトは、SyncFactory staticファクトリSPIメカニズムで定義されたabstractクラスSyncProviderの拡張として提供されます。protected InputStream binaryStream
getBinaryStreamによって返されたInputStreamオブジェクトであり、ResultSetインタフェースで指定されています。protected InputStream unicodeStream
getUnicodeStreamによって返されたInputStreamオブジェクトであり、ResultSetインタフェースで指定されています。protected InputStream asciiStream
getAsciiStreamによって返されたInputStreamオブジェクトであり、ResultSetインタフェースで指定されています。protected Reader charStream
getCharacterStreamによって返されたReaderオブジェクトであり、ResultSetインタフェースで指定されています。public BaseRowSet()
Vectorオブジェクトを使用して初期化を実行し、listenersフィールド用の新しいBaseRowSetオブジェクトを作成します。初期化時に使用されるその他のデフォルト値は、このクラスのクラス・コメントのセクション6.0に記載されています。protected void initParams()
BaseRowSetインスタンスの標準機能を使ってJDBC RowSet実装を起動するために必要な内部での構成および初期化を実行します。すべてのパラメータを正しく初期化するには、RowSetオブジェクトがインスタンス化された後でこのメソッドが呼び出されるべきです。このメソッドは、決してアプリケーションによって呼び出されるべきではなく、このクラスを拡張したRowSet実装から呼び出されます。public void addRowSetListener(RowSetListener listener)
RowSetオブジェクトでイベントが発生するたびに通知を受けます。
リスナーの例として、現在のRowSetオブジェクトの状態を正確に反映するために更新する必要がある表やグラフを挙げることができます。
注: RowSetListenerオブジェクトがnullの場合、このメソッドは通知なしでnull値を破棄し、リスナーのセットにnull参照を追加しません。
注: リスナーが設定済みの場合、すでにこのRowSetからイベント通知を受けるための登録が完了しているリスナーのセットに、新しいRowSetListernerインスタンスが追加されます。
listener - javax.sql.RowSetListenerインタフェースを実装し、このRowSetオブジェクトでイベントが発生したときに通知を受けるオブジェクト。nullの場合もある。removeRowSetListener(javax.sql.RowSetListener)public void removeRowSetListener(RowSetListener listener)
RowSetオブジェクトのリスナー・リストから指定されたオブジェクトを削除します。登録済みのリスナー以外が引数として指定された場合、このメソッドは何も行いません。注: RowSetListenerオブジェクトがnullの場合、このメソッドは通知なしでnull値を破棄します。listener - このRowSetオブジェクトのリスナー・リストに含まれるRowSetListenerオブジェクトaddRowSetListener(javax.sql.RowSetListener)protected void notifyCursorMoved()
throws SQLException
RowSetオブジェクトに登録されているすべてのリスナーに、カーソルが移動したことを通知します。
アプリケーションがカーソルを移動するメソッドを呼び出すと、呼び出されたメソッドはカーソルを移動し、このメソッドを内部で呼び出します。アプリケーションがこのメソッドを直接呼び出すことはありません。
SQLException - BaseRowSet abstractクラスを拡張するクラスがRowSetインタフェースまたはそのサブインタフェースを実装していない場合。protected void notifyRowChanged()
throws SQLException
RowSetオブジェクトに登録されているすべてのリスナーに、行が変更されたことを通知します。
アプリケーションが、行を変更するメソッド(CachedRowSetメソッドinsertRow、updateRow、deleteRowなど)を呼び出すと、呼び出されたメソッドは内部でnotifyRowChangedを呼び出します。アプリケーションがこのメソッドを直接呼び出すことはありません。
SQLException - BaseRowSet abstractクラスを拡張するクラスがRowSetインタフェースまたはそのサブインタフェースを実装していない場合。protected void notifyRowSetChanged()
throws SQLException
RowSetオブジェクトに登録されているすべてのリスナーに、コンテンツ全体が変更されたことを通知します。
アプリケーションがRowSetオブジェクトのコンテンツ全体を変更するメソッド(CachedRowSetメソッドexecute、populate、restoreOriginal、releaseなど)を呼び出すと、呼び出されたメソッドは内部で直接的または間接的にnotifyRowSetChangedを呼び出します。アプリケーションがこのメソッドを直接呼び出すことはありません。
SQLException - BaseRowSet abstractクラスを拡張するクラスがRowSetインタフェースまたはそのサブインタフェースを実装していない場合。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)public void setCommand(String cmd) throws SQLException
RowSetオブジェクトのcommandプロパティとして指定のStringオブジェクトを設定し、パラメータがある場合は、以前のコマンド用に設定されたものなので消去します。
RowSetオブジェクトがコマンドをサポートしないソース(スプレッドシート、その他の表形式のファイル)からデータを取得する場合、commandプロパティは不要です。つまり、このプロパティはオプションであり、nullの場合もあります。
cmd - このRowSetオブジェクトのcommandプロパティとして設定されるSQLクエリーを含むStringオブジェクト。nullの場合もあるが、空文字列にはならないSQLException - コマンドの値として空文字列が提供された場合getCommand()public String getUrl() throws SQLException
RowSetオブジェクトのjavax.sql.Readerオブジェクトがリレーショナル・データベースとの接続を作成するために使用するJDBC URLを取得します。
配下のデータ・ソースがSQLデータ・ソースでない場合(スプレッドシートやXMLデータ・ソースの場合)、Urlプロパティはnullになります。
RowSetオブジェクトの接続を確立するために使用されるJDBC URLを含むStringオブジェクト。設定しない場合、null (デフォルト値)になるSQLException - URL値の取得中にエラーが発生した場合setUrl(java.lang.String)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()public String getDataSourceName()
javax.sql.DataSourceオブジェクトを取得する論理名を返します。このDataSourceオブジェクトを使って、このオブジェクトが示すデータ・ソースとの接続を確立することができます。
ユーザーは、urlまたはdata source nameプロパティのいずれかを設定する必要があります。ドライバは、接続を確立するために一番最近設定されたプロパティ・セットを使用します。
DataSourceオブジェクトを識別するStringオブジェクト。論理名が設定されていない場合、nullを返す。setDataSourceName(java.lang.String)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()public String getUsername()
executeメソッドの呼出しの前に設定されます。Stringオブジェクト。設定しない場合、null (デフォルト値)になるsetUsername(java.lang.String)public void setUsername(String name)
RowSetオブジェクトのusernameプロパティとして、指定のユーザー名を設定します。usernameプロパティは直列化されないので、実行時、executeメソッドの呼出しの前に設定されます。name - 接続を作成するためにデータ・ソースに提供されるユーザー名を含むStringオブジェクト。nullも指定できる。getUsername()public String getPassword()
RowSetオブジェクトのデータベース接続を作成するために使用するパスワードを返します。passwordプロパティは直列化されないので、実行時、executeメソッドの呼出しの前に設定されます。デフォルト値はnullStringオブジェクトsetPassword(java.lang.String)public void setPassword(String pass)
RowSetオブジェクトのデータベース接続を作成するために使用するパスワードとして、指定のStringオブジェクトを設定します。passwordプロパティは直列化されないので、実行時、executeメソッドの呼出しの前に設定されます。pass - 接続を作成する際データベースに提供されるパスワードを表すStringオブジェクト。nullも指定できる。getPassword()public void setType(int type)
throws SQLException
RowSetオブジェクトに特定の型を設定します。デフォルトの型はResultSet.TYPE_SCROLL_INSENSITIVEです。type - 次の定数のいずれか。ResultSet.TYPE_FORWARD_ONLY、ResultSet.TYPE_SCROLL_INSENSITIVE、またはResultSet.TYPE_SCROLL_SENSITIVESQLException - パラメータとして次の定数以外が提供された場合。ResultSet.TYPE_FORWARD_ONLYまたはResultSet.TYPE_SCROLL_INSENSITIVE ResultSet.TYPE_SCROLL_SENSITIVEgetConcurrency(), getType()public int getType()
throws SQLException
RowSetオブジェクトの型を返します。型は、最初、RowSetオブジェクトを作成した文によって決定されます。RowSetオブジェクトは、いつでもsetTypeメソッドを呼び出して型を変更できます。デフォルトはTYPE_SCROLL_INSENSITIVEです。RowSetオブジェクトの型。次のいずれかでなければならない。ResultSet.TYPE_FORWARD_ONLY、ResultSet.TYPE_SCROLL_INSENSITIVE、またはResultSet.TYPE_SCROLL_SENSITIVESQLException - このRowSetオブジェクトの型の取得時にエラーが発生した場合setType(int)public void setConcurrency(int concurrency)
throws SQLException
RowSetオブジェクトの並行性を指定された並行性に設定します。接続されている場合でも接続されていない場合でも、RowSetオブジェクトのデフォルトの並行性はResultSet.CONCUR_UPDATABLEです。ただし、このメソッドは、並行性を変更したいときいつでも呼び出すことができます。
concurrency - 次の定数のいずれか。ResultSet.CONCUR_READ_ONLYまたはResultSet.CONCUR_UPDATABLESQLException - パラメータとして次の定数以外が提供された場合。ResultSet.CONCUR_UPDATABLEまたはResultSet.CONCUR_READ_ONLYgetConcurrency(), isReadOnly()public boolean isReadOnly()
RowSetオブジェクトが読取り専用であるかどうかを示すbooleanを返します。読取り専用のRowSetオブジェクトを更新しようとすると、SQLExceptionがスローされます。デフォルトでは、更新が可能であれば、行セットの更新も可能です。RowSetオブジェクトを更新できない場合はtrue、そうでない場合はfalsesetConcurrency(int), setReadOnly(boolean)public void setReadOnly(boolean value)
RowSetオブジェクトのreadOnlyプロパティとしてbooleanを設定します。value - このRowSetオブジェクトが読取り専用の場合はtrue、更新可能な場合はfalsepublic 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_SERIALIZABLESyncFactory、SyncProvider、setTransactionIsolation(int)public void setTransactionIsolation(int level)
throws SQLException
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_SERIALIZABLESQLException - 指定のパラメータがConnection定数でない場合SyncFactory、SyncProvider、getTransactionIsolation()public Map<String,Class<?>> getTypeMap()
RowSetオブジェクトのConnectionオブジェクトに関連付けられた型マップを取得します。
JDBC 3.0 APIをサポートするドライバは、型マップが関連付けられたConnectionオブジェクトを作成します。この型マップは、初期状態では空ですが、1つ以上の完全修飾SQL名と、指定のSQL値のマップ先クラスを示すClassオブジェクトを含めることができます。その他の代替となる型マップが存在しない場合、カスタム型マッピングには、接続の型マップで指定された型マッピングが使用されます。
カスタム・マッピングを実行できるメソッドに、明示的に型マップを提供した場合、この型マップは接続の型マップより優先されます。
java.util.Mapオブジェクト。RowSetオブジェクトの接続に使用する型マップ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も可。public int getMaxFieldSize()
throws SQLException
RowSetオブジェクト内の列の値として使用可能な最大バイト数を取得します。ただし、次の型の値を格納する列には、バイト数の制限が課される: BINARY、VARBINARY、LONGVARBINARY、CHAR、VARCHAR、およびLONGVARCHAR。制限値を超えたデータは通知なしに破棄されます。int。0は制限がないことを表すSQLException - 最大列サイズ制限値の決定時に内部でエラーが発生した場合public void setMaxFieldSize(int max)
throws SQLException
RowSetオブジェクト内の列の値として使用可能な最大バイト数を、指定した値に設定します。ただし、次の型の値を格納する列には、バイト数の制限が課される: BINARY、VARBINARY、LONGVARBINARY、CHAR、VARCHAR、およびLONGVARCHAR。制限値を超えたデータは通知なしに破棄されます。移植性を高めるため、256より大きい値を使用することをお勧めします。max - 新しい最大列サイズ制限値を示すint。0は制限がないことを表すSQLException - (1)最大列サイズ制限値の設定時に内部エラーが発生した場合、(2) 0より小さいサイズが設定された場合public int getMaxRows()
throws SQLException
RowSetオブジェクトに含めることのできる最大行数を取得します。制限値を超えた行は通知なしに除外されます。int。0は制限がないことを表すSQLException - Rowsetオブジェクトに含めることができる最大行数の決定時に内部でエラーが発生した場合public void setMaxRows(int max)
throws SQLException
RowSetオブジェクトに含めることのできる最大の行数を、指定した値に設定します。制限値を超えた行は通知なしに除外されます。max - 現在の最大行数を示すint。0は制限がないことを表すSQLException - JDBC RowSetオブジェクトに含めることができる最大行数の設定時に内部でエラーが発生した場合、maxに0より小さい値が指定された場合、またはmaxにRowSetのfetchSizeより小さい値が指定された場合public void setEscapeProcessing(boolean enable)
throws SQLException
booleanに設定します。デフォルトでは、ドライバはエスケープ処理を行います。
注: PreparedStatementオブジェクトは、通常呼び出す前に構文解析されているので、用意された文に対しエスケープ処理を無効にしても効果はありません。
enable - エスケープ処理を有効にする場合はtrue、無効にする場合はfalseSQLException - 配下のJDBCテクノロジを使用可能なドライバがエスケープ構文を処理するように設定している途中でエラーが発生した場合public int getQueryTimeout()
throws SQLException
SQLExceptionがスローされます。SQLException - クエリー・タイムアウト値の決定時にエラーが発生した場合public void setQueryTimeout(int seconds)
throws SQLException
SQLExceptionがスローされます。seconds - 新しいクエリー・タイムアウトの制限値の秒数。ゼロは無制限を意味する。ゼロより小さい値は使用できないSQLException - クエリー・タイムアウト値の設定時にエラーが発生した場合、またはクエリー・タイムアウト値が0より小さい場合public boolean getShowDeleted()
throws SQLException
booleanを取得します。デフォルト値はfalseです。
注: 削除された行の表示を許可すると、一部のメソッドの動作が複雑になります。ただし、この機能を活用する必要が生じるのは高度なアプリケーションだけなので、ほとんどのRowSetオブジェクト・ユーザーは単純にこの余分な詳細を無視してかまいません。
true、そうでない場合はfalseSQLException - 削除された行を表示するかどうかを決定している途中でエラーが発生した場合setShowDeleted(boolean)public void setShowDeleted(boolean value)
throws SQLException
showDeletedプロパティとして、削除マーク付きの行を現在の行とともに表示するかどうかを指定するbooleanを設定します。value - 削除された行を表示する場合はtrue、そうでない場合はfalseSQLException - 削除された行を表示するかどうかを設定している途中でエラーが発生した場合getShowDeleted()public boolean getEscapeProcessing()
throws SQLException
RowSetオブジェクトでエスケープ処理が有効になっているかどうかを確認します。true、そうでない場合はfalseSQLException - エスケープ処理の有効または無効を決定している途中でエラーが発生した場合、または内部エスケープ処理トリガーが有効になっていない場合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()public int getFetchDirection()
throws SQLException
RowSetオブジェクトの現在のフェッチ方向の設定を取得します。デフォルトの型はResultSet.FETCH_FORWARDResultSet.FETCH_FORWARD、ResultSet.FETCH_REVERSE、ResultSet.FETCH_UNKNOWNのいずれかSQLException - 行をフェッチする現在のフェッチ方向を決定している途中でエラーが発生した場合setFetchDirection(int)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()public int getFetchSize()
throws SQLException
RowSetオブジェクトのフェッチ・サイズを返します。デフォルト値はゼロです。RowSetオブジェクトがデータベースからより多くの行を取得する必要がある場合に、フェッチ・サイズとして提示される行数SQLException - 現在のフェッチ・サイズ内で行数の決定中にエラーが発生した場合setFetchSize(int)public int getConcurrency()
throws SQLException
RowSetオブジェクトの並行処理を返します。RowSetオブジェクトが接続されている場合も、未接続の場合も、デフォルト値はCONCUR_UPDATABLEです。
アプリケーションは、いつでもsetConcurrencyメソッドを呼び出して、RowSetオブジェクトの並行性を変更できます。
RowSetオブジェクトの並行性の型。次のいずれかでなければならない。ResultSet.CONCUR_READ_ONLYまたはResultSet.CONCUR_UPDATABLESQLException - このRowSetオブジェクトの並行性の取得時にエラーが発生した場合setConcurrency(int), isReadOnly()public void setNull(int parameterIndex,
int sqlType)
throws SQLException
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()public void setNull(int parameterIndex,
int sqlType,
String typeName)
throws SQLException
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()public void setBoolean(int parameterIndex,
boolean x)
throws SQLException
booleanに設定します。データベースに送るときに、ドライバはこれをSQL BIT値に変換します。
このメソッドで設定されたパラメータ値は内部で格納され、executeメソッドの呼出し時に、このRowSetオブジェクトのコマンド内の適切なパラメータとして提供されます。execute、populateなどのメソッドは、このクラスを拡張し、標準JSR-114 RowSetインタフェースを1つ以上実装するクラスで提供される必要があります。
注: JdbcRowSetはpopulateメソッドを必要としません。このメソッドは、このクラス内に定義されていません。
parameterIndex - このRowSetオブジェクトのコマンド内の、設定対象となるプレースホルダー・パラメータの順序番号。最初のパラメータが1、2番目のパラメータが2、といった具合になる。1以上でなければいけないx - パラメータ値SQLException - エラーが発生した場合、またはパラメータ・インデックスが範囲外である場合getParams()public void setByte(int parameterIndex,
byte x)
throws SQLException
byteに設定します。データベースに送るときに、ドライバはこれをSQL TINYINT値に変換します。
このメソッドで設定されたパラメータ値は内部で格納され、executeメソッドの呼出し時に、このRowSetオブジェクトのコマンド内の適切なパラメータとして提供されます。execute、populateなどのメソッドは、このクラスを拡張し、標準JSR-114 RowSetインタフェースを1つ以上実装するクラスで提供される必要があります。
注: JdbcRowSetはpopulateメソッドを必要としません。このメソッドは、このクラス内に定義されていません。
parameterIndex - このRowSetオブジェクトのコマンド内の、設定対象となるプレースホルダー・パラメータの順序番号。最初のパラメータが1、2番目のパラメータが2、といった具合になる。1以上でなければいけないx - パラメータ値SQLException - エラーが発生した場合、またはパラメータ・インデックスが範囲外である場合getParams()public void setShort(int parameterIndex,
short x)
throws SQLException
shortに設定します。データベースに送るときに、ドライバはこれをSQL SMALLINT値に変換します。
このメソッドで設定されたパラメータ値は内部で格納され、executeメソッドの呼出し時に、このRowSetオブジェクトのコマンド内の適切なパラメータとして提供されます。execute、populateなどのメソッドは、このクラスを拡張し、標準JSR-114 RowSetインタフェースを1つ以上実装するクラスで提供される必要があります。
注: JdbcRowSetはpopulateメソッドを必要としません。このメソッドは、このクラス内に定義されていません。
parameterIndex - このRowSetオブジェクトのコマンド内の、設定対象となるプレースホルダー・パラメータの順序番号。最初のパラメータが1、2番目のパラメータが2、といった具合になる。1以上でなければいけないx - パラメータ値SQLException - エラーが発生した場合、またはパラメータ・インデックスが範囲外である場合getParams()public void setInt(int parameterIndex,
int x)
throws SQLException
int値に設定します。データベースに送るときに、ドライバはこれをSQL INTEGER値に変換します。
このメソッドで設定されたパラメータ値は内部で格納され、executeメソッドの呼出し時に、このRowSetオブジェクトのコマンド内の適切なパラメータとして提供されます。execute、populateなどのメソッドは、このクラスを拡張し、標準JSR-114 RowSetインタフェースを1つ以上実装するクラスで提供される必要があります。
注: JdbcRowSetはpopulateメソッドを必要としません。このメソッドは、このクラス内に定義されていません。
parameterIndex - このRowSetオブジェクトのコマンド内の、設定対象となるプレースホルダー・パラメータの順序番号。最初のパラメータが1、2番目のパラメータが2、といった具合になる。1以上でなければいけないx - パラメータ値SQLException - エラーが発生した場合、またはパラメータ・インデックスが範囲外である場合getParams()public void setLong(int parameterIndex,
long x)
throws SQLException
longに設定します。データベースに送るときに、ドライバはこれをSQL BIGINT値に変換します。
このメソッドで設定されたパラメータ値は内部で格納され、executeメソッドの呼出し時に、このRowSetオブジェクトのコマンド内の適切なパラメータとして提供されます。execute、populateなどのメソッドは、このクラスを拡張し、標準JSR-114 RowSetインタフェースを1つ以上実装するクラスで提供される必要があります。
注: JdbcRowSetはpopulateメソッドを必要としません。このメソッドは、このクラス内に定義されていません。
parameterIndex - このRowSetオブジェクトのコマンド内の、設定対象となるプレースホルダー・パラメータの順序番号。最初のパラメータが1、2番目のパラメータが2、といった具合になる。1以上でなければいけないx - パラメータ値SQLException - エラーが発生した場合、またはパラメータ・インデックスが範囲外である場合getParams()public void setFloat(int parameterIndex,
float x)
throws SQLException
floatに設定します。データベースに送るときに、ドライバはこれをSQL FLOAT値に変換します。
このメソッドで設定されたパラメータ値は内部で格納され、executeメソッドの呼出し時に、このRowSetオブジェクトのコマンド内の適切なパラメータとして提供されます。execute、populateなどのメソッドは、このクラスを拡張し、標準JSR-114 RowSetインタフェースを1つ以上実装するクラスで提供される必要があります。
注: JdbcRowSetはpopulateメソッドを必要としません。このメソッドは、このクラス内に定義されていません。
parameterIndex - このRowSetオブジェクトのコマンド内の、設定対象となるプレースホルダー・パラメータの順序番号。最初のパラメータが1、2番目のパラメータが2、といった具合になる。1以上でなければいけないx - パラメータ値SQLException - エラーが発生した場合、またはパラメータ・インデックスが範囲外である場合getParams()public void setDouble(int parameterIndex,
double x)
throws SQLException
doubleに設定します。データベースに送るときに、ドライバはこれをSQL DOUBLE値に変換します。
このメソッドで設定されたパラメータ値は内部で格納され、executeメソッドの呼出し時に、このRowSetオブジェクトのコマンド内の適切なパラメータとして提供されます。execute、populateなどのメソッドは、このクラスを拡張し、標準JSR-114 RowSetインタフェースを1つ以上実装するクラスで提供される必要があります。
注: JdbcRowSetはpopulateメソッドを必要としません。このメソッドは、このクラス内に定義されていません。
parameterIndex - このRowSetオブジェクトのコマンド内の、設定対象となるプレースホルダー・パラメータの順序番号。最初のパラメータが1、2番目のパラメータが2、といった具合になる。1以上でなければいけないx - パラメータ値SQLException - エラーが発生した場合、またはパラメータ・インデックスが範囲外である場合getParams()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()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()public void setBytes(int parameterIndex,
byte[] x)
throws SQLException
VARBINARYまたはLONGVARBINARY値(ドライバのVARBINARY値の制限に対する引数のサイズに依存)に変換します。
このメソッドで設定されたパラメータ値は内部で格納され、executeメソッドの呼出し時に、このRowSetオブジェクトのコマンド内の適切なパラメータとして提供されます。execute、populateなどのメソッドは、このクラスを拡張し、標準JSR-114 RowSetインタフェースを1つ以上実装するクラスで提供される必要があります。
注: JdbcRowSetはpopulateメソッドを必要としません。このメソッドは、このクラス内に定義されていません。
parameterIndex - このRowSetオブジェクトのコマンド内の、設定対象となるプレースホルダー・パラメータの順序番号。最初のパラメータが1、2番目のパラメータが2、といった具合になる。1以上でなければいけないx - パラメータ値SQLException - エラーが発生した場合、またはパラメータ・インデックスが範囲外である場合getParams()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()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()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()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()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ドライバがこのメソッドをサポートしない場合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()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ドライバがこのメソッドをサポートしない場合@Deprecated public void setUnicodeStream(int parameterIndex, InputStream x, int length) throws SQLException
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()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()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ドライバがこのメソッドをサポートしない場合public void setObject(int parameterIndex,
Object x,
int targetSqlType,
int scale)
throws SQLException
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()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()public void setObject(int parameterIndex,
Object x)
throws SQLException
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()public void setRef(int parameterIndex,
Ref ref)
throws SQLException
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()、SerialRefpublic void setBlob(int parameterIndex,
Blob x)
throws SQLException
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()、SerialBlobpublic void setClob(int parameterIndex,
Clob x)
throws SQLException
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()、SerialBlobpublic void setArray(int parameterIndex,
Array array)
throws SQLException
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()、SerialArraypublic 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()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()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()public void clearParameters()
throws SQLException
RowSetオブジェクトのコマンドの実行時に設定される、このRowSetオブジェクトのパラメータの内部表現に含まれる現在のパラメータ値をすべて消去します。
通常、このRowSetオブジェクトのコマンド内で再利用できるように、パラメータ値は有効なままです。設定メソッドを使ってパラメータ値を設定すると、指定されたパラメータの値は自動的に消去され、新しく指定された値で置き換えられます。
このメソッドは、setCommandメソッドによって内部で呼び出され、以前のコマンドに設定されたすべてのパラメータを消去します。
このメソッドは、RowSetオブジェクトのスキーマを確保する点で、initParamsメソッドとは異なります。
SQLException - パラメータの消去時にエラーが発生した場合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オブジェクトのパラメータのオブジェクト配列の取得中にエラーが発生した場合、またはパラメータが何も設定されていない場合public void setNull(String parameterName, int sqlType) throws SQLException
NULLに設定します。
注: パラメータのSQLの型を指定する必要があります。
parameterName - パラメータの名前sqlType - java.sql.Typesで定義されるSQL型コードSQLException - データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementについて呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合public void setNull(String parameterName, int sqlType, String typeName) throws SQLException
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ドライバがこのメソッドをサポートしない場合public void setBoolean(String parameterName, boolean x) throws SQLException
boolean値に設定します。データベースに送るときに、ドライバはこれをSQL BITまたはBOOLEAN値に変換します。parameterName - パラメータの名前x - パラメータ値SQLException - データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementについて呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合getParams()public void setByte(String parameterName, byte x) throws SQLException
byte値に設定します。データベースに送るときに、ドライバはこれをSQL TINYINT値に変換します。parameterName - パラメータの名前x - パラメータ値SQLException - データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementについて呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合getParams()public void setShort(String parameterName, short x) throws SQLException
short値に設定します。データベースに送るときに、ドライバはこれをSQL SMALLINT値に変換します。parameterName - パラメータの名前x - パラメータ値SQLException - データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementについて呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合getParams()public void setInt(String parameterName, int x) throws SQLException
int値に設定します。データベースに送るときに、ドライバはこれをSQL INTEGER値に変換します。parameterName - パラメータの名前x - パラメータ値SQLException - データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementについて呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合getParams()public void setLong(String parameterName, long x) throws SQLException
long値に設定します。データベースに送るときに、ドライバはこれをSQL BIGINT値に変換します。parameterName - パラメータの名前x - パラメータ値SQLException - データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementについて呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合getParams()public void setFloat(String parameterName, float x) throws SQLException
float値に設定します。データベースに送るときに、ドライバはこれをSQL FLOAT値に変換します。parameterName - パラメータの名前x - パラメータ値SQLException - データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementについて呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合getParams()public void setDouble(String parameterName, double x) throws SQLException
double値に設定します。データベースに送るときに、ドライバはこれをSQL DOUBLE値に変換します。parameterName - パラメータの名前x - パラメータ値SQLException - データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementについて呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合getParams()public void setBigDecimal(String parameterName, BigDecimal x) throws SQLException
java.math.BigDecimal値に設定します。データベースに送るときに、ドライバはこれをSQL NUMERIC値に変換します。parameterName - パラメータの名前x - パラメータ値SQLException - データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementについて呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合getParams()public void setString(String parameterName, String x) throws SQLException
String値に設定します。データベースに送るときに、ドライバはこれをSQL VARCHARまたはLONGVARCHAR値(ドライバのVARCHAR値の制限に対する引数のサイズに依存)に変換します。parameterName - パラメータの名前x - パラメータ値SQLException - データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementについて呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合getParams()public void setBytes(String parameterName, byte[] x) throws SQLException
VARBINARYまたはLONGVARBINARY (ドライバのVARBINARY値の制限に対する引数のサイズに依存)に変換します。parameterName - パラメータの名前x - パラメータ値SQLException - データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementについて呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合getParams()public void setTimestamp(String parameterName, Timestamp x) throws SQLException
java.sql.Timestamp値に設定します。データベースに送るときに、ドライバはこれをSQL TIMESTAMP値に変換します。parameterName - パラメータの名前x - パラメータ値SQLException - データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementについて呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合getParams()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ドライバがこのメソッドをサポートしない場合public void setBinaryStream(String parameterName, InputStream x, int length) throws SQLException
LONGVARBINARYパラメータに非常に大きなバイナリ値が入力されるときには、java.io.InputStreamオブジェクトを介して送るのが現実的です。ファイルの終わりに達するまで必要に応じてストリームからデータが読み込まれます。
注: このストリーム・オブジェクトは、標準のJavaストリーム・オブジェクト、または標準インタフェースを実装する独自のサブクラスのどちらでもかまいません。
parameterName - パラメータの名前x - バイナリ・パラメータ値を含むJava入力ストリームlength - ストリームのバイト数SQLException - データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementについて呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合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ドライバがこのメソッドをサポートしない場合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ドライバがこのメソッドをサポートしない場合public void setBinaryStream(String parameterName, InputStream x) throws SQLException
LONGVARBINARYパラメータに非常に大きなバイナリ値が入力されるときには、java.io.InputStreamオブジェクトを介して送るのが現実的です。ファイルの終わりに達するまで必要に応じてストリームからデータが読み込まれます。
注: このストリーム・オブジェクトは、標準のJavaストリーム・オブジェクト、または標準インタフェースを実装する独自のサブクラスのどちらでもかまいません。
注: lengthパラメータを使用するバージョンのsetBinaryStreamを使用する方が効率的かどうかを判断するには、JDBCドライバのドキュメントを参照してください。
parameterName - パラメータの名前x - バイナリ・パラメータ値を含むJava入力ストリームSQLException - データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementについて呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合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ドライバがこのメソッドをサポートしない場合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ドライバがこのメソッドをサポートしない場合public void setObject(String parameterName, Object x, int targetSqlType, int scale) throws SQLException
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()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()public void setObject(String parameterName, Object x) throws SQLException
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()public void setBlob(int parameterIndex,
InputStream inputStream,
long length)
throws SQLException
InputStreamオブジェクトに設定します。inputstreamには、lengthで指定された文字数が含まれている必要があります。そうでない場合、PreparedStatementの実行時にSQLExceptionが生成されます。このメソッドは、setBinaryStream (int, InputStream, int)メソッドと異なり、パラメータ値をBLOBとしてサーバーに送信するべきであることをドライバに通知します。setBinaryStreamメソッドを使用すると、ドライバは、パラメータ・データをLONGVARBINARYとBLOBのどちらとしてサーバーに送信するべきかを判断するために余計な作業を行う必要がある可能性があります。parameterIndex - 最初のパラメータのインデックスは1、2番目のパラメータのインデックスは2、... となるinputStream - パラメータ値に設定されるデータを含むオブジェクト。length - パラメータ・データ内のバイト数。SQLException - データベース・アクセス・エラーが発生した場合、このメソッドがクローズされたPreparedStatement上で呼び出された場合、parameterIndexがSQL文のパラメータ・マーカーと対応していない場合、長さとしてゼロ未満の値が指定された場合、入力ストリーム内のバイト数が指定された長さと一致していない場合。SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合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ドライバがこのメソッドをサポートしない場合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文のパラメータ・マーカーと対応していない場合、長さとしてゼロ未満の値が指定された場合、入力ストリーム内のバイト数が指定された長さと一致していない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatement上で呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合public void setBlob(String parameterName, Blob x) throws SQLException
java.sql.Blobオブジェクトに設定します。データベースに送るときに、ドライバはこれをSQL BLOB値に変換します。parameterName - パラメータの名前x - SQL BLOB値をマッピングするBlobオブジェクトSQLException - データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementについて呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合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ドライバがこのメソッドをサポートしない場合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ドライバがこのメソッドをサポートしない場合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ドライバがこのメソッドをサポートしない場合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ドライバがこのメソッドをサポートしない場合public void setClob(String parameterName, Clob x) throws SQLException
java.sql.Clobオブジェクトに設定します。データベースに送るときに、ドライバはこれをSQL CLOB値に変換します。parameterName - パラメータの名前x - SQL CLOB値をマッピングするClobオブジェクトSQLException - データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementについて呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合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ドライバがこのメソッドをサポートしない場合public void setDate(String parameterName, Date x) throws SQLException
java.sql.Date値に設定します。データベースに送るときに、ドライバはこれをSQL DATE値に変換します。parameterName - パラメータの名前x - パラメータ値SQLException - データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementについて呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合getParams()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()public void setTime(String parameterName, Time x) throws SQLException
java.sql.Time値に設定します。データベースに送るときに、ドライバはこれをSQL TIME値に変換します。parameterName - パラメータの名前x - パラメータ値SQLException - データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementについて呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合getParams()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()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()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ドライバがこのメソッドをサポートしない場合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ドライバがこのメソッドをサポートしない場合public void setRowId(int parameterIndex,
RowId x)
throws SQLException
java.sql.RowIdオブジェクトに設定します。データベースに送るときに、ドライバはこれをSQL ROWID値に変換します。parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となるx - パラメータ値SQLException - データベース・アクセス・エラーが発生した場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合public void setRowId(String parameterName, RowId x) throws SQLException
java.sql.RowIdオブジェクトに設定します。データベースに送るときに、ドライバはこれをSQL ROWIDに変換します。parameterName - パラメータの名前x - パラメータ値SQLException - データベース・アクセス・エラーが発生した場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合public void setNString(int parameterIndex,
String value)
throws SQLException
Stringオブジェクトに設定します。データベースに送るときに、ドライバはこれをSQL NCHAR、NVARCHAR、またはLONGNVARCHAR値(ドライバのNVARCHAR値に関する制限に関する引数のサイズに依存)に変換します。parameterIndex - 最初のパラメータのインデックスは1、2番目のパラメータのインデックスは2、... となるvalue - パラメータ値SQLException - ドライバが各国文字セットをサポートしない場合、ドライバがデータ変換エラーが発生した可能性を検出できる場合、またはデータベース・アクセス・エラーが発生した場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合public void setNString(String parameterName, String value) throws SQLException
Stringオブジェクトに設定します。ドライバはこれをSQL NCHAR、NVARCHAR、またはLONGNVARCHARに変換します。parameterName - 設定される列の名前value - パラメータ値SQLException - ドライバが各国文字セットをサポートしない場合、ドライバがデータ変換エラーが発生した可能性を検出できる場合、またはデータベース・アクセス・エラーが発生した場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合public void setNCharacterStream(int parameterIndex,
Reader value,
long length)
throws SQLException
Readerオブジェクトに設定します。Readerは、ファイルの終わりに達するまでデータを読み込みます。ドライバは、必要に応じて、Javaの文字表現をデータベース内の各国文字セットに変換します。parameterIndex - 最初のパラメータのインデックスは1、2番目のパラメータのインデックスは2、... となるvalue - パラメータ値length - パラメータ・データ内の文字数。SQLException - ドライバが各国文字セットをサポートしない場合、ドライバがデータ変換エラーが発生した可能性を検出できる場合、またはデータベース・アクセス・エラーが発生した場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合public void setNCharacterStream(String parameterName, Reader value, long length) throws SQLException
Readerオブジェクトに設定します。Readerは、ファイルの終わりに達するまでデータを読み込みます。ドライバは、必要に応じて、Javaの文字表現をデータベース内の各国文字セットに変換します。parameterName - 設定される列の名前value - パラメータ値length - パラメータ・データ内の文字数。SQLException - ドライバが各国文字セットをサポートしない場合、ドライバがデータ変換エラーが発生した可能性を検出できる場合、またはデータベース・アクセス・エラーが発生した場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合public void setNCharacterStream(String parameterName, Reader value) throws SQLException
Readerオブジェクトに設定します。Readerは、ファイルの終わりに達するまでデータを読み込みます。ドライバは、必要に応じて、Javaの文字表現をデータベース内の各国文字セットに変換します。
注: このストリーム・オブジェクトは、標準のJavaストリーム・オブジェクト、または標準インタフェースを実装する独自のサブクラスのどちらでもかまいません。
注: lengthパラメータを使用するバージョンのsetNCharacterStreamを使用する方が効率的かどうかを判断するには、JDBCドライバのドキュメントを参照してください。
parameterName - パラメータの名前value - パラメータ値SQLException - ドライバが各国文字セットをサポートしない場合、ドライバがデータ変換エラーが発生した可能性を検出できる場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatement上で呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合public void setNClob(String parameterName, NClob value) throws SQLException
java.sql.NClobオブジェクトに設定します。このオブジェクトは、java.sql.NClobインタフェースを実装します。このNClobオブジェクトは、SQL NCLOBにマッピングされます。parameterName - 設定される列の名前value - パラメータ値SQLException - ドライバが各国文字セットをサポートしない場合、ドライバがデータ変換エラーが発生した可能性を検出できる場合、またはデータベース・アクセス・エラーが発生した場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合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ドライバがこのメソッドをサポートしない場合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ドライバがこのメソッドをサポートしない場合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ドライバがこのメソッドをサポートしない場合public void setNClob(int parameterIndex,
NClob value)
throws SQLException
java.sql.NClobオブジェクトに設定します。データベースに送るときに、ドライバはこれをSQL NCLOB値に変換します。parameterIndex - 最初のパラメータのインデックスは1、2番目のパラメータのインデックスは2、... となるvalue - パラメータ値SQLException - ドライバが各国文字セットをサポートしない場合、ドライバがデータ変換エラーが発生した可能性を検出できる場合、またはデータベース・アクセス・エラーが発生した場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合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ドライバがこのメソッドをサポートしない場合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ドライバがこのメソッドをサポートしない場合 バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright© 1993, 2014, Oracle and/or its affiliates. All rights reserved.