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

您可以從 Apache 網站找到 Log4J 的完整文件：Log4J 文件。

iBATIS 除錯示例

以下 Java 類是一個非常簡單的示例，它初始化然後使用 Log4J 日誌庫用於 Java 應用程式。我們將使用上面提到的位於 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);