Java 常见编码格式—

一、前言

　　Log4j目前使用的有两个版本，分别是v1.x和2.x，相关的信息可以查看官方文档：http://logging.apache.org/log4j/2.x/index.html

二、引入依赖

　　本文介绍log4j 2的用法，所以引入v2的jar包

<!--https://mvnrepository.com/artifact/org.apache.logging.log4j/log4j-core-->

<dependency>

	<groupId>org.apache.logging.log4j</groupId>

	<artifactId>log4j-core</artifactId>

	<version>2.12.1</version>

</dependency>

三、配置log4j

　　可以参考官方文档：http://logging.apache.org/log4j/2.x/manual/configuration.html

　　log4j v1使用properties文件进行配置；而log4j v2，常见的做法是使用xml进行配置。

　　在resources目录下创建一个log4j2.xml，注意不是log4j.xml，先看下面的一个简单的配置：

<?xml version="1.0" encoding="UTF-8"?>

<Configuration>

	<Appenders>

		<Console name="log_to_console" target="SYSTEM_OUT">

			<PatternLayout pattern=" %-5level %d{yyyy-MM-dd HH:mm:ss.SSS} [%t] %logger{36} - %msg%n"/>

		</Console>

		<File name="log_to_file" fileName="/opt/logs/app.log">

			<PatternLayout pattern=" %-5level %d{yyyy-MM-dd HH:mm:ss.SSS} [%t] %logger{36} - %msg%n"/>

		</File>

	</Appenders>

	<Loggers>

		<Root level="info">

			<AppenderRef ref="log_to_console"/>

		</Root>

	</Loggers>

</Configuration>

　　上面这个配置中，<Configuration>下有<Appenders>和<Loggers>两个标签。

　　其中<Appenders>可以理解为日志的输出方式，可以是日志文件(File），也可以是可控制台输出（Console）。

3.1、<appenders>配置日志输出方式

　　日志输出方式一般有两种，控制台输出（Console）和日志文件输出（File），在log4j 2中，分别对应<Console>和<File>标签。

<Appenders>

	<Console name="log_to_console" target="SYSTEM_OUT">

		<PatternLayout pattern=" %-5level %d{yyyy-MM-dd HH:mm:ss.SSS} [%t] %logger{36} - %msg%n"/>

	</Console>

	<File name="log_to_file" fileName="/opt/logs/app.log">

		<PatternLayout pattern=" %-5level %d{yyyy-MM-dd HH:mm:ss.SSS} [%t] %logger{36} - %msg%n"/>

	</File>

</Appenders>

　　上面定义了两个日志输出方式：

　　Console的输出方式，名称为log_to_console（这个名称是为了后面需要引用它），输出到SYSTEM_OUT（也就是控制台了）；

　　File的输出方式，名称为log_to_file（名称可以随意指定），然后指定了日志文件的路径为/opt/logs/app.log。

　　Console和File，其实可以统称为<Appender>（因为在<Appenders>标签下嘛）。

　　这两个标签都有一个<PatternLayout>标签，这就是指定输出的日志格式，具体的格式可以查看官方文档。

　　虽然日志有Console和File两种形式，但是还是<Appenders>中却可以配置多个Appender，比如虽然都为日志文件输出形式，但是文件名不同，就是不同的Appender，并不会冲突：

<Appenders>

	<Console name="log_to_console" target="SYSTEM_OUT">

		<PatternLayout pattern=" %-5level %d{yyyy-MM-dd HH:mm:ss.SSS} [%t] %logger{36} - %msg%n"/>

	</Console>

	<File name="log_to_file" fileName="/opt/logs/app.log">

		<PatternLayout pattern=" %-5level %d{yyyy-MM-dd HH:mm:ss.SSS} [%t] %logger{36} - %msg%n"/>

	</File>

	<!-- 再定义一个日志文件输出的Appender -->

	<File name="log_to_file_two" fileName="/opt/logs/app_2.log">

		<PatternLayout pattern=" %-5level %d{yyyy-MM-dd HH:mm:ss.SSS} [%t] %logger{36} - %msg%n"/>

	</File>

</Appenders>

3.2、<Loggers>配置日志级别

　　log4j 2有trace、debug、info、warn、error、fatal这几种日志级别，按照顺序严重程度递增。

　　而<Loggers>可以理解配置不同的日志级别使用不同的日志输出方式，看下面的配置：

<Loggers>

	<Root level="error">

		<AppenderRef ref="log_to_file"/>

	</Root>

	<logger level="info">

		<AppenderRef ref="log_to_console"/>

	</logger>

	<logger level="warn">

		<AppenderRef ref="log_to_file_two"/>

	</logger>

</Loggers>

　　上面的配置中，配置了三个<logger>（<Root>也算一个<logger>），每一个<logger>下面有一个<AppenderRef>，指定以什么形式输出日志（File还是Console）。

　　<Root>是一个比较特殊的<logger>，用来定义全局的日志界别，

　　一个<logger>下面可以有一个或者多个<AppenderRef>：

　　1、上面定义了全局的，只要是error级别或者比如error更高，都会将将日志写到/opt/logs/app.log中（log_to_file是前面<Appenders>中配置的)；

　　2、日志界别为info或者比info更高的级别，就会将日志输出到控制台（log_to_console是前面<Appenders>中配置的）；

　　3、日志界别为warn或者比warn更高的级别，就会将日志输出到/opt/logs/app_2.log（log_to_file_two是前面<Appenders>中配置的）；

3.3、稍微拓展

　　一个级别的日志，比如info日志，我们可能既需要输出到控制台，也需要输出到日志文件中。

　　log4j 2可以这样做，前面已经说过了，一个<logger>下可以有多个<AppenderRef>，比如下面这段配置：

<Loggers>

	<Root level="error">

		<AppenderRef ref="log_to_file"/>

	</Root>

	<!-- info或比info更高级别的日志，既输出到控制台，也输出到日志文件中-->

	<logger level="info">

		<AppenderRef ref="log_to_console"/>

		<AppenderRef ref="log_to_file"/>

	</logger>

</Loggers>

3.4、结合<Appenders>和<loggers>

　　有了前面的了解，下面是一个例子，就可以理解了：

<?xml version="1.0" encoding="UTF-8"?>

<Configuration>

	<Appenders>

		<Console name="log_to_console" target="SYSTEM_OUT">

			<PatternLayout pattern=" %-5level %d{yyyy-MM-dd HH:mm:ss.SSS} [%t] %logger{36} - %msg%n"/>

		</Console>

		<Console name="log_to_console_two" target="SYSTEM_OUT">

			<PatternLayout pattern=" %-5level %d{yyyy-MM-dd HH:mm:ss.SSS} [%t] %logger{36} - %msg%n"/>

		</Console>

		<File name="log_to_file" fileName="/opt/logs/app.log">

			<PatternLayout pattern=" %-5level %d{yyyy-MM-dd HH:mm:ss.SSS} [%t] %logger{36} - %msg%n"/>

		</File>

		<File name="log_to_file_two" fileName="/opt/logs/app_2.log">

			<PatternLayout pattern=" %-5level %d{yyyy-MM-dd HH:mm:ss.SSS} [%t] %logger{36} - %msg%n"/>

		</File>

	</Appenders>

	<Loggers>

		<Root level="error">

			<AppenderRef ref="log_to_console"/>

			<AppenderRef ref="log_to_file"/>

		</Root>

		<logger level="info">

			<AppenderRef ref="log_to_console"/>

			<AppenderRef ref="log_to_file"/>

		</logger>

		<logger level="warn">

			<AppenderRef ref="log_to_console_two"/>

		</logger>

	</Loggers>

</Configuration>

巴特西

Java 常见编码格式——URL、Base64