compact2, compact3

java.sql

Interface SQLData

public interface SQLData

用于SQL自定义映射接口用户定义类型（UDT）对java编程语言中的类。为实现 SQLData接口类的类的对象将进入相应的 Connection对象类型Map随着，UDT是自定义映射SQL的名字。

通常，一个SQLData实现将定义一个SQL结构化类型或单一领域的SQL DISTINCT类型的每个属性字段。当UDT是从数据源中检索与ResultSet.getObject方法，它将被映射为这个类的一个实例。程序员可以在这个类的实例就在java编程语言中的任何其他对象，然后将所做的任何更改它通过调用PreparedStatement.setObject方法，将Map回到SQL类型。

可以预期，一个自定义映射的类的实现将由一个工具完成。在一个典型的实现，程序员只会提供SQL UDT的名称，该类它所映射的名称和名称的字段中的每个的UDT的属性被映射。该工具将使用此信息来实现SQLData.readSQL和SQLData.writeSQL方法。的readSQL方法调用相应的SQLInput方法从SQLInput对象读取每个属性和方法调用的方法writeSQL SQLOutput写回数据源的每个属性通过SQLOutput对象。

程序员通常不直接调用SQLData方法，和SQLInput和SQLOutput方法是通过SQLData内部方法调用，而不是由应用程序代码。

从以下版本开始：

一点二

方法摘要

Modifier and Type	Method and Description
String	getSQLTypeName() 返回SQL的完全限定名，该对象表示用户定义类型。
void	readSQL(SQLInput stream, String typeName) 填充该对象从数据库中读取数据。
void	writeSQL(SQLOutput stream) 写这个对象的给定的SQL数据流，将其转换回数据源的SQL值。

方法详细信息

getSQLTypeName

String getSQLTypeName()
               throws SQLException

返回SQL的完全限定名，该对象表示用户定义类型。这种方法是通过JDBC驱动程序来获得UDT实例被映射到该实例的名称 SQLData。

结果

类型名称，被传递给方法时，这个对象 readSQL构建和填充

异常

SQLException -如果有一个数据库访问错误

SQLFeatureNotSupportedException如果JDBC驱动程序不支持此方法

从以下版本开始：

一点二

readSQL

void readSQL(SQLInput stream,
             String typeName)
      throws SQLException

填充该对象从数据库中读取数据。该方法的实施必须遵循本协议：

• 它必须阅读每个从给定的输入流的SQL类型的属性或元素。这是通过调用读每项输入流的方法，在它们出现的顺序在该类型的SQL定义。
• 方法readSQL然后将数据分配给相应的字段或元素（本或其他对象）。具体而言，它必须调用相应的读者方法（SQLInput.readString，SQLInput.readBigDecimal，等等）的方法（S）做了以下工作：针对不同类型，读取单个数据元素；一个结构类型，阅读的SQL类型的每个属性的值。

JDBC驱动程序初始化输入流与类型图在调用此方法之前，它是由流适当的 SQLInput读者使用的方法。

参数

stream -从中读取数据，在自定义映射值的 SQLInput对象

typeName -数据流值的SQL类型名称

异常

SQLException -如果有一个数据库访问错误

SQLFeatureNotSupportedException如果JDBC驱动程序不支持此方法

从以下版本开始：

一点二

另请参见：

SQLInput

writeSQL

void writeSQL(SQLOutput stream)
       throws SQLException

写这个对象的给定的SQL数据流，将其转换回数据源的SQL值。该方法的实施必须遵循本协议：
必须写的每个SQL类型的输出流的属性。这是通过调用一个写每项输出流的方法，在它们出现的顺序在该类型的SQL定义。具体而言，它必须调用适当的方法 SQLOutput作家（s）（ writeInt， writeString，等等）做了以下工作：针对不同类型，写出它的单个数据元素；一个结构类型，写的SQL类型的每个属性的值。

参数

stream - SQLOutput目标来写，自定义映射值的数据

异常

SQLException -如果有一个数据库访问错误

SQLFeatureNotSupportedException如果JDBC驱动程序不支持此方法

从以下版本开始：

一点二

另请参见：

SQLOutput