MyBatis的使用方法

什么是MyBatis？

MyBatis源自Apache的iBatis开源项目, 从iBatis3.x开始正式更名为MyBatis。它是一个优秀的持久层框架。
iBATIS一词来源于“internet”和“abatis”的组合，是一个基于Java的持久层框架。iBATIS提供的持久层框架包括SQL Maps和Data Access Objects（DAOs）

为什么使用MyBatis？

为了和数据库进行交互，通常的做法是将SQL语句写在Java代码中，SQL语句和Java代码耦合在一起不利于后期维护修改，而MyBatis能够帮助我们将SQL语句和Java代码分离，方便了后期因需求变动而对SQL语句进行修改。

如何使用MyBatis

为了方便说明，写出如下目录作为索引：

下边总结三种使用方法
1，准备工作：
a，下载MyBatis相应jar包：https://github.com/mybatis/mybatis-3/releases
b、创建Java工程，导入MyBatis jar包（mybatis-3.4.4.jar）和数据库驱动包并add to bulid path。
c、创建student表并添加数据

create table student(
	id char(36) primary key,
	name varchar(8) not null,
	age int(3) default 0,
	mobile char(11),
	address varchar(150)
)

2，使用：
第一种使用方法：
i），创建名为mybatis-config.xml的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>
	<environments default="dev">	 <!-- 多个environment，default指明使用的是哪一个 -->
		<environment id="dev">		<!-- id与default配套使用，当值相同时，用哪个配置环境 -->
			<transactionManager type="JDBC"></transactionManager>
			<dataSource type="POOLED">		<!--  -->
				<property name="driver" value="com.mysql.jdbc.Driver"/>
				<property name="url" value="jdbc:mysql://127.0.0.1:3306/test"/>
				<property name="username" value="root"/>
				<property name="password" value="root"/>
			</dataSource>
		</environment>
		<environment id="test">
			<transactionManager type="JDBC"></transactionManager>
			<dataSource type="POOLED">
				<property name="driver" value="com.mysql.jdbc.Driver"/>
				<property name="url" value="jdbc:mysql://127.0.0.1:/3306/test"/>
				<property name="username" value="root"/>
				<property name="password" value="root"/>
			</dataSource>
		</environment>
	</environments>
	
	<mappers>
		<mapper resource="./student1.xml"/>		<!-- 用此行代码链接到student.xml文件，将学生有关信息存储到student.xml文件中，便于模块化开发 -->
	</mappers>
</configuration>

ii），创建名为student1.xml的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="com.zzu.student">
	<select id="selectNameById" resultType="java.lang.String">			<!-- String为返回值类型，name是String类型的。namespace为包名，不会重复， selectNameById为id不能重复-->
		select name from student where id=1			<!-- 为了方法演示，将id设为定值。 -->
	</select>
</mapper>

iii），在com.zzu.test包中创建名为Test的类，写如下代码：

package com.zzu.test;

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;

public class Test {

	//第一种方法
	public static void main(String[] args) {
		InputStream inputStream;
		try {
			inputStream = Resources.getResourceAsStream("config-mybatis.xml");	//得到所有的配置信息，和操作student表的sql语句。
			SqlSessionFactory sqlSessionFactory=new SqlSessionFactoryBuilder().build(inputStream); //将这些信息存储到sqlSessionFactory对象中。
			SqlSession sqlSession=sqlSessionFactory.openSession();	//获取SqlSession对象，代表与数据库的一次会话，用完需要关闭。注意：由于SqlSession为非线程安全的，所以该变量应定义为局部变量，不要定义成全局变量
			String name = sqlSession.selectOne("com.zzu.student.selectNameById");	调用SqlSession对象selectOne方法执行SQL语句，参数用于指定执行哪个命名空间中的哪个SQL语句。
			System.out.println(name);
			sqlSession.close();
		} catch (Exception e) {
			e.printStackTrace();
		}
	}
}

说明：这种配置方式在为SQL语句传数据时由于参数类型为Object，所以隐藏类型安全问题。
第二种使用方法：
i），在com.zzu.student包创建IStudentDao接口，代码如下：

package com.zzu.student;
public interface IStudentDao {
	String getNameById();//方法名
}

ii），创建student.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="com.zzu.student.IStudentDao">	<!-- 此处创建动态代理对象了，com.sun.proxy.$proxy0 -->
	<select id="getNameById" resultType="java.lang.String">	
		select name from student where id=1
	</select>
</mapper>

iii），mybatis-config.xml中文件于第一种方法相同
iv），Test中代码如下：

package com.zzu.test;

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 com.zzu.student.IStudentDao;

public class Test {	
	//第二种方法
	public static void main(String[] args) {
		System.out.println(IStudentDao.class.getName());//com.zzu.student.IStudentDao
		try {
			InputStream inputStream = Resources.getResourceAsStream("config-mybatis.xml");//得到连接数据库信息和SQL语句，信息流inputStream。
			SqlSessionFactory sqlSessionFactory=new SqlSessionFactoryBuilder().build(inputStream); 
			SqlSession sqlSession=sqlSessionFactory.openSession();
			IStudentDao studentDao=sqlSession.getMapper(IStudentDao.class);	//底层创建了动态代理对象。
			
			System.out.println(studentDao.getClass().getName());//输出com.sun.proxy.$Proxy0。证明是jdk生成了一个动态代理对象。
			
			String name = studentDao.getNameById();//类似调用普通方法。
			System.out.println(name);
			sqlSession.close();
		} catch (Exception e) {
			e.printStackTrace();
		}
	}

说明：这种方法不仅实现了SQL语句的分离，而且弥补了第一种方法的不足，所以推荐使用这种MyBatis使用方式。
运行之后输出结果如下：

第三种使用方法：
创建接口，代码如下：

package com.zzu.student;
import org.apache.ibatis.annotations.Select;

public interface IStudentDao {

	@Select("select name from student where id=1")		<!-- 直接将sql语句写在了接口中，由于java 文件会编译为class文件，class文件不可改变，所以不便于后期更改，直接使用了接口，失去了动态代理的意义 -->
	String getNameById();//方法名
}

config-mybatis.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>
	<environments default="dev">	<!-- 多个environment，default指明使用的是哪一个 -->
		<environment id="dev">
			<transactionManager type="JDBC"></transactionManager>
			<dataSource type="POOLED">
				<property name="driver" value="com.mysql.jdbc.Driver"/>
				<property name="url" value="jdbc:mysql://127.0.0.1:3306/test"/>
				<property name="username" value="root"/>
				<property name="password" value="root"/>
			</dataSource>
		</environment>
		<environment id="test">
			<transactionManager type="JDBC"></transactionManager>
			<dataSource type="POOLED">
				<property name="driver" value="com.mysql.jdbc.Driver"/>
				<property name="url" value="jdbc:mysql://127.0.0.1:/3306/test"/>
				<property name="username" value="root"/>
				<property name="password" value="root"/>
			</dataSource>
		</environment>
	</environments>
	
	<mappers>
		<mapper class="com.zzu.student.IStudentDao"/>  
	</mappers>
</configuration>

Test中代码如下：

package com.zzu.test;

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 com.zzu.student.IStudentDao;

public class Test {
public static void main(String[] args) {
		System.out.println(IStudentDao.class.getName());//com.zzu.student.IStudentDao
		try {
			InputStream inputStream = Resources.getResourceAsStream("config-mybatis.xml");//得到连接数据库信息和SQL语句，信息流inputStream。
			SqlSessionFactory sqlSessionFactory=new SqlSessionFactoryBuilder().build(inputStream); 
			SqlSession sqlSession=sqlSessionFactory.openSession();
			IStudentDao studentDao=sqlSession.getMapper(IStudentDao.class);	//底层创建了动态代理对象。
			
			String name = studentDao.getNameById();//类似调用普通方法。
			System.out.println(name);
			sqlSession.close();
		} catch (Exception e) {
			e.printStackTrace();
		}
	}
}

说明：这种方式不仅使得SQL语句与Java代码出现了耦合，而且不便于写复杂的SQL语句，比如依照可以依照多个字段查询时，where关键字后面的条件是动态的，这时就不便于使用注解的方式写该SQL语句。