欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页

JDBC元数据操作-- DatabaseMetaData接口详解 博客分类: java

程序员文章站 2024-03-21 21:43:16
...

1. 前言

    在JDBC技术规范中,提供了Connection,Statement,ResultSet这三个开发过程中经常用到的接口。针对与每个接口,JDBC规范提供了相应的接口描述对象,也就是xxxMetaData系列描述对象。DatabaseMetaData和ResultSetMetaData就是两个常用的获取数据库元数据相关信息的接口,本文只讲解DatabaseMetaData接口获取元数据的方法。

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(); //获取数据库所有Schema
		getTablesList();  //获取某用户下所有的表
		getTablesInfo();  //获取表信息
		getPrimaryKeysInfo(); //获取表主键信息
		getIndexInfo();  //获取表索引信息
		getColumnsInfo(); //获取表中列值信息
	}
}

 

Note: (1)JDBC元数据的操作是很消耗性能的,所以应尽量避免使用。 (2)在获取元数据中的REMARK(即 备注)前,需要设置RemarksReporting属性为true,否则获取到的REMARK属性都是null,设置该属性有两种方法,请参阅上面的Demo。