MyBatis学习(二)

MyBatis官方中文文档

5. 配置解析

5.1 核心配置文件

• mybatis-config.xml

  configuration（配置）
  properties（属性）
  settings（设置）
  typeAliases（类型别名）
  typeHandlers（类型处理器）
  objectFactory（对象工厂）
  plugins（插件）
  environments（环境配置）
  	environment（环境变量）
  		transactionManager（事务管理器）
  		dataSource（数据源）
  databaseIdProvider（数据库厂商标识）
  mappers（映射器）
  

5.2 environments（环境配置）

MyBatis 可以配置成适应多种环境
不过要记住：尽管可以配置多个环境，但每个SqlSessionFactory实例只能选择一种环境
学会使用配置多种多套运行环境！
MyBatis 默认的事务管理器就是JDBC, 连接池： POOLED
例如：如果需要切换到其他配置，只需要将下面的配置文件中environments的default值改为对应的环境id就好了。

<?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：核心配置文件-->
<configuration>
    <environments default="development">
        <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/mybatis?useSSL=true&amp;useUnicode=true&amp;characterEncoding=UTF-8"/>
                <property name="username" value="root"/>
                <property name="password" value="wsl123"/>
            </dataSource>
        </environment>
        <environment id="oracle-development">
            <transactionManager type="JDBC"/>
            <dataSource type="POOLED">
                <property name="driver" value="oracle.jdbc.OracleDriver"></property>
                <property name="url" value="jdbc:oracle:thin:@localhost:1521:orcl"></property>
                <property name="username" value="venus"></property>
                <property name="password" value="123"></property>
            </dataSource>
        </environment>
    </environments>
    <!--每一个Mapper.xml都需要在MyBatis核心配置文件中注册-->
    <mappers>
        <!--所有的路径以斜杠结尾-->
        <mapper resource="com/lzcu/dao/UserMapper.xml"/>
    </mappers>

</configuration>

5.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=wsl123

在核心配置文件中引入：

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

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

5.4 类型别名（typeAliases）

• 类型别名是为 Java 类型设置一个短的名字。

• 只和 XML 配置有关，存在的意义仅在于用来减少类完全限定名的冗余

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

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

<!--可以给实体类起别名-->
<typeAliases>
    <package name="com.lzcu.pojo"/>
</typeAliases>

在实体类比较少的时候，使用第一种方式
如果实体类比较多，建议使用第二种
第一种可以DIY别名，第二种则不行，如果非要改，需要在实体类上增加注解

@Alias("user")
public class User {
	private int id;
	private String name;
	private String password;
}

5.5 设置

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

5.6 其他配置

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

5.7 映射器(mappers)

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

 <!--每一个Mapper.xml都需要在MyBatis核心配置文件中注册-->
<mappers>
    <!--所有的路径以斜杠结尾-->
    <mapper resource="com/lzcu/dao/UserMapper.xml"/>
</mappers>

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

<mappers>
    <!--所有的路径以斜杠结尾-->
    <mapper class="com.lzcu.dao.UserMapper"/>
</mappers>

注意点：

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

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

<mappers>
    <!--所有的路径以斜杠结尾-->
    <package name="com.lzcu.dao"/>
</mappers>

注意点：

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

5.8 生命周期和作用域

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

SqlSessionFactoryBuilder:

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

SqlSessionFactory:

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

SqlSession:

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

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

6.1 问题

数据库中的字段

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

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

测试出现问题：

解决方法：

• 起别名

6.2 resultMap

结果集映射

id name password
id name pwd

<!--结果集映射-->
<resultMap id="UserMap" type="User">
    <!--column数据库中的字段，property实体类中的属性-->
    <result column="id" property="id"/>
    <result column="name" property="name"/>
    <result column="password" property="pwd"/>
</resultMap>

<select id="getUserById" resultMap="UserMap">
    select * from mybatis.user where id = #{id}
</select>

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

7 日志

7.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>

7.2 Log4j

什么是Log4j?

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

7.2.1 先导入Log4j的包

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

7.2.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/lucu.log
log4j.appender.file.MaxFileSize=10mb
log4j.appender.file.Threshold=DEBUG
log4j.appender.file.layout=org.apache.log4j.PatternLayout
log4j.appender.file.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

7.2.3 配置log4j为日志的实现

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

7.2.4 Log4j的使用！直接测试运行刚才的查询

简单使用

1. 在要使用Log4j的类中，导入包 import org.apache.log4j.Logger;
2. 日志对象，参数为当前类的class

 `static Logger logger = Logger.getLogger(UserDaoTest.class);`

3. 日志级别

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

8.分页

思考：为什么要分页？

• 减少数据的处理量

8.1 使用Limit分页

语法:select * from user limit startIndex,pageIndex;

使用MyBatis实现分页，核心SQL

• 接口

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

• Mapper.xml

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

• 测试！

@Test
public void getUserByLimit(){
	SqlSession sqlSession = MyBatisUtils.getSqlSession();
	UserMapper mapper = sqlSession.getMapper(UserMapper.class);
	Map<String, Integer> map = new HashMap<String, Integer>();
	map.put("startIndex",1);
	map.put("pageSize",2);

	List<User> user = mapper.getUserByLimit(map);

	for (User user1 : user) {
		System.out.println(user1);
	}

	sqlSession.close();
}

8.2 RowBounds分页

不在使用SQL实现分页

1. 接口

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

2. mapper.xml

 <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> list = sqlSession.selectList("com.lzcu.dao.UserMapper.getUserByRowBounds",null,rowBounds);

	for (User user : list) {
		System.out.println(user);
	}

	sqlSession.close();
}

8.3 分页插件

https://pagehelper.github.io/

了解即可，万一以后公司架构师，说要使用，你需要知道它是什么东西！