JDBC API 支持 SQL:2003 中的高级数据类型,包括 BLOB、CLOB、ARRAY、REF、STRUCT、XML 等。
16.1 SQL 类型分类
SQL 类型可以分为以下几类:
- 基本类型 —
CHAR、VARCHAR、INTEGER、DECIMAL等 - 高级类型 —
BLOB、CLOB、ARRAY、REF、STRUCT等 - 用户定义类型 (UDT) —
DISTINCT、STRUCTURED等
16.2 高级数据类型映射
JDBC 为 SQL 高级数据类型与 Java 类型定义了标准映射。
16.3 Blob、Clob 和 NClob 对象
16.3.1 Blob、Clob 和 NClob 实现
JDBC 驱动程序必须提供 Blob、Clob 和 NClob 接口的实现。
16.3.2 创建 Blob、Clob 和 NClob 对象
通过 Connection.createBlob()、Connection.createClob() 和 Connection.createNClob(),可以分别创建这些对象。
1 | Blob blob = con.createBlob(); |
16.3.3 在 ResultSet 中检索 BLOB、Clob 和 NClob 值
1 | Blob blob = rs.getBlob("blob_column"); |
16.3.4 访问 Blob、Clob 和 NClob 对象数据
1 | // Blob |
16.3.5 存储 Blob、Clob 和 NClob 对象
1 | PreparedStatement pstmt = con.prepareStatement( |
16.3.6 修改 Blob、Clob 和 NClob 对象
这些对象提供了相应方法,用于修改其中的数据。
16.3.7 释放 Blob、Clob 和 NClob 资源
1 | blob.free(); |
16.4 SQLXML 对象
SQLXML 接口用于支持 XML 数据。
16.4.1 创建 SQLXML 对象
1 | SQLXML sqlxml = con.createSQLXML(); |
16.4.2 在 ResultSet 中检索 SQLXML 值
1 | SQLXML sqlxml = rs.getSQLXML("xml_column"); |
16.4.3 访问 SQLXML 对象数据
1 | String xmlString = sqlxml.getString(); |
16.4.4 存储 SQLXML 对象
1 | pstmt.setSQLXML(1, sqlxml); |
16.4.5 初始化 SQLXML 对象
使用 getSource 和 setResult 方法可以初始化 SQLXML 对象。
16.4.6 释放 SQLXML 资源
1 | sqlxml.free(); |
16.5 Array 对象
Array 接口用于支持 SQL ARRAY 类型。
16.5.1 Array 实现
JDBC 驱动程序必须提供 Array 接口的实现。
16.5.2 创建 Array 对象
1 | Array array = con.createArrayOf("INTEGER", new Object[]{1, 2, 3}); |
16.5.3 检索 Array 对象
1 | Array array = rs.getArray("array_column"); |
16.5.4 存储 Array 对象
1 | pstmt.setArray(1, array); |
16.5.5 更新 Array 对象
1 | rs.updateArray("array_column", array); |
16.5.6 释放 Array 资源
1 | array.free(); |
16.6 Ref 对象
Ref 接口用于支持 SQL REF 类型。
16.6.1 检索 REF 值
1 | Ref ref = rs.getRef("ref_column"); |
16.6.2 检索引用的值
1 | Object obj = ref.getObject(); |
16.6.3 存储 Ref 对象
1 | pstmt.setRef(1, ref); |
16.6.4 存储引用的值
16.6.5 元数据
可以使用 ResultSetMetaData 获取 Ref 列的类型信息。
16.7 Distinct 类型
DISTINCT 类型是以单个预定义类型为基础定义的用户定义类型。
16.7.1 检索 Distinct 类型
读取 DISTINCT 类型的值时,使用其基础类型表示。
16.7.2 存储 Distinct 类型
存储 DISTINCT 类型的值时,使用其基础类型表示。
16.7.3 元数据
可以使用 DatabaseMetaData 获取 Distinct 类型的信息。
16.8 结构化类型
结构化类型是由一个或多个属性组成的用户定义类型。
16.8.1 创建结构化对象
1 | Struct struct = con.createStruct("ADDRESS", |
16.8.2 检索结构化类型
1 | Struct struct = (Struct) rs.getObject("address_column"); |
16.8.3 存储结构化类型
1 | pstmt.setObject(1, struct); |
16.8.4 元数据
可以使用 DatabaseMetaData 获取结构化类型的信息。
16.9 DataLink
DATALINK 类型表示指向数据源外部数据的引用。
16.9.1 检索对外部数据的引用
1 | URL url = rs.getURL("url_column"); |
16.9.2 存储对外部数据的引用
1 | pstmt.setURL(1, new URL("http://example.com/data")); |
16.9.3 元数据
可以使用 ResultSetMetaData 确定 DATALINK 列。
16.10 RowId 对象
RowId 接口用于支持 SQL 的 ROWID 类型。
16.10.1 RowId 的有效期
RowId 值的有效性取决于数据库实现。
16.10.2 检索 RowId 值
1 | RowId rowId = rs.getRowId("rowid_column"); |
16.10.3 使用 RowId 值
1 | pstmt.setRowId(1, rowId); |
16.11 自定义类型映射
16.11.1 类型映射
可以为 UDT 定义自定义类型映射,将 SQL 类型映射到 Java 类。
16.11.2 类约定
参与自定义映射的 Java 类必须实现 SQLData 接口。
16.11.3 SQL 数据流
16.11.3.1 检索数据
使用 SQLInput 方法从流中读取数据。
16.11.3.2 存储数据
使用 SQLOutput 方法将数据写入流。
