|
JavaTM Platform Standard Ed. 6 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
java.lang.Object javax.sql.rowset.serial.SQLOutputImpl
public class SQLOutputImpl
カスタムマップされたユーザー定義型 (UDT) の属性をデータベースに再度書き込むための出力ストリームです。ドライバはこのインタフェースを内部で使用します。 このインタフェースのメソッドがアプリケーションプログラマによって直接呼び出されることはありません。
アプリケーションが PreparedStatement.setObject
メソッドを呼び出すと、ドライバはカスタムマッピングを利用して、書き込まれる値が UDT 型であるかどうかを確認します。UDT 型であれば、この UDT の SQLData
を実装するクラスの Class
オブジェクトを格納する型マップ内にエントリが存在します。書き込まれる値が SQLData
のインスタンスである場合、ドライバは SQLOutputImpl
のインスタンスを作成し、SQLData.writeSQL
メソッドに渡します。すると、writeSQL
メソッドによって適切な SQLOutputImpl.writeXXX
メソッドが呼び出され、SQLData
オブジェクトから SQLOutputImpl
出力ストリームに、SQL ユーザー定義型の表現としてデータが書き込まれます。
コンストラクタの概要 | |
---|---|
SQLOutputImpl(Vector<?> attributes,
Map<String,?> map)
指定の属性および型マップのベクトルで初期化された新しい SQLOutputImpl オブジェクトを作成します。 |
メソッドの概要 | |
---|---|
void |
writeArray(Array x)
この SQLOutputImpl オブジェクトに Java プログラミング言語の Array オブジェクトを書き込みます。 |
void |
writeAsciiStream(InputStream x)
この SQLOutputImpl オブジェクトに ASCII 文字ストリームを書き込みます。 |
void |
writeBigDecimal(BigDecimal x)
この SQLOutputImpl オブジェクトに Java プログラミング言語の java.math.BigDecimal オブジェクトを書き込みます。 |
void |
writeBinaryStream(InputStream x)
この SQLOutputImpl オブジェクトに未解釈のバイトストリームを書き込みます。 |
void |
writeBlob(Blob x)
この SQLOutputImpl オブジェクトに Java プログラミング言語の Blob オブジェクトを書き込みます。 |
void |
writeBoolean(boolean x)
この SQLOutputImpl オブジェクトに Java プログラミング言語の boolean を書き込みます。 |
void |
writeByte(byte x)
この SQLOutputImpl オブジェクトに Java プログラミング言語の byte を書き込みます。 |
void |
writeBytes(byte[] x)
この SQLOutputImpl オブジェクトに Java プログラミング言語の bytes の配列を書き込みます。 |
void |
writeCharacterStream(Reader x)
この SQLOutputImpl オブジェクトに Unicode 文字ストリームを書き込みます。 |
void |
writeClob(Clob x)
この SQLOutputImpl オブジェクトに Java プログラミング言語の Clob オブジェクトを書き込みます。 |
void |
writeDate(Date x)
この SQLOutputImpl オブジェクトに Java プログラミング言語の java.sql.Date オブジェクトを書き込みます。 |
void |
writeDouble(double x)
この SQLOutputImpl オブジェクトに Java プログラミング言語の double を書き込みます。 |
void |
writeFloat(float x)
この SQLOutputImpl オブジェクトに Java プログラミング言語の float を書き込みます。 |
void |
writeInt(int x)
この SQLOutputImpl オブジェクトに Java プログラミング言語の int を書き込みます。 |
void |
writeLong(long x)
この SQLOutputImpl オブジェクトに Java プログラミング言語の long を書き込みます。 |
void |
writeNClob(NClob x)
SQL NCLOB 値をストリームに書き込みます。 |
void |
writeNString(String x)
次の属性を Java プログラミング言語の String としてストリームに書き込みます。 |
void |
writeObject(SQLData x)
指定された SQLData オブジェクトに格納されたデータを、ストリームに書き込みます。 |
void |
writeRef(Ref x)
この SQLOutputImpl オブジェクトに Java プログラミング言語の Ref オブジェクトを書き込みます。 |
void |
writeRowId(RowId x)
SQL ROWID 値をストリームに書き込みます。 |
void |
writeShort(short x)
この SQLOutputImpl オブジェクトに Java プログラミング言語の short を書き込みます。 |
void |
writeSQLXML(SQLXML x)
SQL XML 値をストリームに書き込みます。 |
void |
writeString(String x)
この SQLOutputImpl オブジェクトに Java プログラミング言語の String を書き込みます。 |
void |
writeStruct(Struct x)
この SQLOutputImpl オブジェクトに Java プログラミング言語の Struct オブジェクトを書き込みます。 |
void |
writeTime(Time x)
この SQLOutputImpl オブジェクトに Java プログラミング言語の java.sql.Time オブジェクトを書き込みます。 |
void |
writeTimestamp(Timestamp x)
この SQLOutputImpl オブジェクトに Java プログラミング言語の java.sql.Timestamp オブジェクトを書き込みます。 |
void |
writeURL(URL url)
この SQLOutputImpl オブジェクトに Java プログラミング言語の java.sql.Type.DATALINK オブジェクトを書き込みます。 |
クラス java.lang.Object から継承されたメソッド |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
コンストラクタの詳細 |
---|
public SQLOutputImpl(Vector<?> attributes, Map<String,?> map) throws SQLException
SQLOutputImpl
オブジェクトを作成します。ドライバは、型マップを使って、どの SQLData.writeSQL
メソッドを呼び出すかを決定します。このメソッドによって適切な SQLOutputImpl
ライタメソッドが呼び出され、新しい出力ストリームに属性が書き込まれます。
attributes
- UDT の属性を格納する Vector
オブジェクト。
Java プログラミング言語の 1 個以上のオブジェクトに
マップされるmap
- 0 個以上のエントリを持つ java.util.Map
オブジェクト。
各エントリは、(1) UDT の完全修飾名を指定する String
オブジェクトと、
(2) UDT のマッピング方法を定義する
SQLData
実装の Class
オブジェクトで
構成される
SQLException
- attributes
または map
が
null
値の場合メソッドの詳細 |
---|
public void writeString(String x) throws SQLException
SQLOutputImpl
オブジェクトに Java プログラミング言語の String
を書き込みます。ドライバは、これを SQL CHAR
、VARCHAR
、または LONGVARCHAR
に変換してから、データベースに渡します。
SQLOutput
内の writeString
x
- データベースに渡す値
SQLException
- UDT の属性値をデータベースに書き込むため、
SQLData
オブジェクトによって
SQLOutputImpl
オブジェクトが使用されている場合public void writeBoolean(boolean x) throws SQLException
SQLOutputImpl
オブジェクトに Java プログラミング言語の boolean
を書き込みます。ドライバは、これを SQL BIT
に変換してから、データベースに渡します。
SQLOutput
内の writeBoolean
x
- データベースに渡す値
SQLException
- UDT の属性値をデータベースに書き込むため、
SQLData
オブジェクトによって
SQLOutputImpl
オブジェクトが使用されている場合public void writeByte(byte x) throws SQLException
SQLOutputImpl
オブジェクトに Java プログラミング言語の byte
を書き込みます。ドライバは、これを SQL BIT
に変換してから、データベースに渡します。
SQLOutput
内の writeByte
x
- データベースに渡す値
SQLException
- UDT の属性値をデータベースに書き込むため、
SQLData
オブジェクトによって
SQLOutputImpl
オブジェクトが使用されている場合public void writeShort(short x) throws SQLException
SQLOutputImpl
オブジェクトに Java プログラミング言語の short
を書き込みます。ドライバは、これを SQL SMALLINT
に変換してから、データベースに渡します。
SQLOutput
内の writeShort
x
- データベースに渡す値
SQLException
- UDT の属性値をデータベースに書き込むため、
SQLData
オブジェクトによって
SQLOutputImpl
オブジェクトが使用されている場合public void writeInt(int x) throws SQLException
SQLOutputImpl
オブジェクトに Java プログラミング言語の int
を書き込みます。ドライバは、これを SQL INTEGER
に変換してから、データベースに渡します。
SQLOutput
内の writeInt
x
- データベースに渡す値
SQLException
- UDT の属性値をデータベースに書き込むため、
SQLData
オブジェクトによって
SQLOutputImpl
オブジェクトが使用されている場合public void writeLong(long x) throws SQLException
SQLOutputImpl
オブジェクトに Java プログラミング言語の long
を書き込みます。ドライバは、これを SQL BIGINT
に変換してから、データベースに渡します。
SQLOutput
内の writeLong
x
- データベースに渡す値
SQLException
- UDT の属性値をデータベースに書き込むため、
SQLData
オブジェクトによって
SQLOutputImpl
オブジェクトが使用されている場合public void writeFloat(float x) throws SQLException
SQLOutputImpl
オブジェクトに Java プログラミング言語の float
を書き込みます。ドライバは、これを SQL REAL
に変換してから、データベースに渡します。
SQLOutput
内の writeFloat
x
- データベースに渡す値
SQLException
- UDT の属性値をデータベースに書き込むため、
SQLData
オブジェクトによって
SQLOutputImpl
オブジェクトが使用されている場合public void writeDouble(double x) throws SQLException
SQLOutputImpl
オブジェクトに Java プログラミング言語の double
を書き込みます。ドライバは、これを SQL DOUBLE
に変換してから、データベースに渡します。
SQLOutput
内の writeDouble
x
- データベースに渡す値
SQLException
- UDT の属性値をデータベースに書き込むため、
SQLData
オブジェクトによって
SQLOutputImpl
オブジェクトが使用されている場合public void writeBigDecimal(BigDecimal x) throws SQLException
SQLOutputImpl
オブジェクトに Java プログラミング言語の java.math.BigDecimal
オブジェクトを書き込みます。ドライバは、これを SQL NUMERIC
に変換してから、データベースに渡します。
SQLOutput
内の writeBigDecimal
x
- データベースに渡す値
SQLException
- UDT の属性値をデータベースに書き込むため、
SQLData
オブジェクトによって
SQLOutputImpl
オブジェクトが使用されている場合public void writeBytes(byte[] x) throws SQLException
SQLOutputImpl
オブジェクトに Java プログラミング言語の bytes
の配列を書き込みます。ドライバは、これを SQL VARBINARY
または LONGVARBINARY
に変換してから、データベースに渡します。
SQLOutput
内の writeBytes
x
- データベースに渡す値
SQLException
- UDT の属性値をデータベースに書き込むため、
SQLData
オブジェクトによって
SQLOutputImpl
オブジェクトが使用されている場合public void writeDate(Date x) throws SQLException
SQLOutputImpl
オブジェクトに Java プログラミング言語の java.sql.Date
オブジェクトを書き込みます。ドライバは、これを SQL DATE
に変換してから、データベースに渡します。
SQLOutput
内の writeDate
x
- データベースに渡す値
SQLException
- UDT の属性値をデータベースに書き込むため、
SQLData
オブジェクトによって
SQLOutputImpl
オブジェクトが使用されている場合public void writeTime(Time x) throws SQLException
SQLOutputImpl
オブジェクトに Java プログラミング言語の java.sql.Time
オブジェクトを書き込みます。ドライバは、これを SQL TIME
に変換してから、データベースに渡します。
SQLOutput
内の writeTime
x
- データベースに渡す値
SQLException
- UDT の属性値をデータベースに書き込むため、
SQLData
オブジェクトによって
SQLOutputImpl
オブジェクトが使用されている場合public void writeTimestamp(Timestamp x) throws SQLException
SQLOutputImpl
オブジェクトに Java プログラミング言語の java.sql.Timestamp
オブジェクトを書き込みます。ドライバは、これを SQL TIMESTAMP
に変換してから、データベースに渡します。
SQLOutput
内の writeTimestamp
x
- データベースに渡す値
SQLException
- UDT の属性値をデータベースに書き込むため、
SQLData
オブジェクトによって
SQLOutputImpl
オブジェクトが使用されている場合public void writeCharacterStream(Reader x) throws SQLException
SQLOutputImpl
オブジェクトに Unicode 文字ストリームを書き込みます。ドライバは、必要に応じて、Unicode からデータベースの CHAR
形式への変換を行います。
SQLOutput
内の writeCharacterStream
x
- データベースに渡す値
SQLException
- UDT の属性値をデータベースに書き込むため、
SQLData
オブジェクトによって
SQLOutputImpl
オブジェクトが使用されている場合public void writeAsciiStream(InputStream x) throws SQLException
SQLOutputImpl
オブジェクトに ASCII 文字ストリームを書き込みます。ドライバは、必要に応じて、ASCII からデータベースの CHAR
形式への変換を行います。
SQLOutput
内の writeAsciiStream
x
- データベースに渡す値
SQLException
- UDT の属性値をデータベースに書き込むため、
SQLData
オブジェクトによって
SQLOutputImpl
オブジェクトが使用されている場合public void writeBinaryStream(InputStream x) throws SQLException
SQLOutputImpl
オブジェクトに未解釈のバイトストリームを書き込みます。
SQLOutput
内の writeBinaryStream
x
- データベースに渡す値
SQLException
- UDT の属性値をデータベースに書き込むため、
SQLData
オブジェクトによって
SQLOutputImpl
オブジェクトが使用されている場合public void writeObject(SQLData x) throws SQLException
SQLData
オブジェクトに格納されたデータを、ストリームに書き込みます。このメソッドは、SQLData
オブジェクトが null
の場合、ストリームに SQL NULL
を書き込みます。そうでない場合は、指定されたオブジェクトの SQLData.writeSQL
メソッドを呼び出します。 すると、呼び出されたメソッドによって、オブジェクトの属性がストリームに書き込まれます。
SQLData.writeSQ
メソッドの実装は、オブジェクトの各属性を順序正しく書き込むため、適切な SQLOutputImpl.writeXXX
メソッド (複数可) を呼び出します。属性は SQLInput
入力ストリームから読み取られたあと、ユーザー定義型の SQL 定義の一覧と同じ並び順で SQLOutputImpl
出力ストリームに書き込まれなければなりません。
SQLOutput
内の writeObject
x
- SQL 構造化型または個別の型のデータを表す
オブジェクト
SQLException
- UDT の属性値をデータベースに書き込むため、
SQLData
オブジェクトによって
SQLOutputImpl
オブジェクトが使用されている場合public void writeRef(Ref x) throws SQLException
SQLOutputImpl
オブジェクトに Java プログラミング言語の Ref
オブジェクトを書き込みます。ドライバは、これを直列化可能な SerialRef
SQL REF
値に変換してから、データベースに渡します。
SQLOutput
内の writeRef
x
- SQL REF
値を表すオブジェクト
SQLException
- UDT の属性値をデータベースに書き込むため、
SQLData
オブジェクトによって
SQLOutputImpl
オブジェクトが使用されている場合public void writeBlob(Blob x) throws SQLException
SQLOutputImpl
オブジェクトに Java プログラミング言語の Blob
オブジェクトを書き込みます。ドライバは、これを直列化可能な SerialBlob
SQL BLOB
値に変換してから、データベースに渡します。
SQLOutput
内の writeBlob
x
- SQL BLOB
値を表すオブジェクト
SQLException
- UDT の属性値をデータベースに書き込むため、
SQLData
オブジェクトによって
SQLOutputImpl
オブジェクトが使用されている場合public void writeClob(Clob x) throws SQLException
SQLOutputImpl
オブジェクトに Java プログラミング言語の Clob
オブジェクトを書き込みます。ドライバは、これを直列化可能な SerialClob
SQL CLOB
値に変換してから、データベースに渡します。
SQLOutput
内の writeClob
x
- SQL CLOB
値を表すオブジェクト
SQLException
- UDT の属性値をデータベースに書き込むため、
SQLData
オブジェクトによって
SQLOutputImpl
オブジェクトが使用されている場合public void writeStruct(Struct x) throws SQLException
SQLOutputImpl
オブジェクトに Java プログラミング言語の Struct
オブジェクトを書き込みます。ドライバは、この値を SQL 構造型に変換してから、データベースに渡します。
このメソッドは、SQL 構造型が Java プログラミング言語の Struct
オブジェクトにマップされている場合 (標準マッピング) に使用します。SQL 構造型が Java プログラミング言語のクラスにカスタムマップされている場合は、writeObject
メソッドを使用します。
SQLOutput
内の writeStruct
x
- SQL 構造型の属性を表すオブジェクト
SQLException
- UDT の属性値をデータベースに書き込むため、
SQLData
オブジェクトによって
SQLOutputImpl
オブジェクトが使用されている場合public void writeArray(Array x) throws SQLException
SQLOutputImpl
オブジェクトに Java プログラミング言語の Array
オブジェクトを書き込みます。ドライバは、この値を直列化可能な SerialArray
SQL ARRAY
値に変換してから、データベースに渡します。
SQLOutput
内の writeArray
x
- SQL ARRAY
値を表すオブジェクト
SQLException
- UDT の属性値をデータベースに書き込むため、
SQLData
オブジェクトによって
SQLOutputImpl
オブジェクトが使用されている場合public void writeURL(URL url) throws SQLException
SQLOutputImpl
オブジェクトに Java プログラミング言語の java.sql.Type.DATALINK
オブジェクトを書き込みます。ドライバは、この値を直列化可能な SerialDatalink
SQL DATALINK
値に変換してから、データベースに渡します。
SQLOutput
内の writeURL
url
- SQL DATALINK
値を表すオブジェクト
SQLException
- UDT の属性値をデータベースに書き込むため、
SQLData
オブジェクトによって
SQLOutputImpl
オブジェクトが使用されている場合public void writeNString(String x) throws SQLException
String
としてストリームに書き込みます。ストリームに送るときに、ドライバはこれを SQL NCHAR
、NVARCHAR
、または LONGNVARCHAR
値 (ドライバの NVARCHAR
値に関する制限に関する引数のサイズに依存) に変換します。
SQLOutput
内の writeNString
x
- データベースに渡す値
SQLException
- データベースアクセスエラーが発生した場合public void writeNClob(NClob x) throws SQLException
NCLOB
値をストリームに書き込みます。
SQLOutput
内の writeNClob
x
- SQL NCLOB
値の
データを表す NClob
オブジェクト
SQLException
- データベースアクセスエラーが発生した場合public void writeRowId(RowId x) throws SQLException
ROWID
値をストリームに書き込みます。
SQLOutput
内の writeRowId
x
- SQL ROWID
値の
データを表す RowId
オブジェクト
SQLException
- データベースアクセスエラーが発生した場合public void writeSQLXML(SQLXML x) throws SQLException
XML
値をストリームに書き込みます。
SQLOutput
内の writeSQLXML
x
- SQL XML
値の
データを表す SQLXML
オブジェクト
SQLException
- データベースアクセスエラーが発生した場合
|
JavaTM Platform Standard Ed. 6 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。