《Apache MINA 2.0 用户指南》第十二章:日志过滤器

x33g5p2x  于2021-12-28 转载在 其他  
字(2.6k)|赞(0)|评价(0)|浏览(538)

        背景
Apache MINA 体系允许基于 MINA 的应用的开发者使用他们自己的日志系统。
SLF4J
MINA 使用了简单日志门面 (Simple Logging Facade for Java,SLF4J)。你可以在这里找到 SLF4J 的信息。这个日志工具允许任意数量的日志系统的实现。你可以使用 log4j、java.util.logging 或者其他日志系统。这个的精彩之处在于如果你在以后的开发处理中将 java.util.logging 改为 log4j,你完全不需要修改你的源代码。
选择合适的 jar 包

SLF4J 使用静态绑定。这意味着每个支持的日志框架都有自己的一个 jar 文件。你可以通过选择调用了你静态选择的日志框架的 jar 文件使用你喜爱的日志框架。以下是使用特定日志框架所需 jar 包的列表:

| 日志框架 | 需要的 jar 包 |
| Log4J 1.2.x | slf4j-api.jar, slf4j-log4j12.jar** |
| Log4J 1.3.x | slf4j-api.jar, slf4j-log4j13.jar |
| java.util.logging | slf4j-api.jar, slf4j-jdk14.jar** |
| Commons Logging | slf4j-api.jar, slf4j-jcl.jar |

        有几件事要记住:

  • slf4j-api.jar 是任何实现 jar 包里都必须的
  • 重要 你不可以把多个实现 jar 包放在 class path (比如 slf4j-log4j12.jar 和 slf4j-jdk14.jar 一起);这样可能会导致你的应用出现意想不到的行为。
  • slf4j-api.jar 和 slf4j-.jar 的版本应该一致。
            配置正确之后,你就可以继续去配置你具体选择的日志框架了 (比如,修改 log4j.properties)。
            覆盖 Jakarta Commons Logging
            SLF4J 也提供了一种办法在不修改源代码的情况下将使用 Jakarta Commons Logging 的应用转换为使用 SLF4J。 只需要将 commons-loggong jar 文件从 class path 中移除,然后添加 jcl104-over-slf4j.jar 到 class path。
            log4j 例子
            本示例我们将使用 log4j 日志系统。创建一个项目,然后讲以下代码片段放进一个叫做 log4j.properties 的文件:
# Set root logger level to DEBUG and its only appender to A1.
log4j.rootLogger=DEBUG, A1

# A1 is set to be a ConsoleAppender.
log4j.appender.A1=org.apache.log4j.ConsoleAppender

# A1 uses PatternLayout.
log4j.appender.A1.layout=org.apache.log4j.PatternLayout
log4j.appender.A1.layout.ConversionPattern=%-4r [%t] %-5p %c{1} %x - %m%n

        这个文件将被放在我们项目的 src 目录。如果你使用的是 IDE,在你测试你的代码的时候你需要将此配置文件放在 JVM 的 classpath 下。
        尽管这里演示了如何建立一个使用日志的 IoAcceptor,记住 SLF4J API 可能会在你的程序中的任何地方被使用,以生成适用于你的需求的恰当的日志信息。
        接下来我们建立一个简单的示例服务器以生成一些日志。这里我们采用的是 EchoServer 示例项目并添加日志到类中:

public static void main(String[] args) throws Exception {
    IoAcceptor acceptor = new SocketAcceptor();
    DefaultIoFilterChainBuilder chain = acceptor.getFilterChain();

LoggingFilter loggingFilter = new LoggingFilter();
    chain.addLast("logging", loggingFilter);

    acceptor.setLocalAddress(new InetSocketAddress(PORT));
    acceptor.setHandler(new EchoProtocolHandler());
    acceptor.bind();

    System.out.println("Listening on port " + PORT);
}

        正如你所看到的,我们移除了 addLogger 方法并在 EchoServer 示例中添加了两行。通过 LoggingFilter 的引用,你可以为你的处理器中 IoAcceptor 关联到的每个事件类型设置日志级别。为了定义触发日志的 IoHandler 事件并指定所执行的日志级别,LoggingFilter 定义了一个叫做 setLogLevel(IoEventType, LogLevel) 方法。以下是为这一方法的选项:

| IO 事件类型 | 描述 |
| SESSION_CREATED | 在新会话被建立时调用 |
| SESSION_OPENED | 在新会话被打开时调用 |
| SESSION_CLOSED | 在会话被关闭时调用 |
| MESSAGE_RECEIVED | 接收到数据时调用 |
| MESSAGE_SENT | 消息被发送时调用 |
| SESSION_IDLE | 到达会话空闲时间时调用 |
| EXCEPTION_CAUGHT | 有异常抛出时调用 |

        以下是为日志级别的描述:

| 日志级别 | 描述 |
| NONE | 这个将导致无视配置的存在而没有任何日志事件被创建 |
| TRACE | 在日志系统中创建一个 TRACE 事件 |
| DEBUG | 产生日志系统中的 debug 日志 |
| INFO | 产生日志系统中的信息消息日志 |
| WARN | 产生日志系统中的警告消息日志 |
| ERROR | 产生日志系统中的错误消息日志 |

        使用这些信息,你足以建立一个基本的日志系统了,并可以在此示例基础上进行扩展以为你自己的系统产生日志信息。
原文链接: http://mina.apache.org/mina-project/userguide/ch12-logging-filter/ch12-logging-filter.html

相关文章