MyBatis环境搭建

开发环境

  • IDE: idea 2020..2.1

  • 构建工具：maven 3.8.4

  • MySQL版本：MySQL 5.7

  • MyBatis版本：MyBatis 3.5.7

引入依赖

  • 引入MyBatis核心依赖和MySQL驱动

    <dependencies>
    <!-- Mybatis核心 -->
    <dependency>
        <groupId>org.mybatis</groupId>
        <artifactId>mybatis</artifactId>
        <version>3.5.7</version>
    </dependency>
    <!-- junit测试 -->
    <dependency>
        <groupId>junit</groupId>
        <artifactId>junit</artifactId>
        <version>4.12</version>
        <scope>test</scope>
    </dependency>
    <!-- MySQL驱动 -->
    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <version>5.1.3</version>
    </dependency>
</dependencies>

创建MyBatis核心配置文件

习惯上命名为mybatis-config.xml，这个文件名仅仅只是建议，并非强制要求。将来整合Spring之后，这个配置文件可以省略，所以大家操作时可以直接复制、粘贴。 核心配置文件主要用于配置连接数据库的环境以及MyBatis的全局配置信息 核心配置文件存放的位置是src/main/resources目录下

  • 核心配置文件指定pojo位置

    <typeAliases>
        <package name="com.test.mybatis.pojo"/>
</typeAliases>

  • 核心配置文件指定映射文件Mapper位置

    <mappers>
        <package name="com.test.mybatis.mapper"/>
</mappers>

  • 核心配置文件通过配置文件配置数据库连接信息

    <properties resource="jdbc.properties"/>
​
<environments default="development">
        <environment id="development">
            <transactionManager type="JDBC"/>
            <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>

  • 核心配置文件更多信息参阅官方文档

  • 核心配置文件详解

核心配置文件中的标签必须按照固定的顺序(有的标签可以不写，但顺序一定不能乱)： properties、settings、typeAliases、typeHandlers、objectFactory、objectWrapperFactory、reflectorFactory、plugins、environments、databaseIdProvider、mappers

<?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文件，此时就可以${属性名}的方式访问属性值-->
<properties resource="jdbc.properties"></properties>
<settings>
  <!--将表中字段的下划线自动转换为驼峰-->
  <setting name="mapUnderscoreToCamelCase" value="true"/>
  <!--开启延迟加载-->
  <setting name="lazyLoadingEnabled" value="true"/>
</settings>
<typeAliases>
  <!--
  typeAlias：设置某个具体的类型的别名
  属性：
  type：需要设置别名的类型的全类名
  alias：设置此类型的别名，且别名不区分大小写。若不设置此属性，该类型拥有默认的别名，即类名
  -->
  <!--<typeAlias type="com.test.mybatis.bean.User"></typeAlias>-->
  <!--<typeAlias type="com.test.mybatis.bean.User" alias="user">
  </typeAlias>-->
  <!--以包为单位，设置改包下所有的类型都拥有默认的别名，即类名且不区分大小写-->
  <package name="com.test.mybatis.bean"/>
</typeAliases>
<!--
environments：设置多个连接数据库的环境
属性：
        default：设置默认使用的环境的id
-->
<environments default="mysql_test">
  <!--
  environment：设置具体的连接数据库的环境信息
  属性：
            id：设置环境的唯一标识，可通过environments标签中的default设置某一个环境的id，表示默认使用的环境
  -->
  <environment id="mysql_test">
      <!--
      transactionManager：设置事务管理方式
      属性：
                type：设置事务管理方式，type="JDBC|MANAGED"
                type="JDBC"：设置当前环境的事务管理都必须手动处理
                type="MANAGED"：设置事务被管理，例如spring中的AOP
      -->
      <transactionManager type="JDBC"/>
      <!--
      dataSource：设置数据源
      属性：
                type：设置数据源的类型，type="POOLED|UNPOOLED|JNDI"
                type="POOLED"：使用数据库连接池，即会将创建的连接进行缓存，下次使用可以从缓存中直接获取，不需要重新创建
                type="UNPOOLED"：不使用数据库连接池，即每次使用连接都需要重新创建
                type="JNDI"：调用上下文中的数据源
      -->
      <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="UserMapper.xml"/> -->
  <!--
  以包为单位，将包下所有的映射文件引入核心配置文件
  注意：
            1. 此方式必须保证mapper接口和mapper映射文件必须在相同的包下
            2. mapper接口要和mapper映射文件的名字一致
     -->
     <package name="com.test.mybatis.mapper"/>
 </mappers>
</configuration>

创建mapper接口

MyBatis中的mapper接口相当于以前的dao。但是区别在于，mapper仅仅是接口，我们不需要提供实现类

mapper接口-->映射文件 实现具体的SQL

接口中对于实体类和数据库字段名称不一致或者一对多、多对一的情况使用resultMap处理字段和属性的映射关系

如果一致使用resultType

public interface UserMapper {  
    /**  
    * 添加用户信息  
    */  
    int insertUser();  
}

创建MyBatis的映射文件XXXMapper.xml

  • 相关概念：ORM（Object Relationship Mapping）对象关系映射。

  • 对象：Java的实体类对象

    • 关系：关系型数据库

    • 映射：二者之间的对应关系

Java概念

数据库概念

类

表

属性

字段/列

对象

记录/行

  • 映射文件的命名规则

  • 表所对应的实体类的类名+Mapper.xml

    • 例如：表t_user，映射的实体类为User，所对应的映射文件为UserMapper.xml

    • 因此一个映射文件对应一个实体类，对应一张表的操作

    • MyBatis映射文件用于编写SQL，访问以及操作表中的数据

    • MyBatis映射文件存放的位置是src/main/resources/mappers目录下

  • MyBatis中可以面向接口操作数据，要保证两个一致

  • mapper接口的全类名和映射文件的命名空间（namespace）保持一致

    • mapper接口中方法的方法名和映射文件中编写SQL的标签的id属性保持一致

<?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.test.mybatis.mapper.DeptMapper">
​
    <!--Dept getEmpAndDeptByStepTwo(@Param("did") Integer did);-->
    <select id="getEmpAndDeptByStepTwo" resultType="Dept">
        select * from t_dept where did = #{did}
    </select>
​
    <resultMap id="deptAndEmpResultMap" type="Dept">
        <id property="did" column="did"></id>
        <result property="deptName" column="dept_name"></result>
        <!--
            collection：处理一对多的映射关系
            ofType：表示该属性所对应的集合中存储数据的类型
        -->
        <collection property="emps" ofType="Emp">
            <id property="eid" column="eid"></id>
            <result property="empName" column="emp_name"></result>
            <result property="age" column="age"></result>
            <result property="sex" column="sex"></result>
            <result property="email" column="email"></result>
        </collection>
    </resultMap>
    <!--Dept getDeptAndEmp(@Param("did") Integer did);-->
    <select id="getDeptAndEmp" resultMap="deptAndEmpResultMap">
        select * from t_dept left join t_emp on t_dept.did = t_emp.did where t_dept.did = #{did}
    </select>
​
    <resultMap id="deptAndEmpByStepResultMap" type="Dept">
        <id property="did" column="did"></id>
        <result property="deptName" column="dept_name"></result>
        <collection property="emps"
                    select="com.test.mybatis.mapper.EmpMapper.getDeptAndEmpByStepTwo"
                    column="did" fetchType="eager"></collection>
    </resultMap>
    <!--Dept getDeptAndEmpByStepOne(@Param("did") Integer did);-->
    <select id="getDeptAndEmpByStepOne" resultMap="deptAndEmpByStepResultMap">
        select * from t_dept where did = #{did}
    </select>
​
</mapper>

小结

核心配置文件 mybatis-config.xml 配置全局信息

接口mapper 提供调用入口，具体SQL由映射文件完成

映射文件mapper.xml 实现具体的SQL语句