iBATIS - Depuração

É fácil depurar seu programa enquanto trabalha com o iBATIS. O iBATIS tem suporte de registro embutido e funciona com as seguintes bibliotecas de registro e as procura nesta ordem.

Jakarta Commons Logging (JCL).
Log4J
Registro JDK

Você pode usar qualquer uma das bibliotecas listadas acima junto com o iBATIS.

Depurando com Log4J

Supondo que você usará Log4J para registro. Antes de prosseguir, você precisa verificar os seguintes pontos -

O arquivo Log4J JAR (log4j- {versão} .jar) deve estar no CLASSPATH.
Você tem log4j.properties disponível no CLASSPATH.

A seguir está o arquivo log4j.properties. Observe que algumas das linhas estão comentadas. Você pode removê-los se precisar de informações adicionais de depuração.

# Global logging configuration
log4j.rootLogger = ERROR, stdout

log4j.logger.com.ibatis = DEBUG

# shows SQL of prepared statements
#log4j.logger.java.sql.Connection = DEBUG

# shows parameters inserted into prepared statements
#log4j.logger.java.sql.PreparedStatement = DEBUG

# shows query results
#log4j.logger.java.sql.ResultSet = DEBUG

#log4j.logger.java.sql.Statement = DEBUG

# Console output
log4j.appender.stdout = org.apache.log4j.ConsoleAppender
log4j.appender.stdout.layout = org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern = %5p [%t] − %m%n

Você pode encontrar a documentação completa do Log4J no site da Apaches - Log4J Documentation .

Exemplo de depuração iBATIS

A seguinte classe Java é um exemplo muito simples que inicializa e, em seguida, usa a biblioteca de registro Log4J para aplicativos Java. Usaríamos o arquivo de propriedades mencionado acima, que se encontra em CLASSPATH.

import org.apache.log4j.Logger;

import com.ibatis.common.resources.Resources;
import com.ibatis.sqlmap.client.SqlMapClient;
import com.ibatis.sqlmap.client.SqlMapClientBuilder;

import java.io.*;
import java.sql.SQLException;
import java.util.*;

public class IbatisUpdate{
   static Logger log = Logger.getLogger(IbatisUpdate.class.getName());

   public static void main(String[] args) throws IOException,SQLException{
   
      Reader rd = Resources.getResourceAsReader("SqlMapConfig.xml");
      SqlMapClient smc = SqlMapClientBuilder.buildSqlMapClient(rd);

      /* This would insert one record in Employee table. */
      log.info("Going to update record.....");
      Employee rec = new Employee();
      rec.setId(1);
      rec.setFirstName( "Roma");
      smc.update("Employee.update", rec );
      log.info("Record updated Successfully ");

      log.debug("Going to read records.....");
      List <Employee> ems = (List<Employee>) 
         smc.queryForList("Employee.getAll", null);
      Employee em = null;
		
      for (Employee e : ems) {
         System.out.print("  " + e.getId());
         System.out.print("  " + e.getFirstName());
         System.out.print("  " + e.getLastName());
         System.out.print("  " + e.getSalary());
         em = e;
         System.out.println("");
      }
      log.debug("Records Read Successfully ");
   }
}

Compilação e execução

Em primeiro lugar, certifique-se de definir PATH e CLASSPATH apropriadamente antes de prosseguir com a compilação e execução.

Crie Employee.xml conforme mostrado acima.
Crie Employee.java conforme mostrado acima e compile-o.
Crie IbatisUpdate.java conforme mostrado acima e compile-o.
Crie log4j.properties conforme mostrado acima.
Execute o binário IbatisUpdate para executar o programa.

Você obteria o seguinte resultado. Um registro seria atualizado na tabela EMPLOYEE e posteriormente, o mesmo registro seria lido na tabela EMPLOYEE.

DEBUG [main] - Created connection 28405330.
DEBUG [main] - Returned connection 28405330 to pool.
DEBUG [main] - Checked out connection 28405330 from pool.
DEBUG [main] - Returned connection 28405330 to pool.
   1  Roma  Ali  5000
   2  Zara  Ali  5000
   3  Zara  Ali  5000

Métodos de depuração

No exemplo acima, usamos apenas info() método, no entanto, você pode usar qualquer um dos seguintes métodos de acordo com seus requisitos -

public void trace(Object message);
public void debug(Object message);
public void info(Object message);
public void warn(Object message);
public void error(Object message);
public void fatal(Object message);