[TOC]
# Mybatis 简单实现
## 开发环境
1、创建测试项目，普通 Java 项目或者是 JavaWeb 项目均可，如下图所示：
2、添加相应的 jar 包
Mybatis：mybatis-3.2.2.jar
MYSQL驱动包：mysql-connector-java-5.1.8-bin.jar
3、创建数据库和表，针对 MySQL 数据库
创建数据库：mybatis_test
SQL脚本如下：
~~~
DROP TABLE IF EXISTS `users`;
CREATE TABLE `users` (
`id` int(11) NOT NULL AUTO_INCREMENT,
`name` varchar(255) DEFAULT NULL,
`age` int(11) DEFAULT NULL,
PRIMARY KEY (`id`)
) ENGINE=InnoDB AUTO_INCREMENT=3 DEFAULT CHARSET=utf8;
INSERT INTO `users` VALUES ('1', '张三', '28');
INSERT INTO `users` VALUES ('2', '王五', '25');
~~~
## 使用 MyBatis 查询表中的数据
### 添加 Mybatis 的配置文件 conf.xml
conf.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_test?useUnicode=true&characterEncoding=UTF-8" />
<property name="username" value="root" />
<property name="password" value="" />
</dataSource>
</environment>
</environments>
</configuration>
~~~
### 定义表所对应的实体类
如下图所示：
User 类的代码如下：
~~~
package com.ntqingniao.mybatis.entity;
/**
* users表所对应的实体表
* @author CUI
*/
public class User {
// 实体表的属性和表的字段名称一一对应
// 主键id
private int id;
// 名称
private String name;
// 年龄
private int age;
public int getId() {
return id;
}
public void setId(int id) {
this.id = id;
}
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
public int getAge() {
return age;
}
public void setAge(int age) {
this.age = age;
}
@Override
public String toString() {
return "User [id=" + id + ", name=" + name + ", age=" + age + "]";
}
}
~~~
### 定义操作 users 表的 sql 映射文件 userMapper.xml
创建一个 `com.ntqingniao.mybatis.mapping` 包，专门用于存放 sql 映射文件，在包中创建一个userMapper.xml 文件，如下图所示：
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的值是唯一的
例如namespace="com.ntqingniao.mybatis.mapping.userMapper"就是com.ntqingniao.mybatis.mapping(包名)+userMapper(userMapper.xml文件去除后缀) -->
<mapper namespace="com.ntqingniao.mybatis.mapping.userMapper">
<!-- 在select标签中编写查询的SQL语句， 设置select标签的id属性为getUser，id属性值必须是唯一的，不能够重复.使用parameterType属性指明查询时使用的参数类型，resultType属性指明查询返回的结果集类型
resultType="com.ntqingniao.mybatis.entity.User"就表示将查询结果封装成一个User类的对象返回 User类就是users表所对应的实体类 -->
<!-- 根据id查询得到一个user对象 -->
<select id="getUser" parameterType="int" resultType="com.ntqingniao.mybatis.entity.User">
select * from users where id=#{id}
</select>
</mapper>
~~~
### 在 conf.xml 文件中注册 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>
<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_test" />
<property name="username" value="root" />
<property name="password" value="" />
</dataSource>
</environment>
</environments>
<mappers>
<!-- 注册userMapper.xml文件， userMapper.xml位于com.ntqingniao.mybatis.mapping这个包下，所以resource写成com/ntqingniao/mybatis/mapping/userMapper.xml -->
<mapper resource="com/ntqingniao/mybatis/mapping/userMapper.xml" />
</mappers>
</configuration>
~~~
### 编写测试代码：执行定义的 select 语句
创建一个Test类，编写如下的测试代码：
~~~
package com.ntqingniao.mybatis.test;
import java.io.IOException;
import java.io.InputStream;
import java.io.Reader;
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.ntqingniao.mybatis.entity.User;
public class Test {
public static void main(String[] args) throws IOException {
// mybatis的配置文件
String resource = "conf.xml";
// 使用类加载器加载mybatis的配置文件（它也加载关联的映射文件）
InputStream is = Test.class.getClassLoader().getResourceAsStream(
resource);
// 构建sqlSession的工厂
SqlSessionFactory sessionFactory = new SqlSessionFactoryBuilder().build(is);
// 使用MyBatis提供的Resources类加载mybatis的配置文件（它也加载关联的映射文件）
//Reader reader = Resources.getResourceAsReader(resource);
// 构建sqlSession的工厂
//SqlSessionFactory sessionFactory = new SqlSessionFactoryBuilder().build(reader);
// 创建能执行映射文件中sql的sqlSession
SqlSession session = sessionFactory.openSession();
/**
* 映射sql的标识字符串， com.ntqingniao.mybatis.mapping.userMapper是userMapper.
* xml文件中mapper标签的namespace属性的值，
* getUser是select标签的id属性值，通过select标签的id属性值就可以找到要执行的SQL
*/
// 映射sql的标识字符串
String statement = "com.ntqingniao.mybatis.mapping.userMapper.getUser";
// 执行查询返回一个唯一user对象的sql
User user = session.selectOne(statement, 1);
System.out.println(user);
}
}
~~~
执行结果如下：
User [id=1, name=张三, age=28]
可以看到，数据库中的记录已经成功查询出来了。
