fine-logs模块

• 日志管理

依赖

• pom.xml

<!--fine-logs-->
<dependency>
    <groupId>cn.finemap</groupId>
    <artifactId>fine-logs</artifactId>
    <version>${fine.version}</version>
</dependency>

创建子模块：fine-log

• 在fine-parent中创建：fine-log子模块

fine-log

• 创建子模块：New > Module...
• 添加logback-spring.xml日志配置文件

日志配置文件

• src/main/resources/logback-spring.xml

<?xml version="1.0" encoding="UTF-8"?>
<configuration scan="true" scanPeriod="60 seconds" debug="false">

    <!-- 用于指定logger上下文名称，默认为default -->
    <contextName>logback</contextName>
    <springProperty scope="context" name="application.name" source="spring.application.name"/>

    <!--windows+mac环境:（./项目目录，../项目父目录）-->
    <property name="LOG_HOME" value="../logs/${application.name}"/>

    <!--linux环境-->
    <!--<property name="LOG_HOME" value="/opt/logs/${application.name}"/>-->
    
    <property name="PATTERN" value="[%-5level] %d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] [%c{12}:%L] %msg%n"/>

    <!-- %m输出的信息,%p日志级别,%t线程名,%d日期,%c类的全名,%i索引【从数字0开始递增】,,, -->
    <!-- appender是configuration的子节点，是负责写日志的组件。 -->
    <!-- ConsoleAppender：把日志输出到控制台 -->
    <appender name="console" class="ch.qos.logback.core.ConsoleAppender">
        <encoder>
            <pattern>${PATTERN}</pattern>
            <!-- 控制台也要使用UTF-8，不要使用GBK，否则会中文乱码 -->
            <charset>UTF-8</charset>
        </encoder>
    </appender>
    <!-- RollingFileAppender：滚动记录文件，先将日志记录到指定文件，当符合某个条件时，将日志记录到其他文件 -->
    <!-- 以下的大概意思是：1.先按日期存日志，日期变了，将前一天的日志文件名重命名为XXX%日期%索引，新的日志仍然是demo.log -->
    <!--             2.如果日期没有发生变化，但是当前日志的文件大小超过1KB时，对当前日志进行分割 重命名-->
    <appender name="file" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <File>${LOG_HOME}.log</File>
        <!-- rollingPolicy:当发生滚动时，决定 RollingFileAppender 的行为，涉及文件移动和重命名。 -->
        <!-- TimeBasedRollingPolicy： 最常用的滚动策略，它根据时间来制定滚动策略，既负责滚动也负责出发滚动 -->
        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
            <!-- 活动文件的名字会根据fileNamePattern的值，每隔一段时间改变一次 -->
            <!-- 文件名：log/demo.2017-12-05.0.log -->
            <fileNamePattern>${LOG_HOME}.%d.%i.log</fileNamePattern>
            <!-- 每产生一个日志文件，该日志文件的保存期限为30天 -->
            <maxHistory>30</maxHistory>
            <timeBasedFileNamingAndTriggeringPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedFNATP">
                <!-- maxFileSize:这是活动文件的大小，默认值是10MB，测试时可改成1KB看效果 -->
                <maxFileSize>10MB</maxFileSize>
            </timeBasedFileNamingAndTriggeringPolicy>
        </rollingPolicy>
        <encoder>
            <!-- pattern节点，用来设置日志的输入格式 -->
            <pattern>${PATTERN}</pattern>
            <!-- 记录日志的编码:此处设置字符集 - -->
            <charset>UTF-8</charset>
        </encoder>
    </appender>

    <appender name="async_log" class="ch.qos.logback.classic.AsyncAppender">
        <appender-ref ref="file"/>
    </appender>

    <!--TRACE, DEBUG, INFO, WARN, ERROR, ALL 和 OFF-->
    <!--环境-->
    <springProfile name="dev,test">
        <root level="info">
            <appender-ref ref="console"/>
            <appender-ref ref="async_log"/>
        </root>
        <!--控制打印级别 warn及以上appender  additivity="false" 为false 不向上传递打印2遍-->
        <logger name="cn.finemap" level="debug" additivity="false">
            <appender-ref ref="console"/>
            <appender-ref ref="async_log"/>
        </logger>
    </springProfile>

    <springProfile name="prod">
        <root level="warn">
            <appender-ref ref="console"/>
            <appender-ref ref="async_log"/>
        </root>
        <logger name="cn.finemap" level="warn" additivity="false">
            <appender-ref ref="console"/>
            <appender-ref ref="async_log"/>
        </logger>
    </springProfile>

</configuration>

fine-logs使用

1. 类上加入@Slf4j注解
2. 生成位置：.\应用\logs\应用.log

log使用

1. log.info(默认级别)

// 一般处理业务逻辑的时候使用,打印出数据,说明此处是干什么的
log.info("打印出当前类,entity:{}",entity);

2. log.error

// 用户程序报错，必须解决的时候使用此级别打印日志
log.error("出现异常:",e)

3. log.debug

// 一般放于程序的某个关键点的地方，用于打印一个变量值或者一个方法返回的信息之类的信息
log.debug("测试debug....")

4. log.warn

// 警告，不会影响程序的运行，但是值得注意。
log.warn("测试warn....")

5. log.trace

//  一般不会使用，在日志里边也不会打印出来，最低的一个日志级别。
log.trace("测试trace....")