Java必会技能之iBATIS

一、iBATIS介绍

iBATIS的是一个持久层框架，它能够自动在Java, .NET, 和Ruby on Rails中与SQL数据库和对象之间的映射。映射是从应用程序逻辑封装在XML配置文件中的SQL语句脱钩。

iBATIS是一个轻量级的框架和持久性API适合持久化的POJO（普通Java对象）。

iBATIS是被称为一个数据映射和映射需要的类的属性和数据库中的表的列之间的参数和结果。

iBATIS和其他持久化框架，如Hibernate之间的显著区别在于，iBATIS强调使用SQL，而其他的框架通常使用一个自定义的查询语言，具有Hibernate查询语言（HQL）或Enterprise JavaBeans的查询语言（EJB QL）。

iBATIS的设计理念：

iBatis提供了以下的设计理念：

简单: iBATIS的被广泛认为是可用的最简单的持久化框架之一。

快速开发：iBATIS的理念是尽一切可能，以方便超快速开发。

可移植性: iBATIS可用于几乎任何语言或平台，如Java，Ruby和C＃，微软.NET实现。

独立的接口：iBATIS提供独立于数据库的接口和API，帮助应用程序的其余部分保持独立的任何持久性相关的资源，

开源：iBATIS是自由和开放源码软件。

IBATIS的优点

下面是使用iBATIS的一些优势：

支持存储过程：iBATIS的SQL封装以存储过程的形式，使业务逻辑保持在数据库之外，应用程序更易于部署和测试，更便于移植。

支持内嵌的SQL：预编译器不是必需的，并有完全访问所有的SQL语句的特性。

支持动态SQL: iBATIS特性提供基于参数动态生成SQL查询。

支持O / RM：iBATIS支持许多相同的功能作为一个O / RM工具，如延迟加载，连接抓取，缓存，运行时代码生成和继承

先决条件：

在开始之前，要确保你了解过程和面向对象编程的基本知识：控制结构，数据结构和变量，类，对象等。

iBATIS使用Java编程语言开发面向数据库应用程序。

二、iBATIS配置环境

iBATIS 安装:

这里有几个简单的步骤，需要开展Linux机器上安装iBATIS：

下载iBATIS的最新版本下载iBATIS.

解压下载的文件，从包中提取.jar文件并将其保存在相应的lib目录下。

在提取 .jar文件适当设置PATH和CLASSPATH变量。

下面是进行Linux机器下载iBATIS的二进制文件的步骤：

$ 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://localhost:3306/testdb".

使用的用户名和密码是 "root" and "root".

SQL语句映射的所有操作将被描述在"Employee.xml".

基于上述假设，我们必须创建一个XML配置文件，nameSqlMapConfig.xml以下内容。这就是需要提供所需的iBatis的所有配置：

这两个文件SqlMapConfig.xml和Employee.xml 存在于类路径。

现在，我们将保持Employee.xml文件为空，我们将格式转换的在随后的章节内容。




 useStatementNamespaces="true"/>  

 resource="Employee.xml"/>

还有其他一些可选的属性，您可以在SqlMapConfig.xml文件中设置：

三、iBATIS创建操作

若要使用iBATIS执行的任何CRUD（创建，写入，更新和删除）操作，需要创建一个的POJO（普通Java对象）类对应的表。本课程介绍的对象，将“模式”的数据库表中的行。

POJO类必须实现所有执行所需的操作所需的方法。

我们已经在MySQL下有EMPLOYEE表：

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

Employee POJO 类：

我们会在Employee.java文件中创建Employee类，如下所示：

public class Employee { 

private

 int id;private String first_name;private String last_name;private int salary;/* Define constructors for the Employee class. */public Employee() {

}


public

 Employee(String fname, String lname, int salary) {this.first_name = fname;this.last_name = lname;this.salary = salary;}} /* End of Employee */

可以定义方法来设置表中的各个字段。

Employee.xml 文件:

要定义使用iBATIS SQL映射语句中，我们将使用标签，这个标签定义中，我们会定义将用于在IbatisInsert.java文件的数据库执行SQL INSERT查询“id”。


insert into EMPLOYEE(first_name, last_name, salary) values (#first_name#, #last_name#, #salary#)

select last_insert_id() as id  


这里parameterClass：可以采取一个值作为字符串，整型，浮点型，double或根据要求任何类的对象。在这个例子中，我们将通过Employee对象作为参数而调用SqlMap类的insert方法。

如果您的数据库表使用IDENTITY，AUTO_INCREMENT或串行列或已定义的SEQUENCE/GENERATOR，可以使用元素在的语句中使用或返回数据库生成的值。

IbatisInsert.java 文件:

文件将应用程序级别的逻辑在Employee表中插入记录：

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 IbatisInsert{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. */


System

.out.println("Going to insert record.....");Employee em = new Employee("Zara", "Ali", 5000);

smc

.insert("Employee.insert", em); System.out.println("Record Inserted Successfully ");}} 

编译和运行：

下面是步骤来编译并运行上述软件。请确保已在进行的编译和执行之前，适当地设置PATH和CLASSPATH。

创建Employee.xml如上所示。

创建Employee.java如上图所示，并编译它。

创建IbatisInsert.java如上图所示，并编译它。

执行IbatisInsert二进制文件来运行程序。

会得到下面的结果，并创纪录的将在EMPLOYEE表中创建。

$java IbatisInsert Going to insert record..... Record Inserted Successfully

去查看EMPLOYEE表，它应该有如下结果：

mysql> select * from EMPLOYEE;+----+------------+-----------+--------+| id | first_name | last_name | salary |+----+------------+-----------+--------+| 1 | Zara | Ali | 5000 |+----+------------+-----------+--------+

1 row in set (0.00 sec)

四、iBATIS读取操作

我们已经在MySQL下有EMPLOYEE表：

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)

);

此表有如下只有一条记录：

mysql> select * from EMPLOYEE;+----+------------+-----------+--------+| id | first_name | last_name | salary |+----+------------+-----------+--------+

| 1 | Zara | Ali | 5000 |

+----+------------+-----------+--------+1 row in set (0.00 sec)

Employee POJO 类:

要执行读操作，我们将修改Employee类中Employee.java文件，如下所示：

public class Employee {

private int id;

private Stringfirst_name;

private Stringlast_name;

private int salary;

/* Define constructors for the Employee class. */

  public Employee() {}

public Employee(String fname, String lname,int salary) {

this.first_name = fname;

this.last_name = lname;

this.salary = salary;

}

/* Here are the method definitions */

 public int getId() {

return id;

}

public String getFirstName() {

return first_name;

}

public String getLastName() {

return last_name;

}

public int getSalary() {

return salary;

}

}/* End of Employee */

Employee.xml 文件:

要定义使用iBATIS SQL映射语句，我们将增加标记在Employee.xml文件，这个标签定义中，我们会定义将用于在IbatisRead.java文件的数据库执行SQL SELECT查询的“id”。


PUBLIC "-//ibatis.apache.org//DTD SQL Map 2.0//EN"

"http://ibatis.apache.org/dtd/sql-map-2.dtd">

INSERT INTO EMPLOYEE(first_name, last_name, salary)

values (#first_name#, #last_name#, #salary#)

select last_insert_id() as id

SELECT * FROM EMPLOYEE

在这里，我们没有使用WHERE子句和SQL SELECT语句。后续章节将演示如何用WHERE和SELECT语句子句，以及如何将值传递到WHERE子句。

IbatisRead.java 文件:

该文件将应用程序级别的逻辑从雇员Employee表中读出记录：

public class IbatisRead{

public static void main(String[] args)

throws IOException,SQLException{

Reader rd = Resources.getResourceAsReader("SqlMapConfig.xml");

SqlMapClient smc = SqlMapClientBuilder.buildSqlMapClient(rd);

/* This would read all records from the Employee table. */

  System.out.println("Going to read records.....");

List ems = (List)

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

}

System.out.println("Records Read Successfully ");

}

}

编译和运行：

下面是步骤来编译并运行上述应用。请确保您已在进行的编译和执行之前，适当地设置PATH和CLASSPATH。

创建Employee.xml如上所示。

创建Employee.java如上图所示，并编译它。

创建IbatisRead.java如上图所示，并编译它。

执行IbatisRead二进制文件来运行程序。

你会得到下面的结果，并且将记录从EMPLOYEE表中读取。

Going to read records..... 1 Zara Ali 5000 Record Reads Successfully

五、iBATIS更新操作

我们已经在MySQL下有EMPLOYEE表：

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)

);

此表有如下只有一条记录：

mysql> select * from EMPLOYEE;+----+------------+-----------+--------+| id | first_name | last_name | salary |+----+------------+-----------+--------+

| 1 | Zara | Ali | 5000 |

+----+------------+-----------+--------+1 row in set (0.00 sec)

Employee POJO 类:

要执行读操作，我们将修改Employee类中Employee.java文件，如下所示：

public class Employee {

private int id;

private Stringfirst_name;

private Stringlast_name;

private int salary;

/* Define constructors for the Employee class. */

  public Employee() {}

public Employee(String fname, String lname,int salary) {

this.first_name = fname;

this.last_name = lname;

this.salary = salary;

}

/* Here are the method definitions */

 public int getId() {

return id;

}

public String getFirstName() {

return first_name;

}

public String getLastName() {

return last_name;

}

public int getSalary() {

return salary;

}

}/* End of Employee */

Employee.xml 文件:

要定义使用iBATIS SQL映射语句，我们想补充的标签Employee.xml文件，这个标签定义中，我们会定义将用于在IbatisUpdate.java文件的数据库执行SQL UPDATE查询的“id”。


PUBLIC "-//ibatis.apache.org//DTD SQL Map 2.0//EN"

"http://ibatis.apache.org/dtd/sql-map-2.dtd">

INSERT INTO EMPLOYEE(first_name, last_name, salary)

values (#first_name#, #last_name#, #salary#)

select last_insert_id() as id

SELECT * FROM EMPLOYEE

UPDATE EMPLOYEE

SET    first_name = #first_name#

WHERE  id = #id#

IbatisUpdate.java 文件:

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{

public static void main(String[] args)

throws IOException,SQLException{

Reader rd = Resources.getResourceAsReader("SqlMapConfig.xml");

SqlMapClient smc = SqlMapClientBuilder.buildSqlMapClient(rd);

/* This would update one record in Employee table. */

System.out.println("Going to update record.....");

Employee rec = new Employee();

rec.setId(1);

rec.setFirstName( "Roma");

smc.update("Employee.update", rec );

System.out.println("Record updated Successfully ");

System.out.println("Going to read records.....");

List ems = (List)

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

}

System.out.println("Records Read Successfully ");

}

}

编译和运行：

下面是步骤来编译并运行上述软件。请确保您已在进行的编译和执行之前，适当地设置PATH和CLASSPATH。

创建Employee.xml如上所示。

创建Employee.java如上图所示，并编译它。

创建IbatisUpdate.java如上图所示，并编译它。

执行IbatisUpdate二进制文件来运行程序。

得到下面的结果，并创建纪录在EMPLOYEE表进行更新和更高版本相同的记录将从EMPLOYEE表中读出。

Going to update record..... Record updated Successfully Going to read records..... 1 Roma Ali 5000 Records Read Successfully

六、iBATIS删除操作

我们已经在MySQL下有EMPLOYEE表：

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)

);

此表有如下只有一条记录：

mysql> select * from EMPLOYEE;+----+------------+-----------+--------+| id | first_name | last_name | salary |+----+------------+-----------+--------+

| 1 | Zara  | Ali  | 5000 |

 | 2 | Roma  | Ali  | 3000 | 

+----+------------+-----------+--------+

1 row in set (0.00 sec)

Employee POJO 类:

要执行读操作，我们将修改Employee类中Employee.java文件，如下所示：

public class Employee {

private int id;

private Stringfirst_name;

private Stringlast_name;

private int salary;

/* Define constructors for the Employee class. */

  public Employee() {}

public Employee(String fname, String lname,int salary) {

this.first_name = fname;

this.last_name = lname;

this.salary = salary;

}

/* Here are the method definitions */

 public int getId() {

return id;

}

public String getFirstName() {

return first_name;

}

public String getLastName() {

return last_name;

}

public int getSalary() {

return salary;

}

}/* End of Employee */

Employee.xml 文件:

要定义使用iBATIS SQL映射语句中，我们将增加键标签Employee.xml文件，这个标签定义中，我们会定义将用于在IbatisDelete.java文件执行SQL DELETE查询数据库的“id”。


PUBLIC "-//ibatis.apache.org//DTD SQL Map 2.0//EN"

"http://ibatis.apache.org/dtd/sql-map-2.dtd">

INSERT INTO EMPLOYEE(first_name, last_name, salary)

values (#first_name#, #last_name#, #salary#)

select last_insert_id() as id

SELECT * FROM EMPLOYEE

UPDATE EMPLOYEE

SET    first_name = #first_name#

WHERE  id = #id#

DELETE FROM EMPLOYEE

WHERE  id = #id#

IbatisDelete.java 文件:

文件将应用程序级别的逻辑从Employee表中删除记录：

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 IbatisDelete{

public static void main(String[] args)

throws IOException,SQLException{

Reader rd = Resources.getResourceAsReader("SqlMapConfig.xml");

SqlMapClient smc = SqlMapClientBuilder.buildSqlMapClient(rd);

/* This would delete one record in Employee table. */

System.out.println("Going to delete record.....");

int id = 1;

smc.delete("Employee.delete", id );

System.out.println("Record deleted Successfully ");

System.out.println("Going to read records.....");

List ems = (List)

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

}

System.out.println("Records Read Successfully ");

}

}

编译和运行：

下面是步骤来编译并运行上述软件。请确保已在进行的编译和执行之前，适当地设置PATH和CLASSPATH。

创建Employee.xml如上所示。

创建Employee.java如上图所示，并编译它。

创建IbatisDelete.java如上图所示，并编译它。

执行IbatisDelete二进制文件来运行程序。

得到以下结果，ID=1将在EMPLOYEE表中被删除，并读取EMPLOYEE表中的一条记录。

Going to delete record..... Record deleted Successfully Going to read records..... 2 Roma Ali 3000 Records Read Successfully

七、iBATIS结果映射

resultMap的元素是在iBATIS的最重要和最强大的元素。您可以通过使用iBATIS的结果映射减少高达90％的JDBC编码，在某些情况下，可以让你做JDBC不支持的事情。

ResultMaps的设计是这样的简单语句不需要明确的结果映射，以及更复杂的报表要求不超过绝对必要说明的关系。

本章将只给你一个简单的介绍iBATIS的结果映射。

我们已经在MySQL下有EMPLOYEE表：

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)

);

此表有如下只有一条记录：

mysql> select * from EMPLOYEE;+----+------------+-----------+--------+| id | first_name | last_name | salary |+----+------------+-----------+--------+

| 1 | Zara  | Ali  | 5000 |

 | 2 | Roma  | Ali  | 3000 | 

+----+------------+-----------+--------+

1 row in set (0.00 sec)

Employee POJO 类:

要执行读操作，我们将修改Employee类中Employee.java文件，如下所示：

public class Employee {

private int id;

private Stringfirst_name;

private Stringlast_name;

private int salary;

/* Define constructors for the Employee class. */

  public Employee() {}

public Employee(String fname, String lname,int salary) {

this.first_name = fname;

this.last_name = lname;

this.salary = salary;

}

/* Here are the method definitions */

 public int getId() {

return id;

}

public String getFirstName() {

return first_name;

}

public String getLastName() {

return last_name;

}

public int getSalary() {

return salary;

}

}/* End of Employee */

Employee.xml 文件:

在这里，我们将修改Employee.xml文件介绍标记。这个标签就必须在我们标记的resultMap属性运行此结果映射这是需要一个id。


PUBLIC "-//ibatis.apache.org//DTD SQL Map 2.0//EN"

"http://ibatis.apache.org/dtd/sql-map-2.dtd">


INSERT INTO EMPLOYEE(first_name, last_name, salary)

values (#first_name#, #last_name#, #salary#)

select last_insert_id() as id


SELECT * FROM EMPLOYEE


UPDATE EMPLOYEE

SET    first_name = #first_name#

WHERE  id = #id#


DELETE FROM EMPLOYEE

WHERE  id = #id#



SELECT * FROM EMPLOYEE

WHERE id=#id#

IbatisResultMap.java 文件:

文件将应用程序级别的逻辑，从使用结果映射Employee表中读取记录：

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 IbatisResultMap{

public static void main(String[] args)

throws IOException,SQLException{

Reader rd = Resources.getResourceAsReader("SqlMapConfig.xml");

SqlMapClient smc = SqlMapClientBuilder.buildSqlMapClient(rd);

int id = 1;

System.out.println("Going to read record.....");

Employee e = (Employee)smc.queryForObject

("Employee.useResultMap", id);

System.out.println("ID:  " + e.getId());

System.out.println("First Name:  " + e.getFirstName());

System.out.println("Last Name:  " + e.getLastName());

System.out.println("Salary:  " + e.getSalary());

System.out.println("Record read Successfully ");

}

}

编译和运行：

下面是步骤来编译并运行上述软件。请确保您已在进行的编译和执行之前，适当地设置PATH和CLASSPATH。

创建Employee.xml如上所示。

创建Employee.java如上图所示，并编译它。

创建IbatisResultMap.java如上图所示，并编译它。

执行IbatisResultMap二进制文件来运行程序。

会得到下面的结果是对EMPLOYEE表的读操作。

Going to read record..... ID: 1 First Name: Zara Last Name: Ali Salary: 5000 Record read Successfully

八、iBATIS存储过程

使用iBATIS配置来调用存储过程。为了理解这一章，首先需要了解我们是如何在MySQL中创建一个存储过程。

我们已经在MySQL下有EMPLOYEE表：

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)

);

让我们在MySQL数据库中创建以下存储过程。

DELIMITER $$


DROP PROCEDURE IF EXISTS `testdb`.`getEmp` $$

CREATE PROCEDURE `testdb`.`getEmp`

   (IN empid INT)

BEGIN

   SELECT * FROM EMPLOYEE

   WHERE ID = empid;

END $$


DELIMITER;

考虑EMPLOYEE表是有两条记录如下：

mysql> select * from EMPLOYEE;

+----+------------+-----------+--------+

| id | first_name | last_name | salary |

+----+------------+-----------+--------+

|  1 | Zara       | Ali       |   5000 |

|  2 | Roma       | Ali       |   3000 |

+----+------------+-----------+--------+

2 row in set (0.00 sec)

Employee POJO 类:

使用存储过程，你就需要修改Employee.java文件。

public class Employee {

private int id;

private String first_name; 

private String last_name;

private int salary;

/* Define constructors for the Employee class. */

public Employee() {}


public Employee(String fname, String lname, int salary) {

this.first_name = fname;

this.last_name = lname;

this.salary = salary;

}

/* Here are the required method definitions */

public int getId() {

return id;

}

public void setId(int id) {

 this.id = id;

}

public String getFirstName() {

return first_name;

}

public void setFirstName(String fname) {

this.first_name = fname;

}

public String getLastName() {

return last_name;

}

public void setlastName(String lname) {

this.last_name = lname;

}

public int getSalary() {

return salary;

}

public void setSalary(int salary) {

this.salary = salary;

}

} /* End of Employee */

Employee.xml 类:

在这里，我们将修改Employee.xml文件介绍和标记。这里标签将有一个id，我们会用我们的应用程序来调用存储过程。


PUBLIC "-//ibatis.apache.org//DTD SQL Map 2.0//EN"

"http://ibatis.apache.org/dtd/sql-map-2.dtd">


INSERT INTO EMPLOYEE(first_name, last_name, salary)

values (#first_name#, #last_name#, #salary#)

select last_insert_id() as id


SELECT * FROM EMPLOYEE


UPDATE EMPLOYEE

SET    first_name = #first_name#

WHERE  id = #id#


DELETE FROM EMPLOYEE

WHERE  id = #id#


parameterMap="getEmpInfoCall">

{ call getEmp( #acctID# ) } 

javaType="java.lang.Integer" mode="IN"/>

IbatisSP.java 文件:

文件将应用程序级别的逻辑读取使用结果映射Employee表员工的姓名name：

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 IbatisSP{

public static void main(String[] args)

throws IOException,SQLException{

Reader rd = Resources.getResourceAsReader("SqlMapConfig.xml");

SqlMapClient smc = SqlMapClientBuilder.buildSqlMapClient(rd);

int id = 1;

System.out.println("Going to read employee name.....");

Employee e = (Employee)smc.queryForObject

("Employee.getEmpInfo", id);

System.out.println("First Name:  " + e.getFirstName());

System.out.println("Record name Successfully ");

}

}

编译和运行：

下面是步骤来编译并运行上述应用程序。请确保您在进行的编译和执行之前，适当地设置PATH和CLASSPATH。

创建Employee.xml如上所示。

创建Employee.java如上图所示，并编译它。

创建IbatisSP.java如上图所示，并编译它。

执行IbatisSP二进制文件来运行程序。

得到以下结果：

Going to read record..... ID: 1 First Name: Zara Last Name: Ali Salary: 5000 Record read Successfully

九、iBATIS动态SQL

使用动态查询是iBatis一个非常强大的功能。有时你已经改变WHERE子句条件的基础上你的参数对象的状态。在这种情况下的iBATIS提供了一组可以映射语句中使用，以提高SQL语句的重用性和灵活性的动态SQL标签。

所有的逻辑是使用一些额外的标签放在：XML文件。下面是一个例子，其中的SELECT语句将努力在两个方面：

如果想传递一个ID，然后它会返回所有与该ID的记录，

否则，将返回所有雇员ID为NULL的记录。


PUBLIC "-//ibatis.apache.org//DTD SQL Map 2.0//EN"

"http://ibatis.apache.org/dtd/sql-map-2.dtd">

SELECT * FROM EMPLOYEE

id IS NULL

id = #id#

可以使用标签如下检查条件。在此条件下将增加，只有当通过属性不为空。

   SELECT * FROM EMPLOYEE

  

     

           id = #id#



如果想查询对id和/或雇员的名字选取。SELECT语句如下：

   SELECT * FROM EMPLOYEE

  

     

           id = #id#


     

           first_name = #first_name#



例如：动态SQL

下面的例子将展示如何编写SELECT语句中使用动态SQL。考虑，我们已经在MySQL下有EMPLOYEE表：

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)

);

此表有如下只有一条记录

mysql> select * from EMPLOYEE;

+----+------------+-----------+--------+

| id | first_name | last_name | salary |

+----+------------+-----------+--------+

|  1 | Zara       | Ali       |   5000 |

|  2 | Roma       | Ali       |   3000 |

|  3 | Noha       | Ali       |   7000 |

+----+------------+-----------+--------+

3 row in set (0.00 sec)

Employee POJO 类:

要执行读取操作，让我们在Employee.java文件Employee类，如下所示：

public class Employee {

  private int id;

  private String first_name;

  private String last_name;   

  private int salary;  


  /* Define constructors for the Employee class. */

  public Employee() {}


  public Employee(String fname, String lname, int salary) {

    this.first_name = fname;

    this.last_name = lname;

    this.salary = salary;

  }


  /* Here are the method definitions */

  public int getId() {

    return id;

  }

  public String getFirstName() {

    return first_name;

  }

  public String getLastName() {

    return last_name;

  }

  public int getSalary() {

    return salary;

  }

} /* End of Employee */

Employee.xml 文件:

要定义使用iBATIS SQL映射语句，我们将增加在以下文件Employee.xml修改标记和这个标签定义，我们将定义一个“id”，这将被用于IbatisReadDy.java文件上执行动态SQL的SELECT查询数据库。


PUBLIC "-//ibatis.apache.org//DTD SQL Map 2.0//EN"

"http://ibatis.apache.org/dtd/sql-map-2.dtd">

SELECT * FROM EMPLOYEE

id = #id#

上面的SELECT语句将努力在两个方面（一）如果想传递一个ID，然后将相应的编号（二）返回的记录，否则将返回所有记录。

IbatisReadDy.java 文件:

文件将应用程序级别的逻辑从Employee表读出的条件记录：

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 IbatisReadDy{

public static void main(String[] args)

throws IOException,SQLException{

Reader rd=Resources.getResourceAsReader("SqlMapConfig.xml");

SqlMapClient smc=SqlMapClientBuilder.buildSqlMapClient(rd);

/* This would read all records from the Employee table.*/

System.out.println("Going to read records.....");

Employee rec = new Employee();

rec.setId(1);

List ems = (List)

smc.queryForList("Employee.findByID", rec);

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

}

System.out.println("Records Read Successfully ");

}

}

编译和运行：

下面是步骤来编译并运行上述应用。请确保已在进行的编译和执行之前，适当地设置PATH和CLASSPATH。

创建Employee.xml如上所示。

创建Employee.java如上图所示，并编译它。

创建IbatisReadDy.java如上图所示，并编译它。

执行IbatisReadDy二进制文件来运行程序。

会得到下面的结果，并且将记录从EMPLOYEE表中读取。

Going to read records..... 1 Zara Ali 5000 Record Reads Successfully

试试上面的例子中通过传递空值作为smc.queryForList（“Employee.findByID”，NULL）。

iBATIS OGNL 表达式

iBATIS的提供了强大的基于OGNL的表达式来消除其他元素。

if 语句

choose, when, otherwise 语句

where 语句

foreach 语句

if语句：

最常见的事情在动态SQL是有条件地包括一个where子句的一部分。例如：

           parameterType="Blog" resultType="Blog">

   SELECT * FROM BLOG

   WHERE state = 'ACTIVE.

  

      AND title like #{title}


这条语句会提供功能的可选的文本搜索类型。如果没有传递title，那么所有激活的博客将被退回。但是，如果传递一个标题，它会寻找标题以like 给定的条件。 

可以包括多个if条件如下：

最常见的事情在动态SQL是有条件地包括一个where子句的一部分。例如：

           parameterType="Blog" resultType="Blog">

   SELECT * FROM BLOG

   WHERE state = 'ACTIVE.

  

      AND title like #{title}


  

      AND author like #{author}


choose, when, otherwise 语句:

iBATIS提供了一个选择的元素，它类似于Java的switch语句。这有助于选择很多种情况。

下面的例子将只搜索标题上如果提供，那么只有由作者如果已提供。如果没有提供，让我们只返回精选的博客：

parameterType="Blog" resultType="Blog">

SELECT * FROM BLOG

WHERE state = 'ACTIVE.

AND title like #{title}

author.name != null">

AND author like #{author}

AND featured = 1

where 语句:

如果我们看一下前面的例子中，如果没有一个条件满足会发生什么事？最终SQL看起来像这样：

SELECT * FROM BLOG WHERE

这会失败，但iBATIS有一个简单的改变一个简单的解决方案，让一切工作正常：

           parameterType="Blog" resultType="Blog">

   SELECT * FROM BLOG

  

     

         state = #{state}


     

         AND title like #{title}



         AND author like #{author}



where元素知道只有插入WHERE ，如果有一个由含标签返回的任何内容。此外，如果该内容开头AND或OR，它知道剥离其关闭。

foreach语句：

foreach元素是非常强大的，并允许你指定一个集合，声明可以在元素的体内可用于项目和索引变量。

它也允许你指定打开和关闭的字符串，并添加一个分隔符放置在迭代之间。可以建立一个IN条件如下：

   SELECT *

   FROM POST P

   WHERE ID in


      open="(" separator="," close=")">

         #{item}


十、iBATIS调试

这是很容易，同时与iBATIS的工作程序进行调试。 iBATIS有内置的日志支持，并适用于下列日志库，并在这个顺序搜索他们。

Jakarta Commons日志记录（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文档，从Apaches 网站：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 ems = (List)

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

©著作权归作者所有,转载或内容合作请联系作者
  • 人面猴
    序言：七十年代末，一起剥皮案震惊了整个滨河市，随后出现的几起案子，更是在滨河造成了极大的恐慌，老刑警刘岩，带你破解...
    沈念sama阅读 206,013评论 6赞 481
  • 死咒
    序言：滨河连续发生了三起死亡事件，死亡现场离奇诡异，居然都是意外死亡，警方通过查阅死者的电脑和手机，发现死者居然都...
    沈念sama阅读 88,205评论 2赞 382
  • 救了他两次的神仙让他今天三更去死
    文/潘晓璐 我一进店门，熙熙楼的掌柜王于贵愁眉苦脸地迎上来，“玉大人，你说我怎么就摊上这事。” “怎么了？”我有些...
    开封第一讲书人阅读 152,370评论 0赞 342
  • 道士缉凶录：失踪的卖姜人
    文/不坏的土叔 我叫张陵，是天一观的道长。 经常有香客问我，道长，这世上最难降的妖魔是什么？ 我笑而不...
    开封第一讲书人阅读 55,168评论 1赞 278
  • 港岛之恋（遗憾婚礼）
    正文 为了忘掉前任，我火速办了婚礼，结果婚礼上，老公的妹妹穿的比我还像新娘。我一直安慰自己，他们只是感情好，可当我...
    茶点故事阅读 64,153评论 5赞 371
  • 恶毒庶女顶嫁案：这布局不是一般人想出来的
    文/花漫 我一把揭开白布。 她就那样静静地躺着，像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上，一...
    开封第一讲书人阅读 48,954评论 1赞 283
  • 城市分裂传说
    那天，我揣着相机与录音，去河边找鬼。 笑死，一个胖子当着我的面吹牛，可吹牛的内容都是我干的。 我是一名探鬼主播，决...
    沈念sama阅读 38,271评论 3赞 399
  • 双鸳鸯连环套：你想象不到人心有多黑
    文/苍兰香墨 我猛地睁开眼，长吁一口气：“原来是场噩梦啊……” “哼！你这毒妇竟也来了？” 一声冷哼从身侧响起，我...
    开封第一讲书人阅读 36,916评论 0赞 259
  • 万荣杀人案实录
    序言：老挝万荣一对情侣失踪，失踪者是张志新（化名）和其女友刘颖，没想到半个月后，有当地人在树林里发现了一具尸体，经...
    沈念sama阅读 43,382评论 1赞 300
  • 护林员之死
    正文 独居荒郊野岭守林人离奇死亡，尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,877评论 2赞 323
  • 白月光启示录
    正文 我和宋清朗相恋三年，在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,989评论 1赞 333
  • 活死人
    序言：一个原本活蹦乱跳的男人离奇死亡，死状恐怖，灵堂内的尸体忽然破棺而出，到底是诈尸还是另有隐情，我是刑警宁泽，带...
    沈念sama阅读 33,624评论 4赞 322
  • 日本核电站爆炸内幕
    正文 年R本政府宣布，位于F岛的核电站，受9级特大地震影响，放射性物质发生泄漏。R本人自食恶果不足惜，却给世界环境...
    茶点故事阅读 39,209评论 3赞 307
  • 男人毒药：我在死后第九天来索命
    文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹，春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,199评论 0赞 19
  • 一桩弑父案，背后竟有这般阴谋
    文/苍兰香墨 我抬头看了看天上的太阳。三九已至，却和暖如春，着一层夹袄步出监牢的瞬间，已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,418评论 1赞 260
  • 情欲美人皮
    我被黑心中介骗来泰国打工， 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留，地道东北人。 一个月前我还...
    沈念sama阅读 45,401评论 2赞 352
  • 代替公主和亲
    正文 我出身青楼，却偏偏与公主长得像，于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子，可洞房花烛夜当晚...
    茶点故事阅读 42,700评论 2赞 345

推荐阅读更多精彩内容