SpringBoot零基础详解三：springboot的日志使用及原理

Table of Contents

 

三：SpringBoot与日志

1:日志框架

2：SLF4j使用

2.1、如何在系统中使用SLF4j（官方网址：https://www.slf4j.org）

2.2:统一日志记录，即使是别的框架和我一起统一使用slf4j进行输出

3、SpringBoot日志关系

4：日志的使用

4.1：默认配置使用

4.2：指定配置---使用自己的日志文件代替spring默认的日志配置

5:切换日志框架

5.1：变成slf4j+log4j的方式；

5.2：切换为log4j2

---

三：SpringBoot与日志

1:日志框架

市面上的日志框架；

JUL、JCL、Jboss-logging、logback、log4j、log4j2、slf4j....

日志门面 （日志的抽象层）	日志实现
JCL（Jakarta Commons Logging） SLF4j（Simple Logging Facade for Java） jboss-logging	Log4j JUL（java.util.logging） Log4j2 Logback

左边选一个门面（抽象层）、右边来选一个实现；

SpringBoot选用 SLF4j和logback；

日志门面： SLF4J；

日志实现：Logback；

 

2：SLF4j使用

2.1、如何在系统中使用SLF4j（官方网址：https://www.slf4j.org）

以后开发的时候，日志记录方法的调用，不应该来直接调用日志的实现类，而是调用日志抽象层里面的方法；

给系统里面导入slf4j的jar和 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:统一日志记录，即使是别的框架和我一起统一使用slf4j进行输出

如何让系统中所有的日志都统一到slf4j；

1、将系统中其他日志框架先排除出去；

2、用中间包来替换原有的日志框架；

3、我们导入slf4j其他的实现

 

3、SpringBoot日志关系

<dependency>
	<groupId>org.springframework.boot</groupId>
	<artifactId>spring-boot-starter</artifactId>
</dependency>

利用starter启动器下的logging来实现日志功能

<dependency>
	<groupId>org.springframework.boot</groupId>
	<artifactId>spring-boot-starter-logging</artifactId>
</dependency>

底层依赖关系

总结：

1）、SpringBoot底层也是使用slf4j+logback的方式进行日志记录

2）、SpringBoot也把其他的日志都替换成了slf4j；

3）、中间替换包？

4）、如果我们要引入其他框架？一定要把这个框架的默认日志依赖移除掉？（2.x版本不需要了）

Spring框架用的是commons-logging；

<exclusions></exclusions>标签指的是排除某个依赖包

<dependency>
			<groupId>org.springframework</groupId>
			<artifactId>spring-core</artifactId>
			<exclusions>
				<exclusion>
					<groupId>commons-logging</groupId>
					<artifactId>commons-logging</artifactId>
				</exclusion>
			</exclusions>
		</dependency>

4：日志的使用

4.1：默认配置使用

1:SpringBoot默认帮我们配置好了日志；

 

2:logging.level.com.wkl=trace，可以改变指定包日志输出的级别；

3:指定日志输出位置

logging.file.name

#不指定路径的话就在当前项目下生成日志文件，
#也可以指定路径生成日志文件
logging.file.name=spring.log
logging.file.name=F:/spring.log

logging.file.path

#在当前指定目录下创建指定文件夹，这个文件夹下使用spring.log作为默认文件
#绝对路径
logging.file.path=/log
#相对路径
logging.file.path=./log

注：logging.file.name的优先级比logging.file.path的优先级高；

4：日志输出的格式

     日志输出格式：
        %d表示日期时间，
        %thread表示线程名，
        %-5level：级别从左显示5个字符宽度
        %logger{50} 表示logger名字最长50个字符，否则按照句点分割。 
        %msg：日志消息，
        %n是换行符

如：%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{50} - %msg%n

#控制台输出格式
logging.pattern.console=%d{yyyy-MM-dd HH:mm:ss.SSS}- [%thread]- %-5level -%logger{50} - %msg%n
#日志文件输出格式
logging.pattern.file=%d{yyyy-MM-dd HH:mm:ss.SSS} = [%thread] = %-5level = %logger{50} = %msg%n

4.2：指定配置---使用自己的日志文件代替spring默认的日志配置

给类路径下（resources）放上每个日志框架自己的配置文件即可；SpringBoot就不使用他默认配置的了

Logging System	Customization
Logback	logback-spring.xml, logback-spring.groovy, logback.xml or logback.groovy
Log4j2	log4j2-spring.xml or log4j2.xml
JDK (Java Util Logging)	logging.properties

注：

logback.xml：直接就被日志框架识别了；

logback-spring.xml：日志框架就不直接加载日志的配置项，由SpringBoot解析日志配置，可以使用SpringBoot的高级Profile功能 ;

 

5:切换日志框架

如果想使用其他的日志框架需要两步：

1：排除原有的日志框架

2：导入新的日志框架

例子：

5.1：变成slf4j+log4j的方式；

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
            <exclusions>
                <exclusion>
                    <artifactId>logback-classic</artifactId>
                    <groupId>ch.qos.logback</groupId>
                </exclusion>
                <exclusion>
                    <artifactId>log4j-to-slf4j</artifactId>
                    <groupId>org.apache.logging.log4j</groupId>
                </exclusion>
            </exclusions>
        </dependency>

        <dependency>
            <groupId>org.slf4j</groupId>
            <artifactId>slf4j-log4j12</artifactId>
        </dependency>

5.2：切换为log4j2

        <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>

注：更改框架参考上边那个图，灵活运用