- java.lang.Object
-
- javax.sql.rowset.BaseRowSet
-
- すべての実装されたインタフェース:
Serializable
,Cloneable
public abstract class BaseRowSet extends Object implements Serializable, Cloneable
RowSet
オブジェクトとその基本機能を提供するabstractクラスです。 基本機能には、すべてのJavaBeans™コンポーネントが実装する必要のあるプロパティ保持やイベント通知送信などがあります。1.0 概要
BaseRowSet
クラスはすべてのRowSet
実装の中核機能を提供しますが、どの標準実装でもベンダー固有の標準実装を提供するため、このクラスと1つ以上のRowSet
インタフェースを使用することができます。 より明確な言い方をするなら、どの実装でも必ず、RowSet
インタフェース(JdbcRowSet
、CachedRowSet
、JoinRowSet
、FilteredRowSet
またはWebRowSet
)を1つ以上実装する必要があります。 つまり、BaseRowSet
クラスを拡張する実装では必ず、いずれかのRowSet
インタフェースも実装する必要があります。BaseRowSet
クラスは次の機能を提供します。- プロパティ
- 現在のプロパティを格納するフィールド
- プロパティを取得および設定するメソッド
- イベント通知
RowSet
オブジェクトのコマンドにパラメータを設定する設定メソッドの完全なセット- ストリーム
- ストリーム・インスタンスを格納するフィールド
- ストリームの型を示す定数
2.0 プロパティの設定
どの行セットも必ず一連のプロパティを保持しますが、それらのプロパティは通常、ツールを使用して設定されます。 行セットに含まれるプロパティの数や種類は、RowSet
実装の処理内容やデータの取得方法によって異なります。 たとえば、ResultSet
オブジェクトからデータを取得する行セットでは、データベース接続に必要なプロパティを設定する必要があります。DriverManager
機能を使用して接続を行うRowSet
オブジェクトでは、適切なドライバを識別するJDBC URLのプロパティを設定する必要があるほか、ユーザー名とパスワードを提供するプロパティも設定する必要があります。 一方、推奨の方法であるDataSource
オブジェクトを使用して接続を行う行セットでは、JDBC URLのプロパティを設定する必要はありません。 かわりに、データ・ソースの論理名のプロパティ、およびユーザー名とパスワードのプロパティを設定する必要があります。ノート:
DataSource
オブジェクトを使用して接続を作成する場合は、Java Naming and Directory Interface™ (JNDI) APIを使用するネーム・サービスに、DataSource
オブジェクトを登録する必要があります。 登録は通常、システム管理者が行います。3.0 コマンドとコマンド・パラメータの設定
行セットは、リレーショナル・データベースからデータを取得すると、ResultSet
オブジェクトを生成するコマンド(クエリー)を実行します。 このクエリーは、RowSet
オブジェクトのコマンド・プロパティに設定されるコマンドです。 行セットは、ResultSet
オブジェクトからデータを読み込んで、自身にデータを移植します。 クエリーに未設定の値のプレースホルダーが含まれている場合、BaseRowSet
設定メソッドを使って、これらの値を設定できます。 どの設定メソッドでも、必要に応じてnull
値を設定できます。次のコードの抜粋は、
CachedRowSet
™オブジェクトcrs
にコマンド・プロパティを設定する方法を示しています。 ツールを使ってプロパティを設定する場合、このコードを使用します。crs.setCommand("SELECT FIRST_NAME, LAST_NAME, ADDRESS FROM CUSTOMERS" + "WHERE CREDIT_LIMIT > ? AND REGION = ?");
この例では
CREDIT_LIMIT
とREGION
の値がプレースホルダー・パラメータであり、疑問符(?)で示されています。 最初の疑問符はパラメータ番号1
、2番目の疑問符はパラメータ番号2
のプレースホルダー(以下同様)です。 クエリーを実行するためには、あらかじめプレースホルダー・パラメータを設定しておく必要があります。BaseRowSet
クラスは、プレースホルダー・パラメータの設定に必要な設定メソッドを提供します。この設定メソッドは、PreparedStatement
インタフェースがデータ型の値を設定するために提供するメソッドとよく似ています。RowSet
オブジェクトは、パラメータ値を内部で格納します。このオブジェクトのexecute
メソッドは、格納されたパラメータ値を内部で利用して、実行するDBMSにコマンドを送信する前にプレースホルダー・パラメータの値を設定します。次のコードの抜粋は、先ほどの例で、クエリー内の2つのパラメータを設定する方法を示しています。
この時点でcrs.setInt(1, 5000); crs.setString(2, "West");
execute
メソッドを呼び出すとすると、DBMSに送信されるクエリーは次のようになります。
ノート:"SELECT FIRST_NAME, LAST_NAME, ADDRESS FROM CUSTOMERS" + "WHERE CREDIT_LIMIT > 5000 AND REGION = 'West'"
Array
、Clob
、Blob
およびRef
オブジェクトをコマンド・パラメータとして設定すると、これらの値はそれぞれSerialArray
、SerialClob
、SerialBlob
、およびSerialRef
オブジェクトとして保存されます。4.0 内部のパラメータ処理
ノート:BaseRowSet
クラスは、プロパティを設定する設定メソッドと、プレースホルダー・パラメータを設定する設定メソッドを提供します。 このセクションでは、プレースホルダー・パラメータを設定する設定メソッドについて説明します。BaseRowSet
設定メソッドで設定されたプレースホルダー・パラメータは、内部のHashtable
オブジェクトにオブジェクトとして格納されます。 プリミティブはObject
型として格納されます。 たとえば、byte
はByte
オブジェクト、int
はInteger
オブジェクトとして格納されます。execute
メソッドが呼び出されると、Hashtable
オブジェクト内の値が、コマンド内の適切なプレースホルダー・パラメータに代入されます。getParams
メソッドを呼び出すと、Hashtable
オブジェクトに格納された値がObject
インスタンスの配列として返されます。 この配列内の要素は、単純なObject
インスタンスかObject
型の配列になります。 配列内の要素がObject
になるか配列になるかは、使用する設定メソッドによって異なります。プレースホルダー・パラメータを設定するほとんどのメソッドは、2つのパラメータを取ります。第1のパラメータで設定するプレースホルダー・パラメータを指定し、第2のパラメータで設定する値を指定します。 該当メソッドには、
setInt
、setString
、setBoolean
、setLong
などがあります。 これらのメソッドを呼び出したあと、getParams
を呼び出すと、設定された値から成る配列が返されます。 配列内の各値は、設定された値を表すObject
インスタンスになります。 配列内の値の並び順は、設定メソッドに渡されるint
(第1のパラメータ)によって決定されます。 配列内の値は、設定メソッドに渡される値(第2のパラメータ)になります。 つまり、配列内の第1の要素が、RowSet
オブジェクトのコマンドで第1のプレースホルダー・パラメータに設定されます。 配列内の第2の要素が、第2のプレースホルダー・パラメータに設定される(以下同様)ということになります。設定する値以外に、ドライバとDBMSの情報を送信する設定メソッドもあります。 このような設定メソッドの使用後に
getParams
メソッドを呼び出すと、追加情報を格納するため、配列内の要素自体が配列になります。 このような設定メソッドの特例として、一方のバージョンがパラメータを2つしか取らないsetNull
メソッドがあります(setNull(int parameterIndex, int SqlType)
)。 ただし、このメソッドも、ドライバとDBMSに渡す情報を格納するため、配列を必要とします。 この配列内の第1の要素は、設定する値null
になります。第2の要素は、sqlTypeに代入されるint
であり、null
に設定されるSQL値の型を示します。 この情報は、一部のDBMSでは必須です。したがって、アプリケーションの移植性を確保するためには、この情報が必須になります。 もう一方のバージョンは、null
に設定する値がユーザー定義型であるときに使用するためのものです。 この場合も、3つのパラメータ(setNull(int parameterIndex, int sqlType, String typeName)
)を使用し、ドライバとDBMSに渡す情報を格納する配列が必要になります。 この配列の最初の2つの要素は、最初のバージョンのsetNull
の場合と同じです。 第3の要素typeNameは、ユーザー定義型のSQL名を指定します。 その他の設定メソッドと同じく、設定するプレースホルダー・パラメータの数は、getParams
によって返される配列内の要素の位置で表されます。 たとえば、setNull
のパラメータが2
の場合、getParams
によって返される配列内の第2の要素は、2 - 3個の要素から成る配列になります。setObject
やsetDate
をはじめとする一部のメソッドは、2つ以上のパラメータと、ドライバまたはDBMSに情報を提供する追加のパラメータを取る場合があります。 たとえば、setDate
メソッド、setTime
メソッド、setTimestamp
メソッドは、3番目のパラメータとしてCalendar
オブジェクトを取ることができます。 DBMSにタイムゾーン情報が格納されていない場合、ドライバはCalendar
オブジェクトを使用して、設定するDate
オブジェクト、Time
オブジェクトまたはTimestamp
オブジェクトを作成します。 追加情報を提供するその他のメソッドと同様に、getParams
から返される配列内の要素は、単純なObject
インスタンスではなく、配列になります。setAsciiStream
、setBinaryStream
、setCharacterStream
、setUnicodeStream
の各メソッド(非推奨。アプリケーションは、これらのかわりにgetCharacterStream
を使用するべきである)は、3つのパラメータを取ります。したがって、この場合も、getParams
から返される配列内の要素は配列になります。 これらの設定メソッドは、配列内に、パラメータによって提供される情報だけでなく、設定するストリームの型を示すBaseRowSet
定数が含まれているという点で、その他の設定メソッドと異なっています。ノート:
getParams
メソッドは、このクラスを拡張するRowSet
実装によって内部で呼び出されます。通常、アプリケーション・プログラマによって直接呼び出されることはありません。5.0 イベント通知
BaseRowSet
クラスは、行セットにイベント通知メカニズムを提供します。 このクラスには、listeners
フィールド、リスナーの追加と削除を行うメソッド、リスナーに変更を通知するメソッドが含まれます。リスナーは、
RowSetListener
インタフェースを実装するオブジェクトです。RowSet
オブジェクトのリスナー・リストに追加されたリスナーは、そのRowSet
オブジェクトで発生したイベントの通知を受けます。 イベントの発生通知を受けたときのオブジェクトの動作は、各リスナーのRowSetListener
メソッドの実装によって定義されます。RowSet
オブジェクトで発生する可能性があるイベントは、次の3種類です。- カーソルの移動
- 個々の行の変更(更新、削除、または挿入)
RowSet
オブジェクト全体の内容の変更
通知に使用される
BaseRowSet
メソッドは、発生したイベントの型を示します。 たとえば、notifyRowChanged
メソッドは、行が更新、削除、または挿入されたことを示します。 各通知メソッドは、イベントの発生元のRowSet
オブジェクトを特定するためにリスナーに渡される、RowSetEvent
オブジェクトを作成します。 リスナーがこの情報を利用して何を行うか(何も行わない場合もある)は、リスナーの実装によって異なります。6.0 デフォルトの動作
デフォルトのBaseRowSet
オブジェクトの初期化のときの開始値は、一定ではありません。BaseRowSet
クラスを拡張するデフォルトのRowSet
インスタンスには、次の特徴があります。- スクロール可能なカーソルを使用し、その他のユーザーによる変更を表示しない。
- 更新可能。
- 削除された行は表示しない。
- ドライバが
RowSet
オブジェクトのコマンド実行に費やす時間に制限はない。 - 含むことのできる行数に制限はない。
- 列内のバイト数に制限はない。 ノート: ただし、次の型の値を格納する列には、バイト数の制限が課される:
BINARY
、VARBINARY
、LONGVARBINARY
、CHAR
、VARCHAR
、およびLONGVARCHAR
。 - 未確定のデータは表示しない(「ダーティ」読取りになる)。
- エスケープ処理が有効。
- 接続の型マップは
null
に設定されている。 RowSet
オブジェクトのコマンド内のプレースホルダー・パラメータに設定された値を格納するため、空のVector
オブジェクトが用意されている。
適切な値が異なる場合、アプリケーションは、その値を明示的に設定する必要があります。 たとえば、次のコードは、
CachedRowSet
オブジェクトcrsに最大行数500を設定します。crs.setMaxRows(500);
このBaseRowSet
クラスの拡張に実装されたメソッドは、定義済みのアサーションに対する違反があった場合、SQLException
オブジェクトをスローする必要があります。 そのため、このメソッドは、クラスの拡張によってBaseRowSet
メソッドがオーバーライドされ、再実装されたあと、接続の問題または配下のデータ・ソースの問題が検出された場合も、SQLException
オブジェクトをスローする可能性があります。- 導入されたバージョン:
- 1.5
- 関連項目:
- 直列化された形式
-
-
フィールドのサマリー
フィールド 修飾子と型 フィールド 説明 static 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
インスタンスの標準機能を使ってJDBCRowSet
実装を起動するために必要な内部での構成および初期化を実行します。boolean
isReadOnly()
このRowSet
オブジェクトが読取り専用であるかどうかを示すboolean
を返します。protected void
notifyCursorMoved()
このRowSet
オブジェクトに登録されているすべてのリスナーに、カーソルが移動したことを通知します。protected void
notifyRowChanged()
このRowSet
オブジェクトに登録されているすべてのリスナーに、行が変更されたことを通知します。protected void
notifyRowSetChanged()
このRowSet
オブジェクトに登録されているすべてのリスナーに、コンテンツ全体が変更されたことを通知します。void
removeRowSetListener(RowSetListener listener)
このRowSet
オブジェクトのリスナー・リストから指定されたオブジェクトを削除します。void
setArray(int parameterIndex, Array array)
指定されたパラメータをJavaプログラミング言語のArray
オブジェクトに設定します。void
setAsciiStream(int parameterIndex, InputStream x)
このRowSet
オブジェクトのコマンド内の指定されたパラメータを、指定された入力ストリームに設定します。void
setAsciiStream(int parameterIndex, InputStream x, int length)
指定されたパラメータを、指定されたバイト数を持つ指定されたjava.io.InputStream
オブジェクトに設定します。void
setAsciiStream(String parameterName, InputStream x)
指定されたパラメータを指定された入力ストリームに設定します。void
setAsciiStream(String parameterName, InputStream x, int length)
指定されたパラメータを、指定されたバイト数を持つ指定された入力ストリームに設定します。void
setBigDecimal(int parameterIndex, BigDecimal x)
指定されたパラメータを、指定されたjava.lang.BigDecimal
値に設定します。void
setBigDecimal(String parameterName, BigDecimal x)
指定されたパラメータを、指定されたjava.math.BigDecimal
値に設定します。void
setBinaryStream(int parameterIndex, InputStream x)
このRowSet
オブジェクトのコマンド内の指定されたパラメータを、指定された入力ストリームに設定します。void
setBinaryStream(int parameterIndex, InputStream x, int length)
指定されたパラメータを、指定されたバイト数を持つ指定されたjava.io.InputStream
オブジェクトに設定します。void
setBinaryStream(String parameterName, InputStream x)
指定されたパラメータを指定された入力ストリームに設定します。void
setBinaryStream(String parameterName, InputStream x, int length)
指定されたパラメータを、指定されたバイト数を持つ指定された入力ストリームに設定します。void
setBlob(int parameterIndex, InputStream inputStream)
指定されたパラメータをInputStream
オブジェクトに設定します。void
setBlob(int parameterIndex, InputStream inputStream, long length)
指定されたパラメータをInputStream
オブジェクトに設定します。void
setBlob(int parameterIndex, Blob x)
指定されたパラメータを、指定されたJavaプログラミング言語のBlob
オブジェクトに設定します。void
setBlob(String parameterName, InputStream inputStream)
指定されたパラメータをInputStream
オブジェクトに設定します。void
setBlob(String parameterName, InputStream inputStream, long length)
指定されたパラメータをInputStream
オブジェクトに設定します。void
setBlob(String parameterName, Blob x)
指定されたパラメータを指定されたjava.sql.Blob
オブジェクトに設定します。void
setBoolean(int parameterIndex, boolean x)
指定されたパラメータを、指定されたJavaプログラミング言語のboolean
に設定します。void
setBoolean(String parameterName, boolean x)
指定されたパラメータを指定されたJavaのboolean
値に設定します。void
setByte(int parameterIndex, byte x)
指定されたパラメータを、指定されたJavaプログラミング言語のbyte
に設定します。void
setByte(String parameterName, byte x)
指定されたパラメータを指定されたJavaのbyte
値に設定します。void
setBytes(int parameterIndex, byte[] x)
指定されたパラメータを、指定されたバイト配列に設定します。void
setBytes(String parameterName, byte[] x)
指定されたパラメータを指定されたJavaのバイト配列に設定します。void
setCharacterStream(int parameterIndex, Reader reader)
このRowSet
オブジェクトのコマンド内の指定されたパラメータを、指定されたReader
オブジェクトに設定します。void
setCharacterStream(int parameterIndex, Reader reader, int length)
指定されたパラメータを、指定されたバイト数を持つjava.io.Reader
オブジェクトに設定します。void
setCharacterStream(String parameterName, Reader reader)
指定されたパラメータを指定されたReader
オブジェクトに設定します。void
setCharacterStream(String parameterName, Reader reader, int length)
指定されたパラメータを、指定された文字数である指定されたReader
オブジェクトに設定します。void
setClob(int parameterIndex, Reader reader)
指定されたパラメータをReader
オブジェクトに設定します。void
setClob(int parameterIndex, Reader reader, long length)
指定されたパラメータをReader
オブジェクトに設定します。void
setClob(int parameterIndex, Clob x)
指定されたパラメータを、指定されたJavaプログラミング言語のClob
オブジェクトに設定します。void
setClob(String parameterName, Reader reader)
指定されたパラメータをReader
オブジェクトに設定します。void
setClob(String parameterName, Reader reader, long length)
指定されたパラメータをReader
オブジェクトに設定します。void
setClob(String parameterName, Clob x)
指定されたパラメータを指定されたjava.sql.Clob
オブジェクトに設定します。void
setCommand(String cmd)
このRowSet
オブジェクトのcommand
プロパティとして指定のString
オブジェクトを設定し、パラメータがある場合は、以前のコマンド用に設定されたものなのでクリアします。void
setConcurrency(int concurrency)
このRowSet
オブジェクトの並行性を指定された並行性に設定します。void
setDataSourceName(String name)
このRowSet
オブジェクトのDataSource
nameプロパティとして指定の論理名を設定し、このRowSet
オブジェクトのUrlプロパティをnull
に設定します。void
setDate(int parameterIndex, Date x)
指定されたパラメータを、指定されたjava.sql.Date
値に設定します。void
setDate(int parameterIndex, Date x, Calendar cal)
指定されたパラメータを指定されたjava.sql.Date
オブジェクトに設定します。void
setDate(String parameterName, Date x)
アプリケーションを実行している仮想マシンのデフォルトのタイムゾーンを使用して、指定されたパラメータを指定されたjava.sql.Date
値に設定します。void
setDate(String parameterName, Date x, Calendar cal)
指定されたCalendar
オブジェクトを使用して、指定されたパラメータを指定されたjava.sql.Date
値に設定します。void
setDouble(int parameterIndex, double x)
指定されたパラメータを、指定されたJavaプログラミング言語のdouble
に設定します。void
setDouble(String parameterName, double x)
指定されたパラメータを指定されたJavaのdouble
値に設定します。void
setEscapeProcessing(boolean enable)
データベースにSQL文を送信する前に、ドライバがエスケープ構文をスキャンしてエスケープ置換を行うかどうかを示す指定のboolean
に設定します。void
setFetchDirection(int direction)
このRowSet
オブジェクト内の行が処理される方向について、ドライバにパフォーマンス・ヒントを与えます。void
setFetchSize(int rows)
このRowSet
オブジェクトのフェッチ・サイズとして、指定の行数を設定します。void
setFloat(int parameterIndex, float x)
指定されたパラメータを、指定されたJavaプログラミング言語のfloat
に設定します。void
setFloat(String parameterName, float x)
指定されたパラメータを指定されたJavaのfloat
値に設定します。void
setInt(int parameterIndex, int x)
指定されたパラメータを、指定されたJavaプログラミング言語のint
値に設定します。void
setInt(String parameterName, int x)
指定されたパラメータを指定されたJavaのint
値に設定します。void
setLong(int parameterIndex, long x)
指定されたパラメータを、指定されたJavaプログラミング言語のlong
に設定します。void
setLong(String parameterName, long x)
指定されたパラメータを指定されたJavaのlong
値に設定します。void
setMaxFieldSize(int max)
このRowSet
オブジェクト内の列の値として使用可能な最大バイト数を、指定した値に設定します。void
setMaxRows(int max)
このRowSet
オブジェクトに含めることのできる最大の行数を、指定した値に設定します。void
setNCharacterStream(int parameterIndex, Reader value)
このRowSet
オブジェクトのコマンド内の指定されたパラメータを、Reader
オブジェクトに設定します。void
setNCharacterStream(int parameterIndex, Reader value, long length)
指定されたパラメータをReader
オブジェクトに設定します。void
setNCharacterStream(String parameterName, Reader value)
指定されたパラメータをReader
オブジェクトに設定します。void
setNCharacterStream(String parameterName, Reader value, long length)
指定されたパラメータをReader
オブジェクトに設定します。void
setNClob(int parameterIndex, Reader reader)
指定されたパラメータをReader
オブジェクトに設定します。void
setNClob(int parameterIndex, Reader reader, long length)
指定されたパラメータをReader
オブジェクトに設定します。void
setNClob(int parameterIndex, NClob value)
指定されたパラメータをjava.sql.NClob
オブジェクトに設定します。void
setNClob(String parameterName, Reader reader)
指定されたパラメータをReader
オブジェクトに設定します。void
setNClob(String parameterName, Reader reader, long length)
指定されたパラメータをReader
オブジェクトに設定します。void
setNClob(String parameterName, NClob value)
指定されたパラメータをjava.sql.NClob
オブジェクトに設定します。void
setNString(int parameterIndex, String value)
指定されたパラメータを指定されたString
オブジェクトに設定します。void
setNString(String parameterName, String value)
指定されたパラメータを指定されたString
オブジェクトに設定します。void
setNull(int parameterIndex, int sqlType)
指定されたパラメータをSQLNULL
に設定します。void
setNull(int parameterIndex, int sqlType, String typeName)
指定されたパラメータをSQLNULL
に設定します。void
setNull(String parameterName, int sqlType)
指定されたパラメータをSQLNULL
に設定します。void
setNull(String parameterName, int sqlType, String typeName)
指定されたパラメータをSQLNULL
に設定します。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)
このJDBCRowSet
オブジェクトのトランザクション遮断プロパティとして、指定の定数を設定します。void
setType(int type)
このRowSet
オブジェクトに特定の型を設定します。void
setTypeMap(Map<String,Class<?>> map)
このRowSet
オブジェクトのConnection
オブジェクトに関連付けられた型マップとして、指定のjava.util.Map
オブジェクトをインストールします。void
setUnicodeStream(int parameterIndex, InputStream x, int length)
非推奨。getCharacterStreamはその場所で使用する必要がありますvoid
setUrl(String url)
このRowSet
オブジェクトのUrlプロパティとして指定のString
オブジェクトを設定し、dataSource nameプロパティをnull
に設定します。void
setURL(int parameterIndex, URL x)
指定されたパラメータを、指定されたjava.net.URL
値に設定します。void
setUsername(String name)
このRowSet
オブジェクトのusernameプロパティとして、指定のユーザー名を設定します。
-
-
-
フィールドの詳細
-
UNICODE_STREAM_PARAM
public static final int UNICODE_STREAM_PARAM
Unicodeストリームのパラメータを持つRowSetReaderImpl
オブジェクトを示す定数です。 このRowSetReaderImpl
オブジェクトは、SyncFactory
staticファクトリSPIメカニズムで定義されたabstractクラスSyncProvider
の拡張として提供されます。- 関連項目:
- 定数フィールド値
-
BINARY_STREAM_PARAM
public static final int BINARY_STREAM_PARAM
バイナリ・ストリームのパラメータを持つRowSetReaderImpl
オブジェクトを示す定数です。RowSetReaderImpl
オブジェクトは、SyncFactory
staticファクトリSPIメカニズムで定義されたabstractクラスSyncProvider
の拡張として提供されます。- 関連項目:
- 定数フィールド値
-
ASCII_STREAM_PARAM
public static final int ASCII_STREAM_PARAM
ASCIIストリームのパラメータを持つRowSetReaderImpl
オブジェクトを示す定数です。RowSetReaderImpl
オブジェクトは、SyncFactory
staticファクトリSPIメカニズムで定義されたabstractクラスSyncProvider
の拡張として提供されます。- 関連項目:
- 定数フィールド値
-
binaryStream
protected InputStream binaryStream
メソッドgetBinaryStream
によって返されたInputStream
オブジェクトであり、ResultSet
インタフェースで指定されています。
-
unicodeStream
protected InputStream unicodeStream
メソッドgetUnicodeStream
によって返されたInputStream
オブジェクトであり、ResultSet
インタフェースで指定されています。
-
asciiStream
protected InputStream asciiStream
メソッドgetAsciiStream
によって返されたInputStream
オブジェクトであり、ResultSet
インタフェースで指定されています。
-
charStream
protected Reader charStream
メソッドgetCharacterStream
によって返されたReader
オブジェクトであり、ResultSet
インタフェースで指定されています。
-
-
メソッドの詳細
-
initParams
protected void initParams()
BaseRowSet
インスタンスの標準機能を使ってJDBCRowSet
実装を起動するために必要な内部での構成および初期化を実行します。 すべてのパラメータを正しく初期化するには、RowSet
オブジェクトがインスタンス化された後でこのメソッドが呼び出されるべきです。 このメソッドは、決してアプリケーションによって呼び出されるべきではなく、このクラスを拡張したRowSet
実装から呼び出されます。
-
addRowSetListener
public void addRowSetListener(RowSetListener listener)
リスナーは、このRowSet
オブジェクトでイベントが発生するたびに通知を受けます。リスナーは、たとえば、現在の
RowSet
オブジェクトの状態を正確に反映するために更新する必要がある表やグラフです。ノート:
RowSetListener
オブジェクトがnull
の場合、このメソッドは通知なしでnull
値を破棄し、リスナーのセットにnull参照を追加しません。ノート: リスナーがすでに設定されていて、新しい
RowSetListener
インスタンスが、このRowSet
からイベント通知を受け取るためにすでに登録されているリスナーのセットに追加されている場合。- パラメータ:
listener
-javax.sql.RowSetListener
インタフェースを実装し、このRowSet
オブジェクトでイベントが発生したときに通知を受けるオブジェクト。nullの場合もある。- 関連項目:
removeRowSetListener(javax.sql.RowSetListener)
-
removeRowSetListener
public void removeRowSetListener(RowSetListener listener)
このRowSet
オブジェクトのリスナー・リストから指定されたオブジェクトを削除します。 登録済みのリスナー以外が引数として指定された場合、このメソッドは何も行いません。 ノート:RowSetListener
オブジェクトがnull
の場合、このメソッドは通知なしでnull
値を破棄します。- パラメータ:
listener
- このRowSet
オブジェクトのリスナー・リストに含まれるRowSetListener
オブジェクト- 関連項目:
addRowSetListener(javax.sql.RowSetListener)
-
notifyCursorMoved
protected void notifyCursorMoved() throws SQLException
このRowSet
オブジェクトに登録されているすべてのリスナーに、カーソルが移動したことを通知します。アプリケーションがカーソルを移動するメソッドを呼び出すと、呼び出されたメソッドはカーソルを移動し、このメソッドを内部で呼び出します。 アプリケーションがこのメソッドを直接呼び出すことはありません。
- 例外:
SQLException
-BaseRowSet
abstractクラスを拡張するクラスがRowSet
インタフェースまたはそのサブインタフェースを実装していない場合。
-
notifyRowChanged
protected void notifyRowChanged() throws SQLException
このRowSet
オブジェクトに登録されているすべてのリスナーに、行が変更されたことを通知します。アプリケーションが、行を変更するメソッド(
CachedRowSet
メソッドinsertRow
、updateRow
、deleteRow
など)を呼び出すと、呼び出されたメソッドは内部でnotifyRowChanged
を呼び出します。 アプリケーションがこのメソッドを直接呼び出すことはありません。- 例外:
SQLException
-BaseRowSet
abstractクラスを拡張するクラスがRowSet
インタフェースまたはそのサブインタフェースを実装していない場合。
-
notifyRowSetChanged
protected void notifyRowSetChanged() throws SQLException
このRowSet
オブジェクトに登録されているすべてのリスナーに、コンテンツ全体が変更されたことを通知します。アプリケーションが
RowSet
オブジェクトのコンテンツ全体を変更するメソッド(CachedRowSet
メソッドexecute
、populate
、restoreOriginal
、release
など)を呼び出すと、呼び出されたメソッドは内部で直接的または間接的にnotifyRowSetChanged
を呼び出します。 アプリケーションがこのメソッドを直接呼び出すことはありません。- 例外:
SQLException
-BaseRowSet
abstractクラスを拡張するクラスがRowSet
インタフェースまたはそのサブインタフェースを実装していない場合。
-
getCommand
public String getCommand()
このRowSet
オブジェクトのコマンドになっているSQLクエリーを取得します。 コマンド・プロパティには、このRowSet
オブジェクトを生成するために実行されるクエリーが含まれます。このメソッドから返されるSQLクエリーは、
RowSet
メソッド(execute
、populate
など)によって使用されます。これらのメソッドは、BaseRowSet
abstractクラスを拡張するあらゆるクラスに実装可能であり、標準JSR-114RowSet
インタフェースを1個以上実装します。RowSet
オブジェクトのリーダーは、コマンドを使って、ResultSet
オブジェクトを取得します。 次に、ResultSet
オブジェクトからデータを読み取り、このデータを使ってこのRowSet
オブジェクトを生成します。command
プロパティのデフォルト値はnull
です。- 戻り値:
- この
RowSet
オブジェクトのcommand
プロパティの値を示すString
。null
の場合もある - 関連項目:
setCommand(java.lang.String)
-
setCommand
public void setCommand(String cmd) throws SQLException
このRowSet
オブジェクトのcommand
プロパティとして指定のString
オブジェクトを設定し、パラメータがある場合は、以前のコマンド用に設定されたものなのでクリアします。RowSet
オブジェクトがコマンドをサポートしないソース(スプレッドシート、その他の表形式のファイル)からデータを取得する場合、command
プロパティは不要です。 つまり、このプロパティはオプションであり、null
の場合もあります。- パラメータ:
cmd
- このRowSet
オブジェクトのcommandプロパティとして設定されるSQLクエリーを含むString
オブジェクト。null
の場合もあるが、空文字列にはならない- 例外:
SQLException
- コマンドの値として空文字列が提供された場合- 関連項目:
getCommand()
-
getUrl
public String getUrl() throws SQLException
JDBCテクノロジを使用可能なドライバを使って、このRowSet
オブジェクトのjavax.sql.Reader
オブジェクトがリレーショナル・データベースとの接続を作成するために使用するJDBC URLを取得します。配下のデータ・ソースがSQLデータ・ソースでない場合(スプレッドシートやXMLデータ・ソースの場合)、
Url
プロパティはnull
になります。- 戻り値:
- この
RowSet
オブジェクトの接続を確立するために使用されるJDBC URLを含むString
オブジェクト。設定しない場合、null
(デフォルト値)になる - 例外:
SQLException
- URL値の取得中にエラーが発生した場合- 関連項目:
setUrl(java.lang.String)
-
setUrl
public void setUrl(String url) throws SQLException
このRowSet
オブジェクトのUrlプロパティとして指定のString
オブジェクトを設定し、dataSource nameプロパティをnull
に設定します。 Urlプロパティは、JDBCテクノロジを使用可能なドライバ(JDBCドライバ)とDriverManager
を使って接続を作成するときに使用するJDBC URLです。 特定のドライバ用の正しいJDBC URLは、ドライバのマニュアルに記載されています。 JDBC URLがどのように形成されるかについてのガイドラインはありますが、ドライバ・ベンダーは0
(空の文字列)の長さを持つオブジェクト以外のString
オブジェクトを指定できます。DriverManager
ではなくDataSource
オブジェクトを使って接続を確立した場合、Urlプロパティの設定はオプションになります。 ドライバは、URLプロパティかdataSourceNameプロパティ(最近指定されたもの)を使って接続を作成します。 JDBC URLを使用する場合、アプリケーションは、RowSet
オブジェクトを使ってデータベースに接続する前に、JDBC URLを受け入れるJDBCドライバをロードする必要があります。RowSet
オブジェクトは、データの読み取りまたは書込みを行うため、内部でURLを使用してデータベース接続を作成します。- パラメータ:
url
- このRowSet
オブジェクトのデータベース接続を確立するために使用されるJDBC URLを含むString
オブジェクト。null
の場合もあるが、空文字列にはならない- 例外:
SQLException
- Urlプロパティの設定時にエラーが発生した場合、または長さ0
(空文字列)のパラメータが提供された場合- 関連項目:
getUrl()
-
getDataSourceName
public String getDataSourceName()
Java Naming and Directory Interface (JNDI) APIを使用するネーム・サービスに提供されるとjavax.sql.DataSource
オブジェクトを取得する論理名を返します。 このDataSource
オブジェクトを使って、このオブジェクトが示すデータ・ソースとの接続を確立することができます。ユーザーは、urlまたはdata source nameプロパティのいずれかを設定する必要があります。 ドライバは、接続を確立するために一番最近設定されたプロパティ・セットを使用します。
- 戻り値:
- 接続の作成に使用する
DataSource
オブジェクトを識別するString
オブジェクト。論理名が設定されていない場合、null
を返す。 - 関連項目:
setDataSourceName(java.lang.String)
-
setDataSourceName
public void setDataSourceName(String name) throws SQLException
このRowSet
オブジェクトのDataSource
nameプロパティとして指定の論理名を設定し、このRowSet
オブジェクトのUrlプロパティをnull
に設定します。 JNDIネーム・サービス内でこの名前がDataSource
オブジェクトにバインドされていないと、アプリケーション内でその名前を使用してルックアップを行い、バインドされたDataSource
オブジェクトを取得できません。 その後、DataSource
オブジェクトを使用してこのオブジェクトが表すデータ・ソースへの接続を確立できます。ユーザーは、UrlプロパティとdataSourceNameプロパティのいずれかを設定する必要があります。 両方のプロパティを設定した場合、ドライバは、最近設定されたプロパティを使用します。
- パラメータ:
name
- 名前を持つString
オブジェクト。JNDIテクノロジベースのネーム・サービスにこの名前を渡すことにより、接続の取得に使用するDataSource
オブジェクトを取得できる。null
でもよいが、空の文字列は不可- 例外:
SQLException
-DataSource
名として空文字列が指定された場合- 関連項目:
getDataSourceName()
-
getUsername
public String getUsername()
データベース接続の作成に使用するユーザー名を返します。 usernameプロパティは直列化されないので、実行時、execute
メソッドの呼出しの前に設定されます。- 戻り値:
- 接続を作成するためにデータ・ソースに提供されるユーザー名を含む
String
オブジェクト。設定しない場合、null
(デフォルト値)になる - 関連項目:
setUsername(java.lang.String)
-
setUsername
public void setUsername(String name)
このRowSet
オブジェクトのusernameプロパティとして、指定のユーザー名を設定します。 usernameプロパティは直列化されないので、実行時、execute
メソッドの呼出しの前に設定されます。- パラメータ:
name
- 接続を作成するためにデータ・ソースに提供されるユーザー名を含むString
オブジェクト。 nullも指定できる。- 関連項目:
getUsername()
-
getPassword
public String getPassword()
このRowSet
オブジェクトのデータベース接続を作成するために使用するパスワードを返します。 passwordプロパティは直列化されないので、実行時、execute
メソッドの呼出しの前に設定されます。 デフォルト値はnull
- 戻り値:
- 接続を作成する際データベースに提供する必要があるパスワードを表す
String
オブジェクト - 関連項目:
setPassword(java.lang.String)
-
setPassword
public void setPassword(String pass)
このRowSet
オブジェクトのデータベース接続を作成するために使用するパスワードとして、指定のString
オブジェクトを設定します。 passwordプロパティは直列化されないので、実行時、execute
メソッドの呼出しの前に設定されます。- パラメータ:
pass
- 接続を作成する際データベースに提供されるパスワードを表すString
オブジェクト。 nullも指定できる。- 関連項目:
getPassword()
-
setType
public void setType(int type) throws SQLException
このRowSet
オブジェクトに特定の型を設定します。 デフォルトの型はResultSet.TYPE_SCROLL_INSENSITIVE
です。- パラメータ:
type
- 次の定数のいずれか。ResultSet.TYPE_FORWARD_ONLY
、ResultSet.TYPE_SCROLL_INSENSITIVE
、またはResultSet.TYPE_SCROLL_SENSITIVE
- 例外:
SQLException
- パラメータとして次の定数以外が提供された場合。ResultSet.TYPE_FORWARD_ONLY
またはResultSet.TYPE_SCROLL_INSENSITIVE
ResultSet.TYPE_SCROLL_SENSITIVE
- 関連項目:
getConcurrency()
,getType()
-
getType
public int getType() throws SQLException
このRowSet
オブジェクトの型を返します。 型は、最初、RowSet
オブジェクトを作成した文によって決定されます。RowSet
オブジェクトは、いつでもsetType
メソッドを呼び出して型を変更できます。 デフォルトはTYPE_SCROLL_INSENSITIVE
です。- 戻り値:
- このJDBC
RowSet
オブジェクトの型。次のいずれかでなければならない。ResultSet.TYPE_FORWARD_ONLY
、ResultSet.TYPE_SCROLL_INSENSITIVE
、またはResultSet.TYPE_SCROLL_SENSITIVE
- 例外:
SQLException
- このRowSet
オブジェクトの型の取得時にエラーが発生した場合- 関連項目:
setType(int)
-
setConcurrency
public void setConcurrency(int concurrency) throws SQLException
このRowSet
オブジェクトの並行性を指定された並行性に設定します。 接続されている場合でも接続されていない場合でも、RowSet
オブジェクトのデフォルトの並行性はResultSet.CONCUR_UPDATABLE
です。ただし、このメソッドは、並行性を変更したいときいつでも呼び出すことができます。- パラメータ:
concurrency
- 次の定数のいずれか。ResultSet.CONCUR_READ_ONLY
またはResultSet.CONCUR_UPDATABLE
- 例外:
SQLException
- パラメータとして次の定数以外が提供された場合。ResultSet.CONCUR_UPDATABLE
またはResultSet.CONCUR_READ_ONLY
- 関連項目:
getConcurrency()
,isReadOnly()
-
isReadOnly
public boolean isReadOnly()
このRowSet
オブジェクトが読取り専用であるかどうかを示すboolean
を返します。 読取り専用のRowSet
オブジェクトを更新しようとすると、SQLException
がスローされます。 デフォルトでは、更新が可能であれば、行セットの更新も可能です。- 戻り値:
- この
RowSet
オブジェクトを更新できない場合はtrue
、そうでない場合はfalse
- 関連項目:
setConcurrency(int)
,setReadOnly(boolean)
-
setReadOnly
public void setReadOnly(boolean value)
このRowSet
オブジェクトのreadOnlyプロパティとしてboolean
を設定します。- パラメータ:
value
- このRowSet
オブジェクトが読取り専用の場合はtrue
、更新可能な場合はfalse
-
getTransactionIsolation
public int getTransactionIsolation()
このRowSet
オブジェクトの接続のトランザクション遮断プロパティを返します。 このプロパティは、トランザクション用として要求されたトランザクション遮断レベルを表します。RowSet
実装(未接続の環境で動作するCachedRowSet
など)には、SyncProvider
オブジェクトにより、補足ロックやデータの整合性のオプションが提供されます。 次のオプションは、接続済みRowSet
オブジェクト(JdbcRowSet
オブジェクト)専用です。- 戻り値:
- 次の定数のいずれか。
Connection.TRANSACTION_NONE
、Connection.TRANSACTION_READ_UNCOMMITTED
、Connection.TRANSACTION_READ_COMMITTED
、Connection.TRANSACTION_REPEATABLE_READ
、またはConnection.TRANSACTION_SERIALIZABLE
- 関連項目:
SyncFactory
、SyncProvider
、setTransactionIsolation(int)
-
setTransactionIsolation
public void setTransactionIsolation(int level) throws SQLException
このJDBCRowSet
オブジェクトのトランザクション遮断プロパティとして、指定の定数を設定します。 DBMSは、可能な場合は、このトランザクション遮断レベルを使用します。RowSet
実装(未接続の環境で動作するCachedRowSet
など)には、使用するSyncProvider
オブジェクトにより、補足ロックやデータの整合性のオプションが提供されます。 次のオプションは、接続済みRowSet
オブジェクト(JdbcRowSet
オブジェクト)専用です。- パラメータ:
level
- 次の昇順でリストされた定数のいずれか。Connection.TRANSACTION_NONE
、Connection.TRANSACTION_READ_UNCOMMITTED
、Connection.TRANSACTION_READ_COMMITTED
、Connection.TRANSACTION_REPEATABLE_READ
、またはConnection.TRANSACTION_SERIALIZABLE
- 例外:
SQLException
- 指定のパラメータがConnection定数でない場合- 関連項目:
SyncFactory
、SyncProvider
、getTransactionIsolation()
-
getTypeMap
public Map<String,Class<?>> getTypeMap()
このRowSet
オブジェクトのConnection
オブジェクトに関連付けられた型マップを取得します。JDBC 3.0 APIをサポートするドライバは、型マップが関連付けられた
Connection
オブジェクトを作成します。 この型マップは、初期状態では空ですが、1つ以上の完全修飾SQL名と、指定のSQL値のマップ先クラスを示すClass
オブジェクトを含めることができます。 その他の代替となる型マップが存在しない場合、カスタム型マッピングには、接続の型マップで指定された型マッピングが使用されます。カスタム・マッピングを実行できるメソッドに、明示的に型マップを提供した場合、この型マップは接続の型マップより優先されます。
- 戻り値:
java.util.Map
オブジェクト。RowSet
オブジェクトの接続に使用する型マップ
-
setTypeMap
public void setTypeMap(Map<String,Class<?>> map)
このRowSet
オブジェクトのConnection
オブジェクトに関連付けられた型マップとして、指定のjava.util.Map
オブジェクトをインストールします。 メソッドに別の型マップが明示的に指定されないかぎり、この型マップに示されたカスタム・マッピングが使用されます。明示的に指定された場合、その指定された型マップが使用されます。- パラメータ:
map
- ユーザー定義型(UDT)のSQL型名とJavaプログラミング言語のクラスのマッピングを含むjava.util.Map
オブジェクト。Map
オブジェクトの各エントリは、UDTの完全修飾SQL名と、そのUDTのSQLData
実装のClass
オブジェクトで構成される。null
も可。
-
getMaxFieldSize
public int getMaxFieldSize() throws SQLException
このRowSet
オブジェクト内の列の値として使用可能な最大バイト数を取得します。 ただし、次の型の値を格納する列には、バイト数の制限が課される:BINARY
、VARBINARY
、LONGVARBINARY
、CHAR
、VARCHAR
、およびLONGVARCHAR
。 制限値を超えたデータは通知なしに破棄されます。- 戻り値:
- 現在の最大列サイズ制限値を示す
int
。0は制限がないことを表す - 例外:
SQLException
- 最大列サイズ制限値の決定時に内部でエラーが発生した場合
-
setMaxFieldSize
public void setMaxFieldSize(int max) throws SQLException
このRowSet
オブジェクト内の列の値として使用可能な最大バイト数を、指定した値に設定します。 ただし、次の型の値を格納する列には、バイト数の制限が課される:BINARY
、VARBINARY
、LONGVARBINARY
、CHAR
、VARCHAR
、およびLONGVARCHAR
。 制限値を超えたデータは通知なしに破棄されます。 移植性を高めるため、256より大きい値を使用することをお勧めします。- パラメータ:
max
- 新しい最大列サイズ制限値を示すint
。0は制限がないことを表す- 例外:
SQLException
- (1)最大列サイズ制限値の設定時に内部エラーが発生した場合、(2) 0より小さいサイズが設定された場合
-
getMaxRows
public int getMaxRows() throws SQLException
このRowSet
オブジェクトに含めることのできる最大行数を取得します。 制限値を超えた行は通知なしに除外されます。- 戻り値:
- 現在の最大行数を示す
int
。0は制限がないことを表す - 例外:
SQLException
-Rowset
オブジェクトに含めることができる最大行数の決定時に内部でエラーが発生した場合
-
setMaxRows
public void setMaxRows(int max) throws SQLException
このRowSet
オブジェクトに含めることのできる最大の行数を、指定した値に設定します。 制限値を超えた行は通知なしに除外されます。- パラメータ:
max
- 現在の最大行数を示すint
。0は制限がないことを表す- 例外:
SQLException
- JDBCRowSet
オブジェクトに含めることができる最大行数の設定時に内部でエラーが発生した場合、maxに0
より小さい値が指定された場合、またはmaxにRowSet
のfetchSize
より小さい値が指定された場合
-
setEscapeProcessing
public void setEscapeProcessing(boolean enable) throws SQLException
データベースにSQL文を送信する前に、ドライバがエスケープ構文をスキャンしてエスケープ置換を行うかどうかを示す指定のboolean
に設定します。 デフォルトでは、ドライバはエスケープ処理を行います。ノート:
PreparedStatement
オブジェクトは、通常呼び出す前に構文解析されているので、用意された文に対しエスケープ処理を無効にしても効果はありません。- パラメータ:
enable
- エスケープ処理を有効にする場合はtrue
、無効にする場合はfalse
- 例外:
SQLException
- 配下のJDBCテクノロジを使用可能なドライバがエスケープ構文を処理するように設定している途中でエラーが発生した場合
-
getQueryTimeout
public int getQueryTimeout() throws SQLException
ドライバがクエリーの実行を待つ最大秒数を取得します。 この制限時間を経過すると、SQLException
がスローされます。- 戻り値:
- 現在のクエリー・タイムアウトの制限値(秒数)。ゼロは無制限を意味する
- 例外:
SQLException
- クエリー・タイムアウト値の決定時にエラーが発生した場合
-
setQueryTimeout
public void setQueryTimeout(int seconds) throws SQLException
ドライバがクエリーの実行を待つ最大秒数を設定します。 この制限時間を経過すると、SQLException
がスローされます。- パラメータ:
seconds
- 新しいクエリー・タイムアウトの制限値の秒数。ゼロは無制限を意味する。ゼロより小さい値は使用できない- 例外:
SQLException
- クエリー・タイムアウト値の設定時にエラーが発生した場合、またはクエリー・タイムアウト値が0より小さい場合
-
getShowDeleted
public boolean getShowDeleted() throws SQLException
削除マークが付けられた行を現在の行とともに表示するかどうかを示すboolean
を取得します。 デフォルト値はfalse
です。ノート: 削除された行の表示を許可すると、一部のメソッドの動作が複雑になります。 ただし、この機能を活用する必要が生じるのは高度なアプリケーションだけなので、ほとんどの
RowSet
オブジェクト・ユーザーは単純にこの余分な詳細を無視してかまいません。- 戻り値:
- 削除された行を表示する場合は
true
、そうでない場合はfalse
- 例外:
SQLException
- 削除された行を表示するかどうかを決定している途中でエラーが発生した場合- 関連項目:
setShowDeleted(boolean)
-
setShowDeleted
public void setShowDeleted(boolean value) throws SQLException
showDeleted
プロパティとして、削除マーク付きの行を現在の行とともに表示するかどうかを指定するboolean
を設定します。- パラメータ:
value
- 削除された行を表示する場合はtrue
、そうでない場合はfalse
- 例外:
SQLException
- 削除された行を表示するかどうかを設定している途中でエラーが発生した場合- 関連項目:
getShowDeleted()
-
getEscapeProcessing
public boolean getEscapeProcessing() throws SQLException
このRowSet
オブジェクトでエスケープ処理が有効になっているかどうかを確認します。- 戻り値:
- エスケープ処理が有効な場合は
true
、そうでない場合はfalse
- 例外:
SQLException
- エスケープ処理の有効または無効を決定している途中でエラーが発生した場合、または内部エスケープ処理トリガーが有効になっていない場合
-
setFetchDirection
public void setFetchDirection(int direction) throws SQLException
このRowSet
オブジェクト内の行が処理される方向について、ドライバにパフォーマンス・ヒントを与えます。 このヒントは、無視されることもあります。RowSet
オブジェクトは、データの取得先のResultSet
オブジェクトのデフォルト・プロパティを継承します。ResultSet
オブジェクトのデフォルトのフェッチ方向は、このオブジェクトを作成したStatement
によって設定されます。このメソッドは、JDBCドライバを使ってデータベースに接続されている
RowSet
オブジェクトだけに適用されます。RowSet
オブジェクトは、このメソッドを使って、いつでもフェッチ方向の設定を変更できます。- パラメータ:
direction
-ResultSet.FETCH_FORWARD
、ResultSet.FETCH_REVERSE
、ResultSet.FETCH_UNKNOWN
のいずれか- 例外:
SQLException
- (1)RowSet
の型がTYPE_FORWARD_ONLY
であり、FETCH_FORWARD
以外のフェッチ方向が指定された場合、(2)フェッチ方向が次のいずれでもない場合。ResultSet.FETCH_FORWARD、ResultSet.FETCH_REVERSE、またはResultSet.FETCH_UNKNOWNのいずれか- 関連項目:
getFetchDirection()
-
getFetchDirection
public int getFetchDirection() throws SQLException
このRowSet
オブジェクトの現在のフェッチ方向の設定を取得します。 デフォルトの型はResultSet.FETCH_FORWARD
- 戻り値:
ResultSet.FETCH_FORWARD
、ResultSet.FETCH_REVERSE
、ResultSet.FETCH_UNKNOWN
のいずれか- 例外:
SQLException
- 行をフェッチする現在のフェッチ方向を決定している途中でエラーが発生した場合- 関連項目:
setFetchDirection(int)
-
setFetchSize
public void setFetchSize(int rows) throws SQLException
このRowSet
オブジェクトのフェッチ・サイズとして、指定の行数を設定します。 フェッチ・サイズは、JDBCテクノロジを使用可能なドライバ(JDBCドライバ)に、このRowSet
オブジェクトがより多くの行を必要とするときデータベースからフェッチされる行数を示すヒントとなります。 フェッチ・サイズとしてゼロが指定された場合、ドライバは値を無視し、最適なフェッチ・サイズを独自に推測します。RowSet
オブジェクトは、データの取得先のResultSet
オブジェクトのデフォルト・プロパティを継承します。ResultSet
オブジェクトのデフォルトのフェッチ・サイズは、このオブジェクトを作成したStatement
によって設定されます。このメソッドは、JDBCドライバを使ってデータベースに接続されている
RowSet
オブジェクトだけに適用されます。JdbcRowSet
のように、RowSet
実装が接続されている場合は、配下のJDBCドライバに対して直接的な影響を及ぼします。RowSet
オブジェクトは、このメソッドを使って、いつでもフェッチ・サイズの設定を変更できます。CachedRowSet
などのRowSet
実装は、未接続環境で動作します。この場合、使用されるSyncProvider
オブジェクトは、フェッチ・サイズを利用してデータ・ソースをポーリングし、フェッチ・サイズを超えない範囲で行数を取得します。この行数は、元のクエリーから返される実際の行数のサブセットになります。 これは、未接続のRowSet
オブジェクトで採用された特定のSyncProvider
オブジェクトによって決まる実装上の差異です。- パラメータ:
rows
- フェッチされる行数。0
の場合、ドライバが最適フェッチ・サイズを決定する。0
より小さい値と、このRowSet
オブジェクトに許可された最大行数(getMaxRows()
メソッドの呼出しによって返される値)を超える値は指定できない- 例外:
SQLException
- 指定されたフェッチ・サイズが0
より小さい場合、または最大行数を超過した場合- 関連項目:
getFetchSize()
-
getFetchSize
public int getFetchSize() throws SQLException
このRowSet
オブジェクトのフェッチ・サイズを返します。 デフォルト値はゼロです。- 戻り値:
- この
RowSet
オブジェクトがデータベースからより多くの行を取得する必要がある場合に、フェッチ・サイズとして提示される行数 - 例外:
SQLException
- 現在のフェッチ・サイズ内で行数の決定中にエラーが発生した場合- 関連項目:
setFetchSize(int)
-
getConcurrency
public int getConcurrency() throws SQLException
このRowSet
オブジェクトの並行処理を返します。RowSet
オブジェクトが接続されている場合も、未接続の場合も、デフォルト値はCONCUR_UPDATABLE
です。アプリケーションは、いつでも
setConcurrency
メソッドを呼び出して、RowSet
オブジェクトの並行性を変更できます。- 戻り値:
- この
RowSet
オブジェクトの並行性の型。次のいずれかでなければならない。ResultSet.CONCUR_READ_ONLY
またはResultSet.CONCUR_UPDATABLE
- 例外:
SQLException
- このRowSet
オブジェクトの並行性の取得時にエラーが発生した場合- 関連項目:
setConcurrency(int)
,isReadOnly()
-
setNull
public void setNull(int parameterIndex, int sqlType) throws SQLException
指定されたパラメータをSQLNULL
に設定します。 パラメータのSQL型は、java.sql.Types
で定義された型コードの1つを使用して指定する必要があります。 このSQL型は、2番目のパラメータに指定されます。2番目のパラメータは、DBMSに対して、
NULL
に設定される値のデータ型を通知します。 この情報は一部のDBMSで必要とされるため、コードの移植性を向上させるためには、この情報が必要となります。このメソッドで設定されたパラメータ値は内部で格納され、
execute
メソッドの呼出し時に、このRowSet
オブジェクトのコマンド内の適切なパラメータとして提供されます。execute
、populate
などのメソッドは、このクラスを拡張し、標準JSR-114RowSet
インタフェースを1つ以上実装するクラスで提供される必要があります。ノート:
JdbcRowSet
はpopulate
メソッドを必要としません。このメソッドは、このクラス内に定義されていません。このバージョンの
setNull
を呼び出した後でメソッドgetParams
を呼び出すと、設定されたパラメータ値を含むObject
配列が返されます。 その配列内で、このメソッドで設定された値を表す要素はそれ自体が配列になります。 その配列の最初の要素はnull
です。 2番目の要素は、sqlTypeに設定された値です。 パラメータ番号はメソッドgetParams
から返される配列内での要素の位置によって示され、最初の要素は最初のプレースホルダー・パラメータの値、2番目の要素は2番目のプレースホルダー・パラメータの値、といった具合になります。 言い換えると、2番目のプレースホルダー・パラメータをnull
に設定する場合、その値を含む配列は、getParams
から返される配列内の2番目の要素になります。配列内の要素の番号付けはゼロから開始されるので、プレースホルダー番号parameterIndexに対応する配列要素はparameterIndex -1になります。
- パラメータ:
parameterIndex
- このRowSet
オブジェクトのコマンド内の、設定対象となるプレースホルダー・パラメータの順序番号。 最初のパラメータが1、2番目のパラメータが2、といった具合になる。1
以上でなければいけないsqlType
-Types
クラス内に定義されたSQL型コードを表すint
。 非標準のsqlTypeが提供された場合、このメソッドはSQLException
をスローしない。 この動作により、非標準のSQL型が暗黙的にサポートされる。- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合、または指定されたパラメータ・インデックスが範囲外である場合- 関連項目:
getParams()
-
setNull
public void setNull(int parameterIndex, int sqlType, String typeName) throws SQLException
指定されたパラメータをSQLNULL
に設定します。 このバージョンのメソッドsetNull
はユーザー定義パラメータおよびREF
パラメータを対象としていますが、このメソッドは任意のJDBC型のnullパラメータを設定するために使用できます。 ユーザー定義型は次のとおりです。STRUCT
、DISTINCT
、JAVA_OBJECT
および名前付き配列型。ノート: 移植性を実現するためには、アプリケーションは
NULL
のユーザー定義パラメータまたはREF
パラメータを指定するときにSQL型コードおよび完全修飾SQL型名を指定しなければいけません。 ユーザー定義型の場合、名前はパラメータ自体の型名です。REF
パラメータの場合、名前は参照される型の型名です。 JDBCテクノロジを使用可能なドライバが型コードまたは型名の情報を必要としない場合、それは無視されます。パラメータがユーザー定義型または
REF
型でない場合は、指定したtypeName
パラメータは無視されます。このメソッドで設定されたパラメータ値は内部で格納され、
execute
メソッドの呼出し時に、このRowSet
オブジェクトのコマンド内の適切なパラメータとして提供されます。execute
、populate
などのメソッドは、このクラスを拡張し、標準JSR-114RowSet
インタフェースを1つ以上実装するクラスで提供される必要があります。ノート:
JdbcRowSet
はpopulate
メソッドを必要としません。このメソッドは、このクラス内に定義されていません。このバージョンの
setNull
を呼び出した後でメソッドgetParams
を呼び出すと、設定されたパラメータ値を含むObject
配列が返されます。 その配列内で、このメソッドで設定された値を表す要素はそれ自体が配列になります。 その配列の最初の要素はnull
です。 2番目の要素はsqlTypeに設定された値、3番目の要素はtypeNameに設定された値です。 パラメータ番号はメソッドgetParams
から返される配列内での要素の位置によって示され、最初の要素は最初のプレースホルダー・パラメータの値、2番目の要素は2番目のプレースホルダー・パラメータの値、といった具合になります。 言い換えると、2番目のプレースホルダー・パラメータをnull
に設定する場合、その値を含む配列は、getParams
から返される配列内の2番目の要素になります。配列内の要素の番号付けはゼロから開始されるので、プレースホルダー番号parameterIndexに対応する配列要素はparameterIndex -1になります。
- パラメータ:
parameterIndex
- このRowSet
オブジェクトのコマンド内の、設定対象となるプレースホルダー・パラメータの順序番号。 最初のパラメータが1、2番目のパラメータが2、といった具合になる。1
以上でなければいけないsqlType
-java.sql.Types
からの値typeName
- SQLユーザー定義型の完全修飾名。パラメータがユーザー定義型でもREF
値でもない場合は無視される- 例外:
SQLException
- エラーが発生した場合、または指定されたパラメータ・インデックスが範囲外である場合- 関連項目:
getParams()
-
setBoolean
public void setBoolean(int parameterIndex, boolean x) throws SQLException
指定されたパラメータを、指定されたJavaプログラミング言語のboolean
に設定します。 データベースに送るときに、ドライバはこれをSQLBIT
値に変換します。このメソッドで設定されたパラメータ値は内部で格納され、
execute
メソッドの呼出し時に、このRowSet
オブジェクトのコマンド内の適切なパラメータとして提供されます。execute
、populate
などのメソッドは、このクラスを拡張し、標準JSR-114RowSet
インタフェースを1つ以上実装するクラスで提供される必要があります。ノート:
JdbcRowSet
はpopulate
メソッドを必要としません。このメソッドは、このクラス内に定義されていません。- パラメータ:
parameterIndex
- このRowSet
オブジェクトのコマンド内の、設定対象となるプレースホルダー・パラメータの順序番号。 最初のパラメータが1、2番目のパラメータが2、といった具合になる。1
以上でなければいけないx
- パラメータ値- 例外:
SQLException
- エラーが発生した場合、またはパラメータ・インデックスが範囲外である場合- 関連項目:
getParams()
-
setByte
public void setByte(int parameterIndex, byte x) throws SQLException
指定されたパラメータを、指定されたJavaプログラミング言語のbyte
に設定します。 データベースに送るときに、ドライバはこれをSQLTINYINT
値に変換します。このメソッドで設定されたパラメータ値は内部で格納され、
execute
メソッドの呼出し時に、このRowSet
オブジェクトのコマンド内の適切なパラメータとして提供されます。execute
、populate
などのメソッドは、このクラスを拡張し、標準JSR-114RowSet
インタフェースを1つ以上実装するクラスで提供される必要があります。ノート:
JdbcRowSet
はpopulate
メソッドを必要としません。このメソッドは、このクラス内に定義されていません。- パラメータ:
parameterIndex
- このRowSet
オブジェクトのコマンド内の、設定対象となるプレースホルダー・パラメータの順序番号。 最初のパラメータが1、2番目のパラメータが2、といった具合になる。1
以上でなければいけないx
- パラメータ値- 例外:
SQLException
- エラーが発生した場合、またはパラメータ・インデックスが範囲外である場合- 関連項目:
getParams()
-
setShort
public void setShort(int parameterIndex, short x) throws SQLException
指定されたパラメータを、指定されたJavaプログラミング言語のshort
に設定します。 データベースに送るときに、ドライバはこれをSQLSMALLINT
値に変換します。このメソッドで設定されたパラメータ値は内部で格納され、
execute
メソッドの呼出し時に、このRowSet
オブジェクトのコマンド内の適切なパラメータとして提供されます。execute
、populate
などのメソッドは、このクラスを拡張し、標準JSR-114RowSet
インタフェースを1つ以上実装するクラスで提供される必要があります。ノート:
JdbcRowSet
はpopulate
メソッドを必要としません。このメソッドは、このクラス内に定義されていません。- パラメータ:
parameterIndex
- このRowSet
オブジェクトのコマンド内の、設定対象となるプレースホルダー・パラメータの順序番号。 最初のパラメータが1、2番目のパラメータが2、といった具合になる。1
以上でなければいけないx
- パラメータ値- 例外:
SQLException
- エラーが発生した場合、またはパラメータ・インデックスが範囲外である場合- 関連項目:
getParams()
-
setInt
public void setInt(int parameterIndex, int x) throws SQLException
指定されたパラメータを、指定されたJavaプログラミング言語のint
値に設定します。 データベースに送るときに、ドライバはこれをSQLINTEGER
値に変換します。このメソッドで設定されたパラメータ値は内部で格納され、
execute
メソッドの呼出し時に、このRowSet
オブジェクトのコマンド内の適切なパラメータとして提供されます。execute
、populate
などのメソッドは、このクラスを拡張し、標準JSR-114RowSet
インタフェースを1つ以上実装するクラスで提供される必要があります。ノート:
JdbcRowSet
はpopulate
メソッドを必要としません。このメソッドは、このクラス内に定義されていません。- パラメータ:
parameterIndex
- このRowSet
オブジェクトのコマンド内の、設定対象となるプレースホルダー・パラメータの順序番号。 最初のパラメータが1、2番目のパラメータが2、といった具合になる。1
以上でなければいけないx
- パラメータ値- 例外:
SQLException
- エラーが発生した場合、またはパラメータ・インデックスが範囲外である場合- 関連項目:
getParams()
-
setLong
public void setLong(int parameterIndex, long x) throws SQLException
指定されたパラメータを、指定されたJavaプログラミング言語のlong
に設定します。 データベースに送るときに、ドライバはこれをSQLBIGINT
値に変換します。このメソッドで設定されたパラメータ値は内部で格納され、
execute
メソッドの呼出し時に、このRowSet
オブジェクトのコマンド内の適切なパラメータとして提供されます。execute
、populate
などのメソッドは、このクラスを拡張し、標準JSR-114RowSet
インタフェースを1つ以上実装するクラスで提供される必要があります。ノート:
JdbcRowSet
はpopulate
メソッドを必要としません。このメソッドは、このクラス内に定義されていません。- パラメータ:
parameterIndex
- このRowSet
オブジェクトのコマンド内の、設定対象となるプレースホルダー・パラメータの順序番号。 最初のパラメータが1、2番目のパラメータが2、といった具合になる。1
以上でなければいけないx
- パラメータ値- 例外:
SQLException
- エラーが発生した場合、またはパラメータ・インデックスが範囲外である場合- 関連項目:
getParams()
-
setFloat
public void setFloat(int parameterIndex, float x) throws SQLException
指定されたパラメータを、指定されたJavaプログラミング言語のfloat
に設定します。 データベースに送るときに、ドライバはこれをSQLFLOAT
値に変換します。このメソッドで設定されたパラメータ値は内部で格納され、
execute
メソッドの呼出し時に、このRowSet
オブジェクトのコマンド内の適切なパラメータとして提供されます。execute
、populate
などのメソッドは、このクラスを拡張し、標準JSR-114RowSet
インタフェースを1つ以上実装するクラスで提供される必要があります。ノート:
JdbcRowSet
はpopulate
メソッドを必要としません。このメソッドは、このクラス内に定義されていません。- パラメータ:
parameterIndex
- このRowSet
オブジェクトのコマンド内の、設定対象となるプレースホルダー・パラメータの順序番号。 最初のパラメータが1、2番目のパラメータが2、といった具合になる。1
以上でなければいけないx
- パラメータ値- 例外:
SQLException
- エラーが発生した場合、またはパラメータ・インデックスが範囲外である場合- 関連項目:
getParams()
-
setDouble
public void setDouble(int parameterIndex, double x) throws SQLException
指定されたパラメータを、指定されたJavaプログラミング言語のdouble
に設定します。 データベースに送るときに、ドライバはこれをSQLDOUBLE
値に変換します。このメソッドで設定されたパラメータ値は内部で格納され、
execute
メソッドの呼出し時に、このRowSet
オブジェクトのコマンド内の適切なパラメータとして提供されます。execute
、populate
などのメソッドは、このクラスを拡張し、標準JSR-114RowSet
インタフェースを1つ以上実装するクラスで提供される必要があります。ノート:
JdbcRowSet
はpopulate
メソッドを必要としません。このメソッドは、このクラス内に定義されていません。- パラメータ:
parameterIndex
- このRowSet
オブジェクトのコマンド内の、設定対象となるプレースホルダー・パラメータの順序番号。 最初のパラメータが1、2番目のパラメータが2、といった具合になる。1
以上でなければいけないx
- パラメータ値- 例外:
SQLException
- エラーが発生した場合、またはパラメータ・インデックスが範囲外である場合- 関連項目:
getParams()
-
setBigDecimal
public void setBigDecimal(int parameterIndex, BigDecimal x) throws SQLException
指定されたパラメータを、指定されたjava.lang.BigDecimal
値に設定します。 データベースに送るときに、ドライバはこれをSQLNUMERIC
値に変換します。このメソッドで設定されたパラメータ値は内部で格納され、
execute
メソッドの呼出し時に、このRowSet
オブジェクトのコマンド内の適切なパラメータとして提供されます。execute
、populate
などのメソッドは、このクラスを拡張し、標準JSR-114RowSet
インタフェースを1つ以上実装するクラスで提供される必要があります。ノート:
JdbcRowSet
はpopulate
メソッドを必要としません。このメソッドは、このクラス内に定義されていません。- パラメータ:
parameterIndex
- このRowSet
オブジェクトのコマンド内の、設定対象となるプレースホルダー・パラメータの順序番号。 最初のパラメータが1、2番目のパラメータが2、といった具合になる。1
以上でなければいけないx
- パラメータ値- 例外:
SQLException
- エラーが発生した場合、またはパラメータ・インデックスが範囲外である場合- 関連項目:
getParams()
-
setString
public void setString(int parameterIndex, String x) throws SQLException
指定されたパラメータを、指定されたString
値に設定します。 データベースに送るときに、ドライバはこれをSQLVARCHAR
またはLONGVARCHAR
値(ドライバのVARCHAR
値の制限に対する引数のサイズに依存)に変換します。このメソッドで設定されたパラメータ値は内部で格納され、
execute
メソッドの呼出し時に、このRowSet
オブジェクトのコマンド内の適切なパラメータとして提供されます。execute
、populate
などのメソッドは、このクラスを拡張し、標準JSR-114RowSet
インタフェースを1つ以上実装するクラスで提供される必要があります。ノート:
JdbcRowSet
はpopulate
メソッドを必要としません。このメソッドは、このクラス内に定義されていません。- パラメータ:
parameterIndex
- このRowSet
オブジェクトのコマンド内の、設定対象となるプレースホルダー・パラメータの順序番号。 最初のパラメータが1、2番目のパラメータが2、といった具合になる。1
以上でなければいけないx
- パラメータ値- 例外:
SQLException
- エラーが発生した場合、またはパラメータ・インデックスが範囲外である場合- 関連項目:
getParams()
-
setBytes
public void setBytes(int parameterIndex, byte[] x) throws SQLException
指定されたパラメータを、指定されたバイト配列に設定します。 データベースに送るときに、ドライバはこれをSQLVARBINARY
またはLONGVARBINARY
値(ドライバのVARBINARY
値の制限に対する引数のサイズに依存)に変換します。このメソッドで設定されたパラメータ値は内部で格納され、
execute
メソッドの呼出し時に、このRowSet
オブジェクトのコマンド内の適切なパラメータとして提供されます。execute
、populate
などのメソッドは、このクラスを拡張し、標準JSR-114RowSet
インタフェースを1つ以上実装するクラスで提供される必要があります。ノート:
JdbcRowSet
はpopulate
メソッドを必要としません。このメソッドは、このクラス内に定義されていません。- パラメータ:
parameterIndex
- このRowSet
オブジェクトのコマンド内の、設定対象となるプレースホルダー・パラメータの順序番号。 最初のパラメータが1、2番目のパラメータが2、といった具合になる。1
以上でなければいけないx
- パラメータ値- 例外:
SQLException
- エラーが発生した場合、またはパラメータ・インデックスが範囲外である場合- 関連項目:
getParams()
-
setDate
public void setDate(int parameterIndex, Date x) throws SQLException
指定されたパラメータを、指定されたjava.sql.Date
値に設定します。 データベースに送るときに、ドライバはこれをSQLDATE
値に変換します。このメソッドで設定されたパラメータ値は内部で格納され、
execute
メソッドの呼出し時に、このRowSet
オブジェクトのコマンド内の適切なパラメータとして提供されます。execute
、populate
などのメソッドは、このクラスを拡張し、標準JSR-114RowSet
インタフェースを1つ以上実装するクラスで提供される必要があります。ノート:
JdbcRowSet
はpopulate
メソッドを必要としません。このメソッドは、このクラス内に定義されていません。このバージョンの
setDate
を呼び出したあと、getParams
メソッドを呼び出すと、プレースホルダー・パラメータ番号parameterIndex (2番目のパラメータとして提供されるDate
オブジェクト)に設定される値の配列が返されます。 配列内の要素の番号付けはゼロから開始されるので、プレースホルダー番号parameterIndexに対応する配列要素はparameterIndex -1になります。- パラメータ:
parameterIndex
- このRowSet
オブジェクトのコマンド内の、設定対象となるプレースホルダー・パラメータの順序番号。 最初のパラメータが1、2番目のパラメータが2、といった具合になる。1
以上でなければいけないx
- パラメータ値- 例外:
SQLException
- エラーが発生した場合、またはパラメータ・インデックスが範囲外である場合- 関連項目:
getParams()
-
setTime
public void setTime(int parameterIndex, Time x) throws SQLException
指定されたパラメータを、指定されたjava.sql.Time
値に設定します。 データベースに送るときに、ドライバはこれをSQLTIME
値に変換します。このメソッドで設定されたパラメータ値は内部で格納され、
execute
メソッドの呼出し時に、このRowSet
オブジェクトのコマンド内の適切なパラメータとして提供されます。execute
、populate
などのメソッドは、このクラスを拡張し、標準JSR-114RowSet
インタフェースを1つ以上実装するクラスで提供される必要があります。ノート:
JdbcRowSet
はpopulate
メソッドを必要としません。このメソッドは、このクラス内に定義されていません。このバージョンの
setTime
メソッドを呼び出したあと、getParams
メソッドを呼び出すと、設定されたパラメータの配列が返されます。 このメソッドの2番目のパラメータとして設定されたTime
オブジェクトが、プレースホルダー・パラメータ番号parameterIndexのパラメータとして設定されます。配列内の要素の番号付けはゼロから開始されるので、プレースホルダー番号parameterIndexに対応する配列要素はparameterIndex -1になります。
- パラメータ:
parameterIndex
- このRowSet
オブジェクトのコマンド内の、設定対象となるプレースホルダー・パラメータの順序番号。 最初のパラメータが1、2番目のパラメータが2、といった具合になる。1
以上でなければいけないx
-java.sql.Time
オブジェクト。プレースホルダー・パラメータparameterIndexの値として設定される- 例外:
SQLException
- エラーが発生した場合、またはパラメータ・インデックスが範囲外である場合- 関連項目:
getParams()
-
setTimestamp
public void setTimestamp(int parameterIndex, Timestamp x) throws SQLException
指定されたパラメータを、指定されたjava.sql.Timestamp
値に設定します。 データベースに送るときに、ドライバはこれをSQLTIMESTAMP
値に変換します。このメソッドで設定されたパラメータ値は内部で格納され、
execute
メソッドの呼出し時に、このRowSet
オブジェクトのコマンド内の適切なパラメータとして提供されます。execute
、populate
などのメソッドは、このクラスを拡張し、標準JSR-114RowSet
インタフェースを1つ以上実装するクラスで提供される必要があります。ノート:
JdbcRowSet
はpopulate
メソッドを必要としません。このメソッドは、このクラス内に定義されていません。このバージョンの
setTimestamp
を呼び出したあと、getParams
メソッドを呼び出すと、プレースホルダー・パラメータ番号parameterIndex (このメソッドの2番目のパラメータとして提供されるTimestamp
オブジェクト)に設定される値の配列が返されます。 配列内の要素の番号付けはゼロから開始されるので、プレースホルダー番号parameterIndexに対応する配列要素はparameterIndex -1になります。- パラメータ:
parameterIndex
- このRowSet
オブジェクトのコマンド内の、設定対象となるプレースホルダー・パラメータの順序番号。 最初のパラメータが1、2番目のパラメータが2、といった具合になる。1
以上でなければいけないx
-java.sql.Timestamp
オブジェクト- 例外:
SQLException
- エラーが発生した場合、またはパラメータ・インデックスが範囲外である場合- 関連項目:
getParams()
-
setAsciiStream
public void setAsciiStream(int parameterIndex, InputStream x, int length) throws SQLException
指定されたパラメータを、指定されたバイト数を持つ指定されたjava.io.InputStream
オブジェクトに設定します。 ストリームの内容が読み取られ、データベースに送信されます。 読み取られ、データベースに送信されるバイト数がlengthに一致していない場合、このメソッドはSQLException
オブジェクトをスローします。LONGVARCHAR
パラメータに非常に大きなASCII値が入力されるときには、java.io.InputStream
オブジェクトを介して送るのが現実的です。 JDBCテクノロジを使用可能なドライバは、ファイルの終わりに達するまで必要に応じてストリームからデータを読み込みます。 ドライバは、必要に応じて、ASCIIからデータベースのCHAR
形式への変換を行います。ノート: このストリーム・オブジェクトは、標準のJavaストリーム・オブジェクト、または標準インタフェースを実装する独自のサブクラスのどちらでもかまいません。
このメソッドで設定されたパラメータ値は内部で格納され、
execute
メソッドの呼出し時に、このRowSet
オブジェクトのコマンド内の適切なパラメータとして提供されます。execute
、populate
などのメソッドは、このクラスを拡張し、標準JSR-114RowSet
インタフェースを1つ以上実装するクラスで提供される必要があります。ノート:
JdbcRowSet
はpopulate
メソッドを必要としません。このメソッドは、このクラス内に定義されていません。setAsciiStream
を呼び出した後でメソッドgetParams
を呼び出すと、設定されたパラメータ値を含む配列が返されます。 その配列内で、このメソッドで設定された値を表す要素はそれ自体が配列になります。 その配列の最初の要素は、指定されたjava.io.InputStream
オブジェクトです。 2番目の要素は、lengthに設定された値です。 3番目の要素は、このメソッドに渡されたストリームがASCIIストリームであることを指定する、BaseRowSet
の内部定数です。 パラメータ番号はメソッドgetParams
から返される配列内での要素の位置によって示され、最初の要素は最初のプレースホルダー・パラメータの値、2番目の要素は2番目のプレースホルダー・パラメータの値、といった具合になります。 言い換えると、設定する入力ストリームが2番目のプレースホルダー・パラメータの値である場合、その値を含む配列は、getParams
から返される配列内の2番目の要素になります。配列内の要素の番号付けはゼロから開始されるので、プレースホルダー・パラメータ番号parameterIndexに対応する配列要素番号はparameterIndex -1になります。
- パラメータ:
parameterIndex
- このRowSet
オブジェクトのコマンド内の、設定対象となるプレースホルダー・パラメータの順序番号。 最初のパラメータが1、2番目のパラメータが2、といった具合になる。1
以上でなければいけないx
- ASCIIパラメータ値を含むJava入力ストリームlength
- ストリームのバイト数。 ドライバからDBMSに送信されるバイト数に一致する。バイト長0以下は未定義だが、配下のJDBCドライバで無効な長さ例外がスローされる。- 例外:
SQLException
- エラーが発生した場合、パラメータ・インデックスが範囲外の場合、またはデータ・ソースに接続した場合は、ドライバによって読み取られデータベースに送信されるバイト数がlengthに指定されたバイト数と一致しない- 関連項目:
getParams()
-
setAsciiStream
public void setAsciiStream(int parameterIndex, InputStream x) throws SQLException
このRowSet
オブジェクトのコマンド内の指定されたパラメータを、指定された入力ストリームに設定します。LONGVARCHAR
パラメータに非常に大きなASCII値が入力されるときには、java.io.InputStream
を介して送るのが現実的です。 ファイルの終わりに達するまで必要に応じてストリームからデータが読み込まれます。 JDBCドライバは、データをASCIIからデータベースのchar形式に変換します。ノート: このストリーム・オブジェクトは、標準のJavaストリーム・オブジェクト、または標準インタフェースを実装する独自のサブクラスのどちらでもかまいません。
ノート: lengthパラメータを使用するバージョンの
setAsciiStream
を使用する方が効率的かどうかを判断するには、JDBCドライバのドキュメントを参照してください。- パラメータ:
parameterIndex
- 最初のパラメータは1、2番目のパラメータは2、... となるx
- ASCIIパラメータ値を含むJava入力ストリーム- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたPreparedStatement
について呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
setBinaryStream
public void setBinaryStream(int parameterIndex, InputStream x, int length) throws SQLException
指定されたパラメータを、指定されたバイト数を持つ指定されたjava.io.InputStream
オブジェクトに設定します。 ストリームの内容が読み取られ、データベースに送信されます。 読み取られ、データベースに送信されるバイト数がlengthに一致していない場合、このメソッドはSQLException
オブジェクトをスローします。LONGVARBINARY
パラメータに非常に大きなバイナリ値が入力されるときには、java.io.InputStream
オブジェクトを介して送るのが現実的です。 JDBCテクノロジを使用可能なドライバは、ファイルの終わりに達するまで必要に応じてストリームからデータを読み込みます。ノート: このストリーム・オブジェクトは、標準のJavaストリーム・オブジェクト、または標準インタフェースを実装する独自のサブクラスのどちらでもかまいません。
このメソッドで設定されたパラメータ値は内部で格納され、
execute
メソッドの呼出し時に、このRowSet
オブジェクトのコマンド内の適切なパラメータとして提供されます。execute
、populate
などのメソッドは、このクラスを拡張し、標準JSR-114RowSet
インタフェースを1つ以上実装するクラスで提供される必要があります。ノート:
JdbcRowSet
はpopulate
メソッドを必要としません。このメソッドは、このクラス内に定義されていません。setBinaryStream
を呼び出した後でメソッドgetParams
を呼び出すと、設定されたパラメータ値を含む配列が返されます。 その配列内で、このメソッドで設定された値を表す要素はそれ自体が配列になります。 その配列の最初の要素は、指定されたjava.io.InputStream
オブジェクトです。 2番目の要素は、lengthに設定された値です。 3番目の要素は、このメソッドに渡されたストリームがバイナリ・ストリームであることを指定する、BaseRowSet
の内部定数です。 パラメータ番号はメソッドgetParams
から返される配列内での要素の位置によって示され、最初の要素は最初のプレースホルダー・パラメータの値、2番目の要素は2番目のプレースホルダー・パラメータの値、といった具合になります。 言い換えると、設定する入力ストリームが2番目のプレースホルダー・パラメータの値である場合、その値を含む配列は、getParams
から返される配列内の2番目の要素になります。配列内の要素の番号付けはゼロから開始されるので、プレースホルダー・パラメータ番号parameterIndexに対応する配列要素番号はparameterIndex -1になります。
- パラメータ:
parameterIndex
- このRowSet
オブジェクトのコマンド内の、設定対象となるプレースホルダー・パラメータの順序番号。 最初のパラメータが1、2番目のパラメータが2、といった具合になる。1
以上でなければいけないx
- 設定されるバイナリ値を含む入力ストリームlength
- ストリームのバイト数。バイト長0以下は未定義だが、配下のJDBCドライバで無効な長さ例外がスローされる。- 例外:
SQLException
- エラーが発生した場合、パラメータ・インデックスが範囲外の場合、またはデータ・ソースに接続した場合は、ドライバによって読み取られデータベースに送信されるバイト数がlengthに指定されたバイト数と一致しない- 関連項目:
getParams()
-
setBinaryStream
public void setBinaryStream(int parameterIndex, InputStream x) throws SQLException
このRowSet
オブジェクトのコマンド内の指定されたパラメータを、指定された入力ストリームに設定します。LONGVARBINARY
パラメータに非常に大きなバイナリ値が入力されるときには、java.io.InputStream
オブジェクトを介して送るのが現実的です。 ファイルの終わりに達するまで必要に応じてストリームからデータが読み込まれます。ノート: このストリーム・オブジェクトは、標準のJavaストリーム・オブジェクト、または標準インタフェースを実装する独自のサブクラスのどちらでもかまいません。
ノート: lengthパラメータを使用するバージョンの
setBinaryStream
を使用する方が効率的かどうかを判断するには、JDBCドライバのドキュメントを参照してください。- パラメータ:
parameterIndex
- 最初のパラメータは1、2番目のパラメータは2、... となるx
- バイナリ・パラメータ値を含むJava入力ストリーム- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたPreparedStatement
について呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
setUnicodeStream
@Deprecated public void setUnicodeStream(int parameterIndex, InputStream x, int length) throws SQLException
非推奨。getCharacterStreamはその場所で使用する必要があります指定されたパラメータを、指定されたバイト数を持つ指定されたjava.io.InputStream
オブジェクトに設定します。 ストリームの内容が読み取られ、データベースに送信されます。 読み取られ、データベースに送信されるバイト数がlengthに一致していない場合、このメソッドはSQLException
をスローします。LONGVARCHAR
パラメータに非常に大きなUnicode値が入力されるときには、java.io.InputStream
オブジェクトを介して送るのが現実的です。 JDBCテクノロジを使用可能なドライバは、ファイルの終わりに達するまで必要に応じてストリームからデータを読み込みます。 ドライバは、必要に応じて、UnicodeからデータベースのCHAR
形式への変換を行います。 Unicodeストリームのバイト形式は、Java仮想マシン仕様に定義されているとおりJava UTF-8である必要があります。ノート: このストリーム・オブジェクトは、標準のJavaストリーム・オブジェクト、または標準インタフェースを実装する独自のサブクラスのどちらでもかまいません。
このメソッドは非推奨です。代わりに
getCharacterStream
メソッドを使用してください。このメソッドで設定されたパラメータ値は内部で格納され、
execute
メソッドの呼出し時に、このRowSet
オブジェクトのコマンド内の適切なパラメータとして提供されます。setUnicodeStream
を呼び出した後でメソッドgetParams
を呼び出すと、設定されたパラメータ値を含む配列が返されます。 その配列内で、このメソッドで設定された値を表す要素はそれ自体が配列になります。 その配列の最初の要素は、指定されたjava.io.InputStream
オブジェクトです。 2番目の要素は、lengthに設定された値です。 3番目の要素は、このメソッドに渡されたストリームがUnicodeストリームであることを指定する、BaseRowSet
の内部定数です。 パラメータ番号はメソッドgetParams
から返される配列内での要素の位置によって示され、最初の要素は最初のプレースホルダー・パラメータの値、2番目の要素は2番目のプレースホルダー・パラメータの値、といった具合になります。 言い換えると、設定する入力ストリームが2番目のプレースホルダー・パラメータの値である場合、その値を含む配列は、getParams
から返される配列内の2番目の要素になります。配列内の要素の番号付けはゼロから開始されるので、プレースホルダー・パラメータ番号parameterIndexに対応する配列要素番号はparameterIndex -1になります。
- パラメータ:
parameterIndex
- このRowSet
オブジェクトのコマンド内の、設定対象となるプレースホルダー・パラメータの順序番号。 最初のパラメータが1、2番目のパラメータが2、といった具合になる。1
以上でなければいけないx
- UNICODEパラメータ値を含むjava.io.InputStream
オブジェクトlength
- 入力ストリームのバイト数- 例外:
SQLException
- エラーが発生した場合、パラメータ・インデックスが範囲外の場合、またはデータ・ソースに接続した場合は、ドライバによって読み取られデータベースに送信されるバイト数がlengthに指定されたバイト数と一致しない場合- 関連項目:
getParams()
-
setCharacterStream
public void setCharacterStream(int parameterIndex, Reader reader, int length) throws SQLException
指定されたパラメータを、指定されたバイト数を持つjava.io.Reader
オブジェクトに設定します。 リーダーの内容が読み取られ、データベースに送信されます。 読み取られ、データベースに送信されるバイト数がlengthに一致していない場合、このメソッドはSQLException
をスローします。LONGVARCHAR
パラメータに非常に大きなUnicode値が入力されるときには、Reader
オブジェクトを介して送るのが現実的です。 JDBCテクノロジを使用可能なドライバは、ファイルの終わりに達するまで必要に応じてストリームからデータを読み込みます。 ドライバは、必要に応じて、UnicodeからデータベースのCHAR
形式への変換を行います。 Unicodeストリームのバイト形式は、Java仮想マシン仕様に定義されているとおりJava UTF-8である必要があります。ノート: このストリーム・オブジェクトは、標準のJavaストリーム・オブジェクト、または標準インタフェースを実装する独自のサブクラスのどちらでもかまいません。
このメソッドで設定されたパラメータ値は内部で格納され、
execute
メソッドの呼出し時に、このRowSet
オブジェクトのコマンド内の適切なパラメータとして提供されます。execute
、populate
などのメソッドは、このクラスを拡張し、標準JSR-114RowSet
インタフェースを1つ以上実装するクラスで提供される必要があります。ノート:
JdbcRowSet
はpopulate
メソッドを必要としません。このメソッドは、このクラス内に定義されていません。setCharacterStream
を呼び出した後でメソッドgetParams
を呼び出すと、設定されたパラメータ値を含む配列が返されます。 その配列内で、このメソッドで設定された値を表す要素はそれ自体が配列になります。 その配列の最初の要素は、指定されたjava.io.Reader
オブジェクトです。 2番目の要素は、lengthに設定された値です。 パラメータ番号はメソッドgetParams
から返される配列内での要素の位置によって示され、最初の要素は最初のプレースホルダー・パラメータの値、2番目の要素は2番目のプレースホルダー・パラメータの値、といった具合になります。 言い換えると、設定するリーダーが2番目のプレースホルダー・パラメータの値である場合、その値を含む配列は、getParams
から返される配列内の2番目の要素になります。配列内の要素の番号付けはゼロから開始されるので、プレースホルダー・パラメータ番号parameterIndexに対応する配列要素番号はparameterIndex -1になります。
- パラメータ:
parameterIndex
- このRowSet
オブジェクトのコマンド内の、設定対象となるプレースホルダー・パラメータの順序番号。 最初のパラメータが1、2番目のパラメータが2、といった具合になる。1
以上でなければいけないreader
- Unicodeデータを格納するReader
オブジェクトlength
- ストリーム内の文字数。文字長0以下は未定義だが、配下のJDBCドライバで無効な長さ例外がスローされる。- 例外:
SQLException
- エラーが発生した場合、パラメータ・インデックスが範囲外の場合、またはデータ・ソースに接続した場合は、ドライバによって読み取られデータベースに送信されるバイト数がlengthに指定されたバイト数と一致しない- 関連項目:
getParams()
-
setCharacterStream
public void setCharacterStream(int parameterIndex, Reader reader) throws SQLException
このRowSet
オブジェクトのコマンド内の指定されたパラメータを、指定されたReader
オブジェクトに設定します。LONGVARCHAR
パラメータに非常に大きなUNICODE値が入力されるときには、java.io.Reader
オブジェクトを介して送るのが現実的です。 ファイルの終わりに達するまで必要に応じてストリームからデータが読み込まれます。 JDBCドライバは、データをUNICODEからデータベースのchar形式に変換します。ノート: このストリーム・オブジェクトは、標準のJavaストリーム・オブジェクト、または標準インタフェースを実装する独自のサブクラスのどちらでもかまいません。
ノート: lengthパラメータを使用するバージョンの
setCharacterStream
を使用する方が効率的かどうかを判断するには、JDBCドライバのドキュメントを参照してください。- パラメータ:
parameterIndex
- 最初のパラメータは1、2番目のパラメータは2、... となるreader
- Unicodeデータを格納するjava.io.Reader
オブジェクト- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたPreparedStatement
について呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
setObject
public void setObject(int parameterIndex, Object x, int targetSqlType, int scale) throws SQLException
指定されたパラメータを、指定されたJavaプログラミング言語のObject
値に設定します。 2番目のパラメータはObject
型である必要があります。 整数値の場合は等価なjava.lang
オブジェクトを使用する必要があります。 たとえばint
に対してInteger
クラスのインスタンスを使用します。ドライバは、このオブジェクトをデータベースに送信する前に、指定されたターゲットのSQL型に変換します。 オブジェクトが
SQLData
を実装するクラスのカスタム・マッピングを持つ場合、ドライバはSQLData.writeSQL
メソッドを呼び出して、オブジェクトをSQLデータ・ストリームに書き込む必要があります。 また、オブジェクトがRef
、Blob
、Clob
、Struct
、またはArray
を実装するクラスのオブジェクトである場合、ドライバはこのオブジェクトを対応するSQL型の値としてデータベースに渡す必要があります。このメソッドは、データベース固有の抽象データ型を渡すために使用することに注意してください。
このメソッドで設定されたパラメータ値は内部で格納され、
execute
メソッドの呼出し時に、このRowSet
オブジェクトのコマンド内の適切なパラメータとして提供されます。execute
、populate
などのメソッドは、このクラスを拡張し、標準JSR-114RowSet
インタフェースを1つ以上実装するクラスで提供される必要があります。ノート:
JdbcRowSet
はpopulate
メソッドを必要としません。このメソッドは、このクラス内に定義されていません。このバージョンの
setObject
を呼び出した後でメソッドgetParams
を呼び出すと、設定されたパラメータ値を含む配列が返されます。 その配列内で、このメソッドで設定された値を表す要素はそれ自体が配列になります。 その配列の最初の要素は指定されたObject
インスタンス、2番目の要素はtargetSqlTypeに設定された値になります。 3番目の要素はscaleに設定された値になりますが、設定対象のオブジェクトの型がjava.sql.Types.NUMERIC
、java.sql.Types.DECIMAL
のどちらでもない場合、ドライバはその値を無視します。 パラメータ番号はメソッドgetParams
から返される配列内での要素の位置によって示され、最初の要素は最初のプレースホルダー・パラメータの値、2番目の要素は2番目のプレースホルダー・パラメータの値、といった具合になります。 言い換えると、設定するオブジェクトが2番目のプレースホルダー・パラメータの値である場合、その値を含む配列は、getParams
から返される配列内の2番目の要素になります。配列内の要素の番号付けはゼロから開始されるので、プレースホルダー・パラメータ番号parameterIndexに対応する配列要素番号はparameterIndex -1になります。
- パラメータ:
parameterIndex
- このRowSet
オブジェクトのコマンド内の、設定対象となるプレースホルダー・パラメータの順序番号。 最初のパラメータが1、2番目のパラメータが2、といった具合になる。1
以上でなければいけないx
- 入力パラメータ値を含むObject
。Object
型でなければならないtargetSqlType
- データベースに送られる(java.sql.Types
で定義される) SQL型。scale
引数で、さらにこの型を限定できる。 非標準のtargetSqlTypeが提供された場合、このメソッドはSQLException
をスローしない。 この動作により、非標準のSQL型が暗黙的にサポートされる。scale
-java.sql.Types.DECIMAL
やjava.sql.Types.NUMERIC
型では、小数点以下の桁数。 ほかのすべての型では、この値は無視される。- 例外:
SQLException
- エラーが発生した場合、またはパラメータ・インデックスが範囲外である場合- 関連項目:
getParams()
-
setObject
public void setObject(int parameterIndex, Object x, int targetSqlType) throws SQLException
指定されたパラメータの値を、指定されたObject
値で設定します。 このメソッドは、setObject(int parameterIndex, Object x, int targetSqlType, int scale)
に似ていますが、scaleに0を仮定している点が異なります。このメソッドで設定されたパラメータ値は内部で格納され、
execute
メソッドの呼出し時に、このRowSet
オブジェクトのコマンド内の適切なパラメータとして提供されます。execute
、populate
などのメソッドは、このクラスを拡張し、標準JSR-114RowSet
インタフェースを1つ以上実装するクラスで提供される必要があります。ノート:
JdbcRowSet
はpopulate
メソッドを必要としません。このメソッドは、このクラス内に定義されていません。このバージョンの
setObject
を呼び出した後でメソッドgetParams
を呼び出すと、設定されたパラメータ値を含む配列が返されます。 その配列内で、このメソッドで設定された値を表す要素はそれ自体が配列になります。 その配列の最初の要素は、指定されたObject
インスタンスです。 2番目の要素は、targetSqlTypeに設定された値です。 パラメータ番号はメソッドgetParams
から返される配列内での要素の位置によって示され、最初の要素は最初のプレースホルダー・パラメータの値、2番目の要素は2番目のプレースホルダー・パラメータの値、といった具合になります。 言い換えると、設定するオブジェクトが2番目のプレースホルダー・パラメータの値である場合、その値を含む配列は、getParams
から返される配列内の2番目の要素になります。配列内の要素の番号付けはゼロから開始されるので、プレースホルダー・パラメータ番号parameterIndexに対応する配列要素番号はparameterIndex -1になります。
- パラメータ:
parameterIndex
- このRowSet
オブジェクトのコマンド内の、設定対象となるプレースホルダー・パラメータの順序番号。 最初のパラメータが1、2番目のパラメータが2、といった具合になる。1
以上でなければいけないx
- 入力パラメータ値を含むObject
。Object
型でなければならないtargetSqlType
- データベースに送られる(java.sql.Types
で定義される) SQL型。 非標準のtargetSqlTypeが提供された場合、このメソッドはSQLException
をスローしない。 この動作により、非標準のSQL型が暗黙的にサポートされる。- 例外:
SQLException
- エラーが発生した場合、またはパラメータ・インデックスが範囲外である場合- 関連項目:
getParams()
-
setObject
public void setObject(int parameterIndex, Object x) throws SQLException
指定されたパラメータを、指定されたJavaプログラミング言語のObject
値に設定します。 2番目のパラメータはObject
型である必要があります。 整数値の場合は等価なjava.lang
オブジェクトを使用する必要があります。 たとえばint
に対してInteger
クラスのインスタンスを使用します。JDBC仕様には、Java
Object
型とSQL型の標準マッピングが定義されています。 ドライバは、この標準マッピングを使って、指定されたオブジェクトをデータベースへ送信する前に、対応するSQL型に変換します。 オブジェクトがSQLData
を実装するクラスのカスタム・マッピングを持つ場合、ドライバはSQLData.writeSQL
メソッドを呼び出して、オブジェクトをSQLデータ・ストリームに書き込む必要があります。また、オブジェクトが
Ref
、Blob
、Clob
、Struct
、またはArray
を実装するクラスのオブジェクトである場合、ドライバはこのオブジェクトを対応するSQL型の値としてデータベースに渡す必要があります。たとえば、オブジェクトが1個以上のインタフェースを複数実装するクラスであるなど、あいまいさがある場合、このメソッドは例外をスローします。
このメソッドは、データベース固有の抽象データ型を渡すために使用することに注意してください。
このメソッドで設定されたパラメータ値は内部で格納され、
execute
メソッドの呼出し時に、このRowSet
オブジェクトのコマンド内の適切なパラメータとして提供されます。execute
、populate
などのメソッドは、このクラスを拡張し、標準JSR-114RowSet
インタフェースを1つ以上実装するクラスで提供される必要があります。ノート:
JdbcRowSet
はpopulate
メソッドを必要としません。このメソッドは、このクラス内に定義されていません。このメソッドを呼び出した後でメソッド
getParams
を呼び出すと、現在のコマンド・パラメータのオブジェクト配列が返されますが、その配列には、プレースホルダー・パラメータ番号parameterIndex
に設定されたObject
が含まれます。 配列内の要素の番号付けはゼロから開始されるので、プレースホルダー・パラメータ番号parameterIndexに対応する配列要素番号はparameterIndex -1になります。- パラメータ:
parameterIndex
- このRowSet
オブジェクトのコマンド内の、設定対象となるプレースホルダー・パラメータの順序番号。 最初のパラメータが1、2番目のパラメータが2、といった具合になる。1
以上でなければいけないx
- 入力パラメータ値を含むオブジェクト- 例外:
SQLException
- エラーが発生した場合、パラメータ・インデックスが範囲外である場合、または設定されるオブジェクトの実装にあいまいさがある場合- 関連項目:
getParams()
-
setRef
public void setRef(int parameterIndex, Ref ref) throws SQLException
指定されたパラメータを、指定されたJavaプログラミング言語のRef
オブジェクトに設定します。 データベースに送るときに、ドライバはこれをSQLREF
値に変換します。 内部的には、Ref
は直列化可能性を確保するため、SerialRef
で表されます。このメソッドで設定されたパラメータ値は内部で格納され、
execute
メソッドの呼出し時に、このRowSet
オブジェクトのコマンド内の適切なパラメータとして提供されます。execute
、populate
などのメソッドは、このクラスを拡張し、標準JSR-114RowSet
インタフェースを1つ以上実装するクラスで提供される必要があります。ノート:
JdbcRowSet
はpopulate
メソッドを必要としません。このメソッドは、このクラス内に定義されていません。このメソッドを呼び出した後でメソッド
getParams
を呼び出すと、現在のコマンド・パラメータのオブジェクト配列が返されますが、その配列には、プレースホルダー・パラメータ番号parameterIndex
に設定されたRef
オブジェクトが含まれます。 配列内の要素の番号付けはゼロから開始されるので、プレースホルダー・パラメータ番号parameterIndexに対応する配列要素番号はparameterIndex -1になります。- パラメータ:
parameterIndex
- このRowSet
オブジェクトのコマンド内の、設定対象となるプレースホルダー・パラメータの順序番号。 最初のパラメータが1、2番目のパラメータが2、といった具合になる。1
以上でなければいけないref
- SQLREF
値を表すRef
オブジェクト。nullは不可- 例外:
SQLException
- エラーが発生した場合、またはパラメータ・インデックスが範囲外であるか、Ref
オブジェクトがnull
の場合、またはRef
オブジェクトがnull
の基底型名を返した場合。- 関連項目:
getParams()
、SerialRef
-
setBlob
public void setBlob(int parameterIndex, Blob x) throws SQLException
指定されたパラメータを、指定されたJavaプログラミング言語のBlob
オブジェクトに設定します。 データベースに送るときに、ドライバはこれをSQLBLOB
値に変換します。 内部的には、Blob
は直列化可能性を確保するため、SerialBlob
で表されます。このメソッドで設定されたパラメータ値は内部で格納され、
execute
メソッドの呼出し時に、このRowSet
オブジェクトのコマンド内の適切なパラメータとして提供されます。execute
、populate
などのメソッドは、このクラスを拡張し、標準JSR-114RowSet
インタフェースを1つ以上実装するクラスで提供される必要があります。 ノート:JdbcRowSet
はpopulate
メソッドを必要としません。このメソッドは、このクラス内に定義されていません。このメソッドを呼び出した後でメソッド
getParams
を呼び出すと、現在のコマンド・パラメータのオブジェクト配列が返されますが、その配列には、プレースホルダー・パラメータ番号parameterIndex
に設定されたBlob
オブジェクトが含まれます。 配列内の要素の番号付けはゼロから開始されるので、プレースホルダー・パラメータ番号parameterIndexに対応する配列要素番号はparameterIndex -1になります。- パラメータ:
parameterIndex
- このRowSet
オブジェクトのコマンド内の、設定対象となるプレースホルダー・パラメータの順序番号。 最初のパラメータが1、2番目のパラメータが2、といった具合になる。1
以上でなければいけないx
- SQLBLOB
値を表すBlob
オブジェクト- 例外:
SQLException
- エラーが発生した場合、またはパラメータ・インデックスが範囲外である場合- 関連項目:
getParams()
、SerialBlob
-
setClob
public void setClob(int parameterIndex, Clob x) throws SQLException
指定されたパラメータを、指定されたJavaプログラミング言語のClob
オブジェクトに設定します。 データベースに送るときに、ドライバはこれをSQLCLOB
値に変換します。 内部的には、Clob
は直列化可能性を確保するため、SerialClob
で表されます。このメソッドで設定されたパラメータ値は内部で格納され、
execute
メソッドの呼出し時に、このRowSet
オブジェクトのコマンド内の適切なパラメータとして提供されます。execute
、populate
などのメソッドは、このクラスを拡張し、標準JSR-114RowSet
インタフェースを1つ以上実装するクラスで提供される必要があります。ノート:
JdbcRowSet
はpopulate
メソッドを必要としません。このメソッドは、このクラス内に定義されていません。このメソッドを呼び出した後でメソッド
getParams
を呼び出すと、現在のコマンド・パラメータのオブジェクト配列が返されますが、その配列には、プレースホルダー・パラメータ番号parameterIndex
に設定されたClob
オブジェクトが含まれます。 配列内の要素の番号付けはゼロから開始されるので、プレースホルダー・パラメータ番号parameterIndexに対応する配列要素番号はparameterIndex -1になります。- パラメータ:
parameterIndex
- このRowSet
オブジェクトのコマンド内の、設定対象となるプレースホルダー・パラメータの順序番号。 最初のパラメータが1、2番目のパラメータが2、といった具合になる。1
以上でなければいけないx
- SQLCLOB
値を表すClob
オブジェクト。nullは不可- 例外:
SQLException
- エラーが発生した場合、パラメータ・インデックスが範囲外である場合、またはClob
がnullの場合- 関連項目:
getParams()
、SerialBlob
-
setArray
public void setArray(int parameterIndex, Array array) throws SQLException
指定されたパラメータをJavaプログラミング言語のArray
オブジェクトに設定します。 データベースに送るときに、ドライバはこれをSQLARRAY
値に変換します。 内部的には、Array
は直列化可能性を確保するため、SerialArray
で表されます。このメソッドで設定されたパラメータ値は内部で格納され、
execute
メソッドの呼出し時に、このRowSet
オブジェクトのコマンド内の適切なパラメータとして提供されます。execute
、populate
などのメソッドは、このクラスを拡張し、標準JSR-114RowSet
インタフェースを1つ以上実装するクラスで提供される必要があります。ノート:
JdbcRowSet
はpopulate
メソッドを必要としません。このメソッドは、このクラス内に定義されていません。このメソッドを呼び出した後でメソッド
getParams
を呼び出すと、現在のコマンド・パラメータのオブジェクト配列が返されますが、その配列には、プレースホルダー・パラメータ番号parameterIndex
に設定されたArray
オブジェクトが含まれます。 配列内の要素の番号付けはゼロから開始されるので、プレースホルダー・パラメータ番号parameterIndexに対応する配列要素番号はparameterIndex -1になります。- パラメータ:
parameterIndex
- このRowSet
オブジェクトのコマンド内の、設定対象となるプレースホルダー・パラメータの順序番号。 最初のパラメータが1、2番目のパラメータが2、といった具合になる。1
以上でなければいけないarray
- SQLARRAY
値を表すArray
オブジェクト。nullは不可。 このメソッドに渡されるArray
オブジェクトは、すべてのgetArray()
メソッド呼出しでnull以外のObjectを返す必要があります。 値がnullの場合はSQLException
がスローされます。- 例外:
SQLException
- エラーが発生した場合、パラメータ・インデックスが範囲外である場合、またはARRAY
がnullの場合- 関連項目:
getParams()
、SerialArray
-
setDate
public void setDate(int parameterIndex, Date x, Calendar cal) throws SQLException
指定されたパラメータを指定されたjava.sql.Date
オブジェクトに設定します。 DBMSにタイムゾーン情報が格納されていない場合、ドライバは指定されたCalendar
オブジェクトを使用して、SQLDATE
値を作成し、これをデータベースに送ります。Calendar
オブジェクトを使用する場合、ドライバはカスタム・タイムゾーンを考慮して日付を計算できます。Calendar
オブジェクトを指定しない場合、ドライバは、アプリケーションを実行している仮想マシンのタイムゾーンを使用します。このメソッドで設定されたパラメータ値は内部で格納され、
execute
メソッドの呼出し時に、このRowSet
オブジェクトのコマンド内の適切なパラメータとして提供されます。execute
、populate
などのメソッドは、このクラスを拡張し、標準JSR-114RowSet
インタフェースを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
- SQLDATE
値を表すjava.sql.Date
オブジェクトcal
- 日付を作成するために使用するjava.util.Calendar
オブジェクト- 例外:
SQLException
- エラーが発生した場合、またはパラメータ・インデックスが範囲外である場合- 関連項目:
getParams()
-
setTime
public void setTime(int parameterIndex, Time x, Calendar cal) throws SQLException
指定されたパラメータを指定されたjava.sql.Time
オブジェクトに設定します。 データベースに送るときに、ドライバはこれをSQLTIME
値に変換します。DBMSにタイムゾーン情報が格納されていない場合、ドライバは指定された
Calendar
オブジェクトを使用して、SQLTIME
値を作成し、これをデータベースに送ります。Calendar
オブジェクトを使用する場合、ドライバはカスタム・タイムゾーンを考慮して日付を計算できます。Calendar
オブジェクトを指定しない場合、ドライバは、アプリケーションを実行している仮想マシンのタイムゾーンを使用します。このメソッドで設定されたパラメータ値は内部で格納され、
execute
メソッドの呼出し時に、このRowSet
オブジェクトのコマンド内の適切なパラメータとして提供されます。execute
、populate
などのメソッドは、このクラスを拡張し、標準JSR-114RowSet
インタフェースを1つ以上実装するクラスで提供される必要があります。ノート:
JdbcRowSet
はpopulate
メソッドを必要としません。このメソッドは、このクラス内に定義されていません。このバージョンの
setTime
を呼び出した後でメソッドgetParams
を呼び出すと、設定されたパラメータ値を含む配列が返されます。 その配列内で、このメソッドで設定された値を表す要素はそれ自体が配列になります。 その配列の最初の要素は、指定されたjava.sql.Time
オブジェクトです。 2番目の要素は、calに設定された値です。 パラメータ番号はメソッドgetParams
から返される配列内での要素の位置によって示され、最初の要素は最初のプレースホルダー・パラメータの値、2番目の要素は2番目のプレースホルダー・パラメータの値、といった具合になります。 言い換えると、設定する時間が2番目のプレースホルダー・パラメータの値である場合、その値を含む配列は、getParams
から返される配列内の2番目の要素になります。配列内の要素の番号付けはゼロから開始されるので、プレースホルダー番号parameterIndexに対応する配列要素はparameterIndex -1になります。
- パラメータ:
parameterIndex
- このRowSet
オブジェクトのコマンド内の、設定対象となるプレースホルダー・パラメータの順序番号。 最初のパラメータが1、2番目のパラメータが2、といった具合になる。1
以上でなければいけないx
-java.sql.Time
オブジェクトcal
- ドライバが時間を作成するために使用するjava.util.Calendar
オブジェクト- 例外:
SQLException
- エラーが発生した場合、またはパラメータ・インデックスが範囲外である場合- 関連項目:
getParams()
-
setTimestamp
public void setTimestamp(int parameterIndex, Timestamp x, Calendar cal) throws SQLException
指定されたパラメータを指定されたjava.sql.Timestamp
オブジェクトに設定します。 データベースに送るときに、ドライバはこれをSQLTIMESTAMP
値に変換します。DBMSにタイムゾーン情報が格納されていない場合、ドライバは指定された
Calendar
オブジェクトを使用して、SQLTIMESTAMP
値を作成し、これをデータベースに送ります。Calendar
オブジェクトを使用する場合、ドライバはカスタム・タイムゾーンを考慮してタイムスタンプを計算できます。Calendar
オブジェクトを指定しない場合、ドライバは、アプリケーションを実行している仮想マシンのタイムゾーンを使用します。このメソッドで設定されたパラメータ値は内部で格納され、
execute
メソッドの呼出し時に、このRowSet
オブジェクトのコマンド内の適切なパラメータとして提供されます。execute
、populate
などのメソッドは、このクラスを拡張し、標準JSR-114RowSet
インタフェースを1つ以上実装するクラスで提供される必要があります。ノート:
JdbcRowSet
はpopulate
メソッドを必要としません。このメソッドは、このクラス内に定義されていません。このバージョンの
setTimestamp
を呼び出した後でメソッドgetParams
を呼び出すと、設定されたパラメータ値を含む配列が返されます。 その配列内で、このメソッドで設定された値を表す要素はそれ自体が配列になります。 その配列の最初の要素は、指定されたjava.sql.Timestamp
オブジェクトです。 2番目の要素は、calに設定された値です。 パラメータ番号はメソッドgetParams
から返される配列内での要素の位置によって示され、最初の要素は最初のプレースホルダー・パラメータの値、2番目の要素は2番目のプレースホルダー・パラメータの値、といった具合になります。 言い換えると、設定するタイムスタンプが2番目のプレースホルダー・パラメータの値である場合、その値を含む配列は、getParams
から返される配列内の2番目の要素になります。配列内の要素の番号付けはゼロから開始されるので、プレースホルダー番号parameterIndexに対応する配列要素はparameterIndex -1になります。
- パラメータ:
parameterIndex
- このRowSet
オブジェクトのコマンド内の、設定対象となるプレースホルダー・パラメータの順序番号。 最初のパラメータが1、2番目のパラメータが2、といった具合になる。1
以上でなければいけないx
-java.sql.Timestamp
オブジェクトcal
- ドライバがタイムスタンプを作成するために使用するjava.util.Calendar
オブジェクト- 例外:
SQLException
- エラーが発生した場合、またはパラメータ・インデックスが範囲外である場合- 関連項目:
getParams()
-
clearParameters
public void clearParameters() throws SQLException
このRowSet
オブジェクトのコマンドの実行時に設定される、このRowSet
オブジェクトのパラメータの内部表現に含まれる現在のパラメータ値をすべてクリアします。通常、この
RowSet
オブジェクトのコマンド内で再利用できるように、パラメータ値は有効なままです。 設定メソッドを使ってパラメータ値を設定すると、指定されたパラメータの値は自動的にクリアされ、新しく指定された値で置き換えられます。このメソッドは、
setCommand
メソッドによって内部で呼び出され、以前のコマンドに設定されたすべてのパラメータをクリアします。このメソッドは、
RowSet
オブジェクトのスキーマを確保する点で、initParams
メソッドとは異なります。- 例外:
SQLException
- パラメータのクリア時にエラーが発生した場合
-
getParams
public Object[] getParams() throws SQLException
このRowSet
オブジェクトのコマンドに設定されたパラメータ値(オブジェクトとプリミティブ)を含む配列を取得し、すべてのパラメータが設定されていない場合はSQLException
オブジェクトをスローします。 コマンドがDBMSに送信され、実行される前に、これらのパラメータは、BaseRowSet
クラスを拡張するRowSet
実装のコマンドであるPreparedStatement
オブジェクト内のプレースホルダー・パラメータで置き換えられます。返される配列内の各要素は、設定メソッドに提供されるパラメータの値を含む
Object
インスタンスになります。 要素の順番は、parameterIndexの値によって決定されます。 設定メソッドがパラメータ・インデックスと設定される値(通常null)だけを取る場合、配列要素には、設定される値(Object
で表される)が含まれます。 追加パラメータがある場合、配列要素自体が、設定される値と、設定メソッドに提供される追加パラメータ値を含む配列になります。 メソッドがストリームを設定する場合、配列要素には、メソッドに提供されるストリームの型が含まれます。 これらの追加パラメータは、ドライバまたはDBMSを対象としており、使用してもしなくてもかまいません。ノート:
Array
型、Blob
型、Clob
型、およびRef
型の格納されたパラメータ値は、それぞれSerialArray
、SerialBlob
、SerialClob
、SerialRef
で返されます。- 戻り値:
- この
RowSet
オブジェクトのコマンドで設定されるパラメータ値を含むObject
インスタンスの配列。パラメータが何も設定されていない場合は空の配列 - 例外:
SQLException
- このRowSet
オブジェクトのパラメータのオブジェクト配列の取得中にエラーが発生した場合、またはパラメータが何も設定されていない場合
-
setNull
public void setNull(String parameterName, int sqlType) throws SQLException
指定されたパラメータをSQLNULL
に設定します。ノート: パラメータのSQLの型を指定する必要があります。
- パラメータ:
parameterName
- パラメータの名前sqlType
-java.sql.Types
で定義されるSQL型コード- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatement
について呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合
-
setNull
public void setNull(String parameterName, int sqlType, String typeName) throws SQLException
指定されたパラメータをSQLNULL
に設定します。 ユーザー定義型およびREF型のパラメータでは、このバージョンのsetNull
メソッドを使用するべきです。 ユーザー定義型の例には、STRUCT、DISTINCT、JAVA_OBJECT、および名前付き配列があります。ノート: 移植性を実現するためには、アプリケーションはNULLのユーザー定義パラメータまたはREFパラメータを指定するときにSQL型コードおよび完全修飾SQL型名を指定しなければいけません。 ユーザー定義型の場合、名前はパラメータ自体の型名です。 REFパラメータの場合、名前は参照される型の型名です。 JDBCドライバが型コードまたは型名の情報を必要としない場合、それは無視されます。 ユーザー定義パラメータおよびREFパラメータを対象としていますが、このメソッドは任意のJDBC型のnullパラメータを設定するために使用できます。 パラメータがユーザー定義の型またはREF型を持たない場合、指定されたtypeNameは無視されます。
- パラメータ:
parameterName
- パラメータの名前sqlType
-java.sql.Types
からの値typeName
- SQLユーザー定義型の完全修飾名。パラメータがユーザー定義型でもSQLREF
値でもない場合は無視される- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatement
について呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合
-
setBoolean
public void setBoolean(String parameterName, boolean x) throws SQLException
指定されたパラメータを指定されたJavaのboolean
値に設定します。 データベースに送るときに、ドライバはこれをSQLBIT
またはBOOLEAN
値に変換します。- パラメータ:
parameterName
- パラメータの名前x
- パラメータ値- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatement
について呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 関連項目:
getParams()
-
setByte
public void setByte(String parameterName, byte x) throws SQLException
指定されたパラメータを指定されたJavaのbyte
値に設定します。 データベースに送るときに、ドライバはこれをSQLTINYINT
値に変換します。- パラメータ:
parameterName
- パラメータの名前x
- パラメータ値- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatement
について呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 関連項目:
getParams()
-
setShort
public void setShort(String parameterName, short x) throws SQLException
指定されたパラメータを指定されたJavaのshort
値に設定します。 データベースに送るときに、ドライバはこれをSQLSMALLINT
値に変換します。- パラメータ:
parameterName
- パラメータの名前x
- パラメータ値- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatement
について呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 関連項目:
getParams()
-
setInt
public void setInt(String parameterName, int x) throws SQLException
指定されたパラメータを指定されたJavaのint
値に設定します。 データベースに送るときに、ドライバはこれをSQLINTEGER
値に変換します。- パラメータ:
parameterName
- パラメータの名前x
- パラメータ値- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatement
について呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 関連項目:
getParams()
-
setLong
public void setLong(String parameterName, long x) throws SQLException
指定されたパラメータを指定されたJavaのlong
値に設定します。 データベースに送るときに、ドライバはこれをSQLBIGINT
値に変換します。- パラメータ:
parameterName
- パラメータの名前x
- パラメータ値- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatement
について呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 関連項目:
getParams()
-
setFloat
public void setFloat(String parameterName, float x) throws SQLException
指定されたパラメータを指定されたJavaのfloat
値に設定します。 データベースに送るときに、ドライバはこれをSQLFLOAT
値に変換します。- パラメータ:
parameterName
- パラメータの名前x
- パラメータ値- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatement
について呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 関連項目:
getParams()
-
setDouble
public void setDouble(String parameterName, double x) throws SQLException
指定されたパラメータを指定されたJavaのdouble
値に設定します。 データベースに送るときに、ドライバはこれをSQLDOUBLE
値に変換します。- パラメータ:
parameterName
- パラメータの名前x
- パラメータ値- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatement
について呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 関連項目:
getParams()
-
setBigDecimal
public void setBigDecimal(String parameterName, BigDecimal x) throws SQLException
指定されたパラメータを、指定されたjava.math.BigDecimal
値に設定します。 データベースに送るときに、ドライバはこれをSQLNUMERIC
値に変換します。- パラメータ:
parameterName
- パラメータの名前x
- パラメータ値- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatement
について呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 関連項目:
getParams()
-
setString
public void setString(String parameterName, String x) throws SQLException
指定されたパラメータを指定されたJavaのString
値に設定します。 データベースに送るときに、ドライバはこれをSQLVARCHAR
またはLONGVARCHAR
値(ドライバのVARCHAR
値の制限に対する引数のサイズに依存)に変換します。- パラメータ:
parameterName
- パラメータの名前x
- パラメータ値- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatement
について呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 関連項目:
getParams()
-
setBytes
public void setBytes(String parameterName, byte[] x) throws SQLException
指定されたパラメータを指定されたJavaのバイト配列に設定します。 データベースに送るときに、ドライバはこれをSQLVARBINARY
またはLONGVARBINARY
(ドライバのVARBINARY
値の制限に対する引数のサイズに依存)に変換します。- パラメータ:
parameterName
- パラメータの名前x
- パラメータ値- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatement
について呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 関連項目:
getParams()
-
setTimestamp
public void setTimestamp(String parameterName, Timestamp x) throws SQLException
指定されたパラメータを、指定されたjava.sql.Timestamp
値に設定します。 データベースに送るときに、ドライバはこれをSQLTIMESTAMP
値に変換します。- パラメータ:
parameterName
- パラメータの名前x
- パラメータ値- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatement
について呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 関連項目:
getParams()
-
setAsciiStream
public void setAsciiStream(String parameterName, InputStream x, int length) throws SQLException
指定されたパラメータを、指定されたバイト数を持つ指定された入力ストリームに設定します。LONGVARCHAR
パラメータに非常に大きなASCII値が入力されるときには、java.io.InputStream
を介して送るのが現実的です。 ファイルの終わりに達するまで必要に応じてストリームからデータが読み込まれます。 JDBCドライバは、データをASCIIからデータベースのchar形式に変換します。ノート: このストリーム・オブジェクトは、標準のJavaストリーム・オブジェクト、または標準インタフェースを実装する独自のサブクラスのどちらでもかまいません。
- パラメータ:
parameterName
- パラメータの名前x
- ASCIIパラメータ値を含むJava入力ストリームlength
- ストリームのバイト数- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatement
について呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合
-
setBinaryStream
public void setBinaryStream(String parameterName, InputStream x, int length) throws SQLException
指定されたパラメータを、指定されたバイト数を持つ指定された入力ストリームに設定します。LONGVARBINARY
パラメータに非常に大きなバイナリ値が入力されるときには、java.io.InputStream
オブジェクトを介して送るのが現実的です。 ファイルの終わりに達するまで必要に応じてストリームからデータが読み込まれます。ノート: このストリーム・オブジェクトは、標準のJavaストリーム・オブジェクト、または標準インタフェースを実装する独自のサブクラスのどちらでもかまいません。
- パラメータ:
parameterName
- パラメータの名前x
- バイナリ・パラメータ値を含むJava入力ストリームlength
- ストリームのバイト数- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatement
について呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合
-
setCharacterStream
public void setCharacterStream(String parameterName, Reader reader, int length) throws SQLException
指定されたパラメータを、指定された文字数である指定されたReader
オブジェクトに設定します。LONGVARCHAR
パラメータに非常に大きなUNICODE値が入力されるときには、java.io.Reader
オブジェクトを介して送るのが現実的です。 ファイルの終わりに達するまで必要に応じてストリームからデータが読み込まれます。 JDBCドライバは、データをUNICODEからデータベースのchar形式に変換します。ノート: このストリーム・オブジェクトは、標準のJavaストリーム・オブジェクト、または標準インタフェースを実装する独自のサブクラスのどちらでもかまいません。
- パラメータ:
parameterName
- パラメータの名前reader
- 指定されたパラメータとして使用されるUNICODEデータを含むjava.io.Reader
オブジェクトlength
- ストリーム内の文字数- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatement
について呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合
-
setAsciiStream
public void setAsciiStream(String parameterName, InputStream x) throws SQLException
指定されたパラメータを指定された入力ストリームに設定します。LONGVARCHAR
パラメータに非常に大きなASCII値が入力されるときには、java.io.InputStream
を介して送るのが現実的です。 ファイルの終わりに達するまで必要に応じてストリームからデータが読み込まれます。 JDBCドライバは、データをASCIIからデータベースのchar形式に変換します。ノート: このストリーム・オブジェクトは、標準のJavaストリーム・オブジェクト、または標準インタフェースを実装する独自のサブクラスのどちらでもかまいません。
ノート: lengthパラメータを使用するバージョンの
setAsciiStream
を使用する方が効率的かどうかを判断するには、JDBCドライバのドキュメントを参照してください。- パラメータ:
parameterName
- パラメータの名前x
- ASCIIパラメータ値を含むJava入力ストリーム- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatement
について呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
setBinaryStream
public void setBinaryStream(String parameterName, InputStream x) throws SQLException
指定されたパラメータを指定された入力ストリームに設定します。LONGVARBINARY
パラメータに非常に大きなバイナリ値が入力されるときには、java.io.InputStream
オブジェクトを介して送るのが現実的です。 ファイルの終わりに達するまで必要に応じてストリームからデータが読み込まれます。ノート: このストリーム・オブジェクトは、標準のJavaストリーム・オブジェクト、または標準インタフェースを実装する独自のサブクラスのどちらでもかまいません。
ノート: lengthパラメータを使用するバージョンの
setBinaryStream
を使用する方が効率的かどうかを判断するには、JDBCドライバのドキュメントを参照してください。- パラメータ:
parameterName
- パラメータの名前x
- バイナリ・パラメータ値を含むJava入力ストリーム- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatement
について呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
setCharacterStream
public void setCharacterStream(String parameterName, Reader reader) throws SQLException
指定されたパラメータを指定されたReader
オブジェクトに設定します。LONGVARCHAR
パラメータに非常に大きなUNICODE値が入力されるときには、java.io.Reader
オブジェクトを介して送るのが現実的です。 ファイルの終わりに達するまで必要に応じてストリームからデータが読み込まれます。 JDBCドライバは、データをUNICODEからデータベースのchar形式に変換します。ノート: このストリーム・オブジェクトは、標準のJavaストリーム・オブジェクト、または標準インタフェースを実装する独自のサブクラスのどちらでもかまいません。
ノート: lengthパラメータを使用するバージョンの
setCharacterStream
を使用する方が効率的かどうかを判断するには、JDBCドライバのドキュメントを参照してください。- パラメータ:
parameterName
- パラメータの名前reader
- Unicodeデータを格納するjava.io.Reader
オブジェクト- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatement
について呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
setNCharacterStream
public void setNCharacterStream(int parameterIndex, Reader value) throws SQLException
このRowSet
オブジェクトのコマンド内の指定されたパラメータを、Reader
オブジェクトに設定します。Reader
は、ファイルの終わりに達するまでデータを読み込みます。 ドライバは、必要に応じて、Javaの文字表現をデータベース内の各国文字セットに変換します。ノート: このストリーム・オブジェクトは、標準のJavaストリーム・オブジェクト、または標準インタフェースを実装する独自のサブクラスのどちらでもかまいません。
ノート: lengthパラメータを使用するバージョンの
setNCharacterStream
を使用する方が効率的かどうかを判断するには、JDBCドライバのドキュメントを参照してください。- パラメータ:
parameterIndex
- 最初のパラメータのインデックスは1、2番目のパラメータのインデックスは2、... となるvalue
- パラメータ値- 例外:
SQLException
- ドライバが各国文字セットをサポートしない場合、ドライバがデータ変換エラーが発生した可能性を検出できる場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたPreparedStatement
上で呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
setObject
public void setObject(String parameterName, Object x, int targetSqlType, int scale) throws SQLException
指定されたパラメータの値を、指定されたオブジェクトで設定します。 2番目の引数はオブジェクト型である必要があります。整数値の場合は等価なjava.lang
オブジェクトを使用すべきです。指定されたJavaオブジェクトは、データベースに送られる前に、指定されたtargetSqlTypeに変換されます。 オブジェクトがカスタム・マッピングを持つ場合(オブジェクトがインタフェース
SQLData
を実装するクラスのインスタンスである場合)、JDBCドライバはSQLData.writeSQL
メソッドを呼び出して、そのオブジェクトをSQLデータ・ストリームへ書き込む必要があります。 また、オブジェクトがRef
、Blob
、Clob
、NClob
、Struct
、java.net.URL
、またはArray
を実装するクラスのオブジェクトである場合、ドライバはこのオブジェクトを対応するSQL型の値としてデータベースに渡す必要があります。このメソッドは、データベース固有の抽象データ型を渡すために使用することに注意してください。
- パラメータ:
parameterName
- パラメータの名前x
- 入力パラメータ値を含むオブジェクトtargetSqlType
- データベースに送られる(java.sql.Typesで定義される) SQL型。 scale引数で、さらにこの型を限定できる。scale
- java.sql.Types.DECIMALやjava.sql.Types.NUMERIC型では、小数点以下の桁数。 ほかのすべての型では、この値は無視される。- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatement
について呼び出された場合SQLFeatureNotSupportedException
-targetSqlType
のデータ型が、ARRAY
、BLOB
、CLOB
、DATALINK
、JAVA_OBJECT
、NCHAR
、NCLOB
、NVARCHAR
、LONGNVARCHAR
、REF
、ROWID
、SQLXML
、またはSTRUCT
で、JDBCドライバがこのデータ型をサポートしていない場合- 関連項目:
Types
、getParams()
-
setObject
public void setObject(String parameterName, Object x, int targetSqlType) throws SQLException
指定されたパラメータの値を、指定されたオブジェクトで設定します。 このメソッドは、上記のsetObject
メソッドに似ていますが、scaleに0を仮定している点が異なります。- パラメータ:
parameterName
- パラメータの名前x
- 入力パラメータ値を含むオブジェクトtargetSqlType
- データベースに送られる(java.sql.Typesで定義される) SQL型- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatement
について呼び出された場合SQLFeatureNotSupportedException
-targetSqlType
のデータ型が、ARRAY
、BLOB
、CLOB
、DATALINK
、JAVA_OBJECT
、NCHAR
、NCLOB
、NVARCHAR
、LONGNVARCHAR
、REF
、ROWID
、SQLXML
、またはSTRUCT
で、JDBCドライバがこのデータ型をサポートしていない場合- 関連項目:
getParams()
-
setObject
public void setObject(String parameterName, Object x) throws SQLException
指定されたパラメータの値を、指定されたオブジェクトで設定します。 2番目のパラメータはObject
型である必要があります。したがって、組込み型の場合、等価なjava.lang
オブジェクトを使用すべきです。JDBCの仕様では、Javaの
Object
型からSQL型への標準マッピングを規定しています。 指定された引数は、データベースに送られる前に、対応するSQL型に変換されます。このメソッドは、ドライバ固有のJava型を使用して、データベース固有の抽象データ型を渡すために使用できます。 オブジェクトがインタフェース
SQLData
を実装するクラスのインスタンスである場合、JDBCドライバはSQLData.writeSQL
メソッドを呼び出して、そのオブジェクトをSQLデータ・ストリームへ書き込む必要があります。 また、オブジェクトがRef
、Blob
、Clob
、NClob
、Struct
、java.net.URL
、またはArray
を実装するクラスのオブジェクトである場合、ドライバはこのオブジェクトを対応するSQL型の値としてデータベースに渡す必要があります。たとえば、オブジェクトが上記のインタフェースを複数実装するクラスであるなど、あいまいさがある場合、このメソッドは例外をスローします。
- パラメータ:
parameterName
- パラメータの名前x
- 入力パラメータ値を含むオブジェクト- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合、このメソッドがクローズされたCallableStatement
で呼び出された場合、または指定されたObject
パラメータがあいまいな場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 関連項目:
getParams()
-
setBlob
public void setBlob(int parameterIndex, InputStream inputStream, long length) throws SQLException
指定されたパラメータをInputStream
オブジェクトに設定します。InputStream
には、長さで指定された文字数が含まれていなければなりません。それ以外の場合は、PreparedStatement
が実行されるときにSQLException
が生成されます。 このメソッドは、setBinaryStream (int, InputStream, int)
メソッドと異なり、パラメータ値をBLOB
としてサーバーに送信するべきであることをドライバに通知します。setBinaryStream
メソッドを使用すると、ドライバは、パラメータ・データをLONGVARBINARY
とBLOB
のどちらとしてサーバーに送信するべきかを判断するために余計な作業を行う必要がある可能性があります。- パラメータ:
parameterIndex
- 最初のパラメータのインデックスは1、2番目のパラメータのインデックスは2、... となるinputStream
- パラメータ値に設定されるデータを含むオブジェクト。length
- パラメータ・データ内のバイト数。- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合、parameterIndexがSQL文のパラメータ・マーカーに対応していない場合、指定された長さが0より小さい場合、またはInputStream
のバイト数が一致しない場合、閉じたPreparedStatement
に対してこのメソッドが呼び出されます。SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
setBlob
public void setBlob(int parameterIndex, InputStream inputStream) throws SQLException
指定されたパラメータをInputStream
オブジェクトに設定します。 このメソッドは、setBinaryStream (int, InputStream)
メソッドと異なり、パラメータ値をBLOB
としてサーバーに送信しなければならないことをドライバに通知します。setBinaryStream
メソッドを使用すると、ドライバは、パラメータ・データをLONGVARBINARY
とBLOB
のどちらとしてサーバーに送信するべきかを判断するために余計な作業を行う必要がある可能性があります。ノート: lengthパラメータを使用するバージョンの
setBlob
を使用する方が効率的かどうかを判断するには、JDBCドライバのドキュメントを参照してください。- パラメータ:
parameterIndex
- 最初のパラメータのインデックスは1、2番目のパラメータのインデックスは2、... となるinputStream
- パラメータ値に設定されるデータを含むオブジェクト。- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合、このメソッドがクローズされたPreparedStatement
で呼び出された場合、またはparameterIndexがSQL文のパラメータ・マーカーと対応していない場合、SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
setBlob
public void setBlob(String parameterName, InputStream inputStream, long length) throws SQLException
指定されたパラメータをInputStream
オブジェクトに設定します。Inputstream
にはlengthで指定された文字数が含まれていなければなりません。そうでない場合は、CallableStatement
が実行されるときにSQLException
が生成されます。 このメソッドは、setBinaryStream (int, InputStream, int)
メソッドと異なり、パラメータ値をBLOB
としてサーバーに送信するべきであることをドライバに通知します。setBinaryStream
メソッドを使用すると、ドライバは、パラメータ・データをLONGVARBINARY
とBLOB
のどちらとしてサーバーに送信するべきかを判断するために余計な作業を行う必要がある可能性があります。- パラメータ:
parameterName
- 2番目は2に設定されるパラメータの名前inputStream
- パラメータ値に設定されるデータを含むオブジェクト。length
- パラメータ・データ内のバイト数。- 例外:
SQLException
- parameterIndexがSQL文のパラメータ・マーカーに対応していない場合、または指定された長さがゼロ未満の場合。InputStream
のバイト数が指定された長さと一致しない場合データベース・アクセス・エラーが発生した場合、またはこのメソッドが閉じられたCallableStatement
で呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
setBlob
public void setBlob(String parameterName, Blob x) throws SQLException
指定されたパラメータを指定されたjava.sql.Blob
オブジェクトに設定します。 データベースに送るときに、ドライバはこれをSQLBLOB
値に変換します。- パラメータ:
parameterName
- パラメータの名前x
- SQLBLOB
値をマッピングするBlob
オブジェクト- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatement
について呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
setBlob
public void setBlob(String parameterName, InputStream inputStream) throws SQLException
指定されたパラメータをInputStream
オブジェクトに設定します。 このメソッドは、setBinaryStream (int, InputStream)
メソッドと異なり、パラメータ値をBLOB
としてサーバーに送信しなければならないことをドライバに通知します。setBinaryStream
メソッドを使用すると、ドライバは、パラメータ・データをLONGVARBINARY
とBLOB
のどちらとしてサーバーに送信するかを判断するために余計な作業を行う必要がある可能性があります。ノート: lengthパラメータを使用するバージョンの
setBlob
を使用する方が効率的かどうかを判断するには、JDBCドライバのドキュメントを参照してください。- パラメータ:
parameterName
- パラメータの名前inputStream
- パラメータ値に設定されるデータを含むオブジェクト。- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatement
について呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
setClob
public void setClob(int parameterIndex, Reader reader, long length) throws SQLException
指定されたパラメータをReader
オブジェクトに設定します。 readerには、lengthで指定された文字数が含まれている必要があります。そうでない場合、PreparedStatement
の実行時にSQLException
が生成されます。 このメソッドは、setCharacterStream (int, Reader, int)
メソッドと異なり、パラメータ値をCLOB
としてサーバーに送信するべきであることをドライバに通知します。setCharacterStream
メソッドを使用すると、ドライバは、パラメータ・データをLONGVARCHAR
とCLOB
のどちらとしてサーバーに送信するべきかを判断するために余計な作業を行う必要がある可能性があります。- パラメータ:
parameterIndex
- 最初のパラメータのインデックスは1、2番目のパラメータのインデックスは2、... となるreader
- パラメータ値に設定されるデータを含むオブジェクト。length
- パラメータ・データ内の文字数。- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合、このメソッドがクローズされたPreparedStatement
で呼び出された場合、parameterIndexがSQL文のパラメータ・マーカーと対応していない場合、または長さとしてゼロ未満の値が指定された場合。SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
setClob
public void setClob(int parameterIndex, Reader reader) throws SQLException
指定されたパラメータをReader
オブジェクトに設定します。 このメソッドは、setCharacterStream (int, Reader)
メソッドと異なり、パラメータ値をCLOB
としてサーバーに送信するべきであることをドライバに通知します。setCharacterStream
メソッドを使用すると、ドライバは、パラメータ・データをLONGVARCHAR
とCLOB
のどちらとしてサーバーに送信するべきかを判断するために余計な作業を行う必要がある可能性があります。ノート: lengthパラメータを使用するバージョンの
setClob
を使用する方が効率的かどうかを判断するには、JDBCドライバのドキュメントを参照してください。- パラメータ:
parameterIndex
- 最初のパラメータのインデックスは1、2番目のパラメータのインデックスは2、... となるreader
- パラメータ値に設定されるデータを含むオブジェクト。- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合、このメソッドがクローズされたPreparedStatement
で呼び出された場合、またはparameterIndexがSQL文のパラメータ・マーカーと対応していない場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
setClob
public void setClob(String parameterName, Reader reader, long length) throws SQLException
指定されたパラメータをReader
オブジェクトに設定します。reader
には、lengthで指定された文字数が含まれている必要があります。そうでない場合、CallableStatement
の実行時にSQLException
が生成されます。 このメソッドは、setCharacterStream (int, Reader, int)
メソッドと異なり、パラメータ値をCLOB
としてサーバーに送信するべきであることをドライバに通知します。setCharacterStream
メソッドを使用すると、ドライバは、パラメータ・データをLONGVARCHAR
とCLOB
のどちらとしてサーバーに送信するかを判断するために余計な作業を行う必要がある可能性があります。- パラメータ:
parameterName
- 設定されるパラメータの名前。reader
- パラメータ値に設定されるデータを含むオブジェクト。length
- パラメータ・データ内の文字数。- 例外:
SQLException
- parameterIndexがSQL文のパラメータ・マーカーと対応していない場合、長さとしてゼロ未満の値が指定された場合、データベース・アクセス・エラーが発生した場合、このメソッドがクローズされたCallableStatement
で呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
setClob
public void setClob(String parameterName, Clob x) throws SQLException
指定されたパラメータを指定されたjava.sql.Clob
オブジェクトに設定します。 データベースに送るときに、ドライバはこれをSQLCLOB
値に変換します。- パラメータ:
parameterName
- パラメータの名前x
- SQLCLOB
値をマッピングするClob
オブジェクト- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatement
について呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
setClob
public void setClob(String parameterName, Reader reader) throws SQLException
指定されたパラメータをReader
オブジェクトに設定します。 このメソッドは、setCharacterStream (int, Reader)
メソッドと異なり、パラメータ値をCLOB
としてサーバーに送信するべきであることをドライバに通知します。setCharacterStream
メソッドを使用すると、ドライバは、パラメータ・データをLONGVARCHAR
とCLOB
のどちらとしてサーバーに送信するかを判断するために余計な作業を行う必要がある可能性があります。ノート: lengthパラメータを使用するバージョンの
setClob
を使用する方が効率的かどうかを判断するには、JDBCドライバのドキュメントを参照してください。- パラメータ:
parameterName
- パラメータの名前reader
- パラメータ値に設定されるデータを含むオブジェクト。- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatement
について呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
setDate
public void setDate(String parameterName, Date x) throws SQLException
アプリケーションを実行している仮想マシンのデフォルトのタイムゾーンを使用して、指定されたパラメータを指定されたjava.sql.Date
値に設定します。 データベースに送るときに、ドライバはこれをSQLDATE
値に変換します。- パラメータ:
parameterName
- パラメータの名前x
- パラメータ値- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatement
について呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 関連項目:
getParams()
-
setDate
public void setDate(String parameterName, Date x, Calendar cal) throws SQLException
指定されたCalendar
オブジェクトを使用して、指定されたパラメータを指定されたjava.sql.Date
値に設定します。 ドライバはCalendar
オブジェクトを使用してSQLDATE
値を作成し、続いてそれをデータベースに送ります。Calendar
オブジェクトを使用すると、ドライバはカスタム・タイムゾーンを考慮して日付を計算できます。Calendar
オブジェクトを指定しない場合、ドライバは、アプリケーションを実行している仮想マシンのタイムゾーンであるデフォルトのタイムゾーンを使用します。- パラメータ:
parameterName
- パラメータの名前x
- パラメータ値cal
- ドライバが日付を作成するために使用するCalendar
オブジェクト- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatement
について呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 関連項目:
getParams()
-
setTime
public void setTime(String parameterName, Time x) throws SQLException
指定されたパラメータを、指定されたjava.sql.Time
値に設定します。 データベースに送るときに、ドライバはこれをSQLTIME
値に変換します。- パラメータ:
parameterName
- パラメータの名前x
- パラメータ値- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatement
について呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 関連項目:
getParams()
-
setTime
public void setTime(String parameterName, Time x, Calendar cal) throws SQLException
指定されたCalendar
オブジェクトを使用して、指定されたパラメータを指定されたjava.sql.Time
値に設定します。 ドライバはCalendar
オブジェクトを使用してSQLTIME
値を作成し、続いてそれをデータベースに送ります。Calendar
オブジェクトを使用すると、ドライバはカスタム・タイムゾーンを考慮して時間を計算できます。Calendar
オブジェクトを指定しない場合、ドライバは、アプリケーションを実行している仮想マシンのタイムゾーンであるデフォルトのタイムゾーンを使用します。- パラメータ:
parameterName
- パラメータの名前x
- パラメータ値cal
- ドライバが時間を作成するために使用するCalendar
オブジェクト- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatement
について呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 関連項目:
getParams()
-
setTimestamp
public void setTimestamp(String parameterName, Timestamp x, Calendar cal) throws SQLException
指定されたCalendar
オブジェクトを使用して、指定されたパラメータを指定されたjava.sql.Timestamp
値に設定します。 ドライバはCalendar
オブジェクトを使用してSQLTIMESTAMP
値を作成し、続いてそれをデータベースに送ります。Calendar
オブジェクトを使用すると、ドライバはカスタム・タイムゾーンを考慮してタイムスタンプを計算できます。Calendar
オブジェクトを指定しない場合、ドライバは、アプリケーションを実行している仮想マシンのタイムゾーンであるデフォルトのタイムゾーンを使用します。- パラメータ:
parameterName
- パラメータの名前x
- パラメータ値cal
- ドライバがタイムスタンプを作成するために使用するCalendar
オブジェクト- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatement
について呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 関連項目:
getParams()
-
setSQLXML
public void setSQLXML(int parameterIndex, SQLXML xmlObject) throws SQLException
指定されたパラメータを指定されたjava.sql.SQLXML
オブジェクトに設定します。 データベースに送るときに、ドライバはこれをSQLXML
値に変換します。- パラメータ:
parameterIndex
- 最初のパラメータのインデックスは1、2番目のパラメータのインデックスは2、... となるxmlObject
- SQLXML
値をマッピングするSQLXML
オブジェクト- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合、このメソッドがクローズされた結果セットで呼び出された場合、SQLXML
オブジェクト用のjava.xml.transform.Result
、Writer
、またはOutputStream
がクローズされていない場合、あるいはXML値の処理中にエラーが発生した場合。 この例外のgetCause
メソッドにより、より詳細な例外が提供されることがある(たとえばストリームに有効なXMLが含まれていない場合)。SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
setSQLXML
public void setSQLXML(String parameterName, SQLXML xmlObject) throws SQLException
指定されたパラメータを指定されたjava.sql.SQLXML
オブジェクトに設定します。 データベースに送るときに、ドライバはこれをSQL XML
値に変換します。- パラメータ:
parameterName
- パラメータの名前xmlObject
-SQL XML
値をマッピングするSQLXML
オブジェクト- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合、このメソッドがクローズされた結果セットで呼び出された場合、SQLXML
オブジェクト用のjava.xml.transform.Result
、Writer
、またはOutputStream
がクローズされていない場合、あるいはXML値の処理中にエラーが発生した場合。 この例外のgetCause
メソッドにより、より詳細な例外が提供されることがある(たとえばストリームに有効なXMLが含まれていない場合)。SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
setRowId
public void setRowId(int parameterIndex, RowId x) throws SQLException
指定されたパラメータを指定されたjava.sql.RowId
オブジェクトに設定します。 データベースに送るときに、ドライバはこれをSQLROWID
値に変換します。- パラメータ:
parameterIndex
- 最初のパラメータは1、2番目のパラメータは2、... となるx
- パラメータ値- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
setRowId
public void setRowId(String parameterName, RowId x) throws SQLException
指定されたパラメータを指定されたjava.sql.RowId
オブジェクトに設定します。 データベースに送るときに、ドライバはこれをSQLROWID
に変換します。- パラメータ:
parameterName
- パラメータの名前x
- パラメータ値- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
setNString
public void setNString(int parameterIndex, String value) throws SQLException
指定されたパラメータを指定されたString
オブジェクトに設定します。 データベースに送るときに、ドライバはこれをSQLNCHAR
、NVARCHAR
、またはLONGNVARCHAR
値(ドライバのNVARCHAR
値に関する制限に関する引数のサイズに依存)に変換します。- パラメータ:
parameterIndex
- 最初のパラメータのインデックスは1、2番目のパラメータのインデックスは2、... となるvalue
- パラメータ値- 例外:
SQLException
- ドライバが各国文字セットをサポートしない場合、ドライバがデータ変換エラーが発生した可能性を検出できる場合、またはデータベース・アクセス・エラーが発生した場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
setNString
public void setNString(String parameterName, String value) throws SQLException
指定されたパラメータを指定されたString
オブジェクトに設定します。 ドライバはこれをSQLNCHAR
、NVARCHAR
、またはLONGNVARCHAR
に変換します。- パラメータ:
parameterName
- 設定される列の名前value
- パラメータ値- 例外:
SQLException
- ドライバが各国文字セットをサポートしない場合、ドライバがデータ変換エラーが発生した可能性を検出できる場合、またはデータベース・アクセス・エラーが発生した場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
setNCharacterStream
public void setNCharacterStream(int parameterIndex, Reader value, long length) throws SQLException
指定されたパラメータをReader
オブジェクトに設定します。Reader
は、ファイルの終わりに達するまでデータを読み込みます。 ドライバは、必要に応じて、Javaの文字表現をデータベース内の各国文字セットに変換します。- パラメータ:
parameterIndex
- 最初のパラメータのインデックスは1、2番目のパラメータのインデックスは2、... となるvalue
- パラメータ値length
- パラメータ・データ内の文字数。- 例外:
SQLException
- ドライバが各国文字セットをサポートしない場合、ドライバがデータ変換エラーが発生した可能性を検出できる場合、またはデータベース・アクセス・エラーが発生した場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
setNCharacterStream
public void setNCharacterStream(String parameterName, Reader value, long length) throws SQLException
指定されたパラメータをReader
オブジェクトに設定します。Reader
は、ファイルの終わりに達するまでデータを読み込みます。 ドライバは、必要に応じて、Javaの文字表現をデータベース内の各国文字セットに変換します。- パラメータ:
parameterName
- 設定される列の名前value
- パラメータ値length
- パラメータ・データ内の文字数。- 例外:
SQLException
- ドライバが各国文字セットをサポートしない場合、ドライバがデータ変換エラーが発生した可能性を検出できる場合、またはデータベース・アクセス・エラーが発生した場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
setNCharacterStream
public void setNCharacterStream(String parameterName, Reader value) throws SQLException
指定されたパラメータをReader
オブジェクトに設定します。Reader
は、ファイルの終わりに達するまでデータを読み込みます。 ドライバは、必要に応じて、Javaの文字表現をデータベース内の各国文字セットに変換します。ノート: このストリーム・オブジェクトは、標準のJavaストリーム・オブジェクト、または標準インタフェースを実装する独自のサブクラスのどちらでもかまいません。
ノート: lengthパラメータを使用するバージョンの
setNCharacterStream
を使用する方が効率的かどうかを判断するには、JDBCドライバのドキュメントを参照してください。- パラメータ:
parameterName
- パラメータの名前value
- パラメータ値- 例外:
SQLException
- ドライバが各国文字セットをサポートしない場合、ドライバがデータ変換エラーが発生した可能性を検出できる場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatement
上で呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
setNClob
public void setNClob(String parameterName, NClob value) throws SQLException
指定されたパラメータをjava.sql.NClob
オブジェクトに設定します。 このオブジェクトは、java.sql.NClob
インタフェースを実装します。 このNClob
オブジェクトは、SQLNCLOB
にマッピングされます。- パラメータ:
parameterName
- 設定される列の名前value
- パラメータ値- 例外:
SQLException
- ドライバが各国文字セットをサポートしない場合、ドライバがデータ変換エラーが発生した可能性を検出できる場合、またはデータベース・アクセス・エラーが発生した場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
setNClob
public void setNClob(String parameterName, Reader reader, long length) throws SQLException
指定されたパラメータをReader
オブジェクトに設定します。reader
には、lengthで指定された文字数が含まれている必要があります。そうでない場合、CallableStatement
の実行時にSQLException
が生成されます。 このメソッドは、setCharacterStream (int, Reader, int)
メソッドと異なり、パラメータ値をNCLOB
としてサーバーに送信するべきであることをドライバに通知します。setCharacterStream
メソッドを使用すると、ドライバは、パラメータ・データをLONGNVARCHAR
とNCLOB
のどちらとしてサーバーに送信するかを判断するために余計な作業を行う必要がある可能性があります。- パラメータ:
parameterName
- 設定されるパラメータの名前。reader
- パラメータ値に設定されるデータを含むオブジェクト。length
- パラメータ・データ内の文字数。- 例外:
SQLException
- parameterIndexがSQL文のパラメータ・マーカーと対応していない場合、長さとしてゼロ未満の値が指定された場合、ドライバが各国文字セットをサポートしない場合、ドライバがデータ変換エラーが発生した可能性を検出できる場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatement
上で呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
setNClob
public void setNClob(String parameterName, Reader reader) throws SQLException
指定されたパラメータをReader
オブジェクトに設定します。 このメソッドは、setCharacterStream (int, Reader)
メソッドと異なり、パラメータ値をNCLOB
としてサーバーに送信しなければならないことをドライバに通知します。setCharacterStream
メソッドを使用すると、ドライバは、パラメータ・データをLONGNVARCHAR
とNCLOB
のどちらとしてサーバーに送信するかを判断するために余計な作業を行う必要がある可能性があります。ノート: lengthパラメータを使用するバージョンの
setNClob
を使用する方が効率的かどうかを判断するには、JDBCドライバのドキュメントを参照してください。- パラメータ:
parameterName
- パラメータの名前reader
- パラメータ値に設定されるデータを含むオブジェクト。- 例外:
SQLException
- ドライバが各国文字セットをサポートしない場合、ドライバがデータ変換エラーが発生した可能性を検出できる場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatement
上で呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
setNClob
public void setNClob(int parameterIndex, Reader reader, long length) throws SQLException
指定されたパラメータをReader
オブジェクトに設定します。 readerには、lengthで指定された文字数が含まれている必要があります。そうでない場合、PreparedStatement
の実行時にSQLException
が生成されます。 このメソッドは、setCharacterStream (int, Reader, int)
メソッドと異なり、パラメータ値をNCLOB
としてサーバーに送信するべきであることをドライバに通知します。setCharacterStream
メソッドを使用すると、ドライバは、パラメータ・データをLONGNVARCHAR
とNCLOB
のどちらとしてサーバーに送信するべきかを判断するために余計な作業を行う必要がある可能性があります。- パラメータ:
parameterIndex
- 最初のパラメータのインデックスは1、2番目のパラメータのインデックスは2、... となるreader
- パラメータ値に設定されるデータを含むオブジェクト。length
- パラメータ・データ内の文字数。- 例外:
SQLException
- parameterIndexがSQL文のパラメータ・マーカーと対応していない場合、長さとしてゼロ未満の値が指定された場合、ドライバが各国文字セットをサポートしない場合、ドライバがデータ変換エラーが発生した可能性を検出できる場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたPreparedStatement
上で呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
setNClob
public void setNClob(int parameterIndex, NClob value) throws SQLException
指定されたパラメータをjava.sql.NClob
オブジェクトに設定します。 データベースに送るときに、ドライバはこれをSQLNCLOB
値に変換します。- パラメータ:
parameterIndex
- 最初のパラメータのインデックスは1、2番目のパラメータのインデックスは2、... となるvalue
- パラメータ値- 例外:
SQLException
- ドライバが各国文字セットをサポートしない場合、ドライバがデータ変換エラーが発生した可能性を検出できる場合、またはデータベース・アクセス・エラーが発生した場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
setNClob
public void setNClob(int parameterIndex, Reader reader) throws SQLException
指定されたパラメータをReader
オブジェクトに設定します。 このメソッドは、setCharacterStream (int, Reader)
メソッドと異なり、パラメータ値をNCLOB
としてサーバーに送信しなければならないことをドライバに通知します。setCharacterStream
メソッドを使用すると、ドライバは、パラメータ・データをLONGNVARCHAR
とNCLOB
のどちらとしてサーバーに送信するべきかを判断するために余計な作業を行う必要がある可能性があります。ノート: lengthパラメータを使用するバージョンの
setNClob
を使用する方が効率的かどうかを判断するには、JDBCドライバのドキュメントを参照してください。- パラメータ:
parameterIndex
- 最初のパラメータのインデックスは1、2番目のパラメータのインデックスは2、... となるreader
- パラメータ値に設定されるデータを含むオブジェクト。- 例外:
SQLException
- parameterIndexがSQL文のパラメータ・マーカーに対応しない場合、ドライバが各国の文字セットをサポートしない場合、ドライバがデータ変換エラーが発生したことを検出できる場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたPreparedStatement
で呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
setURL
public void setURL(int parameterIndex, URL x) throws SQLException
指定されたパラメータを、指定されたjava.net.URL
値に設定します。 データベースに送るときに、ドライバはこれをSQLDATALINK
値に変換します。- パラメータ:
parameterIndex
- 最初のパラメータは1、2番目のパラメータは2、... となるx
- 設定されるjava.net.URL
オブジェクト- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたPreparedStatement
について呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合
-
-