从零开始搭建Mybatis框架-蒲公英云

Mybatis是一个基于java的持久型框架，有了Mybatis，终于可以不用写jdbc代码这种东西了，写个搭建Mybatis框架过程，就当做个笔记吧。

（一）新建一个web项目，起好项目名之后一路next，finish。下面是项目建好后的工程目录(图中用的Eclipse工具，项目名FirstMybatis)

70 1

（二）加入Mybatis框架需要的jar包，我这里添加了4个，分别是：

jstl-1.2.jar //jstl标准标签库，后面使用jsp页面来显示数据

log4j-1.2.17.jar //日志包

mybatis-3.2.0.jar //Mybatis的jar包，必须加入上面log4j-1.2.17.jar这个jar包，否则会报错，Mybatis更高的版本可能不用

mysql-connector-5.1.8.jar //mysql驱动包，要连接mysql数据库必须加入

把上面的jar包放WebContent/WEB-INF/lib下添加依赖

为了便于管理，我在src下新建了5个包，包名可以自己定义

这里的Controller包用来存放控制器类，Service包用来处理业务，Pojo包存放实体类，Mapper包作为数据访问层，Utils包作为工具包

在src目录下再新建一个mybatis-config.xml文件，用来配置Mybatis的各种配置

下面贴图

70 2

（三）下面就是mybatis的各种配置了

打开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即环境 -->
    <!-- 为了方便数据库配置，使用多种配置environment时，可以通过environments中的default
    来声明默认使用哪种配置 -->
  <environments default="mysql">
    <environment id="mysql">
      <transactionManager type="JDBC"/>
      <!-- pooled即池，配置连接池 -->
      <dataSource type="POOLED">
          <!-- 配置驱动 -->
        <property name="driver" value="com.mysql.jdbc.Driver"/>
        <!-- 配置连接地址 -->
        <property name="url" value="jdbc:mysql://localhost:3306/test"/>
        <!-- 配置数据库用户名 -->
        <property name="username" value="root"/>
        <!-- 配置数据库密码 -->
        <property name="password" value="123456"/>
      </dataSource>
    </environment>
  </environments>
  <!-- 关联配置映射文件 -->
  <mappers>
      <!-- 包扫描关联映射文件 -->
      <package name="Mapper"/>
  </mappers>
</configuration>

配置文件中的连接地址、用户名、密码改成自己的

其中的标签用来关联映射文件，因为要在Mapper包下建立映射文件来进行数据操作，所以要关联的映射文件就直接写上这个包名就可以了，它会自动扫描这个包下所有的用到Mybatis的文件。

配置文件已经完成了，对于上面的配置，还可以用另一种方式配置

如果觉得麻烦的话可以忽略下面内容，直接跳到（四）

在src目录下建个后缀为properties的文件，比如我新建一个db.properties

70 3

db.properties文件中写你的配置参数

比如我的数据库配置参数

driver=com.mysql.jdbc.Driver
url=jdbc:mysql://localhost:3306/hibernatedb
username=root
password=123456

然后在mybatis-config.xml文件的标签中加入这句代码

<!-- 加载全局配置文件 -->
    <properties resource="db.properties"></properties>

申明db.properties文件作为全局配置

配置完成后我们就可以用${driver}（表示db.properties中driver对应的值）来配置数据库了

例如可以将上面的数据库配置写成下面这样

<environments default="mysql">
    <environment id="mysql">
      <transactionManager type="JDBC"/>
      <!-- pooled即池，配置连接池 -->
      <dataSource type="POOLED">
          <!-- 配置驱动 -->
        <property name="driver" value="${driver}"/>
        <!-- 配置连接地址 -->
        <property name="url" value="${url}"/>
        <!-- 配置数据库用户名 -->
        <property name="username" value="${username}"/>
        <!-- 配置数据库密码 -->
        <property name="password" value="${password}"/>
      </dataSource>
    </environment>
 </environment>

这样，在数据库配置参数有所变动时，也可以直接在db.properties中修改

（四）然后再来写个工具类，用来获取SqlSession的连接工厂

在Utils包下新建一个SqlSessionFactoryUtils.class，名字自定义

代码如下

public class SqlSessionFactoryUtils {
    //定义一个变量保存mybatis框架的连接工厂
    private static SqlSessionFactory sqlSessionFactory;
    //初始化连接工厂
    //静态代码块，与类一起加载，访问类的时候与类一起加载
    //读取配置文件来做Mybatis连接工厂
    static {
        try {
            String resource = "mybatis-config.xml";
            //读取配置文件，自动到src类路径下寻找配置文件
            InputStream inputStream = Resources.getResourceAsStream(resource);
            //将inputStream转换成Mybatis的连接工厂
            sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
        } catch (Exception e) {
            // TODO Auto-generated catch block
            e.printStackTrace();
        }
    }
    //定义一个获取连接的方法
    public static SqlSession getSqlSession()
    {
        return sqlSessionFactory.openSession();
    }
    //释放连接，关闭资源
    public static void close(SqlSession sqlSession)
    {
        if(sqlSession!=null)sqlSession.close();
    }
}

（五）…一大堆配置完成了，后面是具体的使用

首先在Pojo中新建一个User类，保存用户信息，这里示范的数据库名为test，有一张user表，id,name,address三个字段

User类用来存放从user表中取出来的数据，字段必须对应

public class User {
    int id;
    String name;
    String password;
    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 String getPassword() {
        return password;
    }
    public void setPassword(String password) {
        this.password = password;
    }
}

在Mapper包下面新建一个接口类UserMapper.java(必须在Mapper包下，之前配置文件中配置扫描此包，不写在这里是找不到这个文件的)

在接口类中写一个用来查询数据的方法

为这个方法加上注解（@Select注解：执行查询操作，写入查询的sql语句）

public interface UserMapper {
    @Select("select * from user")
    public List<User> findAll();
}

（六）在Service包下新建一个UserService.java作为用户的业务处理类

public class UserService {
    public List<User> findAll()
    {
        //从sqlSession工具类中获取SqlSession
        SqlSession sqlSession = SqlSessionFactoryUtils.getSqlSession();
        //从sqlSession中获取映射文件
        UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
        //调用userMapper中的findAll方法，执行查询语句，并返回一个List<User>数据
        return userMapper.findAll();
    }
}

终于到最后一部分了…

接下来要新建一个控制器，再调用UserService业务类中的finAll方法，拿到数据，再绑到jsp页面中显示

先到Controller包下建一个servlet控制器，比如我这里叫UserController.java

在Get方法中调用UserService中的findAll方法，获得返回的数据，跳转到jsp页面展示数据

@WebServlet("/UserController")
public class UserController extends HttpServlet {
    private static final long serialVersionUID = 1L;
    /**
     * @see HttpServlet#HttpServlet()
     */
    public UserController() {
        super();
        // TODO Auto-generated constructor stub
    }
    /**
     * @see HttpServlet#doGet(HttpServletRequest request, HttpServletResponse response)
     */
    protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        // TODO Auto-generated method stub
        UserService userService = new UserService();
        //获取返回的数据
        request.setAttribute("users", userService.findAll());
        //跳转页面显示
        request.getRequestDispatcher("/WEB-INF/jsp/user.jsp").forward(request, response);
    }
    /**
     * @see HttpServlet#doPost(HttpServletRequest request, HttpServletResponse response)
     */
    protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        // TODO Auto-generated method stub
        doGet(request, response);
    }
}

在WEB-INF目录下新建个jsp文件夹，在其中建立个user.jsp文件

把请求的数据绑定到jsp页面上

<%@ page language="java" contentType="text/html; charset=UTF-8"
    pageEncoding="UTF-8"%>
<!-- 这里要用到jstl标签库中的标签，必须加上下面这行代码 -->
<%@ taglib uri="http://java.sun.com/jsp/jstl/core" prefix="c" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Insert title here</title>
</head>
<body>
<table>
<!-- 使用forEach标签循环绑定数据 -->
<c:forEach items="${users}" var="user">
<tr>
<td>${user.id}</td>
<td>${user.name}</td>
<td>${user.address}</td>
</tr>
</c:forEach>
</table>
</body>
</html>