We specialize in the following:

• Air filters
  
• Coffee filters
  
• Pump filters
  
• Camera lens filters
  
• Image filters for Adobe Photoshop
  
• Web content filters
  
• Kalman filters
  
• Servlet and JSP filters
  

Today's Special: " + title + "s!

// Rotate among the three available filter images.

private void updateSpecials() {
double num = Math.random();
if (num < 0.333) {
title = "Air Filter";
picture = "air-filter.jpg";
} else if (num < 0.666) {
title = "Coffee Filter";
picture = "coffee-filter.gif";
} else {
title = "Pump Filter";
picture = "pump-filter.jpg";
}
}
}

程序清单9-6 RedirectorServlet.java
package moreservlets;

import java.io.*;
import javax.servlet.*;
import javax.servlet.http.*;

/** Servlet that simply redirects users to the
* Web application home page. Registered with the
* default servlet URL to prevent clients from
* using http://host/webAppPrefix/servlet/ServletName
* to bypass filters or security settings that
* are associated with custom URLs.
*/

public class RedirectorServlet extends HttpServlet {
public void doGet(HttpServletRequest request,
HttpServletResponse response)
throws ServletException, IOException {
response.sendRedirect(request.getContextPath());
}

public void doPost(HttpServletRequest request,
HttpServletResponse response)
throws ServletException, IOException {
doGet(request, response);
}
}
3． 从过滤器中访问servlet环境
前一节的ReportFilter只要调用指定的servlet或JSP页面，就在标准输出上打印一个报告。当你在自己的桌面系统上运行一个服务器时，一般会用一个显示标准输出的窗口，在开发过程中，标准输出上的报告很好用。但在部署过程中，不可能访问这个窗口。因此，一种自然的改进是将报告写入servlet日志文件写到标准输出。
Servlet API提供了两个log方法：一个取一个简单的String而另一个取一个String和一个Throwable。这两个方法都可以从GenericServlet或ServletContext类中使用。关于这两个方法所用的日志文件的准确位置，请查看相关服务器的帮助文档。问题是doFilter方法在与其相关的serlvet或JSP页面之前执行。因此，你不能访问该servlet的实例，从而不能调用从GenericServlet继承的log方法。此外，API没有体统从doFilter方法中访问ServletContext的简单方法。可以访问ServletContext的方法并且与过滤器相关的唯一类是FilterConfig，访问ServletContext的方法为getServletContext。FilterConfig对象被传输给init方法，但不会自动存放到doFilter可使用的某个位置。
因此，你必须自己存放FilterConfig。可建立一个FilterConfig类型的字段，然后重载init，将它的参数分配给该字段。因为一般只使用FilterConfig对象来访问ServletContext和过滤器名，所以可以存放该ServletContext和名称在字段中。相面举一个例子：
public class SomeFilter implements Filter {
protected FilterConfig config;
private ServletContext context;
private String filterName;
public void init(FilterConfig config)
throws ServletException {
this.config = config; // In case it is needed by subclass.
context = config.getServletContext();
filterName = config.getFilterName();
}

// doFilter and destroy methods...
}
4． 例子：日志记录过滤器
我们来更新ReportFilter（程序清单9-2），以便消息进入日志文件而不是标准输出。为了完成这个任务，过滤器应该具有下列内容：
1）实现Filter接口的一个类。这个类名为LogFilter，如程序清单9-7所示。这个类的init方法在过滤器的字段中存放FilterConfig、ServletContext和过滤器名。它对destory方法提供一个空体。
2）在doFilter方法中过滤行为。这个行为和ReportFilter的行为之间有两点不同：报告放于日志文件中而不是标准输出中，报告包括过滤器的名称。
3）调用FilterChain的doFilter方法。在打印出报告后，此过滤器调用FilterChain的doFilter方法激活链中的下一个过滤器（如果没有更多的过滤器，则激活servlet或JSP页面）。
4）对所有URL进行注册。首先，filter元素将名称LogFilter与类moreservlets.filters.LogFilter相关联。接着，filter-mapping元素使用值为/*的url-pattern将此过滤器与Web应用中所有URL相关联。参看程序清单9-8。
5）禁用激活servlet。这个操作已经在第2节介绍过，这里就不再重复了。
当这个Web应用部署在一个外部服务器上且附加了日志记录过滤器后，客户机对此Web应用主页的请求将在日志文件中产生一个项，如：“audits.irs.gov tired to acces http://www.filtersrus.com/filters/index.jsp on Fri Oct 26 15:16:15 EDT 2001.(Reported by Logger.)”。

程序清单9-7 LogFilter.java
package moreservlets.filters;

import java.io.*;
import javax.servlet.*;
import javax.servlet.http.*;
import java.util.*; // For Date class

/** Simple filter that prints a report in the log file
* whenever the associated servlets or JSP pages
* are accessed.
*/

public class LogFilter implements Filter {
protected FilterConfig config;
private ServletContext context;
private String filterName;
public void doFilter(ServletRequest request,
ServletResponse response,
FilterChain chain)
throws ServletException, IOException {
HttpServletRequest req = (HttpServletRequest)request;
context.log(req.getRemoteHost() +
" tried to access " +
req.getRequestURL() +
" on " + new Date() + ". " +
"(Reported by " + filterName + ".)");
chain.doFilter(request,response);
}

public void init(FilterConfig config)
throws ServletException {
this.config = config; // In case it is needed by subclass.
context = config.getServletContext();
filterName = config.getFilterName();
}

public void destroy() {}

}

程序清单9-8 web.xml（针对日志记录过滤器的摘录）

"-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
"http://java.sun.com/dtd/web-app_2_3.dtd">

<!-- ... -->

<!-- Register the name "Logger" for LogFilter. -->

Logger

moreservlets.filters.LogFilter


<!-- ... -->

<!-- Apply the Logger filter to all servlets and
JSP pages.
-->

Logger
/*

<!-- ... -->

5． 利用过滤器的初始化参数
对于servlet和JSP页面，可通过提供初始化参数定制初始化行为。这个功能之所以游泳的原因在于有三组不同的人员可能希望定制servlet或JSP页面的行为，这三组人员分别为：
1）开发人员——他们通过更改serlvet或JSP页面的代码定制相应的行为。
2）最终用户——他们通过在HTML表单中输入值来定制相应的行为。
3）部署人员——这是提供初始化参数服务的一组人员。这组人员是那些获得现存Web应用（或个别的servlet或JSP页面）并在一个定制环境环境中部署它们的人员。他们不一定是开发人员，因此期望他们修改servlet和JSP代码是不现实的。但由于过滤器在它们所附加的servlet或JSP页面之前执行，最终用户一般不能定制过滤器的行为，这种能力仍然很有用。定制过滤器的行为用如下步骤完成：
1）定义初始化参数。使用web.xml中的filter的init-param子元素以及param-nam和param-value子元素，如下所示。

SomeFilter
somePackage.SomeFilterClass

param1
value1


param2
value2

2）读初始化参数。从过滤器的inti方法中调用FilterConfig的getInitParameter方法。如下所示。

public void init(FilterConfig config)
throws ServletException {
String val1 = config.getInitParameter("param1");
String val2 = config.getInitParameter("param2");
...
}

3）分析初始化参数。就像servlet和JSP的初始化参数一样，每个过滤器的初始化都是String类型的。因此，如果想要其他类型的值，必须对它进行转换。例如，可用Integer.parseInt将String“7”转换为int 7。在分析时，别忘了检查缺少的和不良的数据。缺少初始化参数将导致从getInitParameter返回null。即使这些参数存在，也一个来考虑到部署人员不正确地对其值进行格式化的可能性。例如，在转换String类型的值为int类型的值时，应该将Integer.parseInt调用封在try/catch中，这个块捕捉NumberFormatException。这种办法彻底地处理了null和格式化不正确的值。
6． 例子：访问时的过滤器
第4节的LogFilter，每当相关的servlet或JSP页面被访问时，就在日志文件中打印一个项。假如想修改它，使它只注意不寻常时刻出现的访问。因为“不寻常”要视具体情况而定，servlet应该提供不寻常时间范围的缺省值，并允许部署人员通过初始化参数来重载这些值。为了完成这种功能，相应的过滤器应该具有下面的内容：
1）实现Filter接口的一个类。这个类名为LateAccessFilter，如程序清单9-9所示。这个类的init方法读取startTime和endTime初始化参数。它尝试作为init分析这些值，如果这些参数为null或未格式化为整数，这使用缺省值。然后，它将开始和结束事件、FilterConfig、ServletContext以及过滤器名存入过滤器的字段。最后，LateAccessFilter对destroy方法提供一个空体。
2）在doFilter方法中过滤行为。这个方法查找当前事件，看它问是否在开始时间和结束事件给出的范围内，如果是，打印一个日志项。
3）调用FilterChain的doFilter方法。在打印出报告后，此过滤器调用FilterChain的doFilter方法激活链中的下一个过滤器（如果没有更多的过滤器，则激活servlet或JSP页面）。
4）对Web应用主页进行注册；定义初始化参数。首先，filter元素将名称LateAccessFilter与类moreservlets.filters.LateAccessFilter相关联。filter元素还包含两个init-param子元素：一个定义startTime参数，另一个定义endTime参数。因为将要访问filterRus主页的人是程序员，考虑反常的时间范围为上午2:00到10:00之间。最后，filter-mapping元素使用值为/index.jsp的ulr-pattern子元素，将此过滤器与Web应用主页相关联。参看程序清单9-10。
5）己用激活器serlvet。这个已经在第2节介绍过，不再重复。
当这个Web应用部署在一个外部服务器上且附加了日志记录过滤器后，客户机对此Web应用主页的请求将在日志文件中产生一个项，如：“WARNING: hacker6.filtersrus.com accessed http://www.filtersrus.com/filters/index.jsp on Oct 30,2001 9:22:09 AM.”。

程序清单9-9 LateAccessFilter.java
package moreservlets.filters;

import java.io.*;
import javax.servlet.*;
import javax.servlet.http.*;
import java.util.*;
import java.text.*;

/** Filter that keeps track of accesses that occur
* at unusual hours.
*/
public class LateAccessFilter implements Filter {
private FilterConfig config;
private ServletContext context;
private int startTime, endTime;
private DateFormat formatter;
public void doFilter(ServletRequest request,
ServletResponse response,
FilterChain chain)
throws ServletException, IOException {
HttpServletRequest req = (HttpServletRequest)request;
GregorianCalendar calendar = new GregorianCalendar();
int currentTime = calendar.get(calendar.HOUR_OF_DAY);
if (isUnusualTime(currentTime, startTime, endTime)) {
context.log("WARNING: " +
req.getRemoteHost() +
" accessed " +
req.getRequestURL() +
" on " +
formatter.format(calendar.getTime()));
}
chain.doFilter(request,response);
}

public void init(FilterConfig config)
throws ServletException {
this.config = config;
context = config.getServletContext();
formatter =
DateFormat.getDateTimeInstance(DateFormat.MEDIUM,
DateFormat.MEDIUM);
try {
startTime =
Integer.parseInt(config.getInitParameter("startTime"));
endTime =
Integer.parseInt(config.getInitParameter("endTime"));
} catch(NumberFormatException nfe) { // Malformed or null
// Default: access at or after 10 p.m. but before 6 a.m.
// is considered unusual.
startTime = 22; // 10:00 p.m.
endTime = 6; // 6:00 a.m.
}
}

public void destroy() {}

// Is the current time between the start and end
// times that are marked as abnormal access times?

private boolean isUnusualTime(int currentTime,
int startTime,
int endTime) {
// If the start time is less than the end time (i.e.,
// they are two times on the same day), then the
// current time is considered unusual if it is
// between the start and end times.
if (startTime < endTime) {
return((currentTime >= startTime) &&
(currentTime < endTime));
}
// If the start time is greater than or equal to the
// end time (i.e., the start time is on one day and
// the end time is on the next day), then the current
// time is considered unusual if it is NOT between
// the end and start times.
else {
return(!isUnusualTime(currentTime, endTime, startTime));
}
}
}

程序清单9-10 web.xml（针对访问时过滤器的摘录）

"-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
"http://java.sun.com/dtd/web-app_2_3.dtd">

<!-- ... -->

<!-- Register the name "LateAccessFilter" for
moreservlets.filter.LateAccessFilter.
Supply two initialization parameters:
startTime and endTime.
-->

LateAccessFilter

moreservlets.filters.LateAccessFilter


startTime
2


endTime
10


<!-- ... -->

<!-- Apply LateAccessFilter to the home page. -->

LateAccessFilter
/index.jsp

<!-- ... -->