第十章 springboot + logback

logback是boot默认的日志首选，个人觉得是最好的日志实现（比log4j好）

下边，在之前的代码基础上增加一个功能，该功能要实现mybatis的and or联查功能，并通过logback日志在控制台去查看输出的sql情况。

即实现如下sql的功能：

SELECT * FROM tb_user WHERE id = ? AND (username=? OR `password`= ?);

该语句需要用到xml格式。

注意：由本节开始，springboot采用了1.3.0.

1、com.xxx.firstboot.web.UserController

    @ApiOperation("测试mybatis and or联查")
    @ApiImplicitParams({
        @ApiImplicitParam(paramType="query",name="id",dataType="int",required=false, value="用户的id",defaultValue="1"),
        @ApiImplicitParam(paramType="query",name="username",dataType="String",required=false,value="用户的姓名",defaultValue="zhaojigang"),
        @ApiImplicitParam(paramType="query",name="password",dataType="String",required=false,value="用户的密码",defaultValue="wangna")
    })
    @ApiResponses({
        @ApiResponse(code=400,message="请求参数没填好"),
        @ApiResponse(code=404,message="请求路径没有或页面跳转路径不对")
    })
    @RequestMapping(value="/testMybatisAndOrUnion",method=RequestMethod.GET)
    public User getUserByIdAndUsernameOrPassword(@RequestParam(name="id",required=false) Integer id, 
                                                 @RequestParam(name="username",required=false) String username, 
                                                 @RequestParam(name="password",required=false) String password) {
        return userService.getUserByIdAndUsernameOrPassword(id, username, password);
    }

注意：

• 这里我三个参数都是"required=false"，是为了测试。
• id使用Integer是为了让其可以为null来测试，如果改成int的话如果前端不传参数就会出问题。
  • 这也是Integer的一个用途

2、com.xxx.firstboot.service.UserService

@Service
public class UserService {
    
    private static final Logger LOGGER = LoggerFactory.getLogger(UserService.class);

    @Autowired
    private UserDao userDao;

    public User getUserByIdAndUsernameOrPassword(Integer id, String username, String password){
        User user = userDao.getUserByIdAndUsernameOrPassword(id, username, password);
        LOGGER.info("getUserByIdAndUsernameOrPassword success! user:'{}'", user);
        return user;
    }

说明：

• 在该service中引入了slf4j，这是日志接口，其实现可以是各种实现，包括logback,log4j等

3、com.xxx.firstboot.dao.UserDao

    /**
     * 测试 mybatis and or联查
     */
    public User getUserByIdAndUsernameOrPassword(Integer id, String username, String password){
        return userMapper.getUserByIdAndUsernameOrPassword(id, username, password);
    }

4、com.xxx.firstboot.mapper.UserMapper

public User getUserByIdAndUsernameOrPassword(@Param("id") Integer id, @Param("username") String username, @Param("password") String password);

说明：

• 这里参数的传递必须使用@Param来传递，否则xml里接收不到
  • 目前为止，只发现传递模型类（eg.User）不需要@Param注解。

5、src/main/resources/mapper/UserMapper.xml

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd">

<!-- 指定工作空间，要与接口名相同，源代码没有去看，猜测应该是通过"这里的namespace.下边方法的id"来定位方法的 -->
<mapper namespace="com.xxx.firstboot.mapper.UserMapper">
    <resultMap type="User" id="userResultMap">
        <id property="id" column="id" />
        <result property="username" column="username" />
        <result property="password" column="password" />
    </resultMap>

    <!-- SELECT * FROM tb_user WHERE id = 1 AND (username='' OR `password`='wangna'); -->
    <select id="getUserByIdAndUsernameOrPassword" resultMap="userResultMap">
        <![CDATA[ SELECT * FROM tb_user WHERE id = #{id}]]>
        <trim prefix=" AND (" suffix=")" prefixOverrides="OR">
            <if test="username != null"><![CDATA[ username = #{username}]]></if>
            <if test="password != null"><![CDATA[ OR password = #{password}]]></if>
        </trim>
    </select>

</mapper>

注意：trim的作用

• prefix=" AND ("：在"被trim括起来的满足条件的语句的最前方"添加，例如添加" AND ("
• suffix=")"：在"被trim括起来的满足条件的语句的最后方"添加，例如添加")"
• prefixOverrides="OR"：被trim括起来的满足条件的语句的最前方如果是"OR"（语句中的OR前可以有多个空格，但是prefixOverrides="OR"中的OR前边不能有空格）。eg.如果上述语句中id和password传了，如果不加这个属性，就会形成如下的sql：SELECT * FROM tb_user WHERE id = 1 AND ( OR 'password'='wangna')，该语句就错了；如果加了的话，就会使用prefix=" AND ("来覆盖" OR"，就会如下sql：SELECT * FROM tb_user WHERE id = 1 AND ( 'password'='wangna')
• 如果username和password都isBlank(即为null或者为"")，该trim标签会判断trim内没有语句，则不会加上prefix和suffix，eg.SELECT * FROM tb_user WHERE id = 1 AND ( )（这样的情况不会出现）。

6、src/main/resources/logback.xml

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
    <include resource="org/springframework/boot/logging/logback/base.xml" />
    <!-- 1、logger 
         属性： 
            1)name:用来指定受此logger约束的某一个包或者具体的某一个类 
            2)level:用来设置打印级别，大小写无关（最常用的几种）：DEBUG, INFO, WARN, ERROR 
         2、 
    -->
    <!-- <logger name="org.springframework.web" level="DEBUG" /> -->

    <!-- mybatis日志打印 -->
    <!-- <logger name="com.ibatis" level="DEBUG" /> -->
    <!-- <logger name="com.ibatis.common.jdbc.SimpleDataSource" level="DEBUG" /> -->
    <!-- <logger name="com.ibatis.common.jdbc.ScriptRunner" level="DEBUG" /> -->
    <!-- <logger name="com.ibatis.sqlmap.engine.impl.SqlMapClientDelegate" level="DEBUG" /> -->
    
    <!-- <logger name="java.sql.Connection" level="DEBUG" /> -->
    <!-- <logger name="java.sql.Statement" level="DEBUG" /> -->
    <!-- <logger name="java.sql.PreparedStatement" level="DEBUG" /> -->
    <!-- 这一句至关重要如果没有，就无法输出sql语句 -->
    <logger name="com.xxx.firstboot.mapper" level="DEBUG"></logger>
 </configuration>

注意：在boot中，想在控制台打印mybatis的sql语句，只需要配置下边这一句就好了。

<logger name="com.xxx.firstboot.mapper" level="DEBUG"></logger>

即将mapper接口打入logger就行。

但是在ssm中，可能就需要该行上边的7行了。（这个没有测过不清楚）

测试：

启动应用，打开swagger。

打印出的sql语句：SELECT * FROM tb_user WHERE id = ? 

打印出的sql语句：SELECT * FROM tb_user WHERE id = ? AND ( username = ? )

打印出的sql语句：SELECT * FROM tb_user WHERE id = ? AND ( password = ? ) 

打印出的sql语句：SELECT * FROM tb_user WHERE id = ? AND ( username = ? OR password = ? )

根据测试可以发现，id是必须的，这也是我的项目的需求（而这里不传id，只是为了测试而已），如果id也不是必须，就要考虑trim的位置以及prefixOverrides的值（可以使用AND|OR这样的表示或）

参考自：

http://stackoverflow.com/questions/21718097/how-to-configure-logback-for-mybatis-to-print-my-sql

http://aub.iteye.com/blog/1896611 关于logback可以参考的博客