Apache Mina 文档翻译

10477777

第十章 - Executor Filter
　　在MINA 1.X的版本里，你可以在Acceptor级别定义线程模型。这是Acceptor设定的一部分。但是这种做法带来了复杂性，所以MINA的开发团队决定废弃这种方式，取而代之的是个更加灵活的方式，基于Filter：ExecutorFilter



ExecutorFilter类
　　这个类实现了IoFilter接口，它里面包含一个Executor，并且把进来的事件转交给线程池来处理。这种方式可以让应用程序更加有效的利用处理器，特别是处理CPU敏感的任务。

如果绝大部分处理都是在你的应用中完成，这个Filter可以被放置在IoHandler之前。或者放在某些CPU敏感的Filter之前（如CodecFilter）。



第十二章 - 日志Filter
　　Apache MINA的日志系统允许开发者在MINA的应用程序中使用自己喜欢的日志系统。



SLF4J
　　MINA使用了Simple Logging Facade for Java (SLF4J)。SLF4J的详细信息可以看这里：http://www.slf4j.org/。 这个日志工具允许你使用很多种日志系统的实现。你可以使用log4j, java.util.logging 或其他的日志系统。 使用这个工具的好处是你可以在不改变代码的情况下切换日志系统。



选择正确的JAR文件
　　SLF4J使用静态绑定，也就是说针对每一个日志框架都有一个对应的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放到classpath里。(例如 slf4j-log4j12.jar 和 slf4j-jdk14.jar); 这会带来一些意想不到的问题。
    slf4j-api.jar的版本和slf4j-.jar的版本应该一致

上面的JAR文件配置好以后，接下来就是配置实际的日志框架（例如：修改log4j.properties）



重写Jakarta Commons Logging
　　SLF4J提供一种方式可以在不更改代码的情况下把Jakarta Commons Logging 替换为SLF4J。 只需要吧classpath下的commons-logging的jar文件删除，并把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，在测试的时候，记住要把这个文件配置到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);
}
　　

我们在EchoServer的例子中删除了addLogger方法，添加了两行代码。在LoggingFilter中你可以为这个IoAcceptor关联的IoHandler中的每一个事件类型设置日志级别。在LoggingFilter里有一个setLogLevel(IoEventType, LogLevel)方法。下面是可选的参数。

IoEventType	描述
SESSION_CREATED	当会话建立时调用
SESSION_OPENED	当会话打开时调用
SESSION_CLOSED	当会话关闭时调用
MESSAGE_RECEIVED	当接收到数据时调用
MESSAGE_SENT	当消息发送时调用
SESSION_IDLE	当会话进入空闲状态时调用
EXCEPTION_CAUGHT	当异常产生时调用

　　
下面是LogLevel的描述:

LogLevel	描述
NONE	无论怎么配置都不产生日志
TRACE	日志系统的TRACE级别
DEBUG	日志系统的DEBUG级别
INFO	日志系统的INFO级别
WARN	日志系统的WARN级别
ERROR	日志系统的ERROR级别