二、MyBatis之框架搭建以及初体验（Win10）

MyBatis之编译环境准备：
一、MyBatis之编译环境准备（Win10）

Mybatis环境搭建过程

1、准备好需要的jar文件

mybatis
下载后直接进行解压，mybatis-3.4.2.zip是MyBatis的jar文件，之后再进行解压，Mybatis-3.4.2.jar为其核心依赖包，Mybatis-3.4.2.pdf为说明文档。

lib目录下为其编译依赖包。

此外还需要使用到一个mysql-connector-java-5.1.40-bin.jar包（MySQL数据库驱动jar文件）
mysql-connector-java

2、数据库的准备

使用MySQL创建一个测试用数据库，新建一张t_user表，并在表中新增id、username、password、gender、registTime五种属性并定义数据类型。
若不熟悉MySQL指令，为方便操作可提前安装好Navicate。
Navicate

之后在表中新增一条数据，用于后面的测试查询。

3、新建Eclipse工程

打开Eclipse，新建一个Dynamic Web Project工程mybatistest，然后将准备好的jar包：lib中的编译依赖包（主要是log4j-1.2.17.jar，用于负责日志输出的jar文件）、核心依赖包Mybatis-3.4.2.jar、MySQL数据库驱动jar文件mysql-connector-java-5.1.40-bin.jar放到建好的工程WEB-INF的lib目录下。

之后在工程上右键进行包的导入，“Build Path—Configure Build Path—Add JARs”，选择lib下刚刚复制的jar文件，之后点击Apply应用。

4、配置日志信息

MyBatis默认使用log4j输出日志信息，如果需要查看控制台输出的SQL语句，就需要在路径下配置其日志文件。在项目src路径下创建log4j.properties文件,并向文件中写入以下内容：

# \u5168\u5C40\u65E5\u5FD7\u914D\u7F6E
log4j.rootLogger=ERROR, stdout
# MyBatis \u65E5\u5FD7\u914D\u7F6E
log4j.logger.org.mybatis.example.BlogMapper=TRACE
# \u63A7\u5236\u53F0\u8F93\u51FA
log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern=%5p [%t] - %m%n

5、创建持久化类

根据数据表在src目录下创建indi.user.entity包，在包下创建持久化类User.java，在类中声明表中对应字段的属性，加入getXX()/setXX()方法，重写toString()方法，User.java实例代码：

package indi.user.entity;
import java.util.Date;
public class User {
    private  Integer id;
    private  String  username;
    private  String  password;
    private  Boolean gender;
    private  Date    registTime;
    public User(){
    }
    public User(Integer id, String username, String password, Boolean gender, Date registTime){

        this.id=id;
        this.username=username;
        this.password=password;
        this.gender=gender;
        this.registTime=registTime;
    }

    public Integer getId() {
        return id;
    }
    public void setId(Integer id) {
        this.id = id;
    }
    public String getUsername() {
        return username;
    }
    public void setUsername(String username) {
        this.username = username;
    }
    public String getPassword() {
        return password;
    }
    public void setPassward(String password) {
        this.password = password;
    }
    public Boolean getGender() {
        return gender;
    }
    public void setGender(Boolean gender) {
        this.gender = gender;
    }
    public Date getRegistTime() {
        return registTime;
    }
    public void setRegistTime(Date registTime) {
        this.registTime = registTime;
    }
	@Override
	public String toString() {
		return "User [id=" + id + ", username=" + username + ", password=" + password + ", gender=" + gender
				+ ", registTime=" + registTime + "]";
	}
}

6、创建SQL映射文件

在src目录下创建indi.user.Mapper包，在包内创建UserMapper.xml配置文件，添加内容如下：

<?xml version="1.0" encoding="UTF-8"?>
<!-- MyBatis约束 -->
<!DOCTYPE mapper  PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
  "http://mybatis.org/dtd/mybatis-3-mapper.dtd">  
  <!-- <mapper>是配置文件根元素 namespace为该mapper指定唯一命名空间 -->
<mapper namespace="indi.user.Mapper.UserMapper">
<!--根据用户姓名获取客户信息-->
<!-- <select>子元素用于执行查询操作的配置
  id:方法名
  parameterType:形参类型
  resultType:返回值类型
  #{}:花括号内是形参名
 -->
  <select id="findUserByName" resultType="indi.user.entity.User">
    select * from t_user where username = #{username}
  </select>
</mapper>

7、创建MyBatis核心配置文件

在src目录下创建MyBatis核心配置文件，可以随意取名。这里核心配置文件取名为:configuration.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="development">
		<!--配置数据库相关信息 -->
		<environment id="development">
			<!--和数据库通信是事务控制类型 -->
			<transactionManager type="jdbc"></transactionManager>
			<!--配置数据库连接相关参数 -->
			<dataSource
				type="org.apache.ibatis.datasource.pooled.PooledDataSourceFactory">
				<property name="driver" value="com.mysql.jdbc.Driver" />
				<!--&转义 &amp; -->
				<property name="url"
					value="jdbc:mysql://localhost:3306/mybatis?useUnicode=true&amp;characterEncoding=utf-8" />
				<property name="username" value="root" />
				<property name="password" value="root" />
			</dataSource>
		</environment>
	</environments>

	<!--注册Mapper文件 -->
	<mappers>
		<mapper resource="indi/user/Mapper/UserMapper.xml"></mapper>
	</mappers>
</configuration>

8、创建测试类

在src目录下创建indi.user.test包，在包下创建测试类UserMapperTest.java，通过jUnit4单元测试。
首先将jUnit4单元测试包导入这个项目，在工程上右键进行包的导入，“Build Path—Configure Build Path—Add Library”，选择jUnit4。

创建创建indi.user.test包，包下创建测试类UserMapperTest.java，类文件内容如下：

package indi.user.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 org.junit.Test;

import indi.user.entity.User;

public class UserMapperTest {
/*
 * 根据客户姓名查询用户信息
 * 
 * */
	
	@Test
	public void findUserByNameTest() throws Exception{
		
		//1.读取配置文件
		
		String resource="configuration.xml";
		
		InputStream inputstream=Resources.getResourceAsStream(resource);
		
		//2.根据配置文件构建SqlSessionFactory
		
		SqlSessionFactory salsessionfactory=new SqlSessionFactoryBuilder().build(inputstream);
		
		//3.通过SqlSessionFactory创建SqlSession
		SqlSession sqlsession=salsessionfactory.openSession();
		
		//4.SqlSession执行映射文件中定义的SQL,并返回映射结果
	User  user=sqlsession.selectOne("indi.user.Mapper"+".UserMapper.findUserByName","小李");		
	
	   //5.打印输出结果
	System.out.println(user.toString());
	
	//6.关闭SqlSession
	sqlsession.close();
	}
}

运行测试类，出现查询结果则MyBatis开发环境搭建成功。

操作内容源码