ArrayIndexOutOfBoundsException ao utilizar NamedParameterJdbcTemplate + MapSqlParameterSource

Fala galera, bora tirar o pó do blog rs…

me deparei com o erro abaixo, nada intuitivo, utilizando NamedParameterJdbcTemplate e MapSqlParameterSource, onde eu tenho na minha query parâmetros opcionais/nullable, ou seja, parâmetros que podem vir ou não com valor (null):

java.lang.ArrayIndexOutOfBoundsException: 128
	at oracle.jdbc.driver.OracleParameterMetaDataParser.computeBasicInfo(OracleParameterMetaDataParser.java:327)
	at oracle.jdbc.driver.OracleParameterMetaDataParser.getParameterMetaDataSql(OracleParameterMetaDataParser.java:433)
	at oracle.jdbc.driver.OracleParameterMetaData.getParameterMetaData(OracleParameterMetaData.java:58)
	at oracle.jdbc.driver.OraclePreparedStatement.getParameterMetaData(OraclePreparedStatement.java:12861)
	at oracle.jdbc.driver.OraclePreparedStatementWrapper.getParameterMetaData(OraclePreparedStatementWrapper.java:1551)
	at org.springframework.jdbc.core.StatementCreatorUtils.setNull(StatementCreatorUtils.java:248)
	at org.springframework.jdbc.core.StatementCreatorUtils.setParameterValueInternal(StatementCreatorUtils.java:229)
	at org.springframework.jdbc.core.StatementCreatorUtils.setParameterValue(StatementCreatorUtils.java:147)
	at org.springframework.jdbc.core.PreparedStatementCreatorFactory$PreparedStatementCreatorImpl.setValues(PreparedStatementCreatorFactory.java:278)
	at org.springframework.jdbc.core.PreparedStatementCreatorFactory$PreparedStatementCreatorImpl.createPreparedStatement(PreparedStatementCreatorFactory.java:236)
	at org.springframework.jdbc.core.JdbcTemplate.execute(JdbcTemplate.java:603)
	at org.springframework.jdbc.core.JdbcTemplate.query(JdbcTemplate.java:657)
	at org.springframework.jdbc.core.JdbcTemplate.query(JdbcTemplate.java:682)
	at org.springframework.jdbc.core.JdbcTemplate.query(JdbcTemplate.java:736)
	at org.springframework.jdbc.core.namedparam.NamedParameterJdbcTemplate.query(NamedParameterJdbcTemplate.java:212)
	...

após perder alguns minutos pesquisando, não achei nada para resolver, então criei uma solução/tratamento simples:

public <T> void setOptionalParameter(MapSqlParameterSource parameters, String name, T value) {
   if (valor == null)
      parameters.addValue(name, value, Types.NULL);
   else
      parameters.addValue(name, value);
}

Forma de utilização:

MapSqlParameterSource parameters = new MapSqlParameterSource();
new MapSqlParameterSourceUtil().setOptionalParameter(parameters, "optionalParam", optionalParam);
parameters.addValue("mandatoryParam", mandatoryParam);
jdbcTemplate.query(...);

Espero ter ajudado, see ya! 😀

Analisando Metadados com JDBC

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;
  3. import java.sql.*;
  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());
  10.         // String de conexao para uma base Oracle
  11.         Connection conn = DriverManager.getConnection(“jdbc:oracle:thin:@127.0.0.1:1521:orcl”,”scott”,”tiger”);
  13.         // recuperar a classe  DatabaseMetadaData a partir da conexao criada
  14.         DatabaseMetaData dbmd = conn.getMetaData();
  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());
  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.     }
  27. }
  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 “);
  6. ResultSetMetaData rsmd = rset.getMetaData();
  8. // retorna o numero total de colunas
  9. int numColumns = rsmd.getColumnCount();
  10. System.out.println(“Total de Colunas = ” + numColumns);
  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));
  19. }

  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);
  5. ResultSetMetaData rsmd = ps.getMetaData();
  7. // retorna o numero total de colunas
  8. int numColumns = rsmd.getColumnCount();
  9. 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();
  4. // recupera o total de parametros
  5. int totalParam = pmd.getParameterCount();
  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);
  11. }
  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.

Fonte: GUJ – Adriano Marcandali