MyBatis中的日志和映射器说明

1.MyBatis中的日志

1.1 什么是日志

​ 在我们编写应用的时候，有一些信息需要及时查看，查看的时候有时需要输出到控制台，有时需要输出到文件。MyBatis也需要日志，一般情况下，使用log4j进行日志管理。

1.2 在MyBatis中使用日志的步骤

1、引入日志的依赖

​ MyBatis默认要引入日志，如果不引入日志就会产生错误，如果引入了日志，但是不对日志进行配置，就会出现警告。

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

2、日志的级别

log4j在使用的时候需要进行配置，配置的时候一般对日志分为6个级别

级别（从低到高）	描述	适用场景
TRACE	提供最详细的程序执行跟踪信息，用于细粒度调试。	开发阶段深度排查问题，生产环境通常关闭。
DEBUG	记录调试信息，帮助开发者了解程序运行细节（如变量值、流程节点）。	开发和测试环境，用于定位问题。
INFO	输出程序运行的关键状态信息（如启动完成、重要操作记录）。	生产环境监控运行状态，记录关键流程。
WARN	提示潜在问题或非预期情况，但不会导致程序中断（如配置缺失、性能下降警告）。	需关注但非紧急的问题，提醒运维排查。
ERROR	记录错误事件，可能导致部分功能失效但程序仍可运行（如数据库连接超时、外部接口异常）。	生产环境错误监控，需及时处理。
FATAL	记录致命错误，导致程序无法继续运行（如内存溢出、系统崩溃）。	需立即终止程序并紧急修复的严重问题。

输出目标一般是控制台和文件：

1. console：控制台
2. file：文件

3、对日志进行配置

1.log4j.appender.console是相关的设置的名字，后面的参数是真正的配置
2.org.apache.log4j.ConsoleAppender：日志的实现类，该类输出到控制台
3.org.apache.log4j.PatternLayout:日志输出布局的实现类
4. [%c]-%m%n:日志输出的格式化

配置代码，配置文件名必须使用log4j.properties,位置放在resources包下

#将等级为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/mybatis.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

2.MyBatis映射器说明

2.1 简介

映射器是 MyBatis 中最重要的文件，文件中包含一组 SQL 语句（例如查询、添加、删除、修改），这些语句称为映射语句或映射 SQL 语句。

映射器由 Java 接口和 XML 文件（或注解）共同组成，它的作用如下。

• 定义参数类型
• 配置缓存
• 提供 SQL 语句和动态 SQL
• 定义查询结果和 POJO 的映射关系

映射器有以下两种实现方式。

• 通过 XML 文件方式实现，比如我们在 mybatis-config.xml 文件中描述的 XML 文件，用来生成 mapper。
• 通过注解的方式实现，使用 Configuration 对象注册 Mapper 接口

如果 SQL 语句存在动态 SQL 或者比较复杂，使用注解写在 Java 文件里可读性差，且增加了维护的成本。所以一般建议使用 XML 文件配置的方式，避免重复编写 SQL 语句。

2.2 XML实现映射器

XML 定义映射器分为两个部分：接口和XML。利用映射器实现增删改查会在下文详细介绍，后续会贴上链接地址

mapper文件标签顺序说明：

<!ELEMENT mapper (cache-ref | cache | resultMap* | parameterMap* | sql* | insert* | update* | delete* | select* )+>

• !ELEMENT mapper：声明了一个节点，该节点是xml的根节点。

• ( )：代表节点里应该有哪些子节点。

• |:代表子节点没有前后顺序，也可以有或者没有。

• *：代表子节点可以没有，也可以有多个

• ？：代表最多只能有一个。

namespace 用来定义命名空间，该命名空间和定义接口的全限定名一致。

<select> 元素表明这是一条查询语句，属性 id 用来标识这条 SQL。resultType 表示返回的是一个 Student 类型的值。

namespace的前缀必须是包名，后面的命名必须和接口的命名一样。

在 MyBatis 配置文件中添加以下代码。

 <package name="org.example.mapper"/>             

该语句用来引入 XML 文件，MyBatis 会读取对应 XxxMapper.xml 文件，生成映射器。

2.3 注解实现映射器

使用注解的方式实现映射器，只需要在接口中使用 Java 注解，注入 SQL 即可。如下所示。

public interface StudentMapper {@Select(value = "select * from Student")public List<Website> select();
}               

这里我们使用了 @Select 注解，并且注入了和 XML 中相同的 select 语句。

注意：

1.如果使用注解和 XML 文件两种方式同时定义，会报id重复的异常。

2.虽然这里注解的方式看起来比 XML 简单，但是现实中我们遇到的 SQL 会比该例子复杂得多。如果 SQL 语句中有多个表的关联、多个查询条件、级联、条件分支等，显然这条 SQL 就会复杂的多，所以并不建议读者使用这种方式。比如下面这条 SQL。

select * from t_user u
left join t_user_role ur on u.id = ur.user_id
left join t_role r on ur.role_id = r.id
left join t_user_info ui on u.id = ui.user_id
left join t_female_health fh on u.id = fh.user_id
left join t_male_health mh on u.id = mh.user_id
where u.user_name like concat('%', ${userName},'%')
and r.role_name like concat('%', ${roleName},'%')
and u.sex = 1
and ui.head_image is not null;       

如果把以上 SQL 放到 @Select 注解中，无疑会大大降低代码的可读性。如果同时还要考虑使用动态 SQL 或需要加入其他的逻辑，这样就使得这个注解更加复杂了，不利于日后的维护和修改。

此外，XML 可以相互引入，而注解是不可以的，所以在一些比较复杂的场景下，使用 XML 方式会更加灵活和方便。因此大部分的企业都以 XML 为主，本教程也会保持一致，以 XML 方式来创建映射器。当然在一些简单的表和应用中使用注解方式也会比较简单。

这个接口可以在 XML 中定义，将在 mybatis-config.xml 中配置 XML 的语句修改为以下语句即可。

<mapper resource="com/mybatis/mapper/WebsiteMapper2" />  

也可以使用 configuration 对象注册这个接口，比如：

configuration.addMapper(WebsiteMapper2.class);

2.4 MyBatis 映射器的主要元素

下面介绍在映射器中可以定义哪些元素，以及它们的作用。

元素名称	描述	备注
mapper	映射文件的根节点，只有 namescape 一个属性	namescape 作用如下：①用于区分不同的 mapper，全局唯一②绑定DAO接口，即面向接口编程。当 namescape 绑定某一接口后，可以不用写该接口的实现类，MyBatis 会通过接口的完整限定名查找到对应的 mapper 配置来执行 SQL 语句。因此 namescape 的命名必须要跟接口同名。
select	查询语句，最常用、最复杂的元素之一	可以自定义参数，返回结果集等
insert	插入语句	执行后返回一个整数，代表插入的条数
update	更新语句	执行后返回一个整数，代表更新的条数
delete	删除语句	执行后返回一个整数，代表删除的条数
parameterMap	定义参数映射关系	即将被删除的元素，不建议使用
sql	允许定义一部分的 SQL，然后在各个地方引用它	例如，一张表列名，我们可以一次定义，在多个 SQL 语句中使用
resultMap	用来描述数据库结果集与对象的对应关系，它是最复杂、最强大的元素	提供映射规则
cache	配置给定命名空间的缓存	-
cache-ref	其它命名空间缓存配置的引用	-

拓展

关于 MyBatis 的 SQL 映射文件中的 mapper 元素的 namescape 属性有如下要求。

• namescape 的命名必须跟某个 DAO 接口同名，同属于 DAO 层，因此代码结构上，映射文件与该接口应放置在同一 package 下（如org.example.mapper），并且习惯上是以 Mapper
  结尾（如StudentMapper.java、TeacherMapper.xml）。
• 不同的 mapper 文件中子元素的 id 可以相同，MyBatis 通过 namescape 和子元素的 id 联合区分。接口中的方法与映射文件中的 SQL 语句 id 应一 一对应。