一、搭建数据源
mysql客户端连接mysql数据库，执行下面语句。【第一次写的时候，居然写成tbl_employee{}，sql语句没有{},应该是() 】
CREATE TABLE tb1_employee (
id INT(11) PRIMARY KEY AUTO_INCREMENT,
last_name VARCHAR(255),
gender CHAR(1),
email VARCHAR(255)
)
因为不区分大小写，所以也可以采用如下写法：
create table tbl_employee(
id int(11) primary key auto_increment,
last_name varchar(255),
gender char(1),
email varchar(255)
)
创建完表格后，并在其中添加一条记录。
id last_name gender email
1 mike 0 [email protected]
二、创建项目代码
1、工程代码总览：
（代码包括mybatis 的两种操作 方法）
2、添加项目jar包
项目用到的jar包主要有：
mybatis-3.4.6.jar 【mybatis 包】
mysql-connector-java-5.1.18.jar 【mysql 驱动包】
额外添加的包：
mybatis-3.4.6-sources.jar 【mybatis 源码包，方便debug 跟踪代码】
mybatis-3.4.6-javadoc【mybatis 文档包，方便查看】
log4j-1.2.17.jar 【日志打印包，需要配合 log4j 的配置文件一起使用，这里用到的配置文件是log4j.xml】
log4j.xml文件：
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE log4j:configuration SYSTEM "log4j.dtd">
<log4j:configuration xmlns:log4j="http://jakarta.apache.org/log4j/">
<appender name="STDOUT" class="org.apache.log4j.ConsoleAppender">
<param name="Encoding" value="UTF-8" />
<layout class="org.apache.log4j.PatternLayout">
<param name="ConversionPattern" value="%-5p %d{MM-dd HH:mm:ss,SSS} %m (%F:%L) \n" />
</layout>
</appender>
<logger name="java.sql">
<level value="debug" />
</logger>
<logger name="org.apache.ibatis">
<level value="info" />
</logger>
<root>
<level value="debug" />
<appender-ref ref="STDOUT" />
</root>
</log4j:configuration>
3、创建ORM中的对象
package com.mybatis.bean;
public class Employee {
private int id;
private String lastName;
private String email;
private String gender;
public int getId() {
return id;
}
public void setId(int id) {
this.id = id;
}
public String getLastName() {
return lastName;
}
public void setLastName(String lastName) {
this.lastName = lastName;
}
public String getEmail() {
return email;
}
public void setEmail(String email) {
this.email = email;
}
public String getGender() {
return gender;
}
public void setGender(String gender) {
this.gender = gender;
}
@Override
public String toString() {
return "Employee [id=" + id + ", lastName=" + lastName + ", email=" + email + ", gender=" + gender + "]";
}
}
4、创建全局配置文件
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>
<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://localhost:3306/mybatis" />
<property name="username" value="root" />
<property name="password" value="Kitty521!" />
</dataSource>
</environment>
</environments>
<!-- 将我们写好的sql映射文件（EmployeeMapper.xml）一定要注册到全局配置文件（mybatis-config.xml）中
如果 数据库全局文件 和 子配置文件 不在同一个目录 ，就需要 /目录/目录/.../EmployeeMapper_old.xml
-->
<mappers>
<!-- 旧方法操作mybatis 需要 的配置文件 -->
<mapper resource="EmployeeMapper_old.xml" />
<!-- 新方法操作mybatis 需要 的配置文件 -->
<mapper resource="EmployeeMapper_new.xml" />
</mappers>
</configuration>
5、旧方法操作mybatis
（1）对象映射配置文件:EmployeeMapper_old.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.mybatis.hhh.EmployeeMapper">
<!--
上面的 namespace:名称空间;名字随便写
下面的 id：唯一标识
下面的 resultType：返回值类型
下面的 #{id}：从传递过来的参数中取出id值
-->
<select id="selectEmp" resultType="com.mybatis.bean.Employee">
<!-- select * from tb1_employee where id = #{id}
这样的查询结果导致数据库 last_name 无法赋值给employee bean中的lastName
所以，employee 中的 lastName 是空值，解决版本是 查询结果 取 别名-->
select id ,last_name lastName,email, gender from tbl_employee where id = #{id}
</select>
</mapper>
(2) JUnit 单元测试:
public class MybatisTest {
/**
* 1、根据xml配置文件（全局配置文件）创建一个SqlSessionFactory对象 有数据源一些运行环境信息
* 2、sql映射文件；配置了每一个sql，以及sql的封装规则等。
* 3、将sql映射文件注册在全局配置文件中
* 4、写代码：
* 1）、根据全局配置文件得到SqlSessionFactory；
* 2）、使用sqlSession工厂，获取到sqlSession对象使用他来执行增删改查
* 一个sqlSession就是代表和数据库的一次会话，用完关闭
* 3）、使用sql的唯一标志来告诉MyBatis执行哪个sql。sql都是保存在sql映射文件中的。
*
* @throws IOException
*/
@Test
public void test_old() throws IOException {
String resource = "mybatis-config.xml";
InputStream inputStream = Resources.getResourceAsStream(resource);
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
//获取sqlSession实例 ，能直接执行已经映射的sql语句。
// sql的唯一标识：statement Unique identifier matching the statement to use.
// 执行sql要用的参数：parameter A parameter object to pass to the statement.
SqlSession openSession = sqlSessionFactory.openSession();
try{
//唯一标识符可以直接写 selectEmp 但为了防止 和别可能有的冲突，添加了命名空间
Employee employee = openSession.selectOne("com.mybatis.hhh.EmployeeMapper.selectEmp",1);
System.out.println(employee);
}catch (Exception e) {
// TODO: handle exception
}finally {
openSession.close();
}
}
}
6、新方法操作mybatis
（1）对象映射配置文件:EmployeeMapper_new.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.mybatis.mapper.EmployeeMapper">
<!--
上面的 namespace:名称空间;指定为接口的全类名
下面的 id：唯一标识被规定为接口方法名 【public Employee getEmpById(Integer id);】
下面的 resultType：返回值类型
下面的 #{id}：从传递过来的参数中取出id值
-->
<select id="getEmpById" resultType="com.mybatis.bean.Employee">
select id,last_name lastName,email,gender from tbl_employee where id = #{id}
</select>
</mapper>
（2）创建对象映射的接口文件
EmployeeMapper.java
package com.mybatis.mapper;
import com.mybatis.bean.Employee;
public interface EmployeeMapper {
public Employee getEmpById(Integer id);
}
(3)JUnit 单元测试
/**
* 1、接口式编程
* 原生： Dao ====> DaoImpl
* mybatis： Mapper ====> xxMapper.xml
*
* 2、SqlSession代表和数据库的一次会话；用完必须关闭；
* 3、SqlSession和connection一样她都是非线程安全。每次使用都应该去获取新的对象。(就是不要放在共享成员变量里面，A线程用完释放，B线程再用就为空了)
* 4、mapper接口没有实现类，但是mybatis会为这个接口生成一个代理对象。
* （将接口和xml进行绑定）
* EmployeeMapper empMapper = sqlSession.getMapper(EmployeeMapper.class);
* 5、两个重要的配置文件：
* mybatis的全局配置文件：包含数据库连接池信息，事务管理器信息等...系统运行环境信息
* sql映射文件：保存了每一个sql语句的映射信息：
* 将sql抽取出来。
*
*/
public class MybatisTest {
public SqlSessionFactory getSqlSessionFactory() throws IOException {
String resource = "mybatis-config.xml";
InputStream inputStream = Resources.getResourceAsStream(resource);
return new SqlSessionFactoryBuilder().build(inputStream);
}
@Test
public void test_new() throws IOException {
// 1、获取sqlSessionFactory对象
SqlSessionFactory sqlSessionFactory = getSqlSessionFactory();
// 2、获取sqlSession对象
SqlSession openSession = sqlSessionFactory.openSession();
try {
// 3、获取接口的实现类对象
//会为接口自动的创建一个代理对象，代理对象去执行增删改查方法
EmployeeMapper mapper = openSession.getMapper(EmployeeMapper.class);
Employee employee = mapper.getEmpById(1);
System.out.println(mapper.getClass());
System.out.println(employee);
} finally {
openSession.close();
}
}
}
三、全局配置文件解析
1、配置标签顺序
在mybatis的全局配置文件中， 在 <configuration>标签下：
Content Model : (properties?, settings?, typeAliases?, typeHandlers?, objectFactory?, objectWrapperFactory?,
reflectorFactory?, plugins?, environments?, databaseIdProvider?, mappers?)
注意上面的子标签都是有顺序的
2、标签详解请看相关章节
四、映射文件解析
补充：
SqlSession 的实例不是线程安全的，因此是不能被共享的。
SqlSession每次使用完成后需要正确关闭，这个关闭操作是必须的
SqlSession可以直接调用方法的id进行数据库操作，但是我们一般还是推荐使用SqlSession获取到Mapper接口的代理类，执行代理对象的方法，可以更安全的进行类型检查操作
关于JUnit单元测试，只需在eclipse中新建 JUnit Test Case 就行了。
