Mybatis基础-入门教程

平时我们都用JDBC访问数据库，除了需要自己写SQL之外，还必须操作Connection, Statment, ResultSet 这些其实只是手段的辅助类。 不仅如此，访问不同的表，还会写很多雷同的代码，显得繁琐和枯燥。 

那么用了Mybatis之后，只需要自己提供SQL语句，其他的工作，诸如建立连接，Statement， JDBC相关异常处理等等都交给Mybatis去做了，那些重复性的工作Mybatis也给做掉了，我们只需要关注在增删改查等操作层面上，而把技术细节都封装在了我们看不见的地方。 

必读： 基于框架的程序要成功运行，对于JAR包的版本，配置文件的正确性有着苛刻的要求，任何一个地方出错了，都会导致框架程序运行失败。

创建项目

通过ecipse创建java project: mybatis

项目目录必须是 e:\project\mybatis

因为后续的学习都是基于这个位置，所以请务必使用这个项目目录，有助于在使用本教程的过程中提高相当的学习效率。

用其他项目位置反而会带来不必要的困扰



导入jar包

本项目用到了两个jar包，lib.rar下载。

下载解压后，在项目目录e:/project/mybatis下新建目录lib,并复制过来

然后通过ecipse在mybatis的项目上导入这两个jar包



创建实体类

准备实体类Category，用于映射表category_

package com.how2java.pojo;

public class Category {
private int id;
private String name;
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;
}

}

配置文件mybatis-config.xml

在src目录下创建mybatis的主配置文件mybatis-config.xml (相当于hibernate.cfg.xml，如果没有hibernate基础请忽略本句)。

其作用主要是提供连接数据库用的驱动，数据库名称，编码方式，账号密码

<property name="driver" value="com.mysql.jdbc.Driver"/>
<property name="url" value="jdbc:mysql://localhost:3306/how2java?characterEncoding=UTF-8"/>
<property name="username" value="root"/>
<property name="password" value="admin"/>

以及别名，自动扫描com.how2java.pojo下的类型，使得在后续配置文件Category.xml中使用resultType的时候，可以直接使用Category,而不比写全com.how2java.pojo.Category

<typeAliases>
<package name="com.how2java.pojo"/>
</typeAliases>

映射Category.xml

<mappers>
<mapper resource="com/how2java/pojo/Category.xml"/>
</mappers>

<?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>
<typeAliases>
<package name="com.how2java.pojo"/>
</typeAliases>
<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/how2java?characterEncoding=UTF-8"/>
<property name="username" value="root"/>
<property name="password" value="admin"/>
</dataSource>
</environment>
</environments>
<mappers>
<mapper resource="com/how2java/pojo/Category.xml"/>
</mappers>
</configuration>

配置文件Category.xml

在包com.how2java.pojo下，新建文件Category.xml

namespace="com.how2java.pojo"

表示命名空间是com.how2java.pojo，在后续调用sql语句的时候，会用到它

里面定义了一条sql语句

select * from   category_

这条sql语句用id: listCategory 进行标示以供后续代码调用。resultType="Category" 表示返回的数据和Category关联起来，这里本应该使用的是 com.how2java.pojo.Category, 但是因为上一步配置了别名，所以直接使用Category就行了

<?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.how2java.pojo">
<select id="listCategory" resultType="Category">
select * from   category_
</select>
</mapper>

测试类TestMybatis

运行并观察到如图所示的结果。

根据配置文件mybatis-config.xml得到sqlSessionFactory 。

String resource = "mybatis-config.xml";
InputStream inputStream = Resources.getResourceAsStream(resource);
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);

然后再根据sqlSessionFactory 得到session

SqlSession session=sqlSessionFactory.openSession();

最后通过session的selectList方法，调用sql语句listCategory。listCategory这个就是在配置文件Category.xml中那条sql语句设置的id。

执行完毕之后，得到一个Category集合，遍历即可看到数据。

List<Category> cs = session.selectList("listCategory");
for (Category c : cs) {
System.out.println(c.getName());
}

注： session.selectList("listCategory"); 也可以写成 session.selectList("com.how2java.pojo.listCategory"); 效果一样。 但是我嫌弃其臃肿，不愿采用这种方式

package com.how2java;

import java.io.IOException;
import java.io.InputStream;
import java.util.List;

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.how2java.pojo.Category;

public class TestMybatis {

public static void main(String[] args) throws IOException {
String resource = "mybatis-config.xml";
InputStream inputStream = Resources.getResourceAsStream(resource);
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
SqlSession session=sqlSessionFactory.openSession();

List<Category> cs=session.selectList("listCategory");
for (Category c : cs) {
System.out.println(c.getName());
}

}
}

基本原理图

1. 应用程序找Mybatis要数据

2. mbatis从数据库中找来数据

2.1 通过mybatis-config.xml 定位哪个数据库

2.2 通过Category.xml执行对应的select语句

2.3 基于Catgory.xml把返回的数据库记录封装在Category对象中

2.4 把多个Category对象装在一个Category集合中

3. 返回一个Category集合