DatabaseMetaData 接口提供数据源的相关信息,应用程序可以据此判断数据源是否支持某项功能或一组功能。例如,是否支持可滚动结果集,能否使用 Connection.commit 和 Connection.rollback。应用程序还可以借助 DatabaseMetaData 接口了解:
- 数据源的限制
- 数据源中包含的 SQL 对象及其属性
- 数据源提供的事务支持
DatabaseMetaData 接口还定义了 40 多个字段,用作多个元数据方法返回值中的常量。
本章概述 DatabaseMetaData 接口,并通过示例介绍元数据方法的分类,以及 JDBC 4.2 API 中新增或修改的方法。完整定义请参阅 JDBC API 规范。
注意:JDBC 还定义了
ResultSetMetaData接口,该接口会在第 15 章“结果集”中介绍。
7.1 创建 DatabaseMetaData 对象
DatabaseMetaData 对象通过 Connection 的 getMetaData 方法创建。获取该对象后,应用程序就可以在运行时查询底层数据源的信息。代码示例 7-1 展示了如何创建 DatabaseMetaData 对象,并用它查询表名允许的最大长度。
1 | // con is a Connection object |
代码示例 7-1 创建和使用 DatabaseMetaData 对象
7.2 获取基本信息
部分 DatabaseMetaData 方法用于查询数据源的基本信息及实现细节,例如:
getURLgetUserNamegetDatabaseProductVersion、getDriverMajorVersion和getDriverMinorVersiongetSchemaTerm、getCatalogTerm和getProcedureTermnullsAreSortedHigh和nullsAreSortedLowusesLocalFiles和usesLocalFilePerTablegetSQLKeywords
7.3 判断功能支持情况
DatabaseMetaData 提供了大量方法,用于判断驱动程序或底层数据源是否支持某项功能或一组功能。有些方法只返回是否支持,有些方法则进一步说明支持级别。
用于判断单项能力是否受支持的方法示例包括:
supportsAlterTableWithDropColumnsupportsBatchUpdatessupportsTableCorrelationNamessupportsPositionedDeletesupportsFullOuterJoinssupportsStoredProceduressupportsMixedCaseQuotedIdentifiers
用于描述支持级别的方法示例包括:
supportsANSI92EntryLevelSQLsupportsCoreSQLGrammar
7.4 数据源限制
另一组方法用于查询数据源的各项限制,例如:
getMaxRowSizegetMaxStatementLengthgetMaxTablesInSelectgetMaxConnectionsgetMaxCharLiteralLengthgetMaxColumnsInTable
这些方法通常返回 int 值。返回值为 0 表示没有限制,或者该限制未知。
7.5 SQL 对象及其属性
还有一些 DatabaseMetaData 方法用于查询数据源中的 SQL 对象及其属性。这组方法通常返回 ResultSet 对象,每一行对应一个具体的 SQL 对象。例如,getUDTs 会返回一个 ResultSet,其中每一行都对应数据源中定义的一个 UDT。
这一类方法的示例包括:
getSchemasgetCatalogsgetTablesgetPrimaryKeysgetProceduresgetProcedureColumnsgetUDTsgetFunctionsgetFunctionColumns
DatabaseMetaData 方法返回的 ResultSet 对象,其结果集类型为 TYPE_FORWARD_ONLY,并发模式为 CONCUR_READ_ONLY。可以通过 ResultSet.getHoldability 判断该 ResultSet 的保持性,因为默认保持性取决于具体实现。
JDBC 驱动程序供应商可以在标准列之外返回额外的列,但这些额外列必须通过列标签访问。这样一来,未来版本的 JDBC 规范就能够在不破坏现有应用程序的前提下,为现有 DatabaseMetaData 方法增加新列。
7.6 事务支持
少量方法用于描述数据源支持的事务语义,例如:
supportsMultipleTransactionsgetDefaultTransactionIsolation
7.7 新方法
JDBC 4.2 API 引入了以下新的 DatabaseMetaData 方法:
supportsRefCursors:用于指示驱动程序或底层数据源是否支持REF CURSOR。getMaxLogicalLobSize:用于获取驱动程序支持的最大逻辑LOB大小。
这些方法的完整定义可参见 JDBC API 规范中的 Javadoc。
7.8 修改的方法
JDBC 4.2 API 修改了以下现有 DatabaseMetaData 方法的定义:
getIndexInfo:返回结果中的CARDINALITY和PAGES列现在返回long值。
这些方法的更新定义见 JDBC 4.2 API 规范。
