原理

Question

我正在开发一个基于Java的命令行工具。我想利用 slf4j 的日志记录抽象。

定期调用应用程序时

java -jar myapp.jar someparameter

那么申请应该给出＆＃34; plain＆＃34; stdout上的CLI输出，例如：

/some/file1
/some/file2

而是使用额外的--verbose标志/选项

调用应用程序

java -jar myapp.jar --verbose someparameter

然后应用程序将提供更高级的日志记录：

16:06:09.031 [main] DEBUG com.example.MyApp - Starting application.
16:06:09.031 [main] DEBUG com.example.MyApp - Entering directory /some/.
16:06:09.046 [main] INFO  com.example.MyApp - /some/file1
16:06:09.046 [main] INFO  com.example.MyApp - /some/file2

虽然很容易确定是否提供了--verbose（例如，通过使用 jCommander CLI库），但 slf4j 似乎不允许设置运行时期间的根记录器级别， slf4j 也不允许在运行时更改日志条目模式布局。

我在运行时（或至少在启动期间）修改日志级别和日志条目模式布局的选项是什么？

我应该避免使用 slf4j 抽象层的高尚立场，而是使用实际的底层日志记录实现（无论是 logback ， slf4j2 ，...）

其他基于Java的命令行工具是如何解决这一挑战的？

Answer 1

我建议使用＆＃34;装饰＆＃34;这个问题的模式。

您必须定义自己的LoggerFactory，并定义方法＆＃34; getLogger＆＃34; ......类似这样的事情：

public class LoggerFactory {
    public static Logger getLogger(String category) {
        return (Boolean.parseBoolean(System.getProperty("verboseFlag"))
                  ? org.slf4j.LoggerFactory.getLogger("verbose-" + category)
                  : org.slf4j.LoggerFactory.getLogger(category);
    }

然后在配置文件中，假设您使用的是log4j，则必须配置两个类别;一个带有详细前缀的另一个没有它...稍后，每个类别必须定义自己的appender，并且必须相应地配置每个appender ......

<log4j:configuration xmlns:log4j="http://jakarta.apache.org/log4j/">
        <appender name="VerboseConsoleAppender" class="org.apache.log4j.ConsoleAppender">
    <layout class="org.apache.log4j.PatternLayout">
        <param name="ConversionPattern" value="%d{yyyy-MM-dd HH:mm:ss,SSS} %-5p [%c] %m%n"/>
    </layout>
</appender>

        <appender name="RegularConsoleAppender" class="org.apache.log4j.ConsoleAppender">
    <layout class="org.apache.log4j.PatternLayout">
        <param name="ConversionPattern" value="%m%n"/>
    </layout>
</appender>
    <category name="verbose-org.xyz" additivity="false">
        <priority value="DEBUG" />
        <appender-ref ref="VerboseConsoleAppender" />
    </category>

    <category name="org.xyz" additivity="false">
        <priority value="INFO" />
        <appender-ref ref="RegularConsoleAppender" />
    </category>
</log4j:configuration>

Answer 2

我提出了以下解决方案：

对于命令行工具的可执行Java应用程序，我决定使用 slf4j 和 logback 。我将应用程序与两个回溯配置文件logback.xml和logback-verbose.xml捆绑在一起。

logback.xml：

<configuration>

  <appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
    <encoder>
      <pattern>%msg%n</pattern>
    </encoder>
  </appender>

  <root level="info">
    <appender-ref ref="STDOUT" />
  </root>

  <logger name="com.example.some.chatty.library.i.want.to.turn.off.logging" level="OFF">
    <appender-ref ref="STDOUT" />
  </logger>

</configuration>

logback-verbose.xml：

<configuration>
  <appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
    <encoder>
      <pattern>%date{ISO8601} [%-17thread] %-5level %-36logger - %msg%n</pattern>
    </encoder>
  </appender>

  <root level="debug">
    <appender-ref ref="STDOUT" />
  </root>
</configuration>

在应用程序启动阶段的早期，我检查--verbose标志。如果设置了该标志，我命令logback使用配置文件logback-verbose.xml而不是默认的logback.xml：

Application.java：

package com.example.my;
//

public class Application {

    public static void main(String[] args) throws Exception {

        // reconfigure JUL for slf4j
        LogManager.getLogManager().reset();
        SLF4JBridgeHandler.removeHandlersForRootLogger();
        SLF4JBridgeHandler.install();
        Logger.getLogger("global").setLevel(Level.FINEST);

        // about to check for verbose output request
        if ( isVerboseOutputRequested() ) {
            LoggerContext context = (LoggerContext) LoggerFactory.getILoggerFactory();

            try {
              JoranConfigurator configurator = new JoranConfigurator();
              configurator.setContext(context);
              // Call context.reset() to clear any previous configuration, e.g. default 
              // configuration. For multi-step configuration, omit calling context.reset().
              context.reset(); 
              configurator.doConfigure( getClass().getResourceAsStream("/logback-verbose.xml") );
            }
            catch (JoranException je) {
              // StatusPrinter will handle this
            }
            StatusPrinter.printInCaseOfErrorsOrWarnings(context);
        }

       startApplication(); 
    }

    // ... implement isVerboseOutputRequested() and startApplication()
}

原理

此设置记住了可执行Java应用程序与该应用程序使用的库之间的分离。

库只能依赖于 slf4j ，而可执行Java应用程序（只是该库的一个薄包装）依赖于 slf4j 和 logback ，以便为最终可执行工件提供实际的日志记录实现。

感谢 Carlitos Way 和 Tansir1 提供导致此解决方案的答案。

Answer 3

在运行时动态更改日志记录配置不是SLF4J的一部分。日志记录配置特定于抽象日志记录机制（log4j，logback等）。

假设您正在使用SLF4J下的Logback库，您可以通过更改JoranConfigurator以编程方式重新配置所有内容。此代码段是从Logback文档网站中的Invoking JoranConfigurator directly复制而来的。您可以从JoranConfigurator更改日志记录模式，appender，日志记录级别以及关于记录器的所有其他参数。

package chapters.configuration;

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

import ch.qos.logback.classic.LoggerContext;
import ch.qos.logback.classic.joran.JoranConfigurator;
import ch.qos.logback.core.joran.spi.JoranException;
import ch.qos.logback.core.util.StatusPrinter;

public class MyApp3 {
  final static Logger logger = LoggerFactory.getLogger(MyApp3.class);

  public static void main(String[] args) {
    // assume SLF4J is bound to logback in the current environment
    LoggerContext context = (LoggerContext) LoggerFactory.getILoggerFactory();

    try {
      JoranConfigurator configurator = new JoranConfigurator();
      configurator.setContext(context);
      // Call context.reset() to clear any previous configuration, e.g. default 
      // configuration. For multi-step configuration, omit calling context.reset().
      context.reset(); 
      configurator.doConfigure(args[0]);
    } catch (JoranException je) {
      // StatusPrinter will handle this
    }
    StatusPrinter.printInCaseOfErrorsOrWarnings(context);

    logger.info("Entering application.");

    Foo foo = new Foo();
    foo.doIt();
    logger.info("Exiting application.");
  }
}

Java命令行工具，详细输出标志

3 个答案:

原理