iBATIS - 環境

在開始實際開發工作之前，你必須為 iBATIS 設定一個合適的環境。本章將說明如何為 iBATIS 設定一個工作環境。

iBATIS 安裝

在 Linux 機器上執行以下簡單步驟來安裝 iBATIS −

• 從 下載 iBATIS，下載最新版本的 iBATIS。

• 解壓下載的檔案，從 bundles 中提取 .jar 檔案並將其儲存在適當的 lib 目錄中。

• 相應地設定提取的 .jar 檔案的 PATH 和 CLASSPATH 變數。

$ unzip ibatis-2.3.4.726.zip
inflating: META-INF/MANIFEST.MF
   creating: doc/
   creating: lib/
	
   creating: simple_example/
   creating: simple_example/com/
   creating: simple_example/com/mydomain/
   creating: simple_example/com/mydomain/data/
   creating: simple_example/com/mydomain/domain/
	
   creating: src/
	
  inflating: doc/dev-javadoc.zip
  inflating: doc/user-javadoc.zip
  
  inflating: jar-dependencies.txt
  inflating: lib/ibatis-2.3.4.726.jar
  inflating: license.txt
  inflating: notice.txt
  inflating: release.txt
  
$pwd
/var/home/ibatis
$set PATH=$PATH:/var/home/ibatis/
$set CLASSPATH=$CLASSPATH:/var/home/ibatis\
      /lib/ibatis-2.3.4.726.jar

資料庫設定

使用以下語法在任意 MySQL 資料庫中建立一個 EMPLOYEE 表 −

mysql> CREATE TABLE EMPLOYEE (
   id INT NOT NULL auto_increment,
   first_name VARCHAR(20) default NULL,
   last_name  VARCHAR(20) default NULL,
   salary     INT  default NULL,
   PRIMARY KEY (id)
);

建立 SqlMapConfig.xml

考慮以下內容 −

• 我們將使用 JDBC 訪問資料庫 testdb。

• MySQL 的 JDBC 驅動程式是 “com.mysql.jdbc.Driver”。

• 連線 URL 是 “jdbc:mysql://:3306/testdb”。

• 我們使用使用者名稱和密碼“root”和“root”。

• 我們所有操作的 SQL 語句對映都將在 “Employee.xml” 中描述。

基於以上假設，我們必須建立一個名為 SqlMapConfig.xml 的 XML 配置檔案，其中包含以下內容。這是你為 iBatis 提供所有所需配置的地方 −

重要的是，SqlMapConfig.xml 檔案和 Employee.xml 檔案都應存在於類路徑中。現在，我們將保持 Employee.xml 檔案為空，我們將在後續章節中介紹其內容。

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE sqlMapConfig PUBLIC "-//ibatis.apache.org//DTD SQL Map Config 2.0//EN" "http://ibatis.apache.org/dtd/sql-map-config-2.dtd">

<sqlMapConfig>
   <settings useStatementNamespaces="true"/>
	
   <transactionManager type="JDBC">
      <dataSource type="SIMPLE">
		
         <property name="JDBC.Driver" value="com.mysql.jdbc.Driver"/>
         <property name="JDBC.ConnectionURL" value="jdbc:mysql://:3306/testdb"/>
         <property name="JDBC.Username" value="root"/>
         <property name="JDBC.Password" value="root"/>
			
      </dataSource>
   </transactionManager>
	
   <sqlMap resource="Employee.xml"/> 
</sqlMapConfig>

你還可以使用 SqlMapConfig.xml 檔案設定以下可選屬性 −

<property name="JDBC.AutoCommit" value="true"/>
<property name="Pool.MaximumActiveConnections" value="10"/>
<property name="Pool.MaximumIdleConnections" value="5"/>
<property name="Pool.MaximumCheckoutTime" value="150000"/> 
<property name="Pool.MaximumTimeToWait" value="500"/> 
<property name="Pool.PingQuery" value="select 1 from Employee"/> 
<property name="Pool.PingEnabled" value="false"/>