Windows Java桌面应用程序集成slf4j实现日志持久化

Windows上一般的应用程序也可以通过日志系统打印日志到指定文件。通过这个例子想说明，问题处理的方法是多种多样的，一种组件的应用场合也是多样的，平时slf4j日志系统多用于Web程序，其实桌面程序等一样可以使用。在真实开发自己的一个Java桌面应用的时候，这还是必须的，否则运行异常日志无法收集。System.out.println毕竟只能用于Hello World这种小的Demo程序，日志系统是现代软件的标准组件。

本文使用的日志实现是log4j，为此需要引入3个jar，slf4j-api这个是日志门面，slf4j-log4j是沟通门面slf4j-api和log4j的桥梁，log4j中包含了具体的日志打印实现。这些jar包在maven公共仓库中都很容器找到，直接下来即可使用，或者直接创建maven工程引入这些jar包。

1 log4j日志系统对配置文件的选择

查看log4j-1.2.17.jar中的加载配置文件的源码LogManager.java、OptionConverter.java，可以看到如果log4j使用哪个配置文件配置日志系统由以下变量决定
public static final String DEFAULT_CONFIGURATION_FILE = “log4j.properties”;
static final String DEFAULT_XML_CONFIGURATION_FILE = “log4j.xml”;
public static final String DEFAULT_CONFIGURATION_KEY = “log4j.configuration”; 优先顺序依次是：
1)、使用环境变量log4j.configuration的值指定的配置文件，要求配置的文件是xml或者是properties文件
2)、没有log4j.configuration指定的配置文件则使用配置文件log4j.xml
3)、没有log4j.xml则使用配置文件log4j.properties

2 代码实现

step1：引入需要的jar包在工程中引入jar包slf4j-api-1.7.7.jar、slf4j-log4j12-1.7.7.jar、log4j-1.2.17.jar 对应的maven配置如下：

<!-- https://mvnrepository.com/artifact/org.slf4j/slf4j-api -->
<dependency>
    <groupId>org.slf4j</groupId>
    <artifactId>slf4j-api</artifactId>
    <version>1.7.7</version>
</dependency>
<!-- https://mvnrepository.com/artifact/org.slf4j/slf4j-log4j12 -->
<dependency>
    <groupId>org.slf4j</groupId>
    <artifactId>slf4j-log4j12</artifactId>
    <version>1.7.7</version>
</dependency>
<!-- https://mvnrepository.com/artifact/log4j/log4j -->
<dependency>
    <groupId>log4j</groupId>
    <artifactId>log4j</artifactId>
    <version>1.2.17</version>
</dependency>

step2：代码实现如果直接使用logback.xml或logback.properties，文件命名不允许变化，且文件的位置必须按规定防止，所以这里使用设置JVM变量的方式决定加载哪个配置文件。这样文件配置的灵活性好一点。

package com.desktopapp.testslf4j;

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

public class TestDesktopAppSlf4j
{
    static
    {
        //指定配置文件加载路径
        System.setProperty("log4j.configuration", "file:./Prj/src/main/java/com/desktopapp/testslf4j/testlog4j.xml");
        LOGGER = LoggerFactory.getLogger(TestDesktopAppSlf4j.class);
    }

    public static Logger LOGGER;

    public static void main(String[] args)
    {
        System.out.println(System.getProperty("user.dir"));
        LOGGER.trace("this is trace log from Windows Java Desktop Application");
        LOGGER.debug("this is debug log from Windows Java Desktop Application");
        LOGGER.info("this is info log from Windows Java Desktop Application");
        LOGGER.warn("this is warn log from Windows Java Desktop Application");
        LOGGER.error("this is error log from Windows Java Desktop Application");
    }
}

testlog4j.xml内容如下：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE log4j:configuration SYSTEM "log4j.dtd">
<log4j:configuration>
    <appender name="fileAppender" class="org.apache.log4j.FileAppender">
        <param name="File" value="d:/logs/testlog4j.log"/>
        <!-- 设置为true直接在源文件后面追加，设置为false覆盖原内容 -->
        <param name="Append" value="true"/>
        <param name="Threshold" value="DEBUG"/>
        <!-- 如果启用缓存,输出日志比较少的情况下不会立刻被输出 -->
        <param name="BufferedIO" value="false"/>
        <!-- 上面的BufferedIO设置为true这里才能生效 -->
        <param name="BufferSize" value="512"/>
        <layout class="org.apache.log4j.PatternLayout">
            <!-- %p表示级别,%d表示日期时间,%m表示日志输出信息,%c表示输出日志的类(使用了%l可以不写,%l已有完整类和函数信息输出),%l表示行号,%n表示换行 -->
            <param name="ConversionPattern" value="[%p] [%d{yyyy-MM-dd HH:mm:ss SSS}] [%m] [%c] [%l]%n"/>
        </layout>
    </appender>
    <root>
        <appender-ref ref="fileAppender"/>
    </root>
</log4j:configuration>

最后在文件D:\logs\testlog4j.log中的执行一次以上程序打印效果如下：

[DEBUG] [2018-09-14 00:22:55 048] [this is debug log from Windows Java Desktop Application] [com.desktopapp.testslf4j.TestDesktopAppSlf4j] [com.desktopapp.testslf4j.TestDesktopAppSlf4j.main(TestDesktopAppSlf4j.java:21)]
[INFO] [2018-09-14 00:22:55 051] [this is info log from Windows Java Desktop Application] [com.desktopapp.testslf4j.TestDesktopAppSlf4j] [com.desktopapp.testslf4j.TestDesktopAppSlf4j.main(TestDesktopAppSlf4j.java:22)]
[WARN] [2018-09-14 00:22:55 051] [this is warn log from Windows Java Desktop Application] [com.desktopapp.testslf4j.TestDesktopAppSlf4j] [com.desktopapp.testslf4j.TestDesktopAppSlf4j.main(TestDesktopAppSlf4j.java:23)]
[ERROR] [2018-09-14 00:22:55 051] [this is error log from Windows Java Desktop Application] [com.desktopapp.testslf4j.TestDesktopAppSlf4j] [com.desktopapp.testslf4j.TestDesktopAppSlf4j.main(TestDesktopAppSlf4j.java:24)]

log4j提供了5种Appender，分别是
org.apache.log4j.RollingFileAppender
org.apache.log4j.ConsoleAppender
org.apache.log4j.FileAppender
org.apache.log4j.DailyRollingFileAppender
org.apache.log4j.WriterAppender
程序中xml配置只使用了org.apache.log4j.FileAppend，其他可以根据自己的需要配置，这里就不再展开讲了。有了以上的程序，大家应该对商用的软件怎样采集日志不会再那么神秘了吧，必要的话，放弃System.out.println吧。