MyBatis/mybatis_plus的项目 如何优雅地打印SQL

在使用MyBatis或者MyBatis-Plus作为ORM框架的时候，会发现默认的日志输出是下面这样的

在参数少并且SQL简单的情况下，这样的SQL我们能通过手动去替换占位符，来获取到真正执行的SQL。但是如果是比较复杂的SQL，或者查询参数比较多的话，一个个替换就比较费时费力了。

MyBatis Plugin
于是我们就可以使用MyBatis对外暴露出的Interceptor接口，来手动实现一个能优雅地打印日志的插件。平常像用的比较多的PageHelper，就是一个MyBatis的插件，实现原理和我们这次要做的功能十分相似。

MyBatis插件的原理

MyBatis插件的实现原理基于Java的动态代理机制。当MyBatis框架在初始化时检测到有插件配置，它会为目标对象（如Executor、StatementHandler等）创建一个代理对象。这个代理对象会包装原始对象，并在方法调用时执行自定义的拦截逻辑。
拦截过程中，如果存在拦截器，且方法的签名与拦截器配置的方法签名匹配，则调用拦截器的intercept方法。在intercept方法中，开发者可以实现自定义的拦截逻辑，通常这里会包含对原始方法调用的修改或增强

MyBatis 插件的几个重点模块
@Intercepts 注解：

这是 MyBatis 提供的一个注解，用于定义一个拦截器。一个拦截器可以拦截一个或多个方法。
@Signature 注解：

这是 @Intercepts 注解的子注解，用于指定要拦截的目标方法。

@Signature 注解的参数分别是：

type：指定要拦截的接口类型。

method：指定要拦截的方法名。

args：指定要拦截的方法的参数类型列表。

实现一个优雅打日志的功能

首先编写一个Interceptor的实现类，具体代码如下，所有的注释都放在代码上了：

其中类上的Intercepts注解含义为：在 Executor 的 query、update 方法执行前后进行自定义的处理，其中Executor 是最底层的执行器，负责与数据库进行通信。它的职责包括创建和缓存 Statement 对象、执行 SQL 语句、处理结果集等。

packagecom.xa.demo1.config;importlombok.extern.slf4j.Slf4j;importorg.apache.ibatis.cache.CacheKey;importorg.apache.ibatis.executor.Executor;importorg.apache.ibatis.mapping.BoundSql;importorg.apache.ibatis.mapping.MappedStatement;importorg.apache.ibatis.mapping.ParameterMapping;importorg.apache.ibatis.plugin.Interceptor;importorg.apache.ibatis.plugin.Intercepts;importorg.apache.ibatis.plugin.Invocation;importorg.apache.ibatis.plugin.Plugin;importorg.apache.ibatis.plugin.Signature;importorg.apache.ibatis.reflection.MetaObject;importorg.apache.ibatis.session.Configuration;importorg.apache.ibatis.session.ResultHandler;importorg.apache.ibatis.session.RowBounds;importorg.apache.ibatis.type.TypeHandlerRegistry;importorg.springframework.util.ObjectUtils;importjava.text.DateFormat;importjava.util.Date;importjava.util.List;importjava.util.Locale;importjava.util.Properties;importjava.util.regex.Matcher;/**
 * @author AkazaAkari   实现一个优雅打日志的功能
 * @Intercepts 注解：
 *
 * 这是 MyBatis 提供的一个注解，用于定义一个拦截器。一个拦截器可以拦截一个或多个方法。
 * @Signature 注解：
 *
 * 这是 @Intercepts 注解的子注解，用于指定要拦截的目标方法。
 *
 * @Signature 注解的参数分别是：
 *
 *     type：指定要拦截的接口类型。
 *
 *     method：指定要拦截的方法名。
 *
 *     args：指定要拦截的方法的参数类型列表。
 *      todo： 这一章其他内容之后补上（Intercepts注解、MyBatis插件开发过程中的各个对象
 */@Intercepts({@Signature(type =Executor.class, method ="query", args ={MappedStatement.class,Object.class,RowBounds.class,ResultHandler.class}),@Signature(type =Executor.class, method ="query", args ={MappedStatement.class,Object.class,RowBounds.class,ResultHandler.class,CacheKey.class,BoundSql.class}),@Signature(type =Executor.class, method ="update", args ={MappedStatement.class,Object.class})})@Slf4jpublicclassSqlInterceptorimplementsInterceptor{@OverridepublicObjectintercept(Invocation invocation)throwsThrowable{// 计算这一次SQL执行钱后的时间，统计一下执行耗时long startTime =System.currentTimeMillis();Object proceed = invocation.proceed();long endTime =System.currentTimeMillis();String printSql =null;try{// 通过generateSql方法拿到最终生成的SQL
            printSql =generateSql(invocation);}catch(Exception exception){
            log.error("获取sql异常",exception);}finally{// 拼接日志打印过程long costTime = endTime - startTime;
            log.info("\n 执行SQL耗时：{}ms \n 执行SQL：{}",costTime,printSql);}return proceed;}privatestaticStringgenerateSql(Invocation invocation){// 获取到BoundSql以及Configuration对象// BoundSql 对象存储了一条具体的 SQL 语句及其相关参数信息。// Configuration 对象保存了 MyBatis 框架运行时所有的配置信息MappedStatement statement =(MappedStatement) invocation.getArgs()[0];Object parameter =null;if(invocation.getArgs().length>1){
            parameter = invocation.getArgs()[1];}Configuration configuration = statement.getConfiguration();BoundSql boundSql = statement.getBoundSql(parameter);// 获取参数对象Object parameterObject = boundSql.getParameterObject();// 获取参数映射List<ParameterMapping> params = boundSql.getParameterMappings();// 获取到执行的SQLString sql = boundSql.getSql();// SQL中多个空格使用一个空格代替
        sql = sql.replaceAll("[\\s]+"," ");if(!ObjectUtils.isEmpty(params)&&!ObjectUtils.isEmpty(parameterObject)){// TypeHandlerRegistry 是 MyBatis 用来管理 TypeHandler 的注册器。TypeHandler 用于在 Java 类型和 JDBC 类型之间进行转换TypeHandlerRegistry typeHandlerRegistry = configuration.getTypeHandlerRegistry();// 如果参数对象的类型有对应的 TypeHandler，则使用 TypeHandler 进行处理if(typeHandlerRegistry.hasTypeHandler(parameterObject.getClass())){
                sql = sql.replaceFirst("\\?",Matcher.quoteReplacement(getParameterValue(parameterObject)));}else{// 否则，逐个处理参数映射for(ParameterMapping param : params){// 获取参数的属性名String propertyName = param.getProperty();MetaObject metaObject = configuration.newMetaObject(parameterObject);// 检查对象中是否存在该属性的 getter 方法，如果存在就取出来进行替换if(metaObject.hasGetter(propertyName)){Object obj = metaObject.getValue(propertyName);
                        sql = sql.replaceFirst("\\?",Matcher.quoteReplacement(getParameterValue(obj)));// 检查 BoundSql 对象中是否存在附加参数。附加参数可能是在动态 SQL 处理中生成的，有的话就进行替换}elseif(boundSql.hasAdditionalParameter(propertyName)){Object obj = boundSql.getAdditionalParameter(propertyName);
                        sql = sql.replaceFirst("\\?",Matcher.quoteReplacement(getParameterValue(obj)));}else{// 如果都没有，说明SQL匹配不上，带上“缺失”方便找问题
                        sql = sql.replaceFirst("\\?","缺失");}}}}return sql;}privatestaticStringgetParameterValue(Object object){String value ="";if(object instanceofString){
            value ="'"+ object.toString()+"'";}elseif(object instanceofDate){DateFormat format =DateFormat.getDateTimeInstance(DateFormat.DEFAULT,DateFormat.DEFAULT,Locale.CHINA);
            value ="'"+ format.format((Date) object)+"'";}elseif(!ObjectUtils.isEmpty(object)){
            value = object.toString();}return value;}@OverridepublicObjectplugin(Object target){returnPlugin.wrap(target,this);}@OverridepublicvoidsetProperties(Properties properties){// 可以通过properties配置插件参数}}

接着编写一个MyBatis的配置类，将这个插件注册进去

/**
     * @Title: mybatisConfigurationCustomizer
     * @Description: 编写一个MyBatis的配置类，将这个插件注册进去
     * @CreatedDate: 2024/06/16 00:06
     * @Param
     * @Return ConfigurationCustomizer
     **/@BeanpublicConfigurationCustomizermybatisConfigurationCustomizer(){return configuration ->{
            configuration.addInterceptor(newSqlInterceptor());};}

实现功能如图所示