項目搭建系列之二：SpringMVC框架下配置MyBatis

1、什么是MyBatis?

　　MyBatis是一個支持普通SQL查詢，存儲過程和高級映射的優秀持久層框架。MyBatis消除了幾乎所有的JDBC代碼和參數的手工設置以及對結果集的檢索封裝。MyBatis可以使用簡單的XML或注解用於配置和原始映射，將接口和Java的POJO（Plain Old Java Objects，普通的Java對象）映射成數據庫中的記錄。

2、環境准備

• 搭建好SpringMVC框架，可以閱讀《項目搭建系列之一：使用Maven搭建SpringMVC項目》，也可以直接到我的GitHub下載。
• 添加jar包

　【MyBatis】

<!-- mybatis begin -->
<dependency>
    <groupId>org.mybatis</groupId>
    <artifactId>mybatis</artifactId>
    <version>3.2.3</version>
</dependency>
<!-- mybatis end -->    

　【MYSQL驅動包】

<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
    <version>5.1.31</version>
</dependency>

• 創建數據庫

CREATE DATABASE mybatis_test;
USE mybatis_test;
CREATE TABLE user (
  name varchar(50) CHARACTER SET utf8 DEFAULT NULL,
  age int(11) DEFAULT NULL,
  UNIQUE KEY name (name)
) ENGINE=InnoDB DEFAULT CHARSET=utf8;

3、MyBatis配置使用

• 新建一個實體類User.java

package cn.jxufe.web.mybatis;

public class User {
    private String name;
    private Integer age;

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public Integer getAge() {
        return age;
    }

    public void setAge(Integer age) {
        this.age = age;
    }

    public User(String name, Integer age) {
        super();
        this.name = name;
        this.age = age;
    }

    public User() {
        super();
    }
}

• 新建一個映射文件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">
<!-- 為這個mapper指定一個唯一的namespace，namespace的值習慣上設置成包名+sql映射文件名，這樣就能夠保證namespace的值是唯一的 -->
<mapper namespace="cn.jxufe.web.mybatis.UserMapper">
    <!-- 這里namespace必須是UserMapper接口的路徑，不然要運行的時候要報錯 “is not known to the MapperRegistry” -->
    <insert id="insertUser" parameterType="User">
        insert into user(name,age) values(#{name},#{age})
        <!-- 這里sql結尾不能加分號，否則報“ORA-00911”的錯誤 -->
    </insert>
　　<!-- 在select標簽中編寫查詢的SQL語句， 設置select標簽的id屬性為getUser，id屬性值必須是唯一的，
　　　　不能夠重復使用parameterType屬性指明查詢時使用的參數類型，resultType屬性指明查詢返回的結果集類型 -->
    <!-- 這里的id必須和UserMapper接口中的接口方法名相同，不然運行的時候也要報錯 -->
    <select id="getUser" resultType="User" parameterType="java.lang.String">
        select * from user where name=#{name}
    </select>
</mapper>  

• 新建一個接口類UserMapper.java

package cn.jxufe.web.mybatis;

public interface UserMapper {
    public void insertUser(User user);

    public User getUser(String name);
}

• 新建配置文件mybatis-config.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>   
    <settings>   
        <!-- changes from the defaults for testing -->   
        <setting name="cacheEnabled" value="false" />   
        <setting name="useGeneratedKeys" value="true" />   
        <setting name="defaultExecutorType" value="REUSE" />   
    </settings>   
    <typeAliases>   
       <typeAlias alias="User" type="cn.jxufe.web.mybatis.User"/>   
    </typeAliases>   
    <environments default="development">   
       <environment id="development">   
           <transactionManager type="jdbc"/>   
　　　　　　 <!-- 配置數據庫連接信息 -->
           <dataSource type="POOLED">   
              <property name="driver" value="com.mysql.jdbc.Driver"/>   
              <property name="url" value="jdbc:mysql://127.0.0.1:3306/mybatis_test"/>   
              <property name="username" value="root"/>   
              <property name="password" value="123456"/>   
           </dataSource>   
       </environment>   
    </environments>   
    <mappers>
        <!-- 注冊UserMapper.xml文件--> 
        <mapper resource="mappers/UserMapper.xml" />   
    </mappers>   
</configuration>  

• 新建一個工具類MyBatisUtil.java,用於創建SqlSessionFactory實例，每個數據庫對應一個 SqlSessionFactory實例。

package cn.jxufe.web.mybatis;

import java.io.IOException;
import java.io.Reader;

import org.apache.ibatis.io.Resources;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;

public class MyBatisUtil {
    private final static SqlSessionFactory sqlSessionFactory;
    static {
        String resource = "mybatis-config.xml";
        Reader reader = null;
        try {
            reader = Resources.getResourceAsReader(resource);
        } catch (IOException e) {
            System.out.println(e.getMessage());

        }
        sqlSessionFactory = new SqlSessionFactoryBuilder().build(reader);
    }

    public static SqlSessionFactory getSqlSessionFactory() {
        return sqlSessionFactory;
    }
}

• 測試調用

package cn.jxufe.web.mybatis;

import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;

public class TestMyBatis {
    static SqlSessionFactory sqlSessionFactory = null;
    static {
        sqlSessionFactory = MyBatisUtil.getSqlSessionFactory();
    }

//    public static void main(String[] args) {
//        testAdd();
//        getUser();
//    }

    public static void testAdd() {
        SqlSession sqlSession = sqlSessionFactory.openSession();
        try {
            UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
            User user = new User("lisi", new Integer(25));
            userMapper.insertUser(user);
            sqlSession.commit();// 這里一定要提交，不然數據進不去數據庫中
        } finally {
            sqlSession.close();
        }
    }

    public static void getUser() {
        SqlSession sqlSession = sqlSessionFactory.openSession();
        try {
            UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
            User user = userMapper.getUser("lisi");
            System.out.println("name: " + user.getName() + "|age: "
                    + user.getAge());
        } finally {
            sqlSession.close();
        }
    }
}

• 工程目錄結構

• 測試結果

• 源碼下載

　　GitHub下載