re: servlet和JSP过滤器Filter

程序清单9-4 index.jsp

Filters 'R' Us
        HREF="filter-styles.css"
        TYPE="text/css">

  Filters 'R' Us

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

Check out Today's Special.

程序清单9-5 TodaysSpecialServlet.java
package moreservlets;

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

/** Sample servlet used to test the simple filters. */

public class TodaysSpecialServlet extends HttpServlet {
  private String title, picture;

  public void doGet(HttpServletRequest request,
                    HttpServletResponse response)
        throws ServletException, IOException {
    updateSpecials();
    response.setContentType("text/html");
    PrintWriter out = response.getWriter();
    String docType =
        "        "Transitional//EN/">/n";
        out.println
        (docType +
        "/n" +
        "Today's Special/n" +
        "/n" +
        "/n" +
        "

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

/n" +
        "        " ALT=/"" + title + "/">/n" +
        "/n" +
        "Special deal: for only twice the price, you can/n" +
        "buy one, get one free!./n" +
        "");
  }

  // 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">

Logger

moreservlets.filters.LogFilter

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">

LateAccessFilter

moreservlets.filters.LateAccessFilter

startTime

endTime

LateAccessFilter

/index.jsp

servlet和JSP过滤器Filter

评论

re: servlet和JSP过滤器Filter

We specialize in the following:

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

你可能感兴趣的:(java)