Mybatis框架（一）

一、框架的概述

1. MyBatis框架的概述

1. MyBatis是一个优秀的基于Java的持久层框架，内部对JDBC做了封装，使开发者只需要关注SQL语句，而不用关注JDBC的代码，使开发变得更加的简单。
2. MyBatis通过XML或者注解的方式将要执行的各种Statement对象配置起来，通过Java对象和statement中SQL的动态参数进行映射，并最终执行SQL语句。执行SQL后，最终将结果已Java对象返回。
3. 采用了ORM的思想。ORM（Object-Relational Mapping）思想是一种程序技术，用于实现面向对象编程语言里不同类型系统的数据之间的转换。它旨在建立领域模型（也称为实体对象，例如 POJO）和数据库表之间的映射，并对实体对象的操作进行跟踪和转换。通过ORM，我们可以将数据库中的记录映射为程序中的对象，反之亦然，从而使得程序可以直接使用数据库中的数据，而不需要编写大量的SQL语句。ORM思想的出现大大简化了数据访问的复杂性，提高了开发效率，同时也降低了代码的复杂度。

二、MyBatis的入门程序

1. 创建数据库和表结构

create database mybatis_db;
use mybatis_db;
​
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','男','广州');

2. MyBatis的入门步骤

1. 创建maven的项目，创建Java工程即可。
2. 引入坐标
   1. 引入MyBatis的3.4.5的版本的坐标
   2. 引入MySQL驱动的jar包，5.1.6版本
   3. 引入Junit单元测试的jar包
   4. 引入log4j的jar包，1.2.12版本（需要引入log4j.properties的配置文件）

  <dependencies>
        <!--mybatis核心包-->
        <dependency>
            <groupId>org.mybatis</groupId>
            <artifactId>mybatis</artifactId>
            <version>3.4.5</version>
        </dependency>
        <!--mysql驱动包-->
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>5.1.6</version>
        </dependency>
        <!-- 单元测试 -->
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.10</version>
            <scope>test</scope>
        </dependency>
        <!-- 日志 -->
        <dependency>
            <groupId>log4j</groupId>
            <artifactId>log4j</artifactId>
            <version>1.2.17</version>
        </dependency>
    </dependencies>

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

# 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

 3.编写User的实现类，属性尽量使用包装类型，具体的代码如下

package com.qcby.domain;
import java.io.Serializable;
import java.util.Date;

public class User implements Serializable {
    private static final long serialVersionUID = 525400707336671154L;
    private Integer id;
    private String username;
    private Date birthday;
    private String sex;
    private String address;

    public Integer getId() {
        return id;
    }
    public void setId(Integer id) {
        this.id = id;
    }
    public String getUsername() {
        return username;
    }
    public void setUsername(String username) {
        this.username = username;
    }
    public Date getBirthday() {
        return birthday;
    }
    public void setBirthday(Date birthday) {
        this.birthday = birthday;
    }
    public String getSex() {
        return sex;
    }
    public void setSex(String sex) {
        this.sex = sex;
    }
    public String getAddress() {
        return address;
    }
    public void setAddress(String address) {
        this.address = address;
    }
    @Override
    public String toString() {
        return "User{" +
                "id=" + id +
                ", username='" + username + '\'' +
                ", birthday=" + birthday +
                ", sex='" + sex + '\'' +
                ", address='" + address + '\'' +
                '}';
    }
}
 

 4.编写UserMapper的接口和方法（相当于UserDao接口）

package com.qcby.mapper;
import com.qcby.domain.User;
import java.util.List;

public interface UserMapper {
    /**
     * 查询所有的用户
     * @return
     */
    public List<User> findAll();
}

 5.在resources目录下，创建mappers文件夹。编写UserMapper.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.qcby.mapper.UserMapper">
    <select id="findAll" resultType="com.qcby.domain.User">
        select * from user;
    </select>
</mapper>

• 1. mapper namespace="com.qcbyjy.mapper.UserMapper"，叫名称空间，表明以后查找UserMapper接口中的findAll的方法。
  2. select id="findAll"中的id属性编写的UserMapper接口中的方法的名称，固定的。
  3. resultType="com.qcbyjy.domain.User"表明的是findAll方法的返回值类型。

 6.编写主配置文件，在resources目录下创建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">
        <!-- 配置具体的环境 -->
        <environment id="mysql">
            <!-- 配置事务管理类型 -->
            <transactionManager type="JDBC"/>
            <!-- 配置是否需要使用连接池，POOLED使用，UNPOOLED不使用 -->
            <dataSource type="POOLED">
                <property name="driver" value="com.mysql.jdbc.Driver"/>
                <property name="url" value="jdbc:mysql:///mybatis_db?useUnicode=true&amp;characterEncoding=UTF-8"/>
                <property name="username" value="root"/>
                <property name="password" value="123456"/>
            </dataSource>
        </environment>
    </environments>

    <!-- 加载映射的配置文件 -->
    <mappers>
        <mapper resource="mappers/UserMapper.xml"/>
    </mappers>
</configuration>

 7.编写测试方法

package com.qcby.test;
import com.qcby.domain.User;
import com.qcby.mapper.UserMapper;
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 org.junit.Test;
import java.io.InputStream;
import java.util.List;

public class UserTest {
    /**
     * 测试查询所有的方法
     * @throws Exception
     */
    @Test
    public void testFindAll() throws Exception {
        // 加载主配置文件，目的是构建SqlSessionFactory的对象
        InputStream in = Resources.getResourceAsStream("SqlMapConfig.xml");
        // 创建SqlSessionFactory对象
        SqlSessionFactory factory = new SqlSessionFactoryBuilder().build(in);
        // 使用SqlSessionFactory工厂对象创建SqlSession对象
        SqlSession session = factory.openSession();
        // 通过session创建UserMapper接口的代理对象
        UserMapper mapper = session.getMapper(UserMapper.class);
//        // 调用查询所有的方法
//        List<User> list = mapper.findAll();
//        // 遍历集合
//        for (User user : list) {
//            System.out.println(user);
//        }
//        //根据id查询
//        User user = mapper.findById(1);
//        System.out.println(user);
        //插入数据
        User user = new User();
        user.setUsername("美美");
        user.setBirthday(new Date());
        user.setSex("男");
        user.setAddress("顺义");
        mapper.insert(user);
        session.commit();
        // 释放资源
        session.close();
        in.close();
    }

    @Test
    public void run2() throws Exception {
        // 加载配置文件
        InputStream inputStream = Resources.getResourceAsStream("SqlMapConfig.xml");
        // 构建SqlSessionFactory对象
        SqlSessionFactory factory = new SqlSessionFactoryBuilder().build(inputStream);
        // 获取到session对象
        SqlSession session = factory.openSession();
//        // 查询所有的数据
//        List<User> list = session.selectList("com.qcby.mapper.UserMapper.findAll");
//        // 变量集合
//        for (User user : list) {
//            System.out.println(user);
//        }
//        //根据id查询数据
//        User user = session.selectOne("com.qcby.mapper.UserMapper.findById",1);
//        System.out.println(user);
        //插入数据
        User user = new User();
        user.setUsername("曹操");
        user.setBirthday(new Date());
        user.setSex("女");
        user.setAddress("南昌");
        int id = session.insert("com.qcby.mapper.UserMapper.insert",user);
        session.commit();
        System.out.println(id);
        // 关闭资源
        session.close();
        inputStream.close();
    }
}

三、代理Dao方式的CRUD操作

1. 代理Dao方式的增删改查

1. 创建项目
2. UserMapper接口代码

package com.qcby.mapper;
import com.qcby.domain.User;
import java.util.List;

public interface UserMapper {
    /**
     * 查询所有的用户
     * @return
     */
    public List<User> findAll();

    public User findById(Integer userId);

    public void insert(User user);

    public void update(User user);

    public void delete(Integer userId);

    public List<User> findByName(String username);

    public Integer findByCount();
}

  3.UserMapper.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.qcby.mapper.UserMapper">
    <select id="findAll" resultType="com.qcby.domain.User">
        select * from user;
    </select>

    <!--
       通过id查询
       SQL语句使用#{占位符的名称，名称可以任意}，仅限于基本数据类型和String类型
   -->
    <select id="findById" resultType="com.qcby.domain.User" parameterType="int">
        select * from user where id = #{id};
    </select>

    <!--保存操作-->
    <insert id="insert" parameterType="com.qcby.domain.User">
        /*
        keyProperty表示要返回的属性名称
        order取值AFTER表示插入数据后的行为
        resultType表示返回值的类型
        select last_insert_id(): 这是MySQL的函数，用于获取最后一个插入的行的ID。
        */
        <selectKey keyProperty="id" order="AFTER" resultType="java.lang.Integer">
            select last_insert_id();
        </selectKey>
        insert into user (username,birthday,sex,address) values (#{username},#{birthday},#{sex},#{address})
    </insert>

    <!-- 修改 -->
    <update id="update" parameterType="com.qcby.domain.User">
        update user set username = #{username},birthday = #{birthday},sex = #{sex},address=#{address} where id = #{id}
    </update>

    <!-- 删除 -->
    <delete id="delete" parameterType="Integer">
        delete from user where id = #{id}
    </delete>

    <!-- 模糊查询 -->
    <select id="findByName" resultType="com.qcby.domain.User" parameterType="string">
        <!-- 第一种方式的SQL语句
        select * from user where username  like #{username}
        -->
        <!-- 第二章SQL语句的编写 强调：'%${value}%'不能修改，固定写法（不推荐使用）  -->
        select * from user where username  like '%${value}%'
    </select>

    <!-- 具体函数的查询 -->
    <select id="findByCount" resultType="int">
        select count(*) from user
    </select>
</mapper>

 4.TestDemo的代码

package com.qcby.test;
import com.qcby.domain.User;
import com.qcby.mapper.UserMapper;
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 org.junit.After;
import org.junit.Before;
import org.junit.Test;
import java.io.IOException;
import java.io.InputStream;
import java.util.Date;
import java.util.List;

public class TestDemo {
    private InputStream in;
    private SqlSession session;
    private UserMapper mapper;

    @Before
    public void init() throws Exception {
        // 加载配置文件
        in = Resources.getResourceAsStream("SqlMapConfig.xml");
        // 创建工厂对象
        SqlSessionFactory factory = new SqlSessionFactoryBuilder().build(in);
        // 创建Session对象
        session = factory.openSession();
        // 获取到代理对象
        mapper = session.getMapper(UserMapper.class);
    }

    @After
    public void destory() throws IOException {
        in.close();
        session.close();
    }

    /**
     * 测试查询所有的方法
     * @throws Exception
     */
    @Test
    public void testFindAll() throws Exception {
        List<User> list = mapper.findAll();
        // 遍历
        for (User user : list) {
            System.out.println(user);
        }
        in.close();
    }

    @Test
    public void testFindById() throws Exception {
        User user = mapper.findById(4);
        System.out.println(user);
        in.close();
    }

    @Test
    public void testInsert() throws Exception {
        User user = new User();
        user.setUsername("美美");
        user.setBirthday(new Date());
        user.setSex("男");
        user.setAddress("顺义");
        mapper.insert(user);
        session.commit();
        System.out.println(user.getId());
    }

    @Test
    public void testUpdate() throws Exception {
        User user = mapper.findById(41);
        user.setUsername("小凤");
        mapper.update(user);
        session.commit();
    }

    @Test
    public void testDelete() throws Exception {
        mapper.delete(48);
        session.commit();
    }

    // 第一种
    @Test
    public void testFindByName1() throws Exception {
        List<User> list = mapper.findByName("%王%");
        for (User user : list) {
            System.out.println(user);
        }
    }
    // 第二种
    @Test
    public void testFindByName2() throws Exception {
        List<User> list = mapper.findByName("王");
        for (User user : list) {
            System.out.println(user);
        }
    }

    @Test
    public void testFindByCount() throws Exception {
        Integer count = mapper.findByCount();
        System.out.println("总记录数："+count);
    }
}

2、模糊查询符号使用的区别#{}和${}

通过#{}可以实现preparedStatement向占位符中设置值，自动进行java类型和jdbc类型转换，#{}可以有效防止sql注入。 #{}可以接收简单类型值或pojo属性值。 如果parameterType传输单个简单类型值，#{}括号中可以是value或其它名称。

通过$可以将传入的内容拼接在中且不进行类型转换，${}可以将parameterType 传入的内容拼接在sql中且不进行jdbc类型转换， ${}可以接收简单类型值或pojo属性值，如果parameterType传输单个简单类型值，${}括号中只能是value。

四、MyBatis参数详解

1. parameterType

1. 简单数据类型    int double类型 String类型 long

简单的写法：java.lang.Integer --> int integer Int Integer 都可以，框架提供简写的方式。

     2.POJO(JavaBean实体类)对象类型，默认是不能简写，可以配置。User对象

     3.POJO包装对象类型 包含更多的实体类

package com.qcby.domain;
import javax.management.relation.Role;
import java.io.Serializable;

public class QueryVo implements Serializable {

    // 自己属性
    private String name;
    // user属性
    private User user;
    // role属性
    private Role role;

    public String getName() {
        return name;
    }

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

    public User getUser() {
        return user;
    }

    public void setUser(User user) {
        this.user = user;
    }

    public Role getRole() {
        return role;
    }

    public void setRole(Role role) {
        this.role = role;
    }
}


// 测试包装类查询
public List<User> findByVo(QueryVo vo);
​
<!--包装类测试查询-->
<select id="findByVo" parameterType="com.qcby.domain.QueryVo" resultType="com.qcby.domain.User">
    select * from user where username = #{user.username}
</select>

//测试代码
@Test
public void testFindByVo() throws Exception {
    QueryVo queryVo = new QueryVo();
    User user = new User();
    user.setUsername("花花");
    queryVo.setUser(user);
    List<User> list = mapper.findByVo(queryVo);
    for (User user1 : list) {
        System.out.println(user1);
    }
}​

2. resultType

1. 返回简单数据类型   int double long String

     2.返回POJO数据类型     返回User对象类型

     3.resultMap结果类型

resultType可以指定pojo将查询结果映射为pojo，但需要pojo的属性名和sql查询的列名一致方可映射成功。 如果sql查询字段名和pojo的属性名不一致，可以通过resultMap将字段名和属性名作一个对应关系 ，resultMap实质上还需要将查询结果映射到pojo对象中。 resultMap可以实现将查询结果映射为复杂类型的pojo，比如在查询结果映射对象中包括pojo和list实现一对一查询和一对多查询。

<!--演示resultMap配置-->
<select id="findUsers" resultMap="userMap">
  select id _id,username _username,birthday _birthday,sex _sex,address _address from user
</select>
​
<!--
        配置resultMap，用来进行数据封装
        id="唯一的名称，用来被引用的"
        type="进行封装数据的类型"
    -->
<resultMap id="userMap" type="com.qcbyjy.domain.User">
  <!--
            property="JavaBean中的属性"
            column="表中的字段"
        -->
  <result property="id" column="_id"/>
  <result property="username" column="_username" />
  <result property="birthday" column="_birthday" />
  <result property="sex" column="_sex" />
  <result property="address" column="_address" />
</resultMap>

五、SqlMapConfig.xml配置文件

1. 定义properties标签的方式管理数据库的信息

1. 把数据库的信息定义property标签中的方式

<?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>
    
    <properties>
        <property name="jdbc.driver" value="com.mysql.jdbc.Driver"/>
        <property name="jdbc.url" value="jdbc:mysql:///mybatis_db?useUnicode=true&amp;characterEncoding=UTF-8"/>
        <property name="jdbc.username" value="root"/>
        <property name="jdbc.password" value="123456"/>
    </properties>
    
    <!-- 配置环境们 -->
    <environments default="mysql">
        <!-- 配置具体的环境 -->
        <environment id="mysql">
            <!-- 配置事务管理类型 -->
            <transactionManager type="JDBC"/>
            <!-- 配置是否需要使用连接池，POOLED使用，UNPOOLED不使用 -->
            <dataSource type="POOLED">
                <property name="driver" value="${jdbc.driver}"/>
                <property name="url" value="${jdbc.url}"/>
                <property name="username" value="${jdbc.username}"/>
                <property name="password" value="${jdbc.password}"/>
            </dataSource>
        </environment>
    </environments>
    
    <!-- 加载映射的配置文件 -->
    <mappers>
        <mapper resource="mappers/UserMapper.xml"/>
    </mappers>
</configuration>

    2.在项目中定义jdbc.properties属性文件，存储数据库相关的信息，统一管理

         1.jdbc.properties属性文件

jdbc.driverClassName=com.mysql.jdbc.Driver
jdbc.url=jdbc:mysql:///spring_db?useUnicode=true&characterEncoding=UTF-8
jdbc.username=root
jdbc.password=123456

            2.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>
    
    <!--  
        <properties resource="jdbc.properties"></properties>读取外部的配置文件
        resource="文件的相对路径写法"。例如：jdbc.properties 或者 cn/tx/xxx/jdbc.properties
    -->
    <properties resource="jdbc.properties"></properties>
    
    <!-- 配置环境们 -->
    <environments default="mysql">
        <!-- 配置具体的环境 -->
        <environment id="mysql">
            <!-- 配置事务管理类型 -->
            <transactionManager type="JDBC"/>
            <!-- 配置是否需要使用连接池，POOLED使用，UNPOOLED不使用 -->
            <dataSource type="POOLED">
                <property name="driver" value="${jdbc.driver}"/>
                <property name="url" value="${jdbc.url}"/>
                <property name="username" value="${jdbc.username}"/>
                <property name="password" value="${jdbc.password}"/>
            </dataSource>
        </environment>
    </environments>
    
    <!-- 加载映射的配置文件 -->
    <mappers>
        <mapper resource="mappers/UserMapper.xml"/>
    </mappers>
</configuration>

2. 类型别名定义

• 1. MyBatis自已有类型别名的注册类，咱们编写int或者integer通过注册可以找到java.lang.Integer
  2. 咱们自己也可以进行别名的注册
     1. SqlMapConfig.xml的配置文件

<!-- 定义别名 -->
<typeAliases>
  <!-- 把com.qcby.domain.User使用user别名来显示，别名user User USER都可以，默认是忽略大写的 
  <typeAlias type="com.qcby.domain.User" alias="user"/>
  -->
  <!-- 针对com.qcby.domain包下的所有的类，都可以使用当前的类名做为别名 -->
  <package name="com.qcby.domain"/>
</typeAliases>

                      2.UserMapper.xml的配置文件使用别名

<!--  
  resultType="com.qcby.domain.User" 原来是全路径
  resultType="user" 现在使用的是别名的方式
 -->
<select id="findAll" resultType="user">
  select * from user
</select>