iBATIS - Depuración

Es fácil depurar su programa mientras trabaja con iBATIS. iBATIS tiene soporte de registro incorporado y funciona con las siguientes bibliotecas de registro y las busca en este orden.

  • Jakarta Commons Logging (JCL).
  • Log4J
  • Registro JDK

Puede utilizar cualquiera de las bibliotecas enumeradas anteriormente junto con iBATIS.

Depurar con Log4J

Suponiendo que va a utilizar Log4J para iniciar sesión. Antes de continuar, debe verificar los siguientes puntos:

  • El archivo JAR de Log4J (log4j- {versión} .jar) debe estar en CLASSPATH.
  • Tiene log4j.properties disponible en CLASSPATH.

A continuación se muestra el archivo log4j.properties. Tenga en cuenta que algunas de las líneas están comentadas. Puede descomentarlos si necesita información adicional de depuración.

# 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

Puede encontrar la documentación completa de Log4J en el sitio de Apaches - Documentación de Log4J .

Ejemplo de depuración de iBATIS

La siguiente clase Java es un ejemplo muy simple que se inicializa y luego usa la biblioteca de registro Log4J para aplicaciones Java. Utilizaríamos el archivo de propiedades mencionado anteriormente que se encuentra en 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 ");
   }
}

Compilación y ejecución

En primer lugar, asegúrese de haber configurado PATH y CLASSPATH correctamente antes de proceder con la compilación y ejecución.

  • Cree Employee.xml como se muestra arriba.
  • Cree Employee.java como se muestra arriba y compílelo.
  • Cree IbatisUpdate.java como se muestra arriba y compílelo.
  • Cree log4j.properties como se muestra arriba.
  • Ejecute IbatisUpdate binary para ejecutar el programa.

Obtendría el siguiente resultado. Se actualizaría un registro en la tabla EMPLOYEE y posteriormente, se leería el mismo registro de la tabla 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 depuración

En el ejemplo anterior, usamos solo info() método, sin embargo, puede utilizar cualquiera de los siguientes métodos según sus 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);