java.sql.Array

java.sql.Array接口是JDBC对SQL集合类型的映射，提供了将SQL数据以数组或ResultSet对象的形式传输到客户端的方法。

表1 java.sql.Array常用方法
方法名	返回值类型	throws	支持JDBC4
getBaseTypeName()	String	SQLException	Yes
getBaseType()	int	SQLException	Yes
getArray()	Object	SQLException	Yes
getArray(java.util.Map<String,Class<?>> map)	Object	SQLException	No
getArray(long index, int count)	Object	SQLException	Yes
getArray(long index, int count, java.util.Map<String,Class<?>> map)	Object	SQLException	No
getResultSet()	ResultSet	SQLException	No
getResultSet(java.util.Map<String,Class<?>> map)	ResultSet	SQLException	No
getResultSet(long index, int count)	ResultSet	SQLException	No
getResultSet (long index, int count, java.util.Map<String,Class<?>> map)	ResultSet	SQLException	No
free()	void	SQLException	No

getArray和getArray(long index, int count)接口获取的数组类型可参考数据类型映射关系的JAVA变量类型列。
例如：元素类型为varchar，getArray接口获取的对象类型为String[]。

特殊说明：元素类型为int2/smallint，元素存取为Short类型，getArray接口获取的对象类型为Short[]。
getBaseType接口获取的sqlType可参考数据类型映射关系的JDBC类型索引列。
getBaseTypeName获取的元素类型名可参考数据类型映射关系，其中集合类型、数组类型、record类型的类型名映射规则如下：
1. 若为package里定义的类型，类型名通常格式为schema.package.type。
  若schema、package、type中有任意名称不符合规则，则类型名格式为"schema"."package"."type"：
  - 只能包含字母、数字或下划线。
  - 第一个字符不能是数字。
2. 若为schema里定义的类型，类型名通常格式为schema.type。
  若schema、type中有任意名称不符合规则，则类型名格式为"schema"."type"：
  - 只能包含字母、数字或下划线。
  - 第一个字符不能是数字。
对于getArray(long index, int count)接口
1. 起始元素的index为1；
2. index的取值范围为1-2147483647，index的输入超范围时报错；
3. count的取值范围为0-2147483647，count的输入超范围时报错；
4. 若index大于元素个数，则返回空数组（长度为0的数组）；
5. 若count超出按当前index可获取的最大元素的数量，则返回剩余元素组成的数组。