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

背景
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。