MyBatis-02

4、配置解析

4.1 核心配置文件

• mybatis-config.xml
• MyBatis 的配置文件包含了会深深影响 MyBatis 行为的设置和属性信息。 配置文档的顶层结构如下：
  • configuration（配置）
    • properties（属性）
    • settings（设置）
    • typeAliases（类型别名）
    • typeHandlers（类型处理器）
    • objectFactory（对象工厂）
    • plugins（插件）
    • environments（环境配置）
      • environment（环境变量）
        • transactionManager（事务管理器）
        • dataSource（数据源）
    • databaseIdProvider（数据库厂商标识）
    • mappers（映射器）

4.2 环境配置（environments）

MyBatis 可以配置成适应多种环境

不过要记住：尽管可以配置多个环境，但每个 SqlSessionFactory 实例只能选择一种环境。

学会使用配置多套运行环境！

MyBatis默认的事务管理器就是JDBC，连接池：POOLED

4.3 属性（properties）

我们可以通过properties属性来实现引用配置文件。

这些属性可以在外部进行配置，并可以进行动态替换。你既可以在典型的 Java 属性文件中配置这些属性，也可以在 properties 元素的子元素中设置。【db.properties】

编写一个配置文件

db.properties

driver=com.mysql.jdbc.Driver
url=jdbc:mysql://localhost:3306/mybatis?useSSL=true&useUnicode=true&characterEncoding=UTF-8
username=root
password=123456

在核心配置文件中引入

    <!--引入外部配置文件-->
    <properties resource="db.properties">
        <property name="username" value="root"/>
        <property name="pwd" value="123456"/>
    </properties>

• 可以直接引入外部文件
• 可以在其中增加一些属性配置
• 如果两个文件有同一个字段，优先使用外部配置文件的

4.4 类型别名（typeAliases）

• 类型别名可为 Java 类型设置一个缩写名字。
• 仅用于 XML 配置，意在降低冗余的全限定类名书写。

    <!--可以给实体类起别名-->
    <typeAliases>
        <typeAlias type="com.won.pojo.User" alias="User"/>
    </typeAliases>

也可以指定一个包名，MyBatis 会在包名下面搜索需要的 Java Bean，即，扫描实体类的包，它的默认别名就为这个类的类名首字母小写。

    <typeAliases>
        <package name="com.won.pojo"/>
    </typeAliases>

在实体类比较少的时候，使用第一种方式。

如果实体类十分多，建议使用第二种。

第一种可以DIY别名，第二种则不行。如果非要改，需要在实体类上增加注解

@Alias("user")
public class User {
    ……
}

4.5 设置（settings）

这是 MyBatis 中极为重要的调整设置，它们会改变 MyBatis 的运行时行为。

4.6 其他配置

• typeHandlers（类型处理器）
• objectFactory（对象工厂）
• plugins（插件）
  • mybatis-generator-core
  • mybatis-plus
  • 通用mapper

4.7 映射器（mappers）

MapperRegistry：注册绑定我们的Mapper文件

方式一：【推荐使用】

    <!--每一个Mapper.xml都需要在MyBatis核心配置文件中注册！！！-->
    <mappers>
        <mapper resource="com/won/dao/UserMapper.xml"/>
    </mappers>

方式二：使用class文件绑定注册

    <mappers>
        <mapper class="com.won.dao.UserMapper"/>
    </mappers>

注意点：

• 接口和它的Mapper配置文件必须同名
• 接口和它的Mapper配置文件必须在同一个包下

方式三：使用扫描包进行注入绑定

    <mappers>
        <package name="com.won.dao"/>
    </mappers>

注意点：

• 接口和它的Mapper配置文件必须同名
• 接口和它的Mapper配置文件必须在同一个包下

4.8 声明周期和作用域

生命周期和作用域是至关重要的，因为错误的使用会导致非常严重的并发问题。

SqlSessionFactoryBuilder：

• 一旦创建了SqlSessionFactory，就不再需要它了
• 局部变量

SqlSessionFactory：

• 说白了就是可以想象为：数据库连接池
• SqlSessionFactory 一旦被创建就应该在应用的运行期间一直存在，没有任何理由丢弃它或重新创建另一个实例。
• SqlSessionFactory 的最佳作用域是应用作用域。
• 最简单的就是使用单例模式或者静态单例模式。

SqlSession：

• 连接到连接池的一个请求
• SqlSession 的实例不是线程安全的，因此是不能被共享的，所以它的最佳的作用域是请求或方法作用域。
• 用完之后需要赶紧关闭，否则资源被占用。
  

这里面的每一个Mapper，就代表一个具体的业务！

5、解决属性名和字段名不一致的问题

5.1 问题

数据库中的字段

新建一个项目，拷贝之前的，测试实体类字段不一致的

public class User {
    private int id;
    private String name;
    private String password;
}

测试出现问题：

    // select * from mybatis.user where id = #{id}
    // 类型处理器
    // select id,name,pwd from mybatis.user where id = #{id}

解决办法：

• 起别名

      <select id="getUserById" parameterType="int" resultType="com.won.pojo.User">
          select id,name,pwd as password from mybatis.user where id = #{id}
      </select>
  

5.2 ResultMap

结果集映射

id    name    pwd
id    naem    password

    <!--结果集映射-->
    <resultMap id="UserMap" type="User">
        <!--column 数据库中的字段，property 实体类中的属性-->
        <result column="id" property="id"/>
        <result column="name" property="name"/>
        <result column="pwd" property="password"/>
    </resultMap>
    <select id="getUserById" resultMap="UserMap">
        select * from mybatis.user where id = #{id}
    </select>

• resultMap 元素是 MyBatis 中最重要最强大的元素。
• ResultMap 的设计思想是，对简单的语句做到零配置，对于复杂一点的语句，只需要描述语句之间的关系就行了。
• ResultMap 的优秀之处在于，你完全可以不用显式地配置它们。
• 如果这个世界总是这么简单就好了。

6、日志

6.1 日志工厂

如果一个数据库操作出现了异常，我们需要排错。日志就是最好的助手！

曾经：sout、debug

现在：日志工厂

• SLF4J
• LOG4J【掌握】
• LOG4J2
• JDK_LOGGING
• COMMONS_LOGGING
• STDOUT_LOGGING 【掌握】
• NO_LOGGING

在MyBatis中具体使用哪个日志实现，在设置中设定。

STDOUT_LOGGING 标准日志输出

在MyBatis核心配置文件中，配置我们的日志！

    <settings>
        <!--标准的日志工厂实现-->
        <setting name="logImpl" value="STDOUT_LOGGING"/>
    </settings>

6.2 Log4j

什么是Log4j

• Log4j是Apache的一个开源项目，通过使用Log4j，我们可以控制日志信息输送的目的地是控制台、文件、GUI组件
• 我们也可以控制每一条日志的输出格式
• 通过定义每一条日志信息的级别，我们能够更加细致地控制日志的生成过程
• 通过一个配置文件来灵活地进行配置，而不需要修改应用的代码

1. 先导入log4j包

   <!-- https://mvnrepository.com/artifact/log4j/log4j -->
   <dependency>
       <groupId>log4j</groupId>
       <artifactId>log4j</artifactId>
       <version>1.2.17</version>
   </dependency>
   

2. log4j.properties

   # 将等级为DEBUG的日志输出到console和file这两个目的地，console和file的定义在下面的代码
   log4j.rootLogger = DEBUG,console,file
   
   # 控制台输出的相关设置
   log4j.appender.console = org.apache.log4j.ConsoleAppender
   log4j.appender.console.Target = System.out
   log4j.appender.console.Threshold = DEBUG
   log4j.appender.console.layout = org.apache.log4j.PatternLayout
   log4j.appender.console.layout.ConversionPattern = [%c]-%m%n
   
   # 文件输出的相关设置
   log4j.appender.file = org.apache.log4j.RollingFileAppender
   log4j.appender.file.File = ./log/won.log
   log4j.appender.file.MaxFileSize = 10mb
   log4j.appender.file.Threshold = DEBUG
   log4j.appender.file.layout = org.apache.log4j.PatternLayout
   log4j.appender.file.layout.ConversionPattern = [%p][%d{yy-MM-dd}][%c]%m%n
   
   # 日志输出级别
   log4j.logger.org.mybatis = DEBUG
   log4j.logger.java.sql = DEBUG
   log4j.logger.java.sql.Statement = DEBUG
   log4j.logger.java.sql.ResultSet = DEBUG
   log4j.logger.java.sql.PreparedStatement = DEBUG
   

3. 配置log4j为日志的实现

       <settings>
           <setting name="logImpl" value="LOG4J"/>
       </settings>
   

4. Log4j的使用

   直接测试运行刚才的查询

   但是报出警告：log4j:WARN custom level class [xxx] not found.

   这是由于："log4j.appender.file.Threshold = DEBUG ## 输出DEBUG级别以上的日志 这行的配置DEBUG后面有注释，由于properties文件的注释只能出现在行首，不能出现在后面，这样配置导致log4j找不到正确的日志错误级别。

将注释删除后，正常运行！

简单使用

1. 在要使用Log4j的类中，导入包 import org.apache.log4j.Logger;

2. 日志对象，参数为当前类的class

   static Logger logger = Logger.getLogger(UserMapperTest.class);
   

3. 日志级别

   logger.info("info:进入了testLog4j");
   logger.debug("debug:进入了testLog4j");
   logger.error("error:进入了testLog4j");
   

7、分页

为什么要分页？

• 减少数据的处理量

7.1 使用Limit分页

select * from user limit startIndex,pageSize;
select * from user limit n; # [0,n]

使用MyBatis实现分页，核心SQL

1. 接口

   // 分页
   List<User> getUserByLimit(Map<String,Integer> map);
   

2. Mapper.xml

   <!--分页-->
   <select id="getUserByLimit" parameterType="map" resultMap="UserMap">
       select * from mybatis.user limit #{startIndex},#{pageSize}
   </select>
   

3. 测试

       @Test
       public void getUserByLimit() {
           SqlSession sqlSession = MybatisUtils.getSqlSession();
           UserMapper mapper = sqlSession.getMapper(UserMapper.class);
   
           HashMap<String,Integer> map = new HashMap<String,Integer>();
           map.put("startIndex",0);
           map.put("pageSize",2);
           List<User> userList = mapper.getUserByLimit(map);
           for (User user : userList) {
               System.out.println(user);
           }
           sqlSession.close();
       }
   

7.2 RowBounds分页

不再使用SQL实现分页

1. 接口

   // 分页2
   List<User> getUserByRowBounds();
   

2. Mapper.xml

   <!--分页2-->
   <select id="getUserByRowBounds" resultMap="UserMap">
       select * from mybatis.user
   </select>
   

3. 测试

   @Test
   public void getUserByRowBounds() {
       SqlSession sqlSession = MybatisUtils.getSqlSession();
   
       // RowBounds实现
       RowBounds rowBounds = new RowBounds(1, 2);
   
       // 通过Java代码层面实现分页
       List<User> userList = sqlSession.selectList("com.won.dao.UserMapper.getUserByRowBounds",null,rowBounds);
       for (User user : userList) {
           System.out.println(user);
       }
   
       sqlSession.close();
   }
   

7.3 分页插件

https://pagehelper.github.io/

8、使用注解开发

8.1 面向接口编程

• 大家之前都学过面向对象编程，也学习过接口，但在真正的开发中，很多时候我们会选择面向接口编程

• 根本原因：解耦、可扩展、提高复用，分层开发中，上层不管具体的实现，大家都遵守共同的标准，使得开发变得容易，规范性更好。

• 在一个面向对象的系统中，系统的各种功能是由许许多多的不同对象协作完成的。在这种情况下，各个对象内部是如何实现自己的，对系统设计人员来讲就不那么重要了。

• 而各个对象之间的协作关系则成为系统设计的关键。小到不同类之间的通信，大到个模块之间的交互，在系统设计之初都是要着重考虑的，这也是系统设计的主要工作内容。面向接口编程就是按照这种思想来编程。

关于接口的理解

• 接口从更深层次的理解，应是定义（规范、约束）与实现（名实分离的原则）的分离。
• 接口的本身反映了系统设计人员对系统的抽象理解
• 接口应有两类：
  • 第一类是对一个个体的抽象，它可以对应为一个抽象体（abstract class）
  • 第二类是对一个个体某一方面的抽象，即形成一个抽象面（ interface）
• 个体可能有多个抽象面。抽象体与抽象面是有区别的。

三个面向区别

• 面向对象是指，我们考虑问题时，以对象为单位，考虑它的属性及方法
• 面向过程是指，我们考虑问题时，以一个具体的流程（事务过程）为单位，考虑它的实现
• 接口设计与非接口设计是针对复用技术而言的，与面向对象（过程）不是一个问题，更多的体现就是对系统整体的架构。

8.2 使用注解开发

1. 注解在接口上实现

   @Select("select * from user")
   List<User> getUsers();
   

2. 需要在核心配置文件中绑定接口

   <!--绑定接口-->
   <mappers>
       <mapper class="com.won.dao.UserMapper"/>
   </mappers>
   

3. 测试

   @Test
   public void test() {
       SqlSession sqlSession = MybatisUtils.getSqlSession();
   
       // 底层主要应用反射
       UserMapper mapper = sqlSession.getMapper(UserMapper.class);
   
       List<User> users = mapper.getUsers();
       for (User user : users) {
           System.out.println(user);
       }
       sqlSession.close();
   }
   

本质：反射机制实现

底层：动态代理

MyBatis详细的执行流程

8.3 CRUD

我们可以在工具类创建的时候实现自动提交事务！

public static SqlSession getSqlSession() {
    return sqlSessionFactory.openSession(true);
}

编写接口，增加注解

public interface UserMapper {
    @Select("select * from user")
    List<User> getUsers();

    // 方法存在多个参数，所有的参数前面必须加上@Param()注解
    // User gerUserByID(@Param("id") int id, @Param("name") String name);
    @Select("select * from user where id = #{id}")
    User gerUserByID(@Param("id") int id);

    @Insert("insert into user(id, name, pwd) values(#{id},#{name},#{password})")
    int addUser(User user);

    @Update("update user set name=#{name},pwd=#{password} where id = #{id}")
    int updateUser(User user);

    @Delete("delete from user where id = #{uid}")
    int deleteUser(@Param("uid") int id);
}

测试类

【注意：必须要将接口注册绑定到我们的核心配置文件中】

关于@Param()注解

• 基本数据类型的参数或者String类型，需要加上
• 引用类型不需要加
• 如果只有一个基本类型的话，可以忽略，但建议加上
• 我们在SQL中引用的就是我们这里的@Param()中设定的属性名

#{} 和 ${} 的区别

• #{}是预编译处理，${}是字符串替换
• mybatis在处理#{}时，会将sql中的#{}替换为?号，调用PreparedStatement的set方法来赋值
• mybatis在处理${ } 时，就是把 ${ } 替换成变量的值
• 使用 #{} 可以有效的防止SQL注入，提高系统安全性