mina 的过滤器的设计非常好。 有兴趣的朋友可以加群QQ: 330535028 大家相互学习: 技术的乐趣是分享,希望大家相互学习,
IoFilter 的作用:
(1)记录事件的日志(这个在本文中关于LoggingFilter 的讲述中会提到)
(2)测量系统性能
(3)信息验证
(4)过载控制
(5)信息的转换 (例如:编码和解码,这个会在关于 ProtocolCodecFilter 的讲述中会提到)
(6)和其他更多的信息
所用的方法 :
(1)sessionCreated()
(2)sessionOpened()
(3)sessionClosed()
(4)sessionIdle()
(5)exceptionCaught()
(6)messageReceived()
(7)messageSent()
(8)filterWrite()
(9)filterClose()
这几个方法都由相应会话(或者说是连接的状态,读、写、空闲、连接的开闭等)的状态的
改变来触发的。当一个会话开启时, LoggingFilter 捕获到会话开启的事件,会触发
sessionCreated()方法,记录该会话开启的日志信息。同样当一个会话发送数据时,Logging
捕获到会话发送消息的事件会记录消息发送的日志信息。 这里只是给出 messageReceived()
的完成方法的实现,其他方法的完整实现请参考附件中 LoggingFilter 的源码。
贴一个:LoggeringFilert的源码 供学习使用,如果有不会的直接copy LoggigFilter代码作为参考学习
/*
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you under the Apache License, Version 2.0 (the
* "License"); you may not use this file except in compliance
* with the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing,
* software distributed under the License is distributed on an
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
* KIND, either express or implied. See the License for the
* specific language governing permissions and limitations
* under the License.
*
*/
package org.apache.mina.filter.logging;
import org.apache.mina.core.filterchain.IoFilter;
import org.apache.mina.core.filterchain.IoFilterAdapter;
import org.apache.mina.core.session.IdleStatus;
import org.apache.mina.core.session.IoEventType;
import org.apache.mina.core.session.IoSession;
import org.apache.mina.core.write.WriteRequest;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
/**
* Logs all MINA protocol events. Each event can be
* tuned to use a different level based on the user's specific requirements. Methods
* are in place that allow the user to use either the get or set method for each event
* and pass in the {@link IoEventType} and the {@link LogLevel}.
*
* By default, all events are logged to the {@link LogLevel#INFO} level except
* {@link IoFilterAdapter#exceptionCaught(IoFilter.NextFilter, IoSession, Throwable)},
* which is logged to {@link LogLevel#WARN}.
*
* @author <a href="http://mina.apache.org">Apache MINA Project</a>
* @org.apache.xbean.XBean
*/
public class LoggingFilter extends IoFilterAdapter {
/** The logger name */
private final String name;
/** The logger */
private final Logger logger;
/** The log level for the exceptionCaught event. Default to WARN. */
private LogLevel exceptionCaughtLevel = LogLevel.WARN;
/** The log level for the messageSent event. Default to INFO. */
private LogLevel messageSentLevel = LogLevel.INFO;
/** The log level for the messageReceived event. Default to INFO. */
private LogLevel messageReceivedLevel = LogLevel.INFO;
/** The log level for the sessionCreated event. Default to INFO. */
private LogLevel sessionCreatedLevel = LogLevel.INFO;
/** The log level for the sessionOpened event. Default to INFO. */
private LogLevel sessionOpenedLevel = LogLevel.INFO;
/** The log level for the sessionIdle event. Default to INFO. */
private LogLevel sessionIdleLevel = LogLevel.INFO;
/** The log level for the sessionClosed event. Default to INFO. */
private LogLevel sessionClosedLevel = LogLevel.INFO;
/**
* Default Constructor.
*/
public LoggingFilter() {
this(LoggingFilter.class.getName());
}
/**
* Create a new NoopFilter using a class name
*
* @param clazz the cass which name will be used to create the logger
*/
public LoggingFilter(Class<?> clazz) {
this(clazz.getName());
}
/**
* Create a new NoopFilter using a name
*
* @param name the name used to create the logger. If null, will default to "NoopFilter"
*/
public LoggingFilter(String name) {
if (name == null) {
this.name = LoggingFilter.class.getName();
} else {
this.name = name;
}
logger = LoggerFactory.getLogger(this.name);
}
/**
* @return The logger's name
*/
public String getName() {
return name;
}
/**
* Log if the logger and the current event log level are compatible. We log
* a message and an exception.
*
* @param eventLevel the event log level as requested by the user
* @param message the message to log
* @param cause the exception cause to log
*/
private void log(LogLevel eventLevel, String message, Throwable cause) {
switch (eventLevel) {
case TRACE:
logger.trace(message, cause);
return;
case DEBUG:
logger.debug(message, cause);
return;
case INFO:
logger.info(message, cause);
return;
case WARN:
logger.warn(message, cause);
return;
case ERROR:
logger.error(message, cause);
return;
default:
return;
}
}
/**
* Log if the logger and the current event log level are compatible. We log
* a formated message and its parameters.
*
* @param eventLevel the event log level as requested by the user
* @param message the formated message to log
* @param param the parameter injected into the message
*/
private void log(LogLevel eventLevel, String message, Object param) {
switch (eventLevel) {
case TRACE:
logger.trace(message, param);
return;
case DEBUG:
logger.debug(message, param);
return;
case INFO:
logger.info(message, param);
return;
case WARN:
logger.warn(message, param);
return;
case ERROR:
logger.error(message, param);
return;
default:
return;
}
}
/**
* Log if the logger and the current event log level are compatible. We log
* a simple message.
*
* @param eventLevel the event log level as requested by the user
* @param message the message to log
*/
private void log(LogLevel eventLevel, String message) {
switch (eventLevel) {
case TRACE:
logger.trace(message);
return;
case DEBUG:
logger.debug(message);
return;
case INFO:
logger.info(message);
return;
case WARN:
logger.warn(message);
return;
case ERROR:
logger.error(message);
return;
default:
return;
}
}
@Override
public void exceptionCaught(NextFilter nextFilter, IoSession session, Throwable cause) throws Exception {
log(exceptionCaughtLevel, "EXCEPTION :", cause);
nextFilter.exceptionCaught(session, cause);
}
@Override
public void messageReceived(NextFilter nextFilter, IoSession session, Object message) throws Exception {
log(messageReceivedLevel, "RECEIVED: {}", message);
nextFilter.messageReceived(session, message);
}
@Override
public void messageSent(NextFilter nextFilter, IoSession session, WriteRequest writeRequest) throws Exception {
log(messageSentLevel, "SENT: {}", writeRequest.getMessage());
nextFilter.messageSent(session, writeRequest);
}
@Override
public void sessionCreated(NextFilter nextFilter, IoSession session) throws Exception {
log(sessionCreatedLevel, "CREATED");
nextFilter.sessionCreated(session);
}
@Override
public void sessionOpened(NextFilter nextFilter, IoSession session) throws Exception {
log(sessionOpenedLevel, "OPENED");
nextFilter.sessionOpened(session);
}
@Override
public void sessionIdle(NextFilter nextFilter, IoSession session, IdleStatus status) throws Exception {
log(sessionIdleLevel, "IDLE");
nextFilter.sessionIdle(session, status);
}
@Override
public void sessionClosed(NextFilter nextFilter, IoSession session) throws Exception {
log(sessionClosedLevel, "CLOSED");
nextFilter.sessionClosed(session);
}
/**
* Set the LogLevel for the ExceptionCaught event.
*
* @param level The LogLevel to set
*/
public void setExceptionCaughtLogLevel(LogLevel level) {
exceptionCaughtLevel = level;
}
/**
* Get the LogLevel for the ExceptionCaught event.
*
* @return The LogLevel for the ExceptionCaught eventType
*/
public LogLevel getExceptionCaughtLogLevel() {
return exceptionCaughtLevel;
}
/**
* Set the LogLevel for the MessageReceived event.
*
* @param level The LogLevel to set
*/
public void setMessageReceivedLogLevel(LogLevel level) {
messageReceivedLevel = level;
}
/**
* Get the LogLevel for the MessageReceived event.
*
* @return The LogLevel for the MessageReceived eventType
*/
public LogLevel getMessageReceivedLogLevel() {
return messageReceivedLevel;
}
/**
* Set the LogLevel for the MessageSent event.
*
* @param level The LogLevel to set
*/
public void setMessageSentLogLevel(LogLevel level) {
messageSentLevel = level;
}
/**
* Get the LogLevel for the MessageSent event.
*
* @return The LogLevel for the MessageSent eventType
*/
public LogLevel getMessageSentLogLevel() {
return messageSentLevel;
}
/**
* Set the LogLevel for the SessionCreated event.
*
* @param level The LogLevel to set
*/
public void setSessionCreatedLogLevel(LogLevel level) {
sessionCreatedLevel = level;
}
/**
* Get the LogLevel for the SessionCreated event.
*
* @return The LogLevel for the SessionCreated eventType
*/
public LogLevel getSessionCreatedLogLevel() {
return sessionCreatedLevel;
}
/**
* Set the LogLevel for the SessionOpened event.
*
* @param level The LogLevel to set
*/
public void setSessionOpenedLogLevel(LogLevel level) {
sessionOpenedLevel = level;
}
/**
* Get the LogLevel for the SessionOpened event.
*
* @return The LogLevel for the SessionOpened eventType
*/
public LogLevel getSessionOpenedLogLevel() {
return sessionOpenedLevel;
}
/**
* Set the LogLevel for the SessionIdle event.
*
* @param level The LogLevel to set
*/
public void setSessionIdleLogLevel(LogLevel level) {
sessionIdleLevel = level;
}
/**
* Get the LogLevel for the SessionIdle event.
*
* @return The LogLevel for the SessionIdle eventType
*/
public LogLevel getSessionIdleLogLevel() {
return sessionIdleLevel;
}
/**
* Set the LogLevel for the SessionClosed event.
*
* @param level The LogLevel to set
*/
public void setSessionClosedLogLevel(LogLevel level) {
sessionClosedLevel = level;
}
/**
* Get the LogLevel for the SessionClosed event.
*
* @return The LogLevel for the SessionClosed eventType
*/
public LogLevel getSessionClosedLogLevel() {
return sessionClosedLevel;
}
}
/*
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you under the Apache License, Version 2.0 (the
* "License"); you may not use this file except in compliance
* with the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing,
* software distributed under the License is distributed on an
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
* KIND, either express or implied. See the License for the
* specific language governing permissions and limitations
* under the License.
*
*/
package org.apache.mina.filter.logging;
import org.apache.mina.core.filterchain.IoFilter;
import org.apache.mina.core.filterchain.IoFilterAdapter;
import org.apache.mina.core.session.IdleStatus;
import org.apache.mina.core.session.IoEventType;
import org.apache.mina.core.session.IoSession;
import org.apache.mina.core.write.WriteRequest;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
/**
* Logs all MINA protocol events. Each event can be
* tuned to use a different level based on the user's specific requirements. Methods
* are in place that allow the user to use either the get or set method for each event
* and pass in the {@link IoEventType} and the {@link LogLevel}.
*
* By default, all events are logged to the {@link LogLevel#INFO} level except
* {@link IoFilterAdapter#exceptionCaught(IoFilter.NextFilter, IoSession, Throwable)},
* which is logged to {@link LogLevel#WARN}.
*
* @author <a href="http://mina.apache.org">Apache MINA Project</a>
* @org.apache.xbean.XBean
*/
public class LoggingFilter extends IoFilterAdapter {
/** The logger name */
private final String name;
/** The logger */
private final Logger logger;
/** The log level for the exceptionCaught event. Default to WARN. */
private LogLevel exceptionCaughtLevel = LogLevel.WARN;
/** The log level for the messageSent event. Default to INFO. */
private LogLevel messageSentLevel = LogLevel.INFO;
/** The log level for the messageReceived event. Default to INFO. */
private LogLevel messageReceivedLevel = LogLevel.INFO;
/** The log level for the sessionCreated event. Default to INFO. */
private LogLevel sessionCreatedLevel = LogLevel.INFO;
/** The log level for the sessionOpened event. Default to INFO. */
private LogLevel sessionOpenedLevel = LogLevel.INFO;
/** The log level for the sessionIdle event. Default to INFO. */
private LogLevel sessionIdleLevel = LogLevel.INFO;
/** The log level for the sessionClosed event. Default to INFO. */
private LogLevel sessionClosedLevel = LogLevel.INFO;
/**
* Default Constructor.
*/
public LoggingFilter() {
this(LoggingFilter.class.getName());
}
/**
* Create a new NoopFilter using a class name
*
* @param clazz the cass which name will be used to create the logger
*/
public LoggingFilter(Class<?> clazz) {
this(clazz.getName());
}
/**
* Create a new NoopFilter using a name
*
* @param name the name used to create the logger. If null, will default to "NoopFilter"
*/
public LoggingFilter(String name) {
if (name == null) {
this.name = LoggingFilter.class.getName();
} else {
this.name = name;
}
logger = LoggerFactory.getLogger(this.name);
}
/**
* @return The logger's name
*/
public String getName() {
return name;
}
/**
* Log if the logger and the current event log level are compatible. We log
* a message and an exception.
*
* @param eventLevel the event log level as requested by the user
* @param message the message to log
* @param cause the exception cause to log
*/
private void log(LogLevel eventLevel, String message, Throwable cause) {
switch (eventLevel) {
case TRACE:
logger.trace(message, cause);
return;
case DEBUG:
logger.debug(message, cause);
return;
case INFO:
logger.info(message, cause);
return;
case WARN:
logger.warn(message, cause);
return;
case ERROR:
logger.error(message, cause);
return;
default:
return;
}
}
/**
* Log if the logger and the current event log level are compatible. We log
* a formated message and its parameters.
*
* @param eventLevel the event log level as requested by the user
* @param message the formated message to log
* @param param the parameter injected into the message
*/
private void log(LogLevel eventLevel, String message, Object param) {
switch (eventLevel) {
case TRACE:
logger.trace(message, param);
return;
case DEBUG:
logger.debug(message, param);
return;
case INFO:
logger.info(message, param);
return;
case WARN:
logger.warn(message, param);
return;
case ERROR:
logger.error(message, param);
return;
default:
return;
}
}
/**
* Log if the logger and the current event log level are compatible. We log
* a simple message.
*
* @param eventLevel the event log level as requested by the user
* @param message the message to log
*/
private void log(LogLevel eventLevel, String message) {
switch (eventLevel) {
case TRACE:
logger.trace(message);
return;
case DEBUG:
logger.debug(message);
return;
case INFO:
logger.info(message);
return;
case WARN:
logger.warn(message);
return;
case ERROR:
logger.error(message);
return;
default:
return;
}
}
@Override
public void exceptionCaught(NextFilter nextFilter, IoSession session, Throwable cause) throws Exception {
log(exceptionCaughtLevel, "EXCEPTION :", cause);
nextFilter.exceptionCaught(session, cause);
}
@Override
public void messageReceived(NextFilter nextFilter, IoSession session, Object message) throws Exception {
log(messageReceivedLevel, "RECEIVED: {}", message);
nextFilter.messageReceived(session, message);
}
@Override
public void messageSent(NextFilter nextFilter, IoSession session, WriteRequest writeRequest) throws Exception {
log(messageSentLevel, "SENT: {}", writeRequest.getMessage());
nextFilter.messageSent(session, writeRequest);
}
@Override
public void sessionCreated(NextFilter nextFilter, IoSession session) throws Exception {
log(sessionCreatedLevel, "CREATED");
nextFilter.sessionCreated(session);
}
@Override
public void sessionOpened(NextFilter nextFilter, IoSession session) throws Exception {
log(sessionOpenedLevel, "OPENED");
nextFilter.sessionOpened(session);
}
@Override
public void sessionIdle(NextFilter nextFilter, IoSession session, IdleStatus status) throws Exception {
log(sessionIdleLevel, "IDLE");
nextFilter.sessionIdle(session, status);
}
@Override
public void sessionClosed(NextFilter nextFilter, IoSession session) throws Exception {
log(sessionClosedLevel, "CLOSED");
nextFilter.sessionClosed(session);
}
/**
* Set the LogLevel for the ExceptionCaught event.
*
* @param level The LogLevel to set
*/
public void setExceptionCaughtLogLevel(LogLevel level) {
exceptionCaughtLevel = level;
}
/**
* Get the LogLevel for the ExceptionCaught event.
*
* @return The LogLevel for the ExceptionCaught eventType
*/
public LogLevel getExceptionCaughtLogLevel() {
return exceptionCaughtLevel;
}
/**
* Set the LogLevel for the MessageReceived event.
*
* @param level The LogLevel to set
*/
public void setMessageReceivedLogLevel(LogLevel level) {
messageReceivedLevel = level;
}
/**
* Get the LogLevel for the MessageReceived event.
*
* @return The LogLevel for the MessageReceived eventType
*/
public LogLevel getMessageReceivedLogLevel() {
return messageReceivedLevel;
}
/**
* Set the LogLevel for the MessageSent event.
*
* @param level The LogLevel to set
*/
public void setMessageSentLogLevel(LogLevel level) {
messageSentLevel = level;
}
/**
* Get the LogLevel for the MessageSent event.
*
* @return The LogLevel for the MessageSent eventType
*/
public LogLevel getMessageSentLogLevel() {
return messageSentLevel;
}
/**
* Set the LogLevel for the SessionCreated event.
*
* @param level The LogLevel to set
*/
public void setSessionCreatedLogLevel(LogLevel level) {
sessionCreatedLevel = level;
}
/**
* Get the LogLevel for the SessionCreated event.
*
* @return The LogLevel for the SessionCreated eventType
*/
public LogLevel getSessionCreatedLogLevel() {
return sessionCreatedLevel;
}
/**
* Set the LogLevel for the SessionOpened event.
*
* @param level The LogLevel to set
*/
public void setSessionOpenedLogLevel(LogLevel level) {
sessionOpenedLevel = level;
}
/**
* Get the LogLevel for the SessionOpened event.
*
* @return The LogLevel for the SessionOpened eventType
*/
public LogLevel getSessionOpenedLogLevel() {
return sessionOpenedLevel;
}
/**
* Set the LogLevel for the SessionIdle event.
*
* @param level The LogLevel to set
*/
public void setSessionIdleLogLevel(LogLevel level) {
sessionIdleLevel = level;
}
/**
* Get the LogLevel for the SessionIdle event.
*
* @return The LogLevel for the SessionIdle eventType
*/
public LogLevel getSessionIdleLogLevel() {
return sessionIdleLevel;
}
/**
* Set the LogLevel for the SessionClosed event.
*
* @param level The LogLevel to set
*/
public void setSessionClosedLogLevel(LogLevel level) {
sessionClosedLevel = level;
}
/**
* Get the LogLevel for the SessionClosed event.
*
* @return The LogLevel for the SessionClosed eventType
*/
public LogLevel getSessionClosedLogLevel() {
return sessionClosedLevel;
}
}