Package javax.sql.rowset.serial

提供实用类允许序列化映射之间的SQL类型和数据在java编程语言的类型。

See: 描述

类摘要

类	描述
SerialArray	序列化版本的 Array对象，这是一个SQL ARRAY价值java编程语言的映射。
SerialBlob	序列化映射在一个SQL BLOB价值java编程语言。
SerialClob	序列化映射在一个SQL CLOB价值java编程语言。
SerialDatalink	序列化映射在一个SQL DATALINK价值java编程语言。
SerialJavaObject	在一个SQL JAVA_OBJECT价值java编程语言的序列化映射。
SerialRef	序列化映射一个 Ref对象，这是一个SQL REF价值java编程语言的映射。
SerialStruct	序列化映射在一个SQL结构化类型的java编程语言。
SQLInputImpl	一种用于自定义映射用户定义的类型（UDT）输入流。
SQLOutputImpl	写一个自定义的属性映射到用户定义类型的输出流（UDT）到数据库中。

异常摘要

异常	描述
SerialException	指示和一个SQL类型如除了SQL类型如 DATALINK and JAVAOBJECT BLOB, CLOB, STRUCT or ARRAY序列化或反序列化错误

Package javax.sql.rowset.serial Description

提供实用类允许序列化映射之间的SQL类型和数据在java编程语言的类型。

标准的JDBC RowSet实现可能使用这些工具类协助断开的RowSet对象序列化。这是有用的当发送一个断开的线RowSet对象不同的虚拟机或在层内的application.

1 serialarray

在SQL数值数组java编程语言的序列化映射。

的 SerialArray class创建数组对象的 SerialArray instance提供一个构造函数，得到了基类型的基类型和SQL命名方法，复制的一部分或全部 SerialArray object和方法。

2 serialblob

在SQL BLOB值java编程语言的序列化映射。

的 SerialBlob class创建从一个blob对象实例提供一个构造函数。注意：blob对象应该把SQL BLOB值的数据到客户端之前， SerialBlob object由它。一个BLOB值的数据可以实现对客户端的字节数组（使用方法 Blob.getBytes）或未解释的字节流（使用方法 Blob.getBinaryStream）。

SerialBlob methods可以复印一 SerialBlob object作为字节数组或流。他们也有可能找到一个给定的图案的字节或 Blob object在 SerialBlob object。

3 serialclob

在SQL CLOB值java编程语言的序列化映射。的 SerialClob class

创建从一个 Clob object实例提供一个构造函数。请注意， Clob object应该带SQL CLOB值的数据到客户端之前， SerialClob object由它。一个SQL CLOB值的数据可以实现在客户端作为一个流的Unicode字符。

SerialClob methods使人们有可能从一个 SerialClob object或得到一个字符串定位模式的字符开始。

5 serialdatalink

在SQL数据值的java编程语言的序列化映射。一个数据值所引用的文件以外的底层数据源的原始数据源管理。

RowSet实现可以使用的方法 RowSet.getURL() to检索 java.net.URL对象，它可以用来处理外部数据。

java.net.URL url = rowset.getURL(1);

6 serialjavaobject

在SQL java_object价值java编程语言的序列化映射。假设java对象实例实现Serializable接口，这只包序列化过程。

如果在java对象序列化序列化不立即是不可能的，这类将试图将所有非静态成员允许对象实例被序列化的状态。静态或瞬态字段不能被序列化并尝试这样做会导致 SerialException being扔。

7 serialref

序列化一个SQL参考类型和java编程语言之间的映射。

的 SerialRef class创建从一个 Ref型 SerialRef instance提供获取和设置 Ref对象类型的方法提供一个构造函数。

8 serialstruct

在SQL结构化类型的java编程语言的序列化映射。每一个属性，是不是已经序列化映射到一个序列化形式，如果一个属性本身就是一种结构类型，它的每一个属性，是不是已经序列化映射为可序列化形式。

此外，如果 Map对象传递一个构造函数或方法 getAttributes，结构化类型的自定义映射在 Map对象指定的映射。
的 SerialStruct class创建从一个 Struct对象实例提供一个构造函数，用于检索的结构化的数据库中的类型的SQL类型名称的方法，获取其属性值的方法。

9 sqlinputimpl

用于自定义映射用户定义的类型（UDT）输入流。一个 SQLInputImpl对象输入流包含一个流，一个UDT的属性值。这类由幕后的驱动程序时使用的方法 getObject叫做一个结构化的或具有自定义映射不同的类型；一个程序员不会调用 SQLInputImpl 方法直接。

的 SQLInputImpl类提供了一套阅读方法类似于 ResultSet getter方法。这些方法使人们有可能从一个 SQLInputImpl对象的值。方法 wasNull用来判断是否读到的最后一个值是sql空。

当构造函数或getter方法，以 Map对象调用，JDBC驱动程序的调用方法 SQLData.getSQLType确定UDT自定义SQL类型映射。司机 SQLInputImpl创建实例，填充它的UDT的属性。司机随后通过输入流的方法 SQLData.readSQL，进而调用 SQLInputImpl方法从输入流中读取属性。

10 sqloutputimpl

输出流写入一个自定义的属性映射到用户定义类型（UDT）到数据库中。驱动程序在内部使用这个接口，它的方法永远不会被应用程序程序员直接调用。

当应用程序调用的方法 PreparedStatement.setObject, the司机检查是否要写入的值是一个UDT使用自定义映射。如果是的话，会有一个包含实现 SQLData for UDT的类的对象类型Map入口。如果要写入的值是 SQLData实例，该驱动程序将创建 SQLOutputImpl实例并将其传递到方法 SQLData.writeSQL。方法 writeSQL依次调用适当的方法 SQLOutputImpl作家写数据从 SQLData对象的 SQLOutputImpl输出流作为一个SQL表示用户定义的类型。

自定义映射

JDBC API提供了机制映射SQL结构化类型或不同类型的java编程语言。通常情况下，一个结构化类型被映射到一个类，它的属性映射到类中的字段。（一个不同的类型可以被认为有一个属性。）然而，有许多其他的可能性，并有可能是任何数量的不同的映射。

一个程序员定义的映射通过实现接口SQLData。例如，如果一个SQL结构化类型的属性名称命名的作者，标题，和出版商，它可以映射到java类命名的作者。作者类可以有字段名称、标题和发布者，这些字段的属性将被映射到。在这种情况下，实施的SQLData可以像下面这样：

公共类的作者实现了sqldata {公共字符串名称；公共字符串标题；公共字符串发布；sql_type字符串；公共字符串getsqltypename() {返回sql_type；}公共无效readsql（sqlinput流、字符串型）抛出SQLException {sql_type =型；名称=流。readstring()；标题=流。readstring()；readstring()出版商=流；}公共无效writesql（sqloutput流）抛出SQLException {流类别（名称）；流类别（标题）；流类别（出版商）；}}

一 java.util.Map对象用于将SQL结构化类型到类的映射 Authors。下面的代码片段显示了一个 Map对象可能创造了一项关联 AUTHORS和 Authors。

java.util.mapMap=新的java hashmap()。利用；Map。把（“schema_name。作者”，类forName（“作者”）；

的 Map对象Map现在包含一个与SQL结构化类型和类 Authors的 类对象的完全限定名称条目。它可以通过一个方法告诉司机如何映射到 Authors AUTHORS。

一个断开的RowSet自定义映射对象，能做的只有当一个Map对象传递给方法或构造函数将做自定义映射。这种情况是连接RowSet对象的不同因为他们保持与数据源的连接。一种方法是自定义映射和被断开RowSet对象可以使用与Connection对象使用相关的Map对象。因此，在其他的话，如果没有指定的Map，连接的类型的Map可以默认使用。