一步步学Mybatis-搭建最简单的开发环境-开篇（1）

时间 2019-11-16

原文原文链接

　　最近抽空学习了Mybatis这个框架，在学习的过程当中也找了不少的文章，我的感受官网上的东西太多太杂，不适合许多但愿一步步快速上手的朋友们，固然以为查阅问题的时候能够直接经过官网找还比较快或者是StackOverflow，鉴于此缘由把本身想把本身学习过程当中的经验留做笔记以供分享参考之用，尽可能少绕弯路。由于想直接了解Mybatis的使用方式，而网上有许多学习文章是Mybatis与Spring的结合范例，或者说直接在Web Project项目下创立的范例，感受对于只是纯粹想了解那个东西怎么使用的朋友应该不须要那么多附加的条件，因此本系列中直接用最简单的Java Project做范例演示。html

　　什么是Mybatis，前身iBatis（我的没用过，因此没什么发言权），引述官网的原意来讲，Mybatis是支持普通SQL查询，能够更简单直接的操做SQL，存储过程和高级映射的一种优秀的持久层框架，使用它基本能够消除全部的JDBC大麦和参数的手工设置以及结果集的检索，其实我的使用下来感受，其实主要工做都是在配置XML或者注解上，而后将接口和Java的POJO（普通Java对象映射成数据库的记录），我的没用过Java的Hb，因此对于二者之间的差别性也没权限发表意见，我相信各个事物的产生总有它本身的目的。java

　　这段时间学习下来，其实对Mybatis来讲主要的过程没法是如下几步mysql

　　1. 从XML配置文件中获取SessionFactory，而后由SessionFactory产生相应的Session。git

　　2. 是用Session对象对业务数据完成相应的CRUD操做（增删改查）和相应的事务控制。github

　　3. 使用完毕后关闭相应的Session，以避免过分占用资源sql

　　4. 使用配置相应的Mapper xml文件进行业务实体的JavaBean与数据库表之间作相应的Map操做数据库

战前准备：apache

　　1. 开发环境Eclipse JavaEE IDE，JDK 1.6，数据库mysql 5.5session

　　2. 下载相应Jar包，以备后用mybatis

　　　　mybatis-3.2.3.zip 解压后拿出 mybatis-3.2.3.jar，=> 下载地址： http://code.google.com/p/mybatis/ （Mybatis核心包）

　　　　mybatis-generator-core-1.3.1.jar => 下载地址： http://code.google.com/p/mybatis/wiki/Generator （Mybatis自动生成配置文件包）

　　　　mysql-connector-java-5.1.26-bin.jar => 下载地址：http://dev.mysql.com/downloads/connector/j/ （Mysql 的jdbc驱动包）

　　接下来你们能够再Eclipse下面建一个名为MybatisDemo的Java Project项目，按照以下图中所示新建相应的包结构和文件夹结构，其中config与mapper分别为文件夹，

　　包david.mybatis.demo与包david.mybatis.model下分别存放相应的demo运行程序与Javabean对象，lib文件夹下存放刚刚下载的那几个第三方jar包。

　　建完下面的目录，咱们能够添加相应的Jar包，以下图

　　完成后，执行下面SQL，创建DEMO所需的表结构，分别有3张表，Visitor（访问者表），Website（网站表），Channel（频道表）

/*建立Visitor*/
CREATE TABLE Visitor
(
    Id INT(11) NOT NULL AUTO_INCREMENT,
    Name VARCHAR(1000) NOT NULL,
    Email VARCHAR(1000) NOT NULL,
    Status INT NOT NULL DEFAULT 1,
    CreateTime DateTime,
    PRIMARY KEY(Id)
)
/*建立网站表*/
CREATE TABLE Website
(
    Id INT NOT NULL PRIMARY KEY AUTO_INCREMENT,
    Name VARCHAR(1000) NOT NULL,
    VisitorId INT REFERENCES Visitor(Id),
    Status INT NOT NULL DEFAULT 1,
    CreateTime DateTime
)

/*建立频道表*/
CREATE TABLE Channel
(
    Id INT NOT NULL PRIMARY KEY AUTO_INCREMENT,
    Name VARCHAR(1000) NOT NULL,
    WebsiteId INT REFERENCES Website(Id),
    Status INT NOT NULL DEFAULT 1,
    CreateTime DateTime
)

建表SQL

全部这些都完成后，咱们就要开始动手啦~

就像开头说的，Mybatis的全部配置都源于一份XML配置文件，咱们须要在config文件夹下，新建名为mybatis_demo_config.xml的配置文件，这一份东西就是咱们后面所须要操做的核心之一。

在配置这个文件千万要注意<configuration>节点内的元素都是有层级顺序的要求的，不可以随意更换次序，不然在加载xml配置文件的时候会出现异常而致使后续操做不成功。

具体的节点说明你们能够查看http://mybatis.github.io/mybatis-3/zh/configuration.html#，这里只说比较经常使用的节点，typeAliases，environments，mappers。

1. typeAliases => 别名节点，能够经过设置这个节点的属性，这样配置文件中其余须要实体名字的地方均可以使用此别名而不是彻底限定名

例如 <typeAlias type="david.mybatis.model.Visitor" alias="Visitor" />

2. environments => 环境节点，配置数据链接相关的信息

3. mappers => 配置SQL映射语句。

最简单的配置以下：

<?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>
        <typeAlias type="david.mybatis.model.Visitor" alias="Visitor" />
    </typeAliases>
    <environments default="development">
        <environment id="development">
            <transactionManager type="JDBC"></transactionManager>
            <dataSource type="POOLED">
                <property name="driver" value="com.mysql.jdbc.Driver" />
                <!-- ?useUnicode=true&amp;characterEncoding=utf8为了支持中文插入 -->
                <property name="url"
                    value="jdbc:mysql://127.0.0.1:3306/mybatis_db?useUnicode=true&amp;characterEncoding=utf8" />
                <property name="username" value="root" />
                <property name="password" value="123456" />
            </dataSource>
        </environment>
    </environments>
    <mappers>
        <mapper resource="mapper/VisitorMapper.xml" />
    </mappers>
</configuration>

XML配置

在包david.mybatis.demo下面新建一个名为MyBatisUtils类，里面存放获取SqlSession与关闭SqlSession的方法，提炼出来方便屡次复用。

package david.mybatis.demo;

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 david.mybatis.model.CRUD_Enum;

public class MybatisUtils {

    private static final String CONFIG_PATH = "config/mybatis_demo_config.xml";

    /*
     * 获取数据库访问连接
     */
    public static SqlSession getSqlSession() {
        SqlSession session = null;
        try {
            InputStream stream = Resources.getResourceAsStream(CONFIG_PATH);
            //能够根据配置的相应环境读取相应的数据库环境
            // SqlSessionFactory factory = new SqlSessionFactoryBuilder().build(
            // stream, "development"); 
            SqlSessionFactory factory = new SqlSessionFactoryBuilder()
                    .build(stream);
            session = factory.openSession();
        } catch (Exception e) {
            // TODO: handle exception
            e.printStackTrace();
        }
        return session;
    }

    /*
     * 获取数据库访问连接
     */
    public static void closeSession(SqlSession session) {
        session.close();
    }
    
    /*
     * 返回操做记录消息
     */
    public static void showMessages(CRUD_Enum type, int count) {
        switch (type) {
        case Add:
            System.out.println("添加了" + count + "条记录。");
            break;
        case Delete:
            System.out.println("删除了" + count + "条记录。");
            break;
        case Update:
            System.out.println("更新了" + count + "条记录。");
            break;
        case Query:
            System.out.println("匹配了" + count + "条记录。");
            break;
        case List:
            System.out.println("共有" + count + "条记录。");
            break;
        default:
            break;
        }
    }
}

MybatisUtils工具类

在包david.mybatis.model下面新建一个名为Visitor的类，用来做相应的OR Mapping。

package david.mybatis.model;

import java.text.SimpleDateFormat;
import java.util.Date;

public class Visitor {
    private int id;
    private String name;
    private String email;
    private int status;
    private Date createTime;

    public Visitor() {
        // TODO Auto-generated constructor stub
        createTime = new Date();
    }

    public Visitor(String name, String email) {
        this.name = name;
        this.email = email;
        this.status = 1;
        this.createTime = new Date();
    }

    public int getId() {
        return id;
    }

    public void setName(String name) {
        this.name = name;
    }

    public String getName() {
        return name;
    }

    public void setEmail(String email) {
        this.email = email;
    }

    public String getEmail() {
        return email;
    }

    public Date getCreateTime() {
        return createTime;
    }

    @Override
    public String toString() {
        // TODO Auto-generated method stub
        return String.format("{Id: %d, Name: %s, CreateTime: %s}", id, name,
                new SimpleDateFormat("yyyy-MM-dd HH:mm:ss").format(createTime));
    }
}

Visitor类

在包david.mybatis.demo下面新建一个VisitorMapper.xml，用来映射相应SQL语句。

这里要注意namespace=>david.mybatis.demo.IVisitorOperation必定要与对应这个包下面的实际文件名，IVisitorOperation不然没法成功加载相应的映射文件

<mapper namespace="david.mybatis.demo.IVisitorOperation">
    <select id="basicQuery" parameterType="int" resultType="Visitor">
        select * from visitor where id=#{id} and
        Status>0 order by Id
    </select>
</mapper>

IVisitorOperation接口

接下来运行下面的程序

    public static void testBasicQuery(int id) {
        SqlSession session = MybatisUtils.getSqlSession();
        try {
            Visitor visitor = (Visitor) session.selectOne("david.mybatis.demo.IVisitorOperation.basicQuery", id);
            MybatisUtils.closeSession(session);
            System.out.println(visitor);
        } catch (Exception e) {
            // TODO: handle exception
        }
    }

基础查询

一个最简单的执行结果就出来啦

这算是Mybatis系列的HelloWord，下回会讲述关于使用接口的方式进行相应操做。