mybatis的入门(二)

　　上篇文章首先介绍了JDBC操作数据库的相关知识，并总结了JDBC操作数据存在的一些问题，那么这篇文章我们来介绍下mybatis的相关内容

一、mybatis的架构图

下面对上面的架构图详细说明下：

1.mybatis的配置

　　sqlMapConfig.xml，此文件作为mybatis的核心配置文件，是mybatis的全局配置文件，配置了mybatis的运行环境等信息。

　　mapper.xml文件即sql映射文件，文件中配置了操作数据库的sql语句，此文件需要在SQLMapConfig.xml文件中加载。一般来说，有多少个数据库表就存在多少个mapper.xml文件。

2.SqlSessionFactory

　　通过mybatis的环境等配置信息来构建SqlSessionFactory，即会话工厂。

3.SQLSession

　　由会话工厂(SqlSessionFactory)来创建SqlSession，操作数据库需要通过SqlSession来进行。

4.executor

　　mybatis的底层自定义了executor执行器接口操作数据库，executor执行器接口由两个实现，一个是基本执行器，一个是缓存执行器。

5.mappedStatement

　　mappedStatement也是mybatis底层的封装对象，它包装了mybatis的配置信息及sql映射信息等。mapper.xml文件中的一个sql对应一个mappedStatement对象，sql的ID就是Mapped statement的ID。

6.输入映射

　　Mapped Statement对sql执行输入参数进行定义，包括HashMap、基本类型、pojo，Executor通过Mapped Statement在执行sql前将输入的java对象映射至sql中，输入参数映射就是jdbc编程中对preparedStatement设置参数。

7.输出映射

　　Mapped Statement对sql执行输出结果进行定义，包括HashMap、基本类型、pojo，Executor通过Mapped Statement在执行sql后将输出结果映射至java对象中，输出结果映射过程相当于jdbc编程中对结果的解析处理过程。

二、mybatis的入门程序开发

2.1 业务需求

　　使用mybatis实现以下功能：

　　　　1.根据用户id查询一个用户信息

　　　　2.根据用户名称模糊查询用户列表

　　　　3.添加用户

　　　　4.更新用户

　　　　5.删除用户

2.2 导包

　　需要提前下载好mybatis的jar包，以及mybatis的依赖包，并将所有的jar包添加到 build path中：

其中，mybatis-3.2.7.jar 是mybatis的核心包，mysql-connector-java-5.1.7-bin.jar 是mysql的数据库驱动包，其他的均为mybatis的依赖包。

2.3 加载配置文件

　　在src目录下创建SqlMapConfig.xml 文件、log4j.properties 文件：

2.3.1 log4j.properties 文件配置信息：

# Global logging configuration
log4j.rootLogger=DEBUG, stdout
# 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.properties是日志配置文件，mybatis默认使用log4j作为输入日志信息。

2.3.2 SqlMapConfig.xml 文件配置信息

<?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="com.mysql.jdbc.Driver" />
                <property name="url" value="jdbc:mysql://localhost:3306/mybatisstudy" />
                <property name="username" value="root" />
                <property name="password" value="root" />
            </dataSource>
        </environment>
      </environments>
</configuration>

SqlMapConfig.xml 文件作为mybatis的核心配置文件，配置文件为数据源和事物管理等。

2.4 根据用户id查询一个用户信息

2.4.1 创建pojo

　　pojo类作为mybatis进行sql映射使用，po类通常与数据库表对应，pojo类如下所示：

package com.lwjnicole.pojo;

import java.io.Serializable;
import java.util.Date;

public class User implements Serializable{

    private static final long serialVersionUID = 1L;
    
    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;
    }
    @Override
    public String toString() {
        return "User [id=" + id + ", username=" + username + ", sex=" + sex + ", birthday=" + birthday + ", address="
                + address + "]";
    }
    
}

2.4.2 创建userMapper.xml映射文件

　　在src下创建sqlmap目录，然后在sqlmap目录下创建userMapper.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，还有一个很重要的作用，后面会讲 -->
<mapper namespace="user">
    <!-- id:statement的id 或者叫做sql的id-->
    <!-- parameterType:声明输入参数的类型 -->
    <!-- resultType:声明输出结果的类型，应该填写pojo的全路径 -->
    <!-- #{}：输入参数的占位符，相当于jdbc的？ -->
    <select id="findUserById" parameterType="Integer" resultType="com.lwjnicole.pojo.User">
        select * from user where id = #{v}
    </select>
</mapper>

2.4.3 加载映射文件

　　mybatis框架需要加载Mapper.xml映射文件，将userMapper.xml映射文件添加到SqlMapConfig.xml 下：

<?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="com.mysql.jdbc.Driver" />
                <property name="url" value="jdbc:mysql://localhost:3306/mybatisstudy" />
                <property name="username" value="root" />
                <property name="password" value="root" />
            </dataSource>
        </environment>
      </environments>
      <!-- 加载映射文件  -->
      <mappers>
          <mapper resource="sqlmap/UserMapper.xml"/>
      </mappers>
</configuration>

2.4.4 编写Junit测试代码

　　这里我们来实现根据id查询用户信息的功能，Junit测试代码的实现步骤如下：

　　　　1.创建SqlSessionFactoryBuilder对象

　　　　2.加载 SqlMapConfig.xml 配置文件

　　　　3.创建 SqlSessionFactory 对象

　　　　4.创建 SqlSession 对象

　　　　5.使用SqlSession对象执行查询sql，获得结果 User 对象

　　　　6.打印结果

　　　　7.释放资源

Junit测试代码如下：

package mybatis_study;

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.After;
import org.junit.Before;

import com.lwjnicole.pojo.User;

public class Test {
    private SqlSessionFactory sqlSessionFactory = null;
    private SqlSession session = null;
    
    @Before
    public  void before(){
        //创建SqlSessionFactoryBuilder对象
        SqlSessionFactoryBuilder sqlSessionFactoryBuilder = new SqlSessionFactoryBuilder();
        InputStream inputStream = null;
        try {
            //加载SqlMapConfig.xml配置文件
            inputStream = Resources.getResourceAsStream("SqlMapConfig.xml");
        } catch (IOException e) {
            e.printStackTrace();
        }
        //创建SqlSessionFactory对象
        this.sqlSessionFactory = sqlSessionFactoryBuilder.build(inputStream);
    }
    
    @org.junit.Test
    public void findUserById(){
        //创建SqlSession对象
        session     = sqlSessionFactory.openSession();
        //使用SqlSession对象执行查询sql，获得结果
        User user  = session.selectOne("findUserById", 27);
        //打印结果
        System.out.println(user);
    }
    
    @After
    public void after(){
        //释放资源
        session.close();
    }
}

执行结果如下：

 至此，第一个业务功能就已经实现啦，剩下的功能在接下来的文章中介绍，我的项目结构为：