Mybatis开发包：https://github.com/mybatis/mybatis-3/releases

搭建Mybatis开发环境

1、创建Maven工程

创建 mybatis01 的工程，工程信息如下：

Groupid:com.coydone
ArtifactId:mybatis01
Packing:jar

此时pom.xml文件是：

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.coydone</groupId>
    <artifactId>mybatis01</artifactId>
    <version>1.0-SNAPSHOT</version>

    <packaging>jar</packaging>
</project>

2、数据库准备

CREATE DATABASE eesy_mybatis;
USE eesy_mybatis;
CREATE TABLE `user` (
    `id` INT(11) NOT NULL AUTO_INCREMENT,
    `username` VARCHAR(32) NOT NULL COMMENT '用户名称',
    `birthday` DATETIME DEFAULT NULL COMMENT '生日',
    `sex` CHAR(1) DEFAULT NULL COMMENT '性别',
    `address` VARCHAR(256) DEFAULT NULL COMMENT '地址',
    PRIMARY KEY  (`id`)
) ENGINE=INNODB DEFAULT CHARSET=utf8;

INSERT  INTO `user`(`id`,`username`,`birthday`,`sex`,`address`) VALUES (41,'老王','2018-02-27 17:47:08','男','北京'),(42,'小二王','2018-03-02 15:09:37','女','北京金燕龙'),(43,'小二王','2018-03-04 11:34:34','女','北京金燕龙'),(45,'小二','2018-03-04 12:04:06','男','北京金燕龙'),(46,'老王','2018-03-07 17:37:26','男','北京'),(48,'小马宝莉','2018-03-08 11:44:00','女','北京修正');

Mybatis入门案例

入门案例工程结构

1、添加日志文件

在配置文件resources目录下新建 log4j.properties 。内容如下：

# Set root category priority to INFO and its only appender to CONSOLE.
#log4j.rootCategory=INFO, CONSOLE            debug   info   warn error fatal
log4j.rootCategory=debug, CONSOLE, LOGFILE

# Set the enterprise logger category to FATAL and its only appender to CONSOLE.
log4j.logger.org.apache.axis.enterprise=FATAL, CONSOLE

# CONSOLE is set to be a ConsoleAppender using a PatternLayout.
log4j.appender.CONSOLE=org.apache.log4j.ConsoleAppender
log4j.appender.CONSOLE.layout=org.apache.log4j.PatternLayout
log4j.appender.CONSOLE.layout.ConversionPattern=%d{ISO8601} %-6r [%15.15t] %-5p %30.30c %x - %m\n

# LOGFILE is set to be a File appender using a PatternLayout.
log4j.appender.LOGFILE=org.apache.log4j.FileAppender
log4j.appender.LOGFILE.File=d:\axis.log
log4j.appender.LOGFILE.Append=true
log4j.appender.LOGFILE.layout=org.apache.log4j.PatternLayout
log4j.appender.LOGFILE.layout.ConversionPattern=%d{ISO8601} %-6r [%15.15t] %-5p %30.30c %x - %m\n

2、添加Mybatis的依赖

在 pom.xml 文件中添加 Mybatis3.4.5 的依赖，如下：

<dependencies>
    <dependency>
        <groupId>org.mybatis</groupId>
        <artifactId>mybatis</artifactId>
        <version>3.4.5</version>
    </dependency>
    <dependency>
        <groupId>junit</groupId>
        <artifactId>junit</artifactId>
        <version>4.10</version>
        <scope>test</scope>
    </dependency>
    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <version>5.1.6</version>
        <scope>runtime</scope>
    </dependency>
    <dependency>
        <groupId>log4j</groupId>
        <artifactId>log4j</artifactId>
        <version>1.2.12</version>
    </dependency>
</dependencies>

<!--为了让Mawen工程打包将java代码中的xml文件打包，需要如下配置-->
<build>
    <!--配置相关的资源进行打包-->
    <resources>
        <resource>
            <directory>src/main/java</directory>
            <includes>
                <include>**/*.xml</include>
            </includes>
        </resource>
        <resource>
            <directory>src/main/resources</directory>
            <includes>
                <include>**/*.xml</include>
            </includes>
        </resource>
    </resources>
</build>

其中包括Mybatis、Mysql连接、Junit单元测试、Log4j日志。

3、编写User实体类

package com.coydone.domain;
import java.io.Serializable;
import java.util.Date;
public class User implements Serializable {
    private Integer id;
    private String username;
    private Date birthday;
    private String sex;
    private String address;
    //get() set()方法
    //toString() 方法
}

4、编写持久层接口IUserDao

package com.coydone.dao;
import com.coydone.domain.User;
import java.util.List;
public interface IUserDao {
    List<User> findAll();
}

5、编写持久层接口的映射文件IUserDao.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.coydone.dao.IUserDao">
    <!--配置查询所有-->
    <select id="findAll" resultType="com.coydone.domain.User">
        select * from user ;
    </select>
</mapper>

6、编写SqlMapConfig.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="mysql">
        <!--配置mysql的环境-->
        <environment id="mysql">
            <!--配置事务的类型-->
            <transactionManager type="JDBC"></transactionManager>
            <!--配置数据源（连接池）-->
            <dataSource type="POOLED">
                <!--配置连接数据库的4个基本信息-->
                <property name="driver" value="com.mysql.jdbc.Driver"/>
                <property name="url" value="jdbc:mysql://localhost:3306/eesy_mybatis"/>
                <property name="username" value="root"/>
                <property name="password" value="root123"/>
            </dataSource>
        </environment>
    </environments>

    <!--指定映射配置文件的位置，映射配置文件指的是每个dao独立的配置文件-->
    <mappers>
        <mapper resource="com/coydone/dao/IUserDao.xml" />
    </mappers>
</configuration>

7、编写测试类

package com.coydone.test;

import com.coydone.dao.IUserDao;
import com.coydone.domain.User;
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 java.io.InputStream;
import java.util.List;

public class MybatisTest {
    public static void main(String[] args) throws Exception{
        //1.读取配置文件
        InputStream in = Resources.getResourceAsStream("SqlMapConfig.xml");
        //2.创建SQLSessionFactory工厂
        SqlSessionFactoryBuilder builder = new SqlSessionFactoryBuilder();
        SqlSessionFactory factory = builder.build(in);
        //3.使用工厂生产SQLSession对象
        SqlSession session = factory.openSession();
        //4.使用SQLSession创建Dao接口的代理对象
        IUserDao userDao = session.getMapper(IUserDao.class);
        //5.使用代理对象执行方法
        List<User> users = userDao.findAll();
        for (User user : users) {
            System.out.println(user);
        }
        //6.释放资源
        session.close();
        in.close();
    }
}

8、测试效果

补充（基于注解的Mybatis使用）

在此前的基础上，我们无需在resources下，在创建com.coydone.dao包下创建的IUserDao.xml文件。

在package com.coydone.dao下的接口IUserDao中加入Select注解。

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

再将SqlMapConfig.xml 配置文件中的mapper映射改为class。

<!--指定映射配置文件的位置，映射配置文件指的是每个dao独立的配置文件
     如果是用注解来配置的话，此处应该使用class属性指定被注解的dao全限定类名
     -->
<mappers>
    <mapper class="com.coydone.dao.IUserDao" />
</mappers>

总结

Mybatis的入门

创建maven工程并导入依赖坐标。
创建实体类和dao的接口。
创建Mybatis的主配置文件 SqlMapConifg.xml。
创建映射配置文件 IUserDao.xml。

环境搭建的注意事项：

创建IUserDao.xml 和 IUserDao.java时名称是为了和我们之前的知识保持一致。在Mybatis中它把持久层的操作接口名称和映射文件也叫做：Mapper 所以：IUserDao 和 IUserMapper是一样的。
在idea中创建目录的时候，它和包是不一样的包在创建时：com.coydone.dao它是三级结构目录在创建时：com.coydone.dao是一级目录。
Mybatis的映射配置文件位置必须和dao接口的包结构相同。
映射配置文件的mapper标签namespace属性的取值必须是dao接口的全限定类名。
映射配置文件的操作配置（select），id属性的取值必须是dao接口的方法名。

当我们遵从了第三，四，五点之后，我们在开发中就无须再写dao的实现类。

注意事项：

不要忘记在映射配置中告知Mybatis要封装到哪个实体类中。
配置的方式：指定实体类的全限定类名。

Mybatis基于注解的入门案例：

把IUserDao.xml移除，在dao接口的方法上使用@Select注解，并且指定SQL语句。同时需要在SqlMapConfig.xml中的mapper配置时，使用class属性指定dao接口的全限定类名。

**明确：**我们在实际开发中，都是越简便越好，所以都是采用不写dao实现类的方式。不管使用XML还是注解配置。但是Mybatis它是支持写dao实现类的。

演示写dao实现类的方式使用Mybatis

在此前xml实现的基础上，在dao层添加impl包，在impl包下创建UserDaoImpl.java

public class UserDaoImpl implements IUserDao {
    private SqlSessionFactory factory;
    public UserDaoImpl(SqlSessionFactory  factory){
        this.factory = factory;
    }
    public List<User> findAll(){
        //1.使用工厂创建SqlSession对象
        SqlSession session = factory.openSession();
        //2.使用session执行查询所有方法
        //参数：namespace.id ,获得mapper.xml中的sql语句
        List<User> users = session.selectList("com.coydone.dao.IUserDao.findAll");
        session.close();
        //3.返回查询结果
        return users;
    }
}

修改测试类即可

public class MybatisTest {
    public static void main(String[] args)throws Exception {
        //1.读取配置文件
        InputStream in = Resources.getResourceAsStream("SqlMapConfig.xml");
        //2.创建SqlSessionFactory工厂
        SqlSessionFactoryBuilder builder = new SqlSessionFactoryBuilder();
        SqlSessionFactory factory = builder.build(in);
        //3.使用工厂创建dao对象
        IUserDao userDao = new UserDaoImpl(factory);
        //4.使用代理对象执行方法
        List<User> users = userDao.findAll();
        for(User user : users){
            System.out.println(user);
        }
        //5.释放资源
        in.close();
    }
}

SqlSession对象

Sqlsession对应着一次数据库会话。由于数据库回话不是永久的，因此Sqlsession的生命周期也不应该是永久的，相反，在你每次访问数据库时都需要创建它（当然并不是说在Sqlsession里只能执行一次sql，你可以执行多次，当一旦关闭了Sqlsession就需要重新创建它）。创建Sqlsession的地方只有一个，那就是SqlsessionFactory的openSession方法。

常用方法：

//SqlSession接口 的源码
public interface SqlSession extends Closeable {
    //查询多条记录，返回list集合
    //List<User> users = session.selectList("com.coydone.dao.IUserDao.findAll");
    <E> List<E> selectList(String var1);

    //查询单条记录，返回映射的对象
    //User user = sqlSession.selectOne("com.coydone.dao.IUserDao.findAll.findById", id);
    <T> T selectOne(String var1, Object var2);

    //添加记录，返回条数
    int insert(String var1);
    int insert(String var1, Object var2);

    //修改记录，返回条数
    int update(String var1, Object var2);

    //删除记录，返回条数
    int delete(String var1);
    int delete(String var1, Object var2);

    //提交事务
    void commit();
    void commit(boolean var1);
    //回滚事务
    void rollback();
    void rollback(boolean var1);

    //关闭连接
    void close();
}

SqlSession调用持久化操作的方法

添加方法：sqlSession.insert(“添加持久化操作”[,参数对象])
修改方法：sqlSession.update(“修改持久化操作”[,参数对象])
删除方法：sqlSession.delete(“删除持久化操作”[,参数对象])
查询单条：sqlSession.selectOne(“查询的持久化操作” [,参数对象]);
查询：sqlSession.selectList(“查询的持久化操作” [,参数对象]);

如果执行添加，修改，删除操作时，Mybatis需要基于事务执行（需要提交或者回滚），即需要在sqlSession调用持久化操作的方法后调用sqlSession.commit()提交事务。

目录CONTENT

Mybatis入门