compact2, compact3

java.sql

Interface Array

所有已知实现类：

SerialArray

public interface Array

对于SQL类型 ARRAY java编程语言中的映射。默认情况下，一个 Array价值是交易时间参考SQL ARRAY价值。默认情况下，一个 Array对象是使用SQL定位器实现（阵列）内部，这意味着一个 Array对象包含一个逻辑数据的指针而不是含 ARRAY值的数据在SQL ARRAY价值。

的Array接口提供了将SQL ARRAY值的数据到客户端为数组或ResultSet对象的方法。如果SQL ARRAY元素UDT，他们可以自定义映射。要创建一个自定义映射，一个程序员必须做两件事：

• 创建一个类，实现了UDT是自定义映射的SQLData接口。
• 在一个类型的Map，包含
  • 完全合格的SQL类型名称的UDT
  • 该类实现SQLData的类对象
  入口

当一个基类类型的入口型Map提供的方法getArray和getResultSet，它包含映射将用于Map的ARRAY价值要素。如果没有提供类型映射，通常是这样的情况下，默认情况下使用连接的类型映射。如果连接的类型映射或提供给该方法的类型映射没有基类型的条目，则根据标准映射映射元素。

在Array接口的所有方法都必须完全执行如果JDBC驱动程序支持的数据类型。

从以下版本开始：

一点二

方法摘要

Modifier and Type	Method and Description
void	free() 这种方法使 Array对象并释放资源，它拥有。
Object	getArray() 检索内容的SQL ARRAY值在java编程语言中的数组的形式通过这 Array对象指定。
Object	getArray(long index, int count) 检索一个切片的SQL ARRAY值指定的 Array对象，从指定的 index含到SQL阵列 count连续的元素。
Object	getArray(long index, int count, Map<String,类<?>> map) retreives一片SQL ARRAY Array对象指定的值，从指定的 index和含有高达 count SQL的连续元素的数组。
Object	getArray(Map<String,类<?>> map) 检索SQL ARRAY价值的内容这 Array指定的对象。
int	getBaseType() 获取数组中指定的 Array对象元素的JDBC类型。
String	getBaseTypeName() 获取数组中指定的元素 Array对象的SQL类型名称。
ResultSet	getResultSet() 检索结果集包含SQL ARRAY价值元素指定的这 Array对象。
ResultSet	getResultSet(long index, int count) 检索结果集控股的子阵，开始在指数 index和包含了 count连续元素的元素。
ResultSet	getResultSet(long index, int count, Map<String,类<?>> map) 检索结果集控股的子阵，开始在指数 index和包含了 count连续元素的元素。
ResultSet	getResultSet(Map<String,类<?>> map) 检索结果集包含SQL ARRAY价值元素指定的这 Array对象。

方法详细信息

getBaseTypeName

String getBaseTypeName()
                throws SQLException

获取数组中指定的元素 Array对象的SQL类型名称。如果元素是一个内置的类型，它将返回元素的特定类型的名称。如果元素是一个用户定义类型（UDT），这个方法返回完全合格的SQL类型名称。

结果

一个 String是一个内置的基类型的特定数据库的名称；或完全合格的SQL类型名称为基类型，UDT

异常

SQLException -如果在试图访问类型名称时发生错误

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

从以下版本开始：

一点二

getBaseType

int getBaseType()
         throws SQLException

获取数组中指定的 Array对象元素的JDBC类型。

结果

不断的从类 Types，数组中指定的 Array对象的元素类型代码

异常

SQLException -如果在试图访问基类中发生错误

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

从以下版本开始：

一点二

getArray

Object getArray()
         throws SQLException

检索SQL ARRAY价值的内容指定的 Array对象在java编程语言中的数组的形式。这个版本的方法 getArray使用的类型映射自定义连接关联的类型图。

注：当getArray是用来实现一个基类型映射到原始的数据类型，那么它是实现定义的数组是否返回的是原始数据类型或Object数组的数组。

结果

在java编程语言包含有序元素的值指定的SQL ARRAY这 Array对象数组

异常

SQLException -如果在试图访问数组时发生错误

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

从以下版本开始：

一点二

getArray

Object getArray(Map<String,类<?>> map)
         throws SQLException

检索SQL ARRAY价值的内容这 Array指定的对象。此方法使用指定的 map类型Map自定义除非数组的基类型不在 map用户定义的类型匹配，在这种情况下，采用标准的映射。这个版本的方法 getArray使用给定的类型图或标准图；它不以与连接相关的类型图。

注：当getArray是用来实现一个基类型映射到原始的数据类型，那么它是实现定义的数组是否返回的是原始数据类型或Object数组的数组。

参数

map - java.util.Map对象包含SQL类型名称映射到java编程语言中的类

结果

在java语言中包含的SQL命令元素数组指定该对象的数组

异常

SQLException -如果在试图访问数组时发生错误

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

从以下版本开始：

一点二

getArray

Object getArray(long index,
                int count)
         throws SQLException

检索一个切片的SQL ARRAY值指定的 Array对象，从指定的 index含到SQL阵列 count连续的元素。该方法使用的类型映射自定义连接关联的类型图。

注：当getArray是用来实现一个基类型映射到原始的数据类型，那么它是实现定义的数组是否返回的是原始数据类型或Object数组的数组。

参数

index -第一个元素的数组索引检索；第一个元素的索引是1

count -连续的SQL数组元素个数检索

结果

一个数组包含了 count的SQL阵列连续的元素，元素 index开始

异常

SQLException -如果在试图访问数组时发生错误

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

从以下版本开始：

一点二

getArray

Object getArray(long index,
                int count,
                Map<String,类<?>> map)
         throws SQLException

一片的SQL ARRAY值指定的这 Array对象retreives，从指定的 index和含有高达 count SQL的连续元素的数组。

此方法使用指定的map类型Map自定义除非数组的基类型不在map用户定义的类型匹配，在这种情况下，采用标准的映射。这个版本的方法getArray使用给定的类型图或标准图；它不以与连接相关的类型图。

注：当getArray是用来实现一个基类型映射到原始的数据类型，那么它是实现定义的数组是否返回的是原始数据类型或Object数组的数组。

参数

index -第一个元素的数组索引检索；第一个元素的索引是1

count -连续的SQL数组元素个数检索

map - java.util.Map对象包含SQL类型名称和类型在java语言中映射到它们

结果

一个数组包含了 count连续元素的SQL ARRAY值指定的 Array对象，与元 index开始

异常

SQLException -如果在试图访问数组时发生错误

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

从以下版本开始：

一点二

getResultSet

ResultSet getResultSet()
                throws SQLException

检索结果集包含SQL ARRAY价值元素指定的这 Array对象。如果适当的话，使用连接的类型映射映射数组的元素；否则，使用标准映射。

结果集包含每一个数组元素的一行，每行有两个列。第二列存储元素值；第一列将该索引存储到该元素的数组中（与索引1时的第一个数组元素）。行是在对应于索引的顺序的提升中的顺序排列的。

结果

一个 ResultSet对象包含每个数组中指定的元素 Array对象这一行，基于指数升序排。

异常

SQLException -如果在试图访问数组时发生错误

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

从以下版本开始：

一点二

getResultSet

ResultSet getResultSet(Map<String,类<?>> map)
                throws SQLException

检索结果集包含SQL ARRAY价值元素指定的这 Array对象。此方法使用指定的 map类型Map自定义除非数组的基类型不在 map用户定义的类型匹配，在这种情况下，采用标准的映射。这个版本的方法 getResultSet使用给定的类型图或标准图；它不以与连接相关的类型图。

结果集包含每一个数组元素的一行，每行有两个列。第二列存储元素值；第一列将该索引存储到该元素的数组中（与索引1时的第一个数组元素）。行是在对应于索引的顺序的提升中的顺序排列的。

参数

map包含SQL映射用户定义的类型到类的java编程语言

结果

一个 ResultSet对象包含每个数组中指定的元素 Array对象这一行，基于指数升序排。

异常

SQLException -如果在试图访问数组时发生错误

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

从以下版本开始：

一点二

getResultSet

ResultSet getResultSet(long index,
                       int count)
                throws SQLException

检索结果集控股的子阵，开始在指数 index和包含了 count连续元素的元素。此方法使用连接的类型映射来映射数组的元素，如果Map中包含基本类型的条目。否则，使用标准映射。

结果集的SQL数组指定该对象的每个元素一行，包含在索引index元素的第一行。结果集的行了count升序基于指数。每一行有两个列：第二列存储元素值；第一列将该索引存储到该元素的数组中。

参数

index -第一个元素的数组索引检索；第一个元素的索引是1

count -连续的SQL数组元素个数检索

结果

一个包含了 count的SQL数组指定的这 Array对象元素连续 ResultSet对象，从指数 index。

异常

SQLException -如果在试图访问数组时发生错误

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

从以下版本开始：

一点二

getResultSet

ResultSet getResultSet(long index,
                       int count,
                       Map<String,类<?>> map)
                throws SQLException

检索结果集控股的子阵，开始在指数 index和包含了 count连续元素的元素。此方法使用指定的 map类型Map自定义除非数组的基类型不在 map用户定义的类型匹配，在这种情况下，采用标准的映射。这个版本的方法 getResultSet使用给定的类型图或标准图；它不以与连接相关的类型图。

结果集的SQL数组指定该对象的每个元素一行，包含在索引index元素的第一行。结果集的行了count升序基于指数。每一行有两个列：第二列存储元素值；第一列将该索引存储到该元素的数组中。

参数

index -第一个元素的数组索引检索；第一个元素的索引是1

count -连续的SQL数组元素个数检索

map -包含SQL类型名称在java类映射的 Map对象（TM）编程语言

结果

一个包含了 count的SQL数组指定的这 Array对象元素连续 ResultSet对象，从指数 index。

异常

SQLException -如果在试图访问数组时发生错误

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

从以下版本开始：

一点二

free

void free()
   throws SQLException

这种方法使 Array对象并释放资源，它拥有。物体一旦 free方法是无效的。

在free一直叫，任何试图调用其他比free将导致SQLException抛出一个方法。如果free调用多次，以free随后电话被视为一个空操作。

异常

SQLException -如果出现错误释放数组中的资源

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

从以下版本开始：

一点六