9.3示例1：日志Filter

9.3示例1：日志Filter

实例简介

作为第1个例子，将做一个简单的Filter：

在app09a的应用中把Request请求的URL记录到日志文本文件中。
日志文本文件名通过Filter的初始化参数来配置。
- 此外，日志的每条记录都会有一个前缀，该前缀也由Filter初始化参数来定义。

通过日志文件，可以获得许多有用的信息，例如在应用中哪些资源访问最频繁；Web站点在一天中的哪个时间段访问量最多。

这个Filter的类名叫LoggingFilter，一般情况下，Filter的类名都以*Filter结尾。

LoggingFilter类

package filter;
import java.io.File;
import java.io.FileNotFoundException;
import java.io.IOException;
import java.io.PrintWriter;
import java.text.DateFormat;
import java.util.Date;
import javax.servlet.Filter;
import javax.servlet.FilterChain;
import javax.servlet.FilterConfig;
import javax.servlet.ServletException;
import javax.servlet.ServletRequest;
import javax.servlet.ServletResponse;
import javax.servlet.annotation.WebFilter;
import javax.servlet.annotation.WebInitParam;
import javax.servlet.http.HttpServletRequest;
@WebFilter(
	filterName = "LoggingFilter",
	urlPatterns ={"/*"},
	initParams = {
		@WebInitParam(
			name = "logFileName",
			value = "log.txt"
		),
		@WebInitParam(
			name = "prefix",
			value = "URI: "
		)
	}
)
public class LoggingFilter
	implements
		Filter
{
	private PrintWriter logger;
	private String prefix;
	static DateFormat format=
		DateFormat.getDateTimeInstance(
			DateFormat.LONG,DateFormat.LONG);
	@Override
	public void init(FilterConfig filterConfig)
		throws ServletException
	{
		//获取初始化参数
		prefix = filterConfig.getInitParameter("prefix");
		//获取初始化参数
		String logFileName =
			filterConfig.getInitParameter("logFileName");
		String appPath = 
			filterConfig.getServletContext().getRealPath("/");
		// without path info in logFileName, the log file will be
		// created in $TOMCAT_HOME/bin
		System.out.println(
				"LoggingFilter的init()方法被执行"
				+ "--->logFileName:"
				+ logFileName);
		try {
			File file=new File(appPath, logFileName);
			logger = new PrintWriter(new File(appPath, 
					logFileName));
			System.out.println("日志文件绝对路径:"+
					file.getAbsolutePath());
		} catch (FileNotFoundException e) {
			e.printStackTrace();
			throw new ServletException(e.getMessage());
		}
	}
	@Override
	public void destroy()
	{
		System.out.println(
			"LoggingFilter的destroy()方法被执行");
		if(logger != null) {
			logger.close();
		}
	}
	@Override
	public void doFilter(ServletRequest request,
			ServletResponse response,FilterChain filterChain)
			throws IOException,ServletException
	{
		System.out.println(
			"LoggingFilter的doFilter()方法被执行");
		HttpServletRequest httpServletRequest =
			(HttpServletRequest) request;
		logger.println(
			format.format(new Date()) + " " 
			+prefix + httpServletRequest.getRequestURI());
		logger.flush();
		filterChain.doFilter(request, response);
	}
}

下面来仔细分析一下该Filter类。

成员变量

首先，该Filter的类实现了Filter的接口并声明两个成员变量：PrintWriter类型的logger和String类型的prefix。

1 2	private PrintWriter logger; private String prefix:

其中PrintWriter用于记录日志到文本文件，prefix的字符串用于每条日志的前缀。

WebFilter注解

Filter的类使用了@WebFilter的Annotation，将两个参数（logFilteName、prefix）传入到该Filter中：

@WebFilter(
	filterName = "LoggingFilter",
	urlPatterns ={"/ *"},
	initParams = {
		@WebInitParam(
			name = "logFileName",
			value = "log.txt"
		),
		@WebInitParam(
			name = "prefix",
			value = "URI: "
		)
	}
)

init方法

获取初始化参数

在Filter的init方法中，通过形式参数FilterConfig对象的getInitParameter方法来获取prefix和getFileName的初始化参数。其中把prefix参数中赋给了类变量prefix，logFileName则用于创建一个PrintWriter：

1
2
3

prefix = filterConfig.getInitParameter("prefix");
String logFileName = filterConfig
        .getInitParameter("logFileName");

工作目录

如果Servlet/JSP应用是通过Servlet/JSP容器启动的，那么当前应用的工作目录是当前JDK所在的目录。
如果是在Tomcat中，该目录是Tomcat的安装目录。
在应用中创建日志文件，可以通过ServletContext.getRealPath来获取工作目录，结合应用工作目录以及初始化参数中的logFilterNmae，就可以得到日志文件的绝对路径：

String appPath = 
        filterConfig.getServletContext().getRealPath("/");
// without path info in logFileName, the log file will be
// created in $TOMCAT_HOME/bin
try {
   logger = new PrintWriter(new File(appPath,
             logFileName));
} catch (FileNotFoundException e) {
   e.printStackTrace();
   throw new ServletException(e.getMessage());
}

当Filter的init方法被执行时，日志文件就会创建出来。如果在应用的工作目录中该文件已经存在，那么该日志文件的内容将会被覆盖。

destroy方法

当应用关闭时，PrintWriter需要被关闭。因此在Filter的destroy方法中，需要：

1
2
3

if (logger != null) {
   logger.close();
}

doFilter方法

Filter的doFilter实现中记录着所有从ServletRequest到HttpServletRequest的Request，并调用了它的getRequestURI方法，该方法的返回值将记录通过PrintWriter的println方法记录下来：

HttpServletRequest httpServletRequest = 
       (HttpServletRequest) request;
logger.println(new Date() + " " + prefix
       + httpServletRequest.getRequestURI());

每条记录都有一个时间戳以及前缀，这样可以很方便地标识每条记录。接下来 Filter的doFilter实现调用PrintWriter的flush方法以及FilterChain.doFilter，以唤起资源的调用：

1 2	logger.flush(); filterChain.doFilter(request, response);

如果使用Tomcat，Filter的初始化并不会等到第一个Request请求时才触发进行。这点可以在控制台中打印出来的logFileName参数值中可以看到。

test.jsp

<%@ page language="java" contentType="text/html; charset=UTF-8"
	pageEncoding="UTF-8"%>
<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
<title>测试</title>
</head>
<body>
	<h2>测试</h2>
</body>
</html>