【MyBatis框架】MyBatis入门程序第一部分

我们通过写一个简单的MyBatis小项目来在实战中学习MyBatis

1.需求
根据用户id（主键）查询用户信息
根据用户名称模糊查询用户信息
添加用户
删除 用户
更新用户

mybatis运行环境（jar包）：
从https://github.com/mybatis/mybatis-3/releases下载，3.2.7版本

lib下：依赖包
mybatis-3.2.7.jar：核心 包
mybatis-3.2.7.pdf，操作指南

加入mysql的驱动包

加入的所有jar包如图(可以在这里下载:http://download.csdn.net/detail/u013517797/8781295)

2.创建log4j.properties
在src中放入日志配置文件
文件内容(拷贝自官方帮助文档)

# Global logging configuration  
#在开发环境下日志级别要设成DEBUG，生产环境设为INFO或ERROR  
log4j.rootLogger=DEBUG, stdout  
# MyBatis logging configuration...  
log4j.logger.org.mybatis.example.BlogMapper=TRACE  
# 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  

接下来创建SqlMapConfig.xml等文件

配置好之后的整个工程结构为图

3.SqlMapConfig.xml
SqlMapConfig.xml内容如下
(由于没有整合Spring，暂时在environments中配数据库连接池dataSource，整合Spring之后将这一块删除就行了)

<?xml version="1.0" encoding="UTF-8"?>  
<!DOCTYPE configuration  
PUBLIC "-//mybatis.org//DTD Config 3.0//EN"  
"http://mybatis.org/dtd/mybatis-3-config.dtd">  
<configuration>  
    <!-- 和spring整合后 environments配置将废除-->  
    <environments default="development">  
        <environment id="development">  
        <!-- 使用jdbc事务管理-->  
            <transactionManager type="JDBC" />  
        <!-- 数据库连接池-->  
            <dataSource type="POOLED">  
                <property name="driver" value="org.gjt.mm.mysql.Driver"/>  
                <property name="url" value="jdbc:mysql://localhost:3306/mybatis?characterEncoding=utf-8"/>  
                <property name="username" value="root"/>  
                <property name="password" value="1234"/>  
            </dataSource>  
        </environment>  
    </environments>  
      
</configuration>  

4.创建PO(persistant object持久对象)类
在数据库中创建mtbatis数据库，创建user表，表详细内容为

id<int>、username<vachar>、birthday<Date>、sex<int>、address<vachar>

在cn.edu.hpu.mybatis.PO包下创建PO对象
User.java:

package cn.edu.hpu.mybatis.PO;  
  
  
import java.util.Date;  
  
  
public class User {  
    private int id;  
    private String username;// 用户姓名  
    private String sex;// 性别  
    private Date birthday;// 生日  
    private String address;// 地址  
      
    public int getId() {  
        return id;  
    }  
    public void setId(int id) {  
        this.id = id;  
    }  
    public String getUsername() {  
        return username;  
    }  
    public void setUsername(String username) {  
        this.username = username;  
    }  
    public String getSex() {  
        return sex;  
    }  
    public void setSex(String sex) {  
        this.sex = sex;  
    }  
    public Date getBirthday() {  
        return birthday;  
    }  
    public void setBirthday(Date birthday) {  
        this.birthday = birthday;  
    }  
    public String getAddress() {  
        return address;  
    }  
    public void setAddress(String address) {  
        this.address = address;  
    }  
      
} 

5.编写User.xml配置文件
我们来写User.xml(里面详细注释，就不多说了)：

<?xml version="1.0" encoding="UTF-8"?>  
<!DOCTYPE mapper  
PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"  
"http://mybatis.org/dtd/mybatis-3-mapper.dtd">  
  
  
<!-- namespace命名空间，作用就是对sql进行分类化管理，理解sql隔离  
注意:使用mapper代理方法开发，namespace有特殊重要的作用 -->  
<mapper namespace="test">  
    <!-- 在映射文件中配置很多sql语句 -->  
      
    <!-- 需求:通过id查询用户表的记录 -->  
    <!-- 通过select执行数据库查询，  
         id:标示映射文件中的sql，成为Statement的id   
         将sql语句封装到mappedStatement对象中，所以将id称为statement的id,  
           
         parameterType:指定输入参数的类型，  
           
         #{}标示一个占位符,  
           
         #{id}其中id表示接收输入参数的名称，如果输入参数是简单类型，那么#{}中的值可以任意。  
           
         resultType：指定sql输出结果的映射的java对象类型，  
         select指定resultType表示将单条记录映射成java对象-->     
    <select id="findUserById" parameterType="int" resultType="cn.edu.hpu.mybatis.PO.User">  
      SELECT * FROM USER WHERE id=#{id}  
    </select>  
</mapper>  

6.在SqlMapConfig.xml中加载映射文件(User.xml)

<!-- 加载映射文件 -->  
<mappers>  
    <mapper resource="sqlmap/User.xml"/>  
</mappers>  

7.编写程序
(1)同归id查询用户
在cn.edu.hpu.mybatis.first包下编写测试样例MyBatisfirst.java
这里我们查询id为1的用户

package cn.edu.hpu.mybatis.first;  
  
  
import java.io.IOException;  
import java.io.InputStream;  
  
  
import org.apache.ibatis.io.Resources;  
import org.apache.ibatis.session.SqlSession;  
import org.apache.ibatis.session.SqlSessionFactory;  
import org.apache.ibatis.session.SqlSessionFactoryBuilder;  
import org.junit.Test;  
  
  
import cn.edu.hpu.mybatis.PO.User;  
  
  
public class MyBatisfirst {  
    private SqlSession sqlSession=null;  
      
    //根据id查询用户信息，得到一条记录结果  
    @Test  
    public void findUserById(){  
          
        //mybatis配置文件  
        String resource="SqlMapConfig.xml";  
          
        //将配置文件加载成流  
        InputStream inputStream;  
          
        try {  
              
            inputStream = Resources.getResourceAsStream(resource);  
            //创建会话工厂，传入mybatis配置文件的信息  
            SqlSessionFactory sqlSessionFactory=new SqlSessionFactoryBuilder().build(inputStream);  
              
            //通过工厂得到sqlSession  
            sqlSession=sqlSessionFactory.openSession();  
              
            //通过SqlSession操作数据库  
            //第一个参数:映射文件中的statement的Id，等于=namespace+"."+statement的Id  
            //第二个参数:指定和映射文件所匹配的parameterType类型的参数  
            //sqlSession.selectOne最终结果与你映射文件中所匹配的resultType类型  
            User user=sqlSession.selectOne("test.findUserById",1);//数据库id=1的字段username为"张三"  
            System.out.println(user.getUsername());  
              
        } catch (IOException e) {  
            e.printStackTrace();  
        }finally{  
            //释放资源  
            sqlSession.close();  
        }  
          
    }  
      
}  

测试结果:张三
查看控制台Console输出的日志记录:

DEBUG [main] - Logging initialized using 'class org.apache.ibatis.logging.slf4j.Slf4jImpl' adapter.  
DEBUG [main] - PooledDataSource forcefully closed/removed all connections.  
DEBUG [main] - PooledDataSource forcefully closed/removed all connections.  
DEBUG [main] - PooledDataSource forcefully closed/removed all connections.  
DEBUG [main] - PooledDataSource forcefully closed/removed all connections.  
DEBUG [main] - Opening JDBC Connection  
DEBUG [main] - Created connection 29683960.  
DEBUG [main] - Setting autocommit to false on JDBC Connection [com.mysql.jdbc.Connection@1c4f0f8]  
DEBUG [main] - ==>  Preparing: SELECT * FROM USER WHERE id=?   
DEBUG [main] - ==> Parameters: 1(Integer)  
DEBUG [main] - <==      Total: 1  
张三  
DEBUG [main] - Resetting autocommit to true on JDBC Connection [com.mysql.jdbc.Connection@1c4f0f8]  
DEBUG [main] - Closing JDBC Connection [com.mysql.jdbc.Connection@1c4f0f8]  
DEBUG [main] - Returned connection 29683960 to pool. 

很清晰的看到整个执行过程

(2)通过用户名模糊查询用户id
使用User.xml，添加根据用户名称模糊查询用户信息的sql语句。

<!-- ${}:表示拼接sql串，将接收到的参数内容不加任何修饰拼接在sql中。  
         使用${}拼接sql，引起sql注入。  
         ${}中只能使用value-->  
<select id="findUserByUsername" parameterType="java.lang.String"   
            resultType="cn.edu.hpu.mybatis.PO.User">  
    select * from user where username like '%${value}%'   
</select>  

测试方法：

//根据用户姓名模糊查询用户id，得到一个记录集合  
    @Test  
    public void findUserByName(){  
          
        //mybatis配置文件  
        String resource="SqlMapConfig.xml";  
          
        //将配置文件加载成流  
        InputStream inputStream;  
          
        try {  
              
            inputStream = Resources.getResourceAsStream(resource);  
            //创建会话工厂，传入mybatis配置文件的信息  
            SqlSessionFactory sqlSessionFactory=new SqlSessionFactoryBuilder().build(inputStream);  
              
            //通过工厂得到sqlSession  
            sqlSession=sqlSessionFactory.openSession();  
              
            //通过SqlSession操作数据库  
            //第一个参数:映射文件中的statement的Id，等于=namespace+"."+statement的Id  
            //第二个参数:指定和映射文件所匹配的parameterType类型的参数  
            //sqlSession.selectOne最终结果与你映射文件中所匹配的resultType类型  
            List<User> users=sqlSession.selectList("test.findUserByUsername","张三");  
            //数据库一共有两个相关数据，"张三"和"张三丰"  
            for (int i = 0; i < users.size(); i++) {  
                User u=users.get(i);  
                System.out.println(u.getId()+":"+u.getUsername());  
            }  
              
              
        } catch (IOException e) {  
            e.printStackTrace();  
        }finally{  
            //释放资源  
            sqlSession.close();  
        }  
          
    }  

测试结果：
1:张三
4:张三丰

输出的日志信息：

DEBUG [main] - PooledDataSource forcefully closed/removed all connections.  
DEBUG [main] - PooledDataSource forcefully closed/removed all connections.  
DEBUG [main] - PooledDataSource forcefully closed/removed all connections.  
DEBUG [main] - PooledDataSource forcefully closed/removed all connections.  
DEBUG [main] - Opening JDBC Connection  
DEBUG [main] - Created connection 29945809.  
DEBUG [main] - Setting autocommit to false on JDBC Connection [com.mysql.jdbc.Connection@1c8efd1]  
DEBUG [main] - ==>  Preparing: select * from user where username like '%张三%'   
DEBUG [main] - ==> Parameters:   
DEBUG [main] - <==      Total: 2  
1:张三  
4:张三丰  
DEBUG [main] - Resetting autocommit to true on JDBC Connection [com.mysql.jdbc.Connection@1c8efd1]  
DEBUG [main] - Closing JDBC Connection [com.mysql.jdbc.Connection@1c8efd1]  
DEBUG [main] - Returned connection 29945809 to pool.  

小结:
a.parameterType
在映射文件中通过parameterType指定输入参数的类型

b.resultType
在映射文件中通过resultType指定输出结果的类型

c.#{}和${}
#{}表示一个占位符号
${}表示一个拼接符号，会引起sql注入，所以不建议使用

d.selectOne和selectList
selectOne表示查询一条记录进行映射，使用selectList也可以使用，只不过只有一个对象
selectList表示查询出一个列表(参数记录)进行映射，不嗯能够使用selectOne查，不然会报下面的错:

org.apache.ibatis.exceptions.TooManyResultsException: Expected one result (or null) to be returned by selectOne(), but found: 2