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
メソッドの呼出しの前に設定されます。デフォルト値はnull
String
オブジェクト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_SENSITIVE
SQLException
- パラメータとして次の定数以外が提供された場合。ResultSet.TYPE_FORWARD_ONLY
またはResultSet.TYPE_SCROLL_INSENSITIVE
ResultSet.TYPE_SCROLL_SENSITIVE
getConcurrency()
, 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_SENSITIVE
SQLException
- このRowSet
オブジェクトの型の取得時にエラーが発生した場合setType(int)
public void setConcurrency(int concurrency) throws SQLException
RowSet
オブジェクトの並行性を指定された並行性に設定します。接続されている場合でも接続されていない場合でも、RowSet
オブジェクトのデフォルトの並行性はResultSet.CONCUR_UPDATABLE
です。ただし、このメソッドは、並行性を変更したいときいつでも呼び出すことができます。
concurrency
- 次の定数のいずれか。ResultSet.CONCUR_READ_ONLY
またはResultSet.CONCUR_UPDATABLE
SQLException
- パラメータとして次の定数以外が提供された場合。ResultSet.CONCUR_UPDATABLE
またはResultSet.CONCUR_READ_ONLY
getConcurrency()
, isReadOnly()
public boolean isReadOnly()
RowSet
オブジェクトが読取り専用であるかどうかを示すboolean
を返します。読取り専用のRowSet
オブジェクトを更新しようとすると、SQLException
がスローされます。デフォルトでは、更新が可能であれば、行セットの更新も可能です。RowSet
オブジェクトを更新できない場合はtrue
、そうでない場合はfalse
setConcurrency(int)
, setReadOnly(boolean)
public void setReadOnly(boolean value)
RowSet
オブジェクトのreadOnlyプロパティとしてboolean
を設定します。value
- このRowSet
オブジェクトが読取り専用の場合はtrue
、更新可能な場合はfalse
public int getTransactionIsolation()
RowSet
オブジェクトの接続のトランザクション遮断プロパティを返します。このプロパティは、トランザクション用として要求されたトランザクション遮断レベルを表します。
RowSet
実装(未接続の環境で動作するCachedRowSet
など)には、SyncProvider
オブジェクトにより、補足ロックやデータの整合性のオプションが提供されます。次のオプションは、接続済みRowSet
オブジェクト(JdbcRowSet
オブジェクト)専用です。
Connection.TRANSACTION_NONE
、Connection.TRANSACTION_READ_UNCOMMITTED
、Connection.TRANSACTION_READ_COMMITTED
、Connection.TRANSACTION_REPEATABLE_READ
、またはConnection.TRANSACTION_SERIALIZABLE
SyncFactory
、SyncProvider
、setTransactionIsolation(int)
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_SERIALIZABLE
SQLException
- 指定のパラメータが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
、無効にする場合はfalse
SQLException
- 配下の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
、そうでない場合はfalse
SQLException
- 削除された行を表示するかどうかを決定している途中でエラーが発生した場合setShowDeleted(boolean)
public void setShowDeleted(boolean value) throws SQLException
showDeleted
プロパティとして、削除マーク付きの行を現在の行とともに表示するかどうかを指定するboolean
を設定します。value
- 削除された行を表示する場合はtrue
、そうでない場合はfalse
SQLException
- 削除された行を表示するかどうかを設定している途中でエラーが発生した場合getShowDeleted()
public boolean getEscapeProcessing() throws SQLException
RowSet
オブジェクトでエスケープ処理が有効になっているかどうかを確認します。true
、そうでない場合はfalse
SQLException
- エスケープ処理の有効または無効を決定している途中でエラーが発生した場合、または内部エスケープ処理トリガーが有効になっていない場合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_FORWARD
ResultSet.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_UPDATABLE
SQLException
- この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()
、SerialRef
public 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()
、SerialBlob
public 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()
、SerialBlob
public 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()
、SerialArray
public void setDate(int parameterIndex, Date x, Calendar cal) throws SQLException
java.sql.Date
オブジェクトに設定します。DBMSにタイムゾーン情報が格納されていない場合、ドライバは指定されたCalendar
オブジェクトを使用して、SQL DATE
値を作成し、これをデータベースに送ります。Calendar
オブジェクトを使用する場合、ドライバはカスタム・タイムゾーンを考慮して日付を計算できます。Calendar
オブジェクトを指定しない場合、ドライバは、アプリケーションを実行している仮想マシンのタイムゾーンを使用します。
このメソッドで設定されたパラメータ値は内部で格納され、execute
メソッドの呼出し時に、このRowSet
オブジェクトのコマンド内の適切なパラメータとして提供されます。execute
、populate
などのメソッドは、このクラスを拡張し、標準JSR-114 RowSet
インタフェースを1つ以上実装するクラスで提供される必要があります。
注: JdbcRowSet
はpopulate
メソッドを必要としません。このメソッドは、このクラス内に定義されていません。
このバージョンのsetDate
を呼び出した後でメソッドgetParams
を呼び出すと、設定されたパラメータ値を含む配列が返されます。その配列内で、このメソッドで設定された値を表す要素はそれ自体が配列になります。その配列の最初の要素は、指定されたjava.sql.Date
オブジェクトです。2番目の要素は、calに設定された値です。パラメータ番号はメソッドgetParams
から返される配列内での要素の位置によって示され、最初の要素は最初のプレースホルダー・パラメータの値、2番目の要素は2番目のプレースホルダー・パラメータの値、といった具合になります。言い換えると、設定する日付が2番目のプレースホルダー・パラメータの値である場合、その値を含む配列は、getParams
から返される配列内の2番目の要素になります。
配列内の要素の番号付けはゼロから開始されるので、プレースホルダー番号parameterIndexに対応する配列要素はparameterIndex -1になります。
parameterIndex
- このRowSet
オブジェクトのコマンド内の、設定対象となるプレースホルダー・パラメータの順序番号。最初のパラメータが1、2番目のパラメータが2、といった具合になる。1
以上でなければいけないx
- SQL DATE
値を表すjava.sql.Date
オブジェクトcal
- 日付を作成するために使用するjava.util.Calendar
オブジェクトSQLException
- エラーが発生した場合、またはパラメータ・インデックスが範囲外である場合getParams()
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.