版权声明：Collected by Bro_Rabbit only for study https://blog.csdn.net/weixin_38240095/article/details/88046127
1.日志框架
- 日志门面（抽象层）与日志实现
- Spring Boot：
底层时SpringFramework，默认使用JCL，但SpringBoot选用SLF4J和logback
2.使用SLF4J
2.1 如何在系统中使用？
- 在开发中，需要调用日志记录的方法时， 不应该直接调用日志实现类，而是调用日志抽象层定义的方法接口
- SLF4J+默认实现logback的简单使用
//导入SLF4J，logback的jar import org.slf4j.Logger; import org.slf4j.LoggerFactory; public class HelloWorld { public static void main(String[] args) { Logger logger = LoggerFactory.getLogger(HelloWorld.class); logger.info("Hello World"); } } - SLF4J日志层图示
每一个日志实现框架都有自己的配置文件。使用SLF4J以后，配置文件还是日志实现框架本身的配置
2.2 遗留问题： 统一日志记录
ProjectA（SLF4j+logback）：架设于Spring（commons-loggin）、Hibernate（jboss-logging）
需求：将底层使用的其他日志框架，统一使用SLF4J抽象层以规范输出 => 桥接：加层+替换
【如何将系统中所有日志都统一到SLF4J】
（1）将系统中其他的日志框架先行排除掉
（2）使用中间包替换原有的日志框架(xxx-over-slf4j.jar)
（3）导入SLF4J其他实现(slf4j-xxx.jar)
3. Spring Boot的日志关系
在pom.xml中右击选择Diagrams -> Show Dependencies 查看IDEA提供的依赖图谱
-
基本依赖 spring-boot-starter
<dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter</artifactId> <version>2.0.4.RELEASE</version> <scope>compile</scope> </dependency> -
Spring Boot使用spring-boot-starter-logging来做日志功能
<dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-logging</artifactId> <version>2.0.4.RELEASE</version> <scope>compile</scope> </dependency> -
中间替换包
与原日志框架完全相同的包组织结构，但在底层“偷换”逻辑，调用SLF4JLogger -
若引入其他框架集成，则一定要把该框架默认的日志依赖移除掉(exclusion)！Spring Boot将自动适配所有日志，统一使用SLF4J+logback进行记录！
4. Spring Boot的日志使用
4.1 默认配置
Spring Boot默认已配置日志功能
@Test
public void contextLoads() {
//得到SLF4J的日志记录器
Logger logger = LoggerFactory.getLogger(getClass());
//日志级别：由低到高为trace, debug, info, warn, error
//可以调整日志级别以增减日志记录，仅该级别及更高级别才会输出
logger.trace("trace格式化日志，过程信息");
logger.debug("debug格式化日志，调试信息");
//SpringBoot默认设置为info级别,没有在全局配置文件中指定级别的类就使用默认级别：root
logger.info("info日志，自定义信息");
logger.warn("warn格式化日志，警告信息");
logger.error("error格式化日志，错误信息");
}
4.2 在主配置文件中修改部分日志配置
#日志级别
logging.level.me.zj=debug
#日志输出文件
#若没有指定，则只在控制台Console输出
#使用相对路径日志文件将在当前工程下生成；使用绝对路径可以修改其位置
#logging.file=springboot.log
#日志输出路径，与logging.file（更高优先级）是冲突配置
#一般使用该配置，而不使用logging.file
#默认文件名spring.log，/表示当前工程所在磁盘的根路径
logging.path=/spring/log
#在控制台输出的日志格式
#logging.pattern.console=
#向文件输出的日志格式
#logging.pattern.file=
4.3 自定义日志配置（替换Spring Boot的默认配置文件）
-
举例：若使用logback日志框架，则在类路径下创建以 logback.xml或logback-spring.xml 为名的自定义配置（即每个日志框架自己的配置文件），Spring Boot就不会使用默认配置
<?xml version="1.0" encoding="UTF-8"?> <!-- scan：当此属性设置为true时，配置文件如果发生改变，将会被重新加载，默认值为true。 scanPeriod：设置监测配置文件是否有修改的时间间隔，如果没有给出时间单位，默认单位是毫秒当scan为true时，此属性生效。默认的时间间隔为1分钟。 debug：当此属性设置为true时，将打印出logback内部日志信息，实时查看logback运行状态。默认值为false。 --> <configuration scan="false" scanPeriod="60 seconds" debug="false"> <!-- 定义日志的根目录 --> <property name="LOG_HOME" value="/app/log" /> <!-- 定义日志文件名称 --> <property name="appName" value="atguigu-springboot"></property> <!-- ch.qos.logback.core.ConsoleAppender 表示控制台输出 --> <appender name="stdout" class="ch.qos.logback.core.ConsoleAppender"> <!-- 日志输出格式： %d表示日期时间， %thread表示线程名， %-5level：级别从左显示5个字符宽度 %logger{50} 表示logger名字最长50个字符，否则按照句点分割。 %msg：日志消息， %n是换行符 --> <layout class="ch.qos.logback.classic.PatternLayout"> <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{50} - %msg%n</pattern> </layout> </appender> <!-- 滚动记录文件，先将日志记录到指定文件，当符合某个条件时，将日志记录到其他文件 --> <appender name="appLogAppender" class="ch.qos.logback.core.rolling.RollingFileAppender"> <!-- 指定日志文件的名称 --> <file>${LOG_HOME}/${appName}.log</file> <!-- 当发生滚动时，决定 RollingFileAppender 的行为，涉及文件移动和重命名 TimeBasedRollingPolicy： 最常用的滚动策略，它根据时间来制定滚动策略，既负责滚动也负责触发滚动。 --> <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy"> <!-- 滚动时产生的文件的存放位置及文件名称 %d{yyyy-MM-dd}：按天进行日志滚动 %i：当文件大小超过maxFileSize时，按照i进行文件滚动 --> <fileNamePattern>${LOG_HOME}/${appName}-%d{yyyy-MM-dd}-%i.log</fileNamePattern> <!-- 可选节点，控制保留的归档文件的最大数量，超出数量就删除旧文件。假设设置每天滚动， 且maxHistory是365，则只保存最近365天的文件，删除之前的旧文件。注意，删除旧文件是， 那些为了归档而创建的目录也会被删除。 --> <MaxHistory>365</MaxHistory> <!-- 当日志文件超过maxFileSize指定的大小是，根据上面提到的%i进行日志文件滚动 注意此处配置SizeBasedTriggeringPolicy是无法实现按文件大小进行滚动的，必须配置timeBasedFileNamingAndTriggeringPolicy --> <timeBasedFileNamingAndTriggeringPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedFNATP"> <maxFileSize>100MB</maxFileSize> </timeBasedFileNamingAndTriggeringPolicy> </rollingPolicy> <!-- 日志输出格式： --> <layout class="ch.qos.logback.classic.PatternLayout"> <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [ %thread ] - [ %-5level ] [ %logger{50} : %line ] - %msg%n</pattern> </layout> </appender> <!-- logger主要用于存放日志对象，也可以定义日志类型、级别 name：表示匹配的logger类型前缀，也就是包的前半部分 level：要记录的日志级别，包括 TRACE < DEBUG < INFO < WARN < ERROR additivity：作用在于children-logger是否使用 rootLogger配置的appender进行输出， false：表示只用当前logger的appender-ref，true： 表示当前logger的appender-ref和rootLogger的appender-ref都有效 --> <!-- hibernate logger --> <logger name="com.atguigu" level="debug" /> <!-- Spring framework logger --> <logger name="org.springframework" level="debug" additivity="false"></logger> <!-- root与logger是父子关系，没有特别定义则默认为root，任何一个类只会和一个logger对应， 要么是定义的logger，要么是root，判断的关键在于找到这个logger，然后判断这个logger的appender和level。 --> <root level="info"> <appender-ref ref="stdout" /> <appender-ref ref="appLogAppender" /> </root> </configuration> -
其他日志框架
LoggingSystem Customization Logback logback-spring.xml
logback-spring.groovy
logback.xml
logback.groovyLog4j2 log4j2-spring.xml
log4j2.xmlJDK(JUL) logging.properties 【推荐使用xxx-spring.xml (spring后缀)，以开启高级功能SpringProfile】
logback.xml：直接被logback原生日志框架识别，绕过了Spring Boot
logback-spring.xml：原生框架不能识别该配置文件，由Spring Boot解析并开启 “按照环境激活配置” 的高级特性<springProfile name="staging"> <!-- configuration to be enabled when the "staging" profile is active --> </springProfile>
4.5 切换日志框架（以log4j/log4j2为例，替换logback）
- 按照SL4J的日志适配图，进行相关移除，导入（适配包+配置文件）
没有什么实际意义，logback本来就是log4j的升级实现，功能架构都更优 - 排除spring-starter-logging，使用spring-starter-log4j
<dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> <exclusions> <exclusion> <artifactId>spring-boot-starter-logging</artifactId> <groupId>org.springframework.boot</groupId> </exclusion> </exclusions> </dependency> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-log4j2</artifactId> </dependency>