RSS

Analisando Metadados com JDBC

23 nov

Introdução

Neste Tutorial você aprenderá a recuperar metadados de seu banco de dados, tabelas e stored procedures. Mas, o que são metadados? Como o próprio nome diz, Metadados são informações sobre os seus dados. Pense em metadata como um reflection do seu banco de dados! Ex: Metadados de uma tabela são: nome das colunas, tipo de dados das colunas (VARCHAR, NUMBER), tamanho da coluna, proprietário da tabela,etc.

Motivação

Em algumas situações é necessário se recuperar esses metadados para construirmos nossas consultas dinamicamente, pois em uma grande base de dados algumas mudanças estruturais podem ocorrer com certa frequência. Alguns desenvolvedores constróem seus próprios frameworks utilizando as funcionalidades de recuperação de metadados do JDBC. Assim quando um Analista de Dados alterar o modelo relacional, acrescentando colunas ou alterando o tipo das mesmas, as suas aplicações não precisam sofrer manutenções. Existem três classes que nos permitem recuperar metadados a partir do Driver JDBC, no pacote java.sql:

  • DatabaseMetaData
  • ResultSetMetaData
  • ParameterMetaData (nova, JDBC 3.0)

    A Classe DatabaseMetaData

    A classe DatabaseMetaData é recuperada através do objeto Connection e nos permitirá recuperar metadados sobre o banco de dados em uso, objetos do banco de dados, informações sobre o Driver JDBC, privilégios de acesso, etc. Existem mais de 150 métodos disponíveis para esta classe. Vamos então verificar como utilizar a Classe DatabaseMetaData :

     

    1. package br.com.guj; 
    2.  
    3. import java.sql.*; 
    4.  
    5. public class Exemplo1 { 
    6. public static void main(String[] args) throws SQLException { 
    7. // registrar o Driver JDBC do banco de dados, neste caso estou usando o da Oracle
    8.         DriverManager.registerDriver(new oracle.jdbc.driver.OracleDriver()); 
    9.  
    10. // String de conexao para uma base Oracle
    11.         Connection conn = DriverManager.getConnection("jdbc:oracle:thin:@127.0.0.1:1521:orcl","scott","tiger"); 
    12.  
    13. // recuperar a classe  DatabaseMetadaData a partir da conexao criada
    14.         DatabaseMetaData dbmd = conn.getMetaData(); 
    15.  
    16.         System.out.println ( "Versao do Driver JDBC = "+ dbmd.getDriverVersion()); 
    17.         System.out.println ( "Versao do Banco de Dados = "+ dbmd.getDatabaseProductVersion()); 
    18.         System.out.println ( "Suporta Select for Update? = "+ dbmd.supportsSelectForUpdate());   
    19.         System.out.println ( "Suporta Transacoes? = "+ dbmd.supportsTransactions()); 
    20.  
    21. // retornar todos os schemas(usuarios) do Banco de Dados
    22.         ResultSet r2 = dbmd.getSchemas(); 
    23. while (r2.next()) { 
    24.             System.out.println("SCHEMA DO BD = " + r2.getString(1)); 
    25.         } 
    26.     } 

    package br.com.guj; import java.sql.*; public class Exemplo1 { public static void main(String[] args) throws SQLException { // registrar o Driver JDBC do banco de dados, neste caso estou usando o da Oracle DriverManager.registerDriver(new oracle.jdbc.driver.OracleDriver()); // String de conexao para uma base Oracle Connection conn = DriverManager.getConnection("jdbc:oracle:thin:@127.0.0.1:1521:orcl","scott","tiger"); // recuperar a classe DatabaseMetadaData a partir da conexao criada DatabaseMetaData dbmd = conn.getMetaData(); System.out.println ( "Versao do Driver JDBC = "+ dbmd.getDriverVersion()); System.out.println ( "Versao do Banco de Dados = "+ dbmd.getDatabaseProductVersion()); System.out.println ( "Suporta Select for Update? = "+ dbmd.supportsSelectForUpdate()); System.out.println ( "Suporta Transacoes? = "+ dbmd.supportsTransactions()); // retornar todos os schemas(usuarios) do Banco de Dados ResultSet r2 = dbmd.getSchemas(); while (r2.next()) { System.out.println("SCHEMA DO BD = " + r2.getString(1)); } } }

    A Classe ResultSetMetaData

    A outra Classe que pode ser utilizada para recuperar mais metadados é a ResultSetMetaData, com um objeto dessa classe você poderá dinamicamente recuperar a quantidade de colunas de uma tabela (não estou me referindo a registros ou linhas, e sim colunas), também poderá dinamicamente descobrir o nome da coluna, seu tipo, tamanho, entre outras informações. Neste próximo exemplo iremos utilizar a classe ResultSetMetaData para descobrirmos dinamicamente o total de colunas de uma tabela, o nome de suas colunas e o tipo das mesmas.

     

    1.   … 
    2. Statement stmt = conn.createStatement(); 
    3. // Tabela a ser analisada
    4. ResultSet rset = stmt.executeQuery("SELECT * from EMP "); 
    5.  
    6. ResultSetMetaData rsmd = rset.getMetaData(); 
    7.  
    8. // retorna o numero total de colunas
    9. int numColumns = rsmd.getColumnCount(); 
    10. System.out.println("Total de Colunas = " + numColumns); 
    11.  
    12. // loop para recuperar os metadados de cada coluna
    13. for (int i=0; i<numColumns; i++) { 
    14.     System.out.print("Nome da Coluna=" + rsmd.getColumnName (i + 1)); 
    15.     System.out.print(" Tipo=" + rsmd.getColumnType (i + 1) ); 
    16.     System.out.print(" Nome do Tipo=" + rsmd.getColumnTypeName (i + 1)); 
    17.     System.out.print(" Tamanho=" + rsmd.getColumnDisplaySize (i + 1)); 
    18.     System.out.println(" Casas Decimais=" + rsmd.getScale(i + 1)); 

    … Statement stmt = conn.createStatement(); // Tabela a ser analisada ResultSet rset = stmt.executeQuery("SELECT * from EMP "); ResultSetMetaData rsmd = rset.getMetaData(); // retorna o numero total de colunas int numColumns = rsmd.getColumnCount(); System.out.println("Total de Colunas = " + numColumns); // loop para recuperar os metadados de cada coluna for (int i=0; i<numColumns; i++) { System.out.print("Nome da Coluna=" + rsmd.getColumnName (i + 1)); System.out.print(" Tipo=" + rsmd.getColumnType (i + 1) ); System.out.print(" Nome do Tipo=" + rsmd.getColumnTypeName (i + 1)); System.out.print(" Tamanho=" + rsmd.getColumnDisplaySize (i + 1)); System.out.println(" Casas Decimais=" + rsmd.getScale(i + 1)); }
    Você ainda pode utilizar as classes PreparedStatement ou CallableStatement para uma instância ResultSetMetaData. Comprove no exemplo abaixo:

     

    1. … 
    2. PreparedStatement ps = conn.prepareStatement("SELECT * FROM EMP where EMPNO = ? "); 
    3. ps.setLong(1,1020L); 
    4.  
    5. ResultSetMetaData rsmd = ps.getMetaData(); 
    6.  
    7. // retorna o numero total de colunas
    8. int numColumns = rsmd.getColumnCount(); 
    9. System.out.println("Total de Colunas = " + numColumns); 

    … PreparedStatement ps = conn.prepareStatement("SELECT * FROM EMP where EMPNO = ? "); ps.setLong(1,1020L); ResultSetMetaData rsmd = ps.getMetaData(); // retorna o numero total de colunas int numColumns = rsmd.getColumnCount(); System.out.println("Total de Colunas = " + numColumns);

    A Classe ParameterMetaData

    Através da classe ParameterMetaData é possível recuperar metadados sobre os "parâmetros" de cláusulas SQL que usamos com a classe PreparedStatement. Assim poderemos descobrir dinamicamente a quantidade de parâmetros utilizados e suas características. Confiram no exemplo abaixo o uso da classe ParameterMetaData recuperando informações sobres os parâmetros "?" da clásula SQL.

     

    1. PreparedStatement pstmt = conn.prepareStatement("SELECT * FROM EMP WHERE EMPNO = ? AND DEPTNO = ?"); 
    2. ParameterMetaData pmd = pstmt.getParameterMetaData(); 
    3.  
    4. // recupera o total de parametros
    5. int totalParam = pmd.getParameterCount(); 
    6.  
    7. // recupera informacoes sobre cada parametro
    8. for (int i=0; i < totalParam; i++) { 
    9. int tipoParam = pmd.getParameterType(i+1); 
    10.     String nomeTipoParam = pmd.getParameterTypeName(i+1); 

    PreparedStatement pstmt = conn.prepareStatement("SELECT * FROM EMP WHERE EMPNO = ? AND DEPTNO = ?"); ParameterMetaData pmd = pstmt.getParameterMetaData(); // recupera o total de parametros int totalParam = pmd.getParameterCount(); // recupera informacoes sobre cada parametro for (int i=0; i < totalParam; i++) { int tipoParam = pmd.getParameterType(i+1); String nomeTipoParam = pmd.getParameterTypeName(i+1); }

    Resumo e conclusão

    Um objeto DatabaseMetaData é obtida através do objeto Connection e oferecerá recursos de recuperação de metadados da base de dados e da sua conexão atual, pode ser utilizada por exemplo para verificar quais os schemas(usuários) de uma base de dados, se a conexão atual possui suporte a um determinado nível de isolamente de transações, ou até mesmo qual a versão do Driver JDBC. Um objeto ResultSetMetaData pode ser obtida através de um ResultSet previamente criado ou através das classes PreparedStatement e CallableStatement, lhe possibilitando a recuperação de metadados sobre as colunas da cláusula SQL atual, como a quantidade de colunas, nome e tipos das mesmas. Um objeto ParameterMetaData é obtida através de um PreparedStatement, e permite que você possa recuperar metadados sobre os parâmetros usados em clausulas SQL. Com essas três classes é possível recuperar informações dinamicamente de uma base de dados. Alguns desenvolvedores utilizam constantemente essas três classes para criarem seu próprio framework de persistência de dados.

  • Anúncios
     
    Deixe um comentário

    Publicado por em 23/11/2009 em Estudos Java

     

    Deixe um comentário

    Preencha os seus dados abaixo ou clique em um ícone para log in:

    Logotipo do WordPress.com

    Você está comentando utilizando sua conta WordPress.com. Sair / Alterar )

    Imagem do Twitter

    Você está comentando utilizando sua conta Twitter. Sair / Alterar )

    Foto do Facebook

    Você está comentando utilizando sua conta Facebook. Sair / Alterar )

    Foto do Google+

    Você está comentando utilizando sua conta Google+. Sair / Alterar )

    Conectando a %s

     
    %d blogueiros gostam disto: