-
- 既知のすべての実装クラス:
SQLInputImpl
public interface SQLInput
SQL構造化型またはSQLの個別の型のインスタンスを表す値のストリームを格納する入力ストリームです。 カスタム・マッピングにだけ使用されるこのインタフェースはドライバによって内部で使用され、SQLInput
メソッドをプログラマが直接呼び出すことはありません。 readerメソッド(readLong
、readBytes
など)を使用すると、SQLInput
オブジェクトの値を読み込むためにSQLData
インタフェースを実装することができます。SQLData
で説明したとおり、readerメソッドの呼出しは、対応する属性が型のSQL定義に出現する順序で行われる必要があります。 最終値がSQLNULL
であったかどうかの確認には、wasNull
メソッドが使用されます。getObject
メソッドがSQLData
インタフェースを実装するクラスのオブジェクトで呼び出されると、JDBCドライバはカスタム・マッピングされるユーザー定義型(UDT)のSQL型を判別するためにSQLData.getSQLType
メソッドを呼び出します。 ドライバは、SQLInput
のインスタンスを作成し、UDTの属性を移植します。 次に、ドライバは入力ストリームをSQLData.readSQL
メソッドに渡し、SQLData.readSQLメソッドはその実装で入力ストリームから属性を読み込むためのSQLInput
readerメソッドを呼び出します。- 導入されたバージョン:
- 1.2
-
-
メソッドのサマリー
すべてのメソッド インスタンス・メソッド 抽象メソッド デフォルト・メソッド 修飾子と型 メソッド 説明 Array
readArray()
ストリームからSQLARRAY
値を読み込み、その値をJavaプログラミング言語のArray
オブジェクトとして返します。InputStream
readAsciiStream()
ストリーム内の次の属性を読み込み、それをASCII文字のストリームとして返します。BigDecimal
readBigDecimal()
ストリーム内の次の属性を読み込み、それをJavaプログラミング言語のjava.math.BigDecimal
オブジェクトとして返します。InputStream
readBinaryStream()
ストリーム内の次の属性を読み込み、それを未解釈のバイト・ストリームとして返します。Blob
readBlob()
ストリームからSQLBLOB
値を読み込み、その値をJavaプログラミング言語のBlob
オブジェクトとして返します。boolean
readBoolean()
ストリーム内の次の属性を読み込み、それをJavaプログラミング言語のboolean
として返します。byte
readByte()
ストリーム内の次の属性を読み込み、それをJavaプログラミング言語のbyte
として返します。byte[]
readBytes()
ストリーム内の次の属性を読み込み、それをJavaプログラミング言語のバイトの配列として返します。Reader
readCharacterStream()
ストリーム内の次の属性を読み込み、それをUnicode文字のストリームとして返します。Clob
readClob()
ストリームからSQLCLOB
値を読み込み、その値をJavaプログラミング言語のClob
オブジェクトとして返します。Date
readDate()
ストリーム内の次の属性を読み込み、それをjava.sql.Date
オブジェクトとして返します。double
readDouble()
ストリーム内の次の属性を読み込み、それをJavaプログラミング言語のdouble
として返します。float
readFloat()
ストリーム内の次の属性を読み込み、それをJavaプログラミング言語のfloat
として返します。int
readInt()
ストリーム内の次の属性を読み込み、それをJavaプログラミング言語のint
として返します。long
readLong()
ストリーム内の次の属性を読み込み、それをJavaプログラミング言語のlong
として返します。NClob
readNClob()
ストリームからSQLNCLOB
値を読み込み、その値をJavaプログラミング言語のNClob
オブジェクトとして返します。String
readNString()
ストリーム内の次の属性を読み込み、それをJavaプログラミング言語のString
として返します。Object
readObject()
ストリームの先頭にあるデータを読み込み、それをJavaプログラミング言語のObject
として返します。default <T> T
readObject(Class<T> type)
ストリーム内の次の属性を読み込み、それをJavaプログラミング言語のObject
として返します。Ref
readRef()
ストリームからSQLREF
値を読み込み、その値をJavaプログラミング言語のRef
オブジェクトとして返します。RowId
readRowId()
ストリームからSQLROWID
値を読み込み、その値をJavaプログラミング言語のRowId
オブジェクトとして返します。short
readShort()
ストリーム内の次の属性を読み込み、それをJavaプログラミング言語のshort
として返します。SQLXML
readSQLXML()
ストリームからSQLXML
値を読み込み、その値をJavaプログラミング言語のSQLXML
オブジェクトとして返します。String
readString()
ストリーム内の次の属性を読み込み、それをJavaプログラミング言語のString
として返します。Time
readTime()
ストリーム内の次の属性を読み込み、それをjava.sql.Time
オブジェクトとして返します。Timestamp
readTimestamp()
ストリーム内の次の属性を読み込み、それをjava.sql.Timestamp
オブジェクトとして返します。URL
readURL()
ストリームからSQLDATALINK
値を読み込み、その値をJavaプログラミング言語のjava.net.URL
オブジェクトとして返します。boolean
wasNull()
最後に読み込まれた値がSQLNULL
かどうかを取得します。
-
-
-
メソッドの詳細
-
readString
String readString() throws SQLException
ストリーム内の次の属性を読み込み、それをJavaプログラミング言語のString
として返します。- 戻り値:
- 属性。値がSQL
NULL
の場合はnull
を返す - 例外:
SQLException
- データベース・アクセス・エラーが発生した場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
readBoolean
boolean readBoolean() throws SQLException
ストリーム内の次の属性を読み込み、それをJavaプログラミング言語のboolean
として返します。- 戻り値:
- 属性。値がSQL
NULL
の場合はfalse
を返す - 例外:
SQLException
- データベース・アクセス・エラーが発生した場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
readByte
byte readByte() throws SQLException
ストリーム内の次の属性を読み込み、それをJavaプログラミング言語のbyte
として返します。- 戻り値:
- 属性。値がSQL
NULL
の場合は0
を返す - 例外:
SQLException
- データベース・アクセス・エラーが発生した場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
readShort
short readShort() throws SQLException
ストリーム内の次の属性を読み込み、それをJavaプログラミング言語のshort
として返します。- 戻り値:
- 属性。値がSQL
NULL
の場合は0
を返す - 例外:
SQLException
- データベース・アクセス・エラーが発生した場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
readInt
int readInt() throws SQLException
ストリーム内の次の属性を読み込み、それをJavaプログラミング言語のint
として返します。- 戻り値:
- 属性。値がSQL
NULL
の場合は0
を返す - 例外:
SQLException
- データベース・アクセス・エラーが発生した場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
readLong
long readLong() throws SQLException
ストリーム内の次の属性を読み込み、それをJavaプログラミング言語のlong
として返します。- 戻り値:
- 属性。値がSQL
NULL
の場合は0
を返す - 例外:
SQLException
- データベース・アクセス・エラーが発生した場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
readFloat
float readFloat() throws SQLException
ストリーム内の次の属性を読み込み、それをJavaプログラミング言語のfloat
として返します。- 戻り値:
- 属性。値がSQL
NULL
の場合は0
を返す - 例外:
SQLException
- データベース・アクセス・エラーが発生した場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
readDouble
double readDouble() throws SQLException
ストリーム内の次の属性を読み込み、それをJavaプログラミング言語のdouble
として返します。- 戻り値:
- 属性。値がSQL
NULL
の場合は0
を返す - 例外:
SQLException
- データベース・アクセス・エラーが発生した場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
readBigDecimal
BigDecimal readBigDecimal() throws SQLException
ストリーム内の次の属性を読み込み、それをJavaプログラミング言語のjava.math.BigDecimal
オブジェクトとして返します。- 戻り値:
- 属性。値がSQL
NULL
の場合はnull
を返す - 例外:
SQLException
- データベース・アクセス・エラーが発生した場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
readBytes
byte[] readBytes() throws SQLException
ストリーム内の次の属性を読み込み、それをJavaプログラミング言語のバイトの配列として返します。- 戻り値:
- 属性。値がSQL
NULL
の場合はnull
を返す - 例外:
SQLException
- データベース・アクセス・エラーが発生した場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
readDate
Date readDate() throws SQLException
ストリーム内の次の属性を読み込み、それをjava.sql.Date
オブジェクトとして返します。- 戻り値:
- 属性。値がSQL
NULL
の場合はnull
を返す - 例外:
SQLException
- データベース・アクセス・エラーが発生した場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
readTime
Time readTime() throws SQLException
ストリーム内の次の属性を読み込み、それをjava.sql.Time
オブジェクトとして返します。- 戻り値:
- 属性。値がSQL
NULL
の場合はnull
を返す - 例外:
SQLException
- データベース・アクセス・エラーが発生した場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
readTimestamp
Timestamp readTimestamp() throws SQLException
ストリーム内の次の属性を読み込み、それをjava.sql.Timestamp
オブジェクトとして返します。- 戻り値:
- 属性。値がSQL
NULL
の場合はnull
を返す - 例外:
SQLException
- データベース・アクセス・エラーが発生した場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
readCharacterStream
Reader readCharacterStream() throws SQLException
ストリーム内の次の属性を読み込み、それをUnicode文字のストリームとして返します。- 戻り値:
- 属性。値がSQL
NULL
の場合はnull
を返す - 例外:
SQLException
- データベース・アクセス・エラーが発生した場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
readAsciiStream
InputStream readAsciiStream() throws SQLException
ストリーム内の次の属性を読み込み、それをASCII文字のストリームとして返します。- 戻り値:
- 属性。値がSQL
NULL
の場合はnull
を返す - 例外:
SQLException
- データベース・アクセス・エラーが発生した場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
readBinaryStream
InputStream readBinaryStream() throws SQLException
ストリーム内の次の属性を読み込み、それを未解釈のバイト・ストリームとして返します。- 戻り値:
- 属性。値がSQL
NULL
の場合はnull
を返す - 例外:
SQLException
- データベース・アクセス・エラーが発生した場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
readObject
Object readObject() throws SQLException
ストリームの先頭にあるデータを読み込み、それをJavaプログラミング言語のObject
として返します。 返されるオブジェクトの実際の型は、デフォルトの型マップおよびこのストリームのこのストリームの型マップに示されるカスタマイズによって判定されます。型マップはストリームがアプリケーションに渡される前にJDBCドライバによってストリームに登録されます。
ストリームの先頭にあるデータがSQL
NULL
の場合、このメソッドはnull
を返します。 データがSQL構造化型または個別の型の場合は、ストリームの先頭にあるデータのSQL型を判定します。 ストリームの型マップにSQL型のエントリがある場合は、ドライバは適切なクラスのオブジェクトを構築してから、そのオブジェクトでSQLData.readSQL
メソッドを呼び出します。SQLData.readSQLメソッドはそのメソッドのために記述されたプロトコルを使用して、ストリームから追加データを読み込みます。- 戻り値:
- ストリームの先頭にあるJavaプログラミング言語の
Object
としてのデータ。データがSQLNULL
の場合はnull
- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
readRef
Ref readRef() throws SQLException
ストリームからSQLREF
値を読み込み、その値をJavaプログラミング言語のRef
オブジェクトとして返します。- 戻り値:
- ストリームの先頭にあるSQL
REF
値を表すRef
オブジェクト。読み込まれた値がSQLNULL
の場合はnull
- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
readBlob
Blob readBlob() throws SQLException
ストリームからSQLBLOB
値を読み込み、その値をJavaプログラミング言語のBlob
オブジェクトとして返します。- 戻り値:
- ストリームの先頭にあるSQL
BLOB
値のデータを表すBlob
オブジェクト。読み込まれた値がSQLNULL
の場合はnull
- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
readClob
Clob readClob() throws SQLException
ストリームからSQLCLOB
値を読み込み、その値をJavaプログラミング言語のClob
オブジェクトとして返します。- 戻り値:
- ストリームの先頭にあるSQL
CLOB
値のデータを表すClob
オブジェクト。読み込まれた値がSQLNULL
の場合はnull
- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
readArray
Array readArray() throws SQLException
ストリームからSQLARRAY
値を読み込み、その値をJavaプログラミング言語のArray
オブジェクトとして返します。- 戻り値:
- ストリームの先頭にあるSQL
ARRAY
値のデータを表すArray
オブジェクト。読み込まれた値がSQLNULL
の場合はnull
- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
wasNull
boolean wasNull() throws SQLException
最後に読み込まれた値がSQLNULL
かどうかを取得します。- 戻り値:
- 最後に読み込まれたSQL値がSQL
NULL
の場合はtrue
、そうでない場合はfalse
- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
readURL
URL readURL() throws SQLException
ストリームからSQLDATALINK
値を読み込み、その値をJavaプログラミング言語のjava.net.URL
オブジェクトとして返します。- 戻り値:
java.net.URL
オブジェクト。- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合、またはURLが無効の場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.4
-
readNClob
NClob readNClob() throws SQLException
ストリームからSQLNCLOB
値を読み込み、その値をJavaプログラミング言語のNClob
オブジェクトとして返します。- 戻り値:
- ストリームの先頭にあるSQL
NCLOB
値のデータを表すNClob
オブジェクト。読み込まれた値がSQLNULL
の場合はnull
- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
readNString
String readNString() throws SQLException
ストリーム内の次の属性を読み込み、それをJavaプログラミング言語のString
として返します。NCHAR
、NVARCHAR
、およびLONGNVARCHAR
列にアクセスするときに使用します。- 戻り値:
- 属性。値がSQL
NULL
の場合はnull
を返す - 例外:
SQLException
- データベース・アクセス・エラーが発生した場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
readSQLXML
SQLXML readSQLXML() throws SQLException
ストリームからSQLXML
値を読み込み、その値をJavaプログラミング言語のSQLXML
オブジェクトとして返します。- 戻り値:
- ストリームの先頭にあるSQL
XML
値のデータを表すSQLXML
オブジェクト。読み込まれた値がSQLNULL
の場合はnull
- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
readRowId
RowId readRowId() throws SQLException
ストリームからSQLROWID
値を読み込み、その値をJavaプログラミング言語のRowId
オブジェクトとして返します。- 戻り値:
- ストリームの先頭にあるSQL
ROWID
値のデータを表すRowId
オブジェクト。読み込まれた値がSQLNULL
の場合はnull
- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
readObject
default <T> T readObject(Class<T> type) throws SQLException
ストリーム内の次の属性を読み込み、それをJavaプログラミング言語のObject
として返します。 返されるオブジェクトの実際の型は、指定されたJavaデータ型およびこのストリームの型マップに示されるカスタマイズによって判定されます。型マップはストリームがアプリケーションに渡される前にJDBCドライバによってストリームに登録されます。
ストリームの先頭にある属性がSQL
NULL
の場合、このメソッドはnull
を返します。 属性がSQL構造化型または個別の型の場合は、ストリームの先頭にある属性のSQL型を判定します。 ストリームの型マップにSQL型のエントリがある場合は、ドライバは適切なクラスのオブジェクトを構築してから、そのオブジェクトでSQLData.readSQL
メソッドを呼び出します。SQLData.readSQLメソッドはそのメソッドのために記述されたプロトコルを使用して、ストリームから追加データを読み込みます。デフォルト実装は
SQLFeatureNotSupportedException
をスローします- 型パラメータ:
T
- このClassオブジェクトでモデル化されるクラスの型- パラメータ:
type
- 属性の変換後のJavaデータ型を表すクラス。- 戻り値:
- ストリームの先頭にあるJavaプログラミング言語の
Object
としての属性。属性がSQLNULL
の場合はnull
- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.8
-
-