iBATIS-デバッグ

iBATISを使用しながら、プログラムをデバッグするのは簡単です。iBATISにはロギングサポートが組み込まれており、以下のロギングライブラリと連携してこの順序で検索します。

  • Jakarta Commons Logging(JCL)。
  • Log4J
  • JDKロギング

上記のライブラリのいずれかをiBATISと一緒に使用できます。

Log4Jを使用したデバッグ

Log4Jをログに使用することを想定しています。先に進む前に、次の点をクロスチェックする必要があります-

  • Log4J JARファイル(log4j- {version} .jar)はCLASSPATHにある必要があります。
  • CLASSPATHで利用可能なlog4j.propertiesがあります。

以下はlog4j.propertiesファイルです。一部の行はコメントアウトされていることに注意してください。追加のデバッグ情報が必要な場合は、コメントを解除できます。

# 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

Log4Jの完全なドキュメントは、Apacheサイト-Log4Jドキュメントから見つけることができます。

iBATISデバッグの例

次のJavaクラスは、Javaアプリケーション用にLog4Jロギングライブラリを初期化して使用する非常に単純な例です。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 ");
   }
}

コンパイルと実行

まず、コンパイルと実行に進む前に、PATHとCLASSPATHが適切に設定されていることを確認してください。

  • 上記のようにEmployee.xmlを作成します。
  • 上記のようにEmployee.javaを作成し、コンパイルします。
  • 上記のようにIbatisUpdate.javaを作成し、コンパイルします。
  • 上記のようにlog4j.propertiesを作成します。
  • IbatisUpdateバイナリを実行してプログラムを実行します。

次の結果が得られます。レコードはEMPLOYEEテーブルで更新され、後で同じレコードが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

デバッグ方法

上記の例では、 info() 方法、ただし、要件に応じて次の方法のいずれかを使用できます-

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);