JDBC元数据操作(一)-- DatabaseMetaData接口详解
1. 前言
在JDBC技术规范中,提供了Connection,Statement,ResultSet这三个开发过程中经常用到的接口。针对与每个接口,JDBC规范提供了相应的接口描述对象,也就是xxxMetaData系列描述对象。DatabaseMetaData和ResultSetMetaData就是两个常用的获取数据库元数据相关信息的接口,本文只讲解DatabaseMetaData接口获取元数据的方法。
本文地址:http://blog.csdn.net/chen_zw/article/details/18816599
2. DatabaseMetaData接口常用的方法:
(1) ResultSet getTables(String catalog,String schemaPattern,String tableNamePattern,String[] types); //获取表信息
(2) ResultSet getPrimaryKeys(String catalog,String schema,String table); //获取表主键信息
(3) ResultSet getIndexInfo(String catalog,String schema,String table,boolean unique,boolean approximate); //获取表索引信息
(4) ResultSet getColumns(String catalog,String schemaPattern,String tableNamePattern,String columnNamePattern); //获取表列信息
3. Demo封装演示:
package com.util;import java.sql.CallableStatement;
import java.sql.Connection;
import java.sql.DatabaseMetaData;
import java.sql.DriverManager;
import java.sql.PreparedStatement;
import java.sql.ResultSet;
import java.sql.SQLException;
import java.sql.Statement;import oracle.jdbc.driver.OracleConnection;/*** @Description: JDBC操作元数据示例-- DatabaseMetaData接口* @CreateTime: 2014-1-19 下午9:46:44* @author: chenzw * @version V1.0*/
public class JdbcUtil {//获得驱动 private static String DRIVER = "oracle.jdbc.driver.OracleDriver"; //获得url private static String URL = "jdbc:oracle:thin:@localhost:test"; //获得连接数据库的用户名 private static String USER = "root"; //获得连接数据库的密码 private static String PASS = "root"; static { try { //初始化JDBC驱动并让驱动加载到jvm中 Class.forName(DRIVER); } catch (ClassNotFoundException e) { e.printStackTrace(); } } public static Connection getConnection(){ Connection conn = null; try { //连接数据库 /** 设置可获取REMARK备注信息Properties props =new Properties();props.put("remarksReporting","true");props.put("user", USER);props.put("password", PASS);conn =DriverManager.getConnection(URL,props);*/conn = DriverManager.getConnection(URL,USER,PASS); conn.setAutoCommit(true);} catch (SQLException e) { e.printStackTrace(); } return conn; } //关闭连接public static void close(Object o){ if (o == null){ return; } if (o instanceof ResultSet){ try { ((ResultSet)o).close(); } catch (SQLException e) { e.printStackTrace(); } } else if(o instanceof Statement){ try { ((Statement)o).close(); } catch (SQLException e) { e.printStackTrace(); } } else if (o instanceof Connection){ Connection c = (Connection)o; try { if (!c.isClosed()){ c.close(); } } catch (SQLException e) { e.printStackTrace(); } } } public static void close(ResultSet rs, Statement stmt, Connection conn){ close(rs); close(stmt); close(conn); } public static void close(ResultSet rs, Connection conn){ close(rs); close(conn); } /*** @Description: 获取数据库相关信息* @author: chenzw * @CreateTime: 2014-1-27 下午5:09:12 * @throws*/public static void getDataBaseInfo() { Connection conn = getConnection();ResultSet rs = null;try{ DatabaseMetaData dbmd = conn.getMetaData();System.out.println("数据库已知的用户: "+ dbmd.getUserName()); System.out.println("数据库的系统函数的逗号分隔列表: "+ dbmd.getSystemFunctions()); System.out.println("数据库的时间和日期函数的逗号分隔列表: "+ dbmd.getTimeDateFunctions()); System.out.println("数据库的字符串函数的逗号分隔列表: "+ dbmd.getStringFunctions()); System.out.println("数据库供应商用于 'schema' 的首选术语: "+ dbmd.getSchemaTerm()); System.out.println("数据库URL: " + dbmd.getURL()); System.out.println("是否允许只读:" + dbmd.isReadOnly()); System.out.println("数据库的产品名称:" + dbmd.getDatabaseProductName()); System.out.println("数据库的版本:" + dbmd.getDatabaseProductVersion()); System.out.println("驱动程序的名称:" + dbmd.getDriverName()); System.out.println("驱动程序的版本:" + dbmd.getDriverVersion()); System.out.println("数据库中使用的表类型"); rs = dbmd.getTableTypes(); while (rs.next()) { System.out.println(rs.getString("TABLE_TYPE")); } }catch (SQLException e){ e.printStackTrace(); } finally{JdbcUtil.close(rs,conn);} } /*** @Description:获得数据库中所有Schemas(对应于oracle中的Tablespace)* @author: chenzw * @CreateTime: 2014-1-27 下午5:10:35 * @throws*/public static void getSchemasInfo(){ Connection conn = getConnection();ResultSet rs = null;try{ DatabaseMetaData dbmd = conn.getMetaData();rs = dbmd.getSchemas(); while (rs.next()){ String tableSchem = rs.getString("TABLE_SCHEM"); System.out.println(tableSchem); } } catch (SQLException e){ e.printStackTrace(); } finally{JdbcUtil.close(rs,conn);} } /*** @Description: 获取数据库中所有的表信息* @author: chenzw * @CreateTime: 2014-1-27 下午5:08:28 * @throws*/public static void getTablesList() { Connection conn = getConnection();ResultSet rs = null;try { /*** 设置连接属性,使得可获取到表的REMARK(备注)*/((OracleConnection)conn).setRemarksReporting(true); DatabaseMetaData dbmd = conn.getMetaData();String[] types = { "TABLE" }; rs = dbmd.getTables(null, null, "%", types); while (rs.next()) { String tableName = rs.getString("TABLE_NAME"); //表名 String tableType = rs.getString("TABLE_TYPE"); //表类型 String remarks = rs.getString("REMARKS"); //表备注 System.out.println(tableName + " - " + tableType + " - " + remarks); } } catch (SQLException e) { e.printStackTrace(); } finally{JdbcUtil.close(rs,conn);} } /*** @Description: 获取某表信息* @author: chenzw * @CreateTime: 2014-1-27 下午3:26:30 * @throws*/public static void getTablesInfo(){Connection conn = getConnection();ResultSet rs = null;try {/*** 设置连接属性,使得可获取到表的REMARK(备注)*/((OracleConnection)conn).setRemarksReporting(true); DatabaseMetaData dbmd = conn.getMetaData();/*** 获取给定类别中使用的表的描述。* 方法原型:ResultSet getTables(String catalog,String schemaPattern,String tableNamePattern,String[] types);* catalog - 表所在的类别名称;""表示获取没有类别的列,null表示获取所有类别的列。* schema - 表所在的模式名称(oracle中对应于Tablespace);""表示获取没有模式的列,null标识获取所有模式的列; 可包含单字符通配符("_"),或多字符通配符("%");* tableNamePattern - 表名称;可包含单字符通配符("_"),或多字符通配符("%");* types - 表类型数组; "TABLE"、"VIEW"、"SYSTEM TABLE"、"GLOBAL TEMPORARY"、"LOCAL TEMPORARY"、"ALIAS" 和 "SYNONYM";null表示包含所有的表类型;可包含单字符通配符("_"),或多字符通配符("%"); */rs = dbmd.getTables(null, null, "CUST_INTER_TF_SERVICE_REQ", new String[]{"TABLE","VIEW"}); while(rs.next()){String tableCat = rs.getString("TABLE_CAT"); //表类别(可为null) String tableSchemaName = rs.getString("TABLE_SCHEM");//表模式(可能为空),在oracle中获取的是命名空间,其它数据库未知 String tableName = rs.getString("TABLE_NAME"); //表名 String tableType = rs.getString("TABLE_TYPE"); //表类型,典型的类型是 "TABLE"、"VIEW"、"SYSTEM TABLE"、"GLOBAL TEMPORARY"、"LOCAL TEMPORARY"、"ALIAS" 和 "SYNONYM"。String remarks = rs.getString("REMARKS"); //表备注 System.out.println(tableCat + " - " + tableSchemaName + " - " +tableName + " - " + tableType + " - " + remarks); }} catch (Exception ex) {ex.printStackTrace();}finally{JdbcUtil.close(rs,conn);}}/*** @Description: 获取表主键信息* @author: chenzw * @CreateTime: 2014-1-27 下午5:12:53 * @throws*/public static void getPrimaryKeysInfo() { Connection conn = getConnection();ResultSet rs = null;try{ DatabaseMetaData dbmd = conn.getMetaData();/*** 获取对给定表的主键列的描述* 方法原型:ResultSet getPrimaryKeys(String catalog,String schema,String table);* catalog - 表所在的类别名称;""表示获取没有类别的列,null表示获取所有类别的列。* schema - 表所在的模式名称(oracle中对应于Tablespace);""表示获取没有模式的列,null标识获取所有模式的列; 可包含单字符通配符("_"),或多字符通配符("%");* table - 表名称;可包含单字符通配符("_"),或多字符通配符("%");*/rs = dbmd.getPrimaryKeys(null, null, "CUST_INTER_TF_SERVICE_REQ"); while (rs.next()){ String tableCat = rs.getString("TABLE_CAT"); //表类别(可为null) String tableSchemaName = rs.getString("TABLE_SCHEM");//表模式(可能为空),在oracle中获取的是命名空间,其它数据库未知 String tableName = rs.getString("TABLE_NAME"); //表名 String columnName = rs.getString("COLUMN_NAME");//列名 short keySeq = rs.getShort("KEY_SEQ");//序列号(主键内值1表示第一列的主键,值2代表主键内的第二列) String pkName = rs.getString("PK_NAME"); //主键名称 System.out.println(tableCat + " - " + tableSchemaName + " - " + tableName + " - " + columnName + " - "+ keySeq + " - " + pkName); } }catch (SQLException e){ e.printStackTrace(); }finally{JdbcUtil.close(rs,conn);}} /*** @Description: 获取表索引信息* @author: chenzw * @CreateTime: 2014-1-27 下午5:12:04 * @throws*/public static void getIndexInfo() { Connection conn = getConnection();ResultSet rs = null;try{ DatabaseMetaData dbmd = conn.getMetaData();/*** 获取给定表的索引和统计信息的描述* 方法原型:ResultSet getIndexInfo(String catalog,String schema,String table,boolean unique,boolean approximate)* catalog - 表所在的类别名称;""表示获取没有类别的列,null表示获取所有类别的列。* schema - 表所在的模式名称(oracle中对应于Tablespace);""表示获取没有模式的列,null标识获取所有模式的列; 可包含单字符通配符("_"),或多字符通配符("%");* table - 表名称;可包含单字符通配符("_"),或多字符通配符("%");* unique - 该参数为 true时,仅返回唯一值的索引; 该参数为 false时,返回所有索引;* approximate - 该参数为true时,允许结果是接近的数据值或这些数据值以外的值;该参数为 false时,要求结果是精确结果;*/rs = dbmd.getIndexInfo(null, null, "CUST_INTER_TF_SERVICE_REQ", false, true); while (rs.next()){ String tableCat = rs.getString("TABLE_CAT"); //表类别(可为null) String tableSchemaName = rs.getString("TABLE_SCHEM");//表模式(可能为空),在oracle中获取的是命名空间,其它数据库未知 String tableName = rs.getString("TABLE_NAME"); //表名 boolean nonUnique = rs.getBoolean("NON_UNIQUE");// 索引值是否可以不唯一,TYPE为 tableIndexStatistic时索引值为 false;String indexQualifier = rs.getString("INDEX_QUALIFIER");//索引类别(可能为空),TYPE为 tableIndexStatistic 时索引类别为 null; String indexName = rs.getString("INDEX_NAME");//索引的名称 ;TYPE为 tableIndexStatistic 时索引名称为 null;/*** 索引类型: * tableIndexStatistic - 此标识与表的索引描述一起返回的表统计信息 * tableIndexClustered - 此为集群索引 * tableIndexHashed - 此为散列索引 * tableIndexOther - 此为某种其他样式的索引 */short type = rs.getShort("TYPE");//索引类型;short ordinalPosition = rs.getShort("ORDINAL_POSITION");//在索引列顺序号;TYPE为 tableIndexStatistic 时该序列号为零;String columnName = rs.getString("COLUMN_NAME");//列名;TYPE为 tableIndexStatistic时列名称为 null;String ascOrDesc = rs.getString("ASC_OR_DESC");//列排序顺序:升序还是降序[A:升序; B:降序];如果排序序列不受支持,可能为 null;TYPE为 tableIndexStatistic时排序序列为 null;int cardinality = rs.getInt("CARDINALITY"); //基数;TYPE为 tableIndexStatistic 时,它是表中的行数;否则,它是索引中唯一值的数量。 int pages = rs.getInt("PAGES"); //TYPE为 tableIndexStatisic时,它是用于表的页数,否则它是用于当前索引的页数。String filterCondition = rs.getString("FILTER_CONDITION"); //过滤器条件,如果有的话(可能为 null)。System.out.println(tableCat + " - " + tableSchemaName + " - " + tableName + " - " + nonUnique + " - " + indexQualifier + " - " + indexName + " - " + type + " - " + ordinalPosition + " - " + columnName + " - " + ascOrDesc + " - " + cardinality + " - " + pages + " - " + filterCondition); } } catch (SQLException e){ e.printStackTrace(); } finally{JdbcUtil.close(rs,conn);} } /*** @Description: 获取表中列值信息* @author: chenzw * @CreateTime: 2014-1-27 下午2:55:56 * @throws*/public static void getColumnsInfo(){Connection conn = getConnection();ResultSet rs = null;try{/*** 设置连接属性,使得可获取到列的REMARK(备注)*/((OracleConnection)conn).setRemarksReporting(true); DatabaseMetaData dbmd = conn.getMetaData();/*** 获取可在指定类别中使用的表列的描述。* 方法原型:ResultSet getColumns(String catalog,String schemaPattern,String tableNamePattern,String columnNamePattern)* catalog - 表所在的类别名称;""表示获取没有类别的列,null表示获取所有类别的列。* schema - 表所在的模式名称(oracle中对应于Tablespace);""表示获取没有模式的列,null标识获取所有模式的列; 可包含单字符通配符("_"),或多字符通配符("%");* tableNamePattern - 表名称;可包含单字符通配符("_"),或多字符通配符("%");* columnNamePattern - 列名称; ""表示获取列名为""的列(当然获取不到);null表示获取所有的列;可包含单字符通配符("_"),或多字符通配符("%");*/rs =dbmd.getColumns(null, null, "CUST_INTER_TF_SERVICE_REQ", null);while(rs.next()){String tableCat = rs.getString("TABLE_CAT"); //表类别(可能为空) String tableSchemaName = rs.getString("TABLE_SCHEM"); //表模式(可能为空),在oracle中获取的是命名空间,其它数据库未知 String tableName_ = rs.getString("TABLE_NAME"); //表名 String columnName = rs.getString("COLUMN_NAME"); //列名 int dataType = rs.getInt("DATA_TYPE"); //对应的java.sql.Types的SQL类型(列类型ID) String dataTypeName = rs.getString("TYPE_NAME"); //java.sql.Types类型名称(列类型名称)int columnSize = rs.getInt("COLUMN_SIZE"); //列大小 int decimalDigits = rs.getInt("DECIMAL_DIGITS"); //小数位数 int numPrecRadix = rs.getInt("NUM_PREC_RADIX"); //基数(通常是10或2) --未知/*** 0 (columnNoNulls) - 该列不允许为空* 1 (columnNullable) - 该列允许为空* 2 (columnNullableUnknown) - 不确定该列是否为空*/int nullAble = rs.getInt("NULLABLE"); //是否允许为null String remarks = rs.getString("REMARKS"); //列描述 String columnDef = rs.getString("COLUMN_DEF"); //默认值 int charOctetLength = rs.getInt("CHAR_OCTET_LENGTH"); // 对于 char 类型,该长度是列中的最大字节数 int ordinalPosition = rs.getInt("ORDINAL_POSITION"); //表中列的索引(从1开始) /** * ISO规则用来确定某一列的是否可为空(等同于NULLABLE的值:[ 0:'YES'; 1:'NO'; 2:''; ])* YES -- 该列可以有空值; * NO -- 该列不能为空;* 空字符串--- 不知道该列是否可为空*/ String isNullAble = rs.getString("IS_NULLABLE"); /** * 指示此列是否是自动递增 * YES -- 该列是自动递增的* NO -- 该列不是自动递增* 空字串--- 不能确定该列是否自动递增*/ //String isAutoincrement = rs.getString("IS_AUTOINCREMENT"); //该参数测试报错 System.out.println(tableCat + " - " + tableSchemaName + " - " + tableName_ + " - " + columnName + " - " + dataType + " - " + dataTypeName + " - " + columnSize + " - " + decimalDigits + " - " + numPrecRadix + " - " + nullAble + " - " + remarks + " - " + columnDef + " - " + charOctetLength+ " - " + ordinalPosition + " - " + isNullAble ); }}catch(SQLException ex){ex.printStackTrace();}finally{JdbcUtil.close(rs,conn);}}/*** @Description: TODO* @author: chenzw * @CreateTime: 2014-1-17 下午2:47:45* @param args * @throws */public static void main(String[] args) {getDataBaseInfo(); //获取数据库信息getSchemasInfo(); //获取数据库所有SchemagetTablesList(); //获取某用户下所有的表getTablesInfo(); //获取表信息getPrimaryKeysInfo(); //获取表主键信息getIndexInfo(); //获取表索引信息getColumnsInfo(); //获取表中列值信息}
}
Note:
(1)JDBC元数据的操作是很消耗性能的,所以应尽量避免使用。
(2)在获取元数据中的REMARK(即 备注)前,需要设置RemarksReporting属性为true,否则获取到的REMARK属性都是null,设置该属性有两种方法,请参阅上面的Demo。