Mybatis快速入门

MyBatis简介

MyBatis 是一个优秀的基于 java 的 持久层框架，它内部封装了 jdbc，使开发者只需要关注 sql 语句本身，而不需要花费精力去处理加载驱动、创建连接、创建 statement 等繁杂的过程。
mybatis 通过 xml 或注解的方式将要执行的各种 statement 配置起来，并通过 java 对象和 statement 中
sql 的动态参数进行映射生成最终执行的 sql 语句，最后由 mybatis 框架执行 sql 并将结果映射为 java 对象并返回。
其采用 ORM（对象关系映射） 思想解决了实体和数据库映射的问题，对 jdbc 进行了封装，屏蔽了 jdbc api 底层访问细节，使我们不用与 jdbc api 打交道，就可以完成对数据库的持久化操作。

MyBatis基于xml的快速入门

----->项目源码

1.案例准备

• 数据准备

DROP TABLE IF EXISTS `user`;

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 
(1,'西施惠','2018-02-27 17:47:08','女','日本'),
(2,'小林','2018-03-02 15:09:37','男','南京'),
(3,'刘强东','2018-03-04 11:34:34','男','北京'),
(4,'奶茶妹妹','2018-03-04 12:04:06','女','北京'),
(5,'马化腾','2018-03-07 17:37:26','男','深圳'),
(6,'韦小宝','2018-03-08 11:44:00','男','苏州');

• 定义User实体类和持久层接口
  
  

2.引入依赖

要使用 MyBatis， 只需将 mybatis-x.x.x.jar 文件置于 classpath 中即可。

如果使用 Maven 来构建项目，则需将下面的 dependency 代码置于 pom.xml 文件中：

        <dependency>
            <groupId>org.mybatis</groupId>
            <artifactId>mybatis</artifactId>
            <version>3.4.5</version>
        </dependency>

由于要操作数据库，还需要添加mysql-connector-java：

       <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>5.1.6</version>
        </dependency>

3.编写全局配置文件

文件名任意：

本例中的配置：

<?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">

<!-- mybatis的主配置文件 -->
<configuration>
    <!-- 配置环境 -->
    <environments default="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/test1?useUnicode=true&amp;characterEncoding=utf8"/>
                <property name="username" value="root"/>
                <property name="password" value="root"/>
            </dataSource>
        </environment>
    </environments>

    <!-- 指定映射配置文件的位置，映射配置文件指的是每个dao独立的配置文件，这里写的是下面第4步的xml文件 -->
    <mappers>
        <mapper resource="com/zhu/dao/IUserDao.xml"/>
    </mappers>
</configuration>

4.编写持久层接口的映射文件

注意创建directory时必须一级一级创建。

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.itheima.dao.IUserDao">
    <!--配置查询所有的statement-->
    <select id="findAll" resultType="com.zhu.domain.User">
        select * from user
    </select>
</mapper>

namespace：命名空间，一般保证命名空间唯一
statement：sql语句
id：唯一标识，取值必须是dao接口的方法名
resultType：sql语句查询结果集的封装类型

注意事项：

• 此文件必须和持久层接口在相同的包中，且必须以持久层接口名称来命名文件名
• 在Mybatis中，持久层的操作接口名称和映射文件也叫Mapper
• Mybatis的映射文件位置必须和dao接口的包结构相同
• 映射配置文件的mapper标签namespace属性的取值必须是dao接口的全限定类名
• 映射配置文件的操作配置(select)，id属性的取值必须是dao接口的方法名

当我们遵从了以上的3、4、5点后，在开发中就无须再写dao的实现类。

5.编写测试类

先添加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

测试类：

/**
 * 入门案例测试
 */
public class MybatisTest {
    public static void main(String[] args) throws IOException {
        //1.读取配置文件
        InputStream in = Resources.getResourceAsStream("mybatis-config.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();
    }
}

运行结果：

目录结构：

案例分析：

MyBatis基于注解的快速入门

----->项目源码
在上文案例的基础上，把IUserDao.xml移除，在dao接口的方法上使用@Select注解，并且指定SQL语句。

/**
 * 用户的持久层接口
 */
public interface IUserDao {

    /**
     * 查询所有操作
     * @return
     */
    @Select("select * from user")
    List<User> findAll();
}

同时在主配置文件中的mapper配置，使用class属性指定dao接口的全限定类名。

    <mappers>
        <mapper class="com.zhu.dao.IUserDao"/>
    </mappers>

运行测试类，得到了和上文使用xml配置相同的结果。由于少写了一个xml，因此注解配置的方式还是十分便捷的。

至此Mybatis快速入门已经完成。
下一篇：自定义Mybatis框架，通过自己定义一个Mybatis框架，来了解框架执行的具体流程。