public class SQLInputImpl extends Object implements SQLInput
SQLInputImpl
オブジェクトは、UDTの属性に相当する値のストリームを格納する入力ストリームです。
このクラスは、カスタム・マッピングを持つSQL構造型またはSQL個別型でgetObject
メソッドが呼び出されるとき、背後でドライバによって使用されます。プログラマが直接SQLInputImpl
メソッドを呼び出すことはありません。これらは、RowSet
実装を記述するユーザー向けの便利なクラスとして提供されたものです。
SQLInputImpl
クラスは、ResultSet
取得メソッドと類似した一連のリーダー・メソッド・セットを提供します。これらのメソッドには、SQLInputImpl
オブジェクト内の値の読取りを可能にする機能があります。
最終値がSQL NULL
であったかどうかの確認には、wasNull
メソッドが使用されます。
getObject
メソッドがSQLData
インタフェースを実装するクラスのオブジェクトで呼び出されると、JDBCドライバはカスタム・マッピングされるUDTのSQL型を判別するためにSQLData.getSQLType
メソッドを呼び出します。ドライバは、SQLInputImpl
のインスタンスを作成し、UDTの属性を移植します。次に、入力ストリームをSQLData.readSQL
メソッドに渡します。すると、このメソッドは、SQLInputImpl
readerメソッドを呼び出して、入力ストリームから属性を読み取ります。
SQLData
コンストラクタと説明 |
---|
SQLInputImpl(Object[] attributes, Map<String,Class<?>> map)
指定された属性の配列と型マップで初期化された
SQLInputImpl オブジェクトを作成します。 |
修飾子と型 | メソッドと説明 |
---|---|
Array |
readArray()
ストリームからSQL
ARRAY 値を読み込み、その値をJavaプログラミング言語のArray オブジェクトとして返します。 |
InputStream |
readAsciiStream()
この
SQLInputImpl オブジェクト内の次の属性をASCII文字ストリームとして取得します。 |
BigDecimal |
readBigDecimal()
この
SQLInputImpl オブジェクト内の次の属性をjava.math.BigDecimal として取得します。 |
InputStream |
readBinaryStream()
この
SQLInputImpl オブジェクト内の次の属性を未解釈のバイト・ストリームとして取得します。 |
Blob |
readBlob()
この
SQLInputImpl オブジェクトの先頭のBLOB 値をJavaプログラミング言語のBlob オブジェクトとして取得します。 |
boolean |
readBoolean()
この
SQLInputImpl オブジェクト内の次の属性をJavaプログラミング言語のboolean として取得します。 |
byte |
readByte()
この
SQLInputImpl オブジェクト内の次の属性をJavaプログラミング言語のbyte として取得します。 |
byte[] |
readBytes()
この
SQLInputImpl オブジェクト内の次の属性をバイト配列として取得します。 |
Reader |
readCharacterStream()
この
SQLInputImpl オブジェクト内の次の属性をUnicode文字ストリームとして取得します。 |
Clob |
readClob()
この
SQLInputImpl オブジェクトの先頭のCLOB 値をJavaプログラミング言語のClob オブジェクトとして取得します。 |
Date |
readDate()
この
SQLInputImpl 内の次の属性をjava.sql.Date オブジェクトとして取得します。 |
double |
readDouble()
この
SQLInputImpl オブジェクト内の次の属性をJavaプログラミング言語のdouble として取得します。 |
float |
readFloat()
この
SQLInputImpl オブジェクト内の次の属性をJavaプログラミング言語のfloat として取得します。 |
int |
readInt()
この
SQLInputImpl オブジェクト内の次の属性をJavaプログラミング言語のint として取得します。 |
long |
readLong()
この
SQLInputImpl オブジェクト内の次の属性をJavaプログラミング言語のlong として取得します。 |
NClob |
readNClob()
ストリームからSQL
NCLOB 値を読み込み、その値をJavaプログラミング言語のClob オブジェクトとして返します。 |
String |
readNString()
ストリーム内の次の属性を読み込み、それをJavaプログラミング言語の
String として返します。 |
Object |
readObject()
この
SQLInputImpl オブジェクトの先頭の値をJavaプログラミング言語のObject として取得します。 |
Ref |
readRef()
この
SQLInputImpl オブジェクトの先頭の値をJavaプログラミング言語のRef オブジェクトとして取得します。 |
RowId |
readRowId()
ストリームからSQL
ROWID 値を読み込み、その値をJavaプログラミング言語のRowId オブジェクトとして返します。 |
short |
readShort()
この
SQLInputImpl オブジェクト内の次の属性をJavaプログラミング言語のshort として取得します。 |
SQLXML |
readSQLXML()
ストリームからSQL
XML 値を読み込み、その値をJavaプログラミング言語のSQLXML オブジェクトとして返します。 |
String |
readString()
この
SQLInputImpl オブジェクト内の次の属性をJavaプログラミング言語のString として取得します。 |
Time |
readTime()
この
SQLInputImpl オブジェクト内の次の属性をjava.sql.Time オブジェクトとして取得します。 |
Timestamp |
readTimestamp()
この
SQLInputImpl オブジェクト内の次の属性をjava.sql.Timestamp オブジェクトとして取得します。 |
URL |
readURL()
ストリームからSQL
DATALINK 値を読み込み、その値をJavaプログラミング言語のURL オブジェクトとして返します。 |
boolean |
wasNull()
この
SQLInputImpl オブジェクトから最後に読み込まれた値がnull かどうかを確認します。 |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
readObject
public SQLInputImpl(Object[] attributes, Map<String,Class<?>> map) throws SQLException
SQLInputImpl
オブジェクトを作成します。指定された属性の中にUDT属性があり、その名前のエントリが型マップ内に存在する場合、この属性は対応するSQLData
実装に従ってマップされます。attributes
- Object
インスタンスの配列(各要素はUDTの属性)。配列内の属性の順序は、UDT定義で属性が定義された順序と同じ。map
- 0個以上のエントリを持つjava.util.Map
オブジェクト。各エントリは、(1) UDTの完全修飾名を指定するString
オブジェクトと、(2) UDTのマッピング方法を定義するSQLData
実装のClass
オブジェクトで構成されるSQLException
- attributes
またはmap
がnull
値の場合public String readString() throws SQLException
SQLInputImpl
オブジェクト内の次の属性をJavaプログラミング言語のString
として取得します。
このメソッドは、期待どおりの型が返されるかどうかを判定する型保証(type-safe)されたチェックを行いません。このチェックは、SQLData
実装に定義されているとおり、UDTマッピングに委譲されます。
readString
、インタフェース: SQLInput
SQLInputImpl
オブジェクトの次の属性。値がSQL NULL
の場合はnull
SQLException
- 読取り位置が無効である場合、またはストリーム内にこれ以上値がない場合。public boolean readBoolean() throws SQLException
SQLInputImpl
オブジェクト内の次の属性をJavaプログラミング言語のboolean
として取得します。
このメソッドは、期待どおりの型が返されるかどうかを判定する型保証(type-safe)されたチェックを行いません。このチェックは、SQLData
実装に定義されているとおり、UDTマッピングに委譲されます。
readBoolean
、インタフェース: SQLInput
SQLInputImpl
オブジェクトの次の属性。値がSQL NULL
の場合はnull
SQLException
- 読取り位置が無効である場合、またはストリーム内にこれ以上値がない場合。public byte readByte() throws SQLException
SQLInputImpl
オブジェクト内の次の属性をJavaプログラミング言語のbyte
として取得します。
このメソッドは、期待どおりの型が返されるかどうかを判定する型保証(type-safe)されたチェックを行いません。このチェックは、SQLData
実装に定義されているとおり、UDTマッピングに委譲されます。
readByte
、インタフェース: SQLInput
SQLInputImpl
オブジェクトの次の属性。値がSQL NULL
の場合はnull
SQLException
- 読取り位置が無効である場合、またはストリーム内にこれ以上値がない場合public short readShort() throws SQLException
SQLInputImpl
オブジェクト内の次の属性をJavaプログラミング言語のshort
として取得します。
このメソッドは、期待どおりの型が返されるかどうかを判定する型保証(type-safe)されたチェックを行いません。このチェックは、SQLData
実装に定義されているとおり、UDTマッピングに委譲されます。
readShort
、インタフェース: SQLInput
SQLInputImpl
オブジェクトの次の属性。値がSQL NULL
の場合はnull
SQLException
- 読取り位置が無効である場合、またはストリーム内にこれ以上値がない場合public int readInt() throws SQLException
SQLInputImpl
オブジェクト内の次の属性をJavaプログラミング言語のint
として取得します。
このメソッドは、期待どおりの型が返されるかどうかを判定する型保証(type-safe)されたチェックを行いません。このチェックは、SQLData
実装に定義されているとおり、UDTマッピングに委譲されます。
readInt
、インタフェース: SQLInput
SQLInputImpl
オブジェクトの次の属性。値がSQL NULL
の場合はnull
SQLException
- 読取り位置が無効である場合、またはストリーム内にこれ以上値がない場合public long readLong() throws SQLException
SQLInputImpl
オブジェクト内の次の属性をJavaプログラミング言語のlong
として取得します。
このメソッドは、期待どおりの型が返されるかどうかを判定する型保証(type-safe)されたチェックを行いません。このチェックは、SQLData
実装に定義されているとおり、UDTマッピングに委譲されます。
readLong
、インタフェース: SQLInput
SQLInputImpl
オブジェクトの次の属性。値がSQL NULL
の場合はnull
SQLException
- 読取り位置が無効である場合、またはストリーム内にこれ以上値がない場合public float readFloat() throws SQLException
SQLInputImpl
オブジェクト内の次の属性をJavaプログラミング言語のfloat
として取得します。
このメソッドは、期待どおりの型が返されるかどうかを判定する型保証(type-safe)されたチェックを行いません。このチェックは、SQLData
実装に定義されているとおり、UDTマッピングに委譲されます。
readFloat
、インタフェース: SQLInput
SQLInputImpl
オブジェクトの次の属性。値がSQL NULL
の場合はnull
SQLException
- 読取り位置が無効である場合、またはストリーム内にこれ以上値がない場合public double readDouble() throws SQLException
SQLInputImpl
オブジェクト内の次の属性をJavaプログラミング言語のdouble
として取得します。
このメソッドは、期待どおりの型が返されるかどうかを判定する型保証(type-safe)されたチェックを行いません。このチェックは、SQLData
実装に定義されているとおり、UDTマッピングに委譲されます。
readDouble
、インタフェース: SQLInput
SQLInputImpl
オブジェクトの次の属性。値がSQL NULL
の場合はnull
SQLException
- 読取り位置が無効である場合、またはストリーム内にこれ以上値がない場合public BigDecimal readBigDecimal() throws SQLException
SQLInputImpl
オブジェクト内の次の属性をjava.math.BigDecimal
として取得します。
このメソッドは、期待どおりの型が返されるかどうかを判定する型保証(type-safe)されたチェックを行いません。このチェックは、SQLData
実装に定義されているとおり、UDTマッピングに委譲されます。
readBigDecimal
、インタフェース: SQLInput
SQLInputImpl
オブジェクトの次の属性。値がSQL NULL
の場合はnull
SQLException
- 読取り位置が無効である場合、またはストリーム内にこれ以上値がない場合public byte[] readBytes() throws SQLException
SQLInputImpl
オブジェクト内の次の属性をバイト配列として取得します。
このメソッドは、期待どおりの型が返されるかどうかを判定する型保証(type-safe)されたチェックを行いません。このチェックは、SQLData
実装に定義されているとおり、UDTマッピングに委譲されます。
readBytes
、インタフェース: SQLInput
SQLInputImpl
オブジェクトの次の属性。値がSQL NULL
の場合はnull
SQLException
- 読取り位置が無効である場合、またはストリーム内にこれ以上値がない場合public Date readDate() throws SQLException
SQLInputImpl
内の次の属性をjava.sql.Date
オブジェクトとして取得します。
このメソッドは、期待どおりの型が返されるかどうかを判定する型保証(type-safe)されたチェックを行いません。このチェックは、SQLData
実装に定義されているとおり、UDTマッピングに委譲されます。
readDate
、インタフェース: SQLInput
SQLInputImpl
オブジェクトの次の属性。値がSQL NULL
の場合はnull
SQLException
- 読取り位置が無効である場合、またはストリーム内にこれ以上値がない場合public Time readTime() throws SQLException
SQLInputImpl
オブジェクト内の次の属性をjava.sql.Time
オブジェクトとして取得します。
このメソッドは、期待どおりの型が返されるかどうかを判定する型保証(type-safe)されたチェックを行いません。このチェックは、SQLData
実装のとおり、UDTマッピングに委譲されます。
readTime
、インタフェース: SQLInput
SQL NULL
の場合はnull
SQLException
- 読取り位置が無効である場合、またはストリーム内にこれ以上値がない場合。public Timestamp readTimestamp() throws SQLException
SQLInputImpl
オブジェクト内の次の属性をjava.sql.Timestamp
オブジェクトとして取得します。readTimestamp
、インタフェース: SQLInput
SQL NULL
の場合はnull
SQLException
- 読取り位置が無効である場合、またはストリーム内にこれ以上値がない場合。public Reader readCharacterStream() throws SQLException
SQLInputImpl
オブジェクト内の次の属性をUnicode文字ストリームとして取得します。
このメソッドは、期待どおりの型が返されるかどうかを判定する型保証(type-safe)されたチェックを行いません。このチェックは、SQLData
実装のとおり、UDTマッピングに委譲されます。
readCharacterStream
、インタフェース: SQLInput
SQL NULL
の場合はnull
SQLException
- 読取り位置が無効である場合、またはストリーム内にこれ以上値がない場合。public InputStream readAsciiStream() throws SQLException
SQLInputImpl
オブジェクト内の次の属性をASCII文字ストリームとして取得します。
このメソッドは、期待どおりの型が返されるかどうかを判定する型保証(type-safe)されたチェックを行いません。このチェックは、SQLData
実装のとおり、UDTマッピングに委譲されます。
readAsciiStream
、インタフェース: SQLInput
SQL NULL
の場合はnull
SQLException
- 読取り位置が無効である場合、またはストリーム内にこれ以上値がない場合。public InputStream readBinaryStream() throws SQLException
SQLInputImpl
オブジェクト内の次の属性を未解釈のバイト・ストリームとして取得します。
このメソッドは、期待どおりの型が返されるかどうかを判定する型保証(type-safe)されたチェックを行いません。このチェックは、SQLData
実装のとおり、UDTマッピングに委譲されます。
readBinaryStream
、インタフェース: SQLInput
SQL NULL
の場合はnull
SQLException
- 読取り位置が無効である場合、またはストリーム内にこれ以上値がない場合。public Object readObject() throws SQLException
SQLInputImpl
オブジェクトの先頭の値をJavaプログラミング言語のObject
として取得します。実際に返されるオブジェクトの型は、SQL型とJavaプログラミング言語の型のデフォルト・マッピングによって決定されます。ただし、カスタム・マッピングが存在する場合、返されるオブジェクトの型はこのストリームの型マップによって決定されます。
JDBCテクノロジ対応のドライバは、アプリケーションにストリームを渡す前に、このストリームに型マップを登録します。
ストリームの先頭にあるデータがSQL NULL
の場合、このメソッドはnull
を返します。データがカスタム・マッピングを持つSQL構造型または個別型である場合、ストリームの先頭のデータのSQL型を判別し、適切なクラスのオブジェクトを構築して、このオブジェクト上でSQLData.readSQL
メソッドを呼び出します。すると、readSQL
メソッドにより、適切なSQLInputImpl.readXXX
メソッドが呼び出され、ストリームから属性値が取り出されます。
readObject
、インタフェース: SQLInput
Object
としての値。値がSQL NULL
の場合はnull
SQLException
- 読取り位置が無効である場合、またはストリーム内にこれ以上値がない場合。public Ref readRef() throws SQLException
SQLInputImpl
オブジェクトの先頭の値をJavaプログラミング言語のRef
オブジェクトとして取得します。readRef
、インタフェース: SQLInput
REF
値を表すRef
オブジェクト。値がSQL NULL
の場合はnull
SQLException
- 読取り位置が無効である場合、またはストリーム内にこれ以上値がない場合。public Blob readBlob() throws SQLException
SQLInputImpl
オブジェクトの先頭のBLOB
値をJavaプログラミング言語のBlob
オブジェクトとして取得します。
このメソッドは、期待どおりの型が返されるかどうかを判定する型保証(type-safe)されたチェックを行いません。このチェックは、SQLData
実装のとおり、UDTマッピングに委譲されます。
readBlob
、インタフェース: SQLInput
BLOB
値を表すBlob
オブジェクト。値がSQL NULL
の場合はnull
SQLException
- 読取り位置が無効である場合、またはストリーム内にこれ以上値がない場合。public Clob readClob() throws SQLException
SQLInputImpl
オブジェクトの先頭のCLOB
値をJavaプログラミング言語のClob
オブジェクトとして取得します。
このメソッドは、期待どおりの型が返されるかどうかを判定する型保証(type-safe)されたチェックを行いません。このチェックは、SQLData
実装のとおり、UDTマッピングに委譲されます。
readClob
、インタフェース: SQLInput
CLOB
値を表すClob
オブジェクト。値がSQL NULL
の場合はnull
SQLException
- 読取り位置が無効である場合、またはストリーム内にこれ以上値がない場合。public Array readArray() throws SQLException
ARRAY
値を読み込み、その値をJavaプログラミング言語のArray
オブジェクトとして返します。
このメソッドは、期待どおりの型が返されるかどうかを判定する型保証(type-safe)されたチェックを行いません。このチェックは、SQLData
実装のとおり、UDTマッピングに委譲されます。
readArray
、インタフェース: SQLInput
ARRAY
値を表すArray
オブジェクト。*値がSQL NULL
の場合はnull
SQLException
- 読取り位置が無効である場合、またはストリーム内にこれ以上値がない場合。public boolean wasNull() throws SQLException
SQLInputImpl
オブジェクトから最後に読み込まれた値がnull
かどうかを確認します。wasNull
、インタフェース: SQLInput
null
の場合はtrue
、そうでない場合はfalse
。デフォルトの戻り値はfalseSQLException
- 最後に読み込まれた値がnull
かどうかを確認中にエラーが発生した場合public URL readURL() throws SQLException
DATALINK
値を読み込み、その値をJavaプログラミング言語のURL
オブジェクトとして返します。
このメソッドは、期待どおりの型が返されるかどうかを判定する型保証(type-safe)されたチェックを行いません。このチェックは、SQLData
実装のとおり、UDTマッピングに委譲されます。
readURL
、インタフェース: SQLInput
DATALINK
値を表すURL
オブジェクト。*値がSQL NULL
の場合はnull
SQLException
- 読取り位置が無効である場合、またはストリーム内にこれ以上値がない場合。public NClob readNClob() throws SQLException
NCLOB
値を読み込み、その値をJavaプログラミング言語のClob
オブジェクトとして返します。readNClob
、インタフェース: SQLInput
NCLOB
値のデータを表すNClob
オブジェクト。読み込まれた値がSQL NULL
の場合はnull
SQLException
- データベース・アクセス・エラーが発生した場合public String readNString() throws SQLException
String
として返します。NCHAR
、NVARCHAR
、およびLONGNVARCHAR
列にアクセスするときに使用します。readNString
、インタフェース: SQLInput
NULL
の場合はnull
を返すSQLException
- データベース・アクセス・エラーが発生した場合public SQLXML readSQLXML() throws SQLException
XML
値を読み込み、その値をJavaプログラミング言語のSQLXML
オブジェクトとして返します。readSQLXML
、インタフェース: SQLInput
XML
値のデータを表すSQLXML
オブジェクト。読み込まれた値がSQL NULL
の場合はnull
SQLException
- データベース・アクセス・エラーが発生した場合public RowId readRowId() throws SQLException
ROWID
値を読み込み、その値をJavaプログラミング言語のRowId
オブジェクトとして返します。readRowId
、インタフェース: SQLInput
ROWID
値のデータを表すRowId
オブジェクト。読み込まれた値がSQL NULL
の場合はnull
SQLException
- データベース・アクセス・エラーが発生した場合 バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright© 1993, 2014, Oracle and/or its affiliates. All rights reserved.