MyBatis配置解析、指定日志实现、实现分页操作

配置解析

1. 核心配置文件

• mybatis-config.xml
• MyBatis 的配置文件包含了会深深影响 MyBatis 行为的设置和属性信息

• 编写配置文件时需要注意的问题：
  • 配置顺序必须按上图的顺序来进行配置，否则会报错
  • 不想配的设置可以不配，但是位置一定得留下，例如：我先配置了properties，然后不想配置settings，那么你就在properties底下配settings的下一个配置

2.属性（properties）

我们可以通过properties属性来实现引用配置文件
这些属性都是可外部配置且可动态替换的，既可以在典型的 Java 属性文件中配置，亦可通过 properties 元素的子元素来传递。（db.properties）

1. 编写一个配置文件，例如db.properties（和数据库建立连接的配置文件）
   这个配置文件常与核心配置文件：mybatis-config.xml 在一个包下
   配置文件里的内容如下，根据自己的数据库进行一些小改动即可：

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

2. 在核心配置文件中映入
   引入外部配置文件

    <properties resource="db.properties">
        <property name="username" value="root"/>
        <property name="pwd" value="11111"/>
    </properties>

• 如果外部配置文件和环境配置中 environment 标签中有同一个字段，优先使用外部配置文件的！

3. 设置（settings）

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

STDOUT_LOGGING为标准日志输出

什么是Log4j？

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

指定日志实现的具体步骤：

1. 在 pom.xml 中依赖 log4j

<dependency>
    <groupId>log4j</groupId>
    <artifactId>log4j</artifactId>
    <version>1.2.17</version>
</dependency>

2. 在 resources 包下创建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/test.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. 在核心配置文件中添加 settings的配置

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

4. 测试结果：
   

4. 类型别名（typeAliases）

• 类型别名是为 Java 类型设置一个短的名字。
• 存在的意义仅在于用来减少类完全限定名的冗余。

可以给实体类起别名

    <typeAliases>
        <typeAlias type="cn.edu.xiyou.pojo.User" alias="User"/>
    </typeAliases>

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

<typeAliases>
    <package name="cn.edu.xiyou.pojo"/>
</typeAliases>

这两种别名方式如何选择？

• 在实体类比较少的时候，使用第一种方式。
• 如果实体类十分多，建议使用第二种。

5. 其他配置

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

在mvn仓库找到 maven 依赖即可

6. 环境配置（environments）

• MyBatis 可以配置成适应多种环境
• 不过要记住：尽管可以配置多个环境，但每个 SqlSessionFactory 实例只能选择一种环境。
• 学会使用配置多套运行环境！（可以转换数据库，例如从mysq数据库转到oracle数据库）
• Mybatis默认的事务管理器就是 JDBC ， 连接池 ： POOLED

<environments default="development">
    <!--这个环境是smbms库-->
    <environment id="development">
        <transactionManager type="JDBC"/>
        <dataSource type="POOLED">
            <property name="driver" value="com.mysql.jdbc.Driver"/>
            <property name="url" value="jdbc:mysql://localhost:3306/smbms?useSSL=true&amp;useUnicode=true&amp;characterEncoding=UTF-8"/>
            <property name="username" value="root"/>
            <property name="password" value="123456"/>
        </dataSource>
    </environment>
    <!--下面的环境是mybatis库-->
    <environment id="mytest">
        <transactionManager type="JDBC"></transactionManager>
        <dataSource type="POOLED">
            <property name="driver" value="com.mysql.jdbc.Driver"/>
            <property name="url" value="jdbc:mysql://localhost:3306/mybatis?useSSL=true&amp;useUnicode=true&amp;characterEncoding=UTF-8"/>
            <property name="username" value="root"/>
            <property name="password" value="123456"/>
        </dataSource>
    </environment>
</environments>

这块就用到了两个环境，改环境的话只需要改 environments 标签的default值即可
default 的值对应的是 environments 标签下 environment 标签的 id 值

7. 映射器（mappers）

MapperRegistry：注册绑定我们的Mapper文件；
方式一： 【推荐使用】

<!--每一个Mapper.XML都需要在Mybatis核心配置文件中注册！-->
<mappers>
    <mapper resource="cn/edu/xiyou/mapper/userMapper.xml"/>
</mappers>

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

<!--每一个Mapper.XML都需要在Mybatis核心配置文件中注册！-->
<mappers>
    <mapper class="cn.edu.xiyou.mapper.userMapper"/>
</mappers>

方式二的注意点：

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

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

<!--每一个Mapper.XML都需要在Mybatis核心配置文件中注册！-->
<mappers>
    <package name="cn.edu.xiyou.dao"/>
</mappers>

方式三的注意点：

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

8. 生命周期

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

• 一旦创建了 SqlSessionFactory，就不再需要它了

SqlSessionFactory：

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

SqlSession

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

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

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

数据库中的字段

pojo中实体类的属性名

这里可以看出 pojo类中的有一个pwd的属性和数据库的password字段不匹配

出现的问题

解决方法

• 起别名

<select id="selectByID" resultType="cn.edu.xiyou.pojo.User">
    select id,name,password as pwd from mybatis.user where id = #{id}
</select>

• resultMap

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

• resultMap 元素是 MyBatis 中最重要最强大的元素
• ResultMap 的设计思想是，对于简单的语句根本不需要配置显式的结果映射，而对于复杂一点的语句只需要描述它们的关系就行了
• ResultMap 最优秀的地方在于，虽然你已经对它相当了解了，但是根本就不需要显式地用到他们

分页

为什么要分页？

减少数据的处理量

方式一：使用Limit分页

语法：SELECT * from user limit startIndex,pageSize;
startIndex 指的是从哪个索引开始分页，pageSize 指的是每页的范围（查询条数）
1.在mapper接口中编写分页查询的方法，代码如下：

//分页
List<User> userByLimit(@Param("startIndex") Integer startIndex,@Param("pageSize") Integer pageSize);

注意点：这块传多个参数，需要用 @Param 注解给你的参数起个名字，这样你的 mapper 配置文件才能拿到值，不加注解可能会报如下的错误

2.在配置文件中编写对应的代码，代码如下：

<select id="userByLimit" resultType="User">
    select * from smbms.smbms_user limit #{startIndex},#{pageSize}
</select>

3. 利用 @Test 注解进行测试，代码如下：

@Test
public void userByLimit(){
    SqlSession sqlsession = mybatisUtils.getSqlsession();
    userMapper mapper = sqlsession.getMapper(userMapper.class);
    List<User> users = mapper.userByLimit(0, 3);
    for (User user : users) {
        System.out.println(user);
    }
    sqlsession.close();
}

方式二：使用RowBounds分页

不再使用SQL实现分页

1. 在mapper接口中编写分页查询的方法，代码如下：

List<User> userLimit();

2. 在配置文件中编写对应的代码，代码如下：

<select id="userLimit" resultType="User">
    select * from smbms.smbms_user
</select>

3. 利用 @Test 注解进行测试，代码如下：

@Test
public void userLimit(){
    SqlSession sqlsession = mybatisUtils.getSqlsession();
    //RowBounds 实现
    RowBounds rowBounds = new RowBounds(0, 4);
    //通过Java代码层面实现分页
    List<User> list = sqlsession.selectList("cn.edu.xiyou.mapper.userMapper.userLimit", null, rowBounds);
    for (User user : list) {
        System.out.println(user);
    }
    sqlsession.close();
}

方式三：也可使用分页插件