MINA2官方教程翻译(4) 日志配置

一、背景

MINA框架允许开发人员在编写基于MINA的应用程序时使用自己熟悉的日志系统。

二、SLF4J

MINA框架使用Simple Logging Facade for Java (SLF4J)。你可以在这里获取到更多关于SLF4J的信息，这种日志系统兼容各种日志系统的实现。你可能会使用log4j、java.util.logging或其他的日志系统，使用这种日志框架的好处在于如果你在开发过程中，将日志系统从java.util.logging改为log4j，你根本需要修改你的代码。

选择正确的jar包

下面几点还需要注意：

• 对于任意一种日志系统，slf4j-api.jar是必须的；
• 重要：在classpath上不能放置多于一个日志系统实现jar包(例如slf4j-log4j12.jar and slf4j-jdk14.jar)，这将导致日志出席不可预知的行为；
• slf4j-api.jar 和 slf4j-<impl>.jar的版本应该是一致的。

如果SLF4J配置正确，你可以继续配置你真正使用的日志系统(例如修改log4j.properties)。

重载Jakarta Commons Logging

SLF4J提供了一种机制可以使现有的应用程序从使用Jakarta Commons Logging变更为SLF4J而不需要修改代码，只需要将commons-loggong JAR文件充classpath中除去，并将jcl104-over-slf4j.jar加入到classpath中。

三、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，当你测试代码是，你实际上是想把这个文件放置在classpath上。

注意：这里只是在IoAcceptor上设置了日志，但slf4j可以在程序中广泛使用，有了它的帮助，你可以根据需要获取到有用的信息。

下面我们编写一个简单的server从而生成一些日志信息，这里我们使用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); }

正如你所见，在EchoServer范例中，我们删除了addLogger方法并新增加了两行代码。通过LoggingFilter的引用，你可以在这里设置与IoAcceptor相关的所有事件的日志级别。在这里，可以使用LoggingFilter中的setLogLevel(IoEventType, LogLevel)方法来区分触发IoHandler日志的时间以及对应的日志级别，下面是这个方法选项：

下面是日志级别的描述：

根据这些信息，你应该可以扩展这些范例来构建一个使用日志的简单系统，这些日志将为你提供有用的信息。