MyBatis入门

1 什么是MyBatis？

• MyBatis 本是apache的一个开源项目iBatis, 2010年这个项目由apache software foundation 迁移到了google code，并且改名为MyBatis 。2013年11月迁移到Github。
• MyBatis是一个优秀的持久层框架，它对jdbc的操作数据库的过程进行封装，使开发者只需要关注 SQL 本身，而不需要花费精力去处理例如注册驱动、创建connection、创建statement、手动设置参数、结果集检索等jdbc繁杂的过程代码。
• Mybatis通过xml或注解的方式将要执行的各种statement（statement、preparedStatemnt、CallableStatement）配置起来，并通过java对象和statement中的sql进行映射生成最终执行的sql语句，最后由mybatis框架执行sql并将结果映射成java对象并返回。

2  MyBatis架构

• SqlMapConfig.xml为MyBatis的全局配置文件，配置了 MyBatis的运行环境
• Mapper-n.xml文件即sql映射文件，文件中配置了操作数据库的sql语句，该文件需要在SqlMapConfig.xml中加载
• 通过MyBatis环境等配置信息构造SqlSession工厂
• 由SqlSession工厂创建SqlSession(操作数据库需要SqlSession)
• MyBatis底层定义了Executor执行器接口操作数据库，Executor接口有两个实现，一个是基本执行器、一个是缓存执行器
• MappedStatment也是MyBatis一个底层封装对象，它包装了mybatis配置信息及sql映射信息等，mapper.xml文件中一个sql对应一个MappedStatement对象，sql的id即是Mapped statement的id
• MappedStatement对sql执行输入参数进行定义，包括HashMap、基本类型、pojo，Executor通过MappedStatement在执行sql前将输入的java对象映射至sql中，输入参数映射就是jdbc编程中对preparedStatement设置参数。
• MappedStatement对sql执行输出结果进行定义，包括HashMap、基本类型、pojo，Executor通过Mapped Statement在执行sql后将输出结果映射至java对象中，输出结果映射过程相当于jdbc编程中对结果的解析处理过程。

3 MyBatis对象 

3.1 SqlSessionFactoryBulider

SqlSessionFactoryBuilder用于创建SqlSessionFacoty，SqlSessionFacoty一旦创建完成就不需要SqlSessionFactoryBuilder了，因为SqlSession是通过SqlSessionFactory创建的。所以可以将SqlSessionFactoryBuilder当成一个工具类使用，最佳使用范围是方法范围即方法体内局部变量。

3.2 SqlSessionFacotory

SqlSessionFactory是一个接口，接口中定义了openSession的不同重载方法，SqlSessionFactory的最佳使用范围是整个应用运行期间，一旦创建后可以重复使用，通常以单例模式管理SqlSessionFactory。

3.3 SqlSession

• SqlSession是一个面向用户的接口，sqlSession中定义了数据库操作方法。
•  每个线程都应该有它自己的SqlSession实例。SqlSession的实例不能共享使用，它也是线程不安全的。因此最佳的范围是请求或方法范围。绝对不能将SqlSession实例的引用放在一个类的静态字段或实例字段中。

4 MyBatis下载 

https://github.com/mybatis/mybatis-3/releases

5 MyBatis入门程序

5.1 引入jar包

5.2 创建表

CREATE TABLE `user` (
  `id` int(11) NOT NULL AUTO_INCREMENT,
  `username` varchar(32) NOT NULL COMMENT '用户名称',
  `birthday` date DEFAULT NULL COMMENT '生日',
  `sex` char(1) DEFAULT NULL COMMENT '性别',
  `address` varchar(256) DEFAULT NULL COMMENT '地址',
  PRIMARY KEY (`id`)
) ENGINE=InnoDB AUTO_INCREMENT=27 DEFAULT CHARSET=utf8;

5.3 创建pojo对象

package com.itykd.domain;

import java.util.Date;

public class User {
	private int id;
	private String username;// 用户姓名
	private String sex;// 性别
	private Date birthday;// 生日
	private String address;// 地址
	private String uuid;
	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;
	}
	
	public String getUuid() {
		return uuid;
	}
	public void setUuid(String uuid) {
		this.uuid = uuid;
	}
	@Override
	public String toString() {
		return "User [id=" + id + ", username=" + username + ", sex=" + sex + ", birthday=" + birthday + ", address="
				+ address + "]";
	}
    

}

5.4  配置文件编写

5.4.1 UserMapper.xml

parameterType代表函数的入参，resultType代表函数的返回值

<?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="user">
    <select id="getUserById" parameterType="int" resultType="com.itykd.domain.User">
        select * from `user` where id=#{id} 
    </select>
<mapper>

5.4.2 SqlMapConfig.xml

需要将映射文件引入主配置文件中( <mapper resource="UserMapper.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整合MyBatis后，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/mybatis?characterEncoding=utf-8"/>
                <property name="username" value="root"/>
                <property name="password" value="NULIFENDOU520"/>
            </dataSource>
        </environment>   
    </environments>
    <!-- 加载映射文件 -->
    <mappers>
        <mapper resource="UserMapper.xml"/>
    </mappers>
</configuration>

 5.5 工具类的编写

package com.itykd.util;

import java.io.IOException;
import java.io.InputStream;

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

public class MyBatisUtils {
	
	private static SqlSessionFactory sqlSessionFactory;
	
	static {
		SqlSessionFactoryBuilder sessionFactoryBuilder = new SqlSessionFactoryBuilder();
		try {
			InputStream inputStream = Resources.getResourceAsStream("SqlMapConfig.xml");
			sqlSessionFactory=sessionFactoryBuilder.build(inputStream);
		} catch (IOException e) {
			// TODO Auto-generated catch block
			e.printStackTrace();
		}	
	}
	public static SqlSessionFactory getSqlSessionFactory() {
		return sqlSessionFactory;
	}

}

5.6 入门程序 

selectone函数的第一个参数为名称空间.方法名，第二个为可变参数，主要根据UserMapper.xml文件中配置的parameterType的类型而定，返回值由resultType定

	public void testQueryUserById() {
		//创建SqlSession对象
		SqlSession sqlSession = MyBatisUtils.getSqlSessionFactory().openSession();
		//执行sqlSession对象查询，获得结果User
		User user = sqlSession.selectOne("user.getUserById", 1);
		// 打印结果
		System.out.println(user);
		// 关闭session
		sqlSession.close();	
	}