All Clickstreams

No Bots |

All Bots |

Both

<% if (clickstreams.keySet().size() == 0) { %>

No clickstreams in progress

<% } %>

<%

Iterator it = clickstreams.keySet().iterator();

int count = 0;

while (it.hasNext()) {

String key = (String)it.next();

Clickstream stream = (Clickstream)clickstreams.get(key);

if (showbots.equals("false") && stream.isBot()) {

continue;

}

else if (showbots.equals("true") && !stream.isBot()) {

continue;

}

count++;

try {

%>

<%= count %>.

">

[<%= stream.getStream().size() %> reqs]

<%

}

catch (Exception e) {

%>

An error occurred - <%= e %>

<%

}

}

%>

这个包很容易从OpenSymphony下载并安装。将Java文件编译并放在

WEB-INF/classes下，将JSP文件放到Web应用路径下，按帮助修改web.xml文件。为防止在这些工作前的争论，你可以从

http://www.javaworld.com/jw-06-2001/Filters/clickstream.war处找到打好包的WAR文件。

为能让此过滤器能在Tomcat 4.0 beta 5下工作，我发现我不得不做一些轻微的改动。我做的改动显示了一些在servlet和过滤器的可移植性中通常容易犯的错误，所以我将他们列在下面：

·我不得不将在JSP中添加一个额外的导入语句：<%@ page import=”Clickstream” %>。在Java中你并不需要导入在同一包下的类，而在服务器上JSP被编译到默认包中，你并不需要这句导入行。但在像Tomcat这样的服务器上，JSP被编译到一个自定义的包中，你不得不明确地从默认包中导入类。

·我不得不将元素移动到web.xml文件中的和元素之后，就像部署描述DTD要求的那样。并不是所有服务器对元素都要求固定的顺序。但Tomcat必须要。

·我不得不将web.xml中的映射由/*.html和/*.jsp改成正确的*.html和*.jsp。一些服务器会忽略开头的/，但Tomcat强硬的规定开头不能有/。

·最后，我得将ClickstreamFilter类升级到最新的生命周期API，将setFilterConfig()改成新的init()和destory()方法。

可下载的WAR文件已经包含了这些修改并能通过服务器在包外运行，虽然我并没有广泛的进行测试。

压缩响应

第三个过滤器是自动压缩响应输出流，以提高带宽利用率并提供一个很好的包装响应对象的示例。这个过滤器是由来自SUN的Amy Roh编写的，他为Tomcat 4.0 的“examples”Web程序做出过贡献。你将从webapps/examples/WEB-INF/classes/compressionFilters下找到原始代码。这里的例子代码以及WAR下的都已经为了更清晰和更简单而编辑过了。

CompressionFilter类的策略是检查请求头以判定客户端是否支持压缩，如果支持，则将响应对象用自定义的响应来打包，它的getOutputStream()和getWriter()方法已经被定义为可以利用压缩过的输出流。使用过滤器允许如此简单而有效的解决问题。

我们将从init()开始看代码：

public void init(FilterConfig filterConfig) {

config = filterConfig;

compressionThreshold = 0;

if (filterConfig != null) {

String str = filterConfig.getInitParameter("compressionThreshold");

if (str != null) {

compressionThreshold = Integer.parseInt(str);

}

else {

compressionThreshold = 0;

}

}

}

注意在检索请求头前必须把request转化为HttpServletRequest，就想在第一个例子里那样。过滤器使用wrapper类CompressResponseWrapper，一个从

HttpServletResponseWrapper类继承下来的自定义类。这个wrapper的代码相对比较简单：

public class CompressionResponseWrapper extends HttpServletResponseWrapper {

protected ServletOutputStream stream = null;

protected PrintWriter writer = null;

protected int threshold = 0;

protected HttpServletResponse origResponse = null;

public CompressionResponseWrapper(HttpServletResponse response) {

super(response);

origResponse = response;

}

public void setCompressionThreshold(int threshold) {

this.threshold = threshold;

}

public ServletOutputStream createOutputStream() throws IOException {

return (new CompressionResponseStream(origResponse));

}

public ServletOutputStream getOutputStream() throws IOException {

if (writer != null) {

throw new IllegalStateException("getWriter() has already been " +

"called for this response");

}

if (stream == null) {

stream = createOutputStream();

}

((CompressionResponseStream) stream).setCommit(true);

((CompressionResponseStream) stream).setBuffer(threshold);

return stream;

}

public PrintWriter getWriter() throws IOException {

if (writer != null) {

return writer;

}

if (stream != null) {

throw new IllegalStateException("getOutputStream() has already " +

"been called for this response");

}

stream = createOutputStream();

((CompressionResponseStream) stream).setCommit(true);

((CompressionResponseStream) stream).setBuffer(threshold);

writer = new PrintWriter(stream);

return writer;

}

}

所有调用getOutputStream() 或者getWriter()都返回一个使用

CompressResponseStream类的对象。CompressionResponseStrteam类没有显示在这个例子中，因为它继承于ServletOutputStream并使用java.util.zip.GZIPOutputStream类来压缩流。

Tomcat的”examples”Web程序中已经预先配置了这个压缩过滤器并加载了一个示例servlet。示例servlet响应/CompressionTestURL（确定先前的路径是/examples）。使用我制作的有用的WAR文件，你可以用/servlet/compressionTest(再次提醒，别忘了适当的前导路径)访问此测试servlet。你可以使用如下的web.xml片段来配置这个测试：

compressionFilter

CompressionFilter

compressionThreshold

10

compressionFilter

compressionTest

compressionTest

CompressionTestServlet

CompressionTestServlet（没有在这里列出）输出压缩是否可用，如果可用，则输出压缩响应成功！

文件上传过滤器

我们将看到的最后一个过滤器是处理多路/多类型数据的POST请求，该类型的请求能包含文件上传。每个多路/多类型数据POST请求包含所有参数和文件，使用一种servlet不能识别的特别的格式。历史上Servlet开发者使用第三方类来处理上传，例如在我的com.oreilly.servlet包中的MultipartRequest和MultipartParser类。这里我们将看到一种使用MultipartFilter的新方法来是处理这种请求更容易。该过滤器基于com.oreilly.servlet包下的parsers构建并已经被集成到该包中（参见Resources）。

MultipartFilter工作与观察输入的请求，当它发现一个文件上传请求时（content type:multipart/form-data），过滤器使用一个知道如何分析这种特殊content type格式的特殊请求包来将请求对象进行包装。servlet获取此特殊请求包并通过标准的getParameter()方法来无缝地访问此multipart参数，因为这个wrapper中已经重新定义了这些方法的功能。此servelt能够通过将requset转换成wrapper类型并使用wrapper中附加的getFile()方法来处理文件上传。

过滤器代码：

package com.oreilly.servlet;

import java.io.*;

import javax.servlet.*;

import javax.servlet.http.*;

public class MultipartFilter implements Filter {

private FilterConfig config = null;

private String dir = null;

public void init(FilterConfig config) throws ServletException {

this.config = config;

// Determine the upload directory. First look for an uploadDir filter

// init parameter. Then look for the context tempdir.

dir = config.getInitParameter("uploadDir");

if (dir == null) {

File tempdir = (File) config.getServletContext()

.getAttribute("javax.servlet.context.tempdir");

if (tempdir != null) {

dir = tempdir.toString();

}

else {

throw new ServletException(

"MultipartFilter: No upload directory found: set an uploadDir " +

"init parameter or ensure the javax.servlet.context.tempdir " +

"directory is valid");

}

}

}

public void destroy() {

config = null;

}

public void doFilter(ServletRequest request, ServletResponse response,

FilterChain chain) throws IOException, ServletException {

HttpServletRequest req = (HttpServletRequest) request;

String type = req.getHeader("Content-Type");

// If this is not a multipart/form-data request continue

if (type == null || !type.startsWith("multipart/form-data")) {

chain.doFilter(request, response);

}

else {

MultipartWrapper multi = new MultipartWrapper(req, dir);

chain.doFilter(multi, response);

}

}

}

init()方法确定文件上传的路径。这是multipart parser放置文件的地方，因此实际的请求并不需要驻留在内存中。它先查找uploadDir过滤器初始化参数，如果没找到，则使用默认的tempdir目录——Servlet API 2.2中的标准context属性。

doFilter()方法检查请求的content type，如果是multipart/form-data请求，则将此请求用MultipartWrapper打包。wrapper代码如下：

package com.oreilly.servlet;

import java.io.*;

import java.util.*;

import javax.servlet.*;

import javax.servlet.http.*;

public class MultipartWrapper extends HttpServletRequestWrapper {

MultipartRequest mreq = null;

public MultipartWrapper(HttpServletRequest req, String dir)

throws IOException {

super(req);

mreq = new MultipartRequest(req, dir);

}

// Methods to replace HSR methods

public Enumeration getParameterNames() {

return mreq.getParameterNames();

}

public String getParameter(String name) {

return mreq.getParameter(name);

}

public String[] getParameterValues(String name) {

return mreq.getParameterValues(name);

}

public Map getParameterMap() {

Map map = new HashMap();

Enumeration enum = getParameterNames();

while (enum.hasMoreElements()) {

String name = (String) enum.nextElement();

map.put(name, mreq.getParameterValues(name));

}

return map;

}

// Methods only in MultipartRequest

public Enumeration getFileNames() {

return mreq.getFileNames();

}

public String getFilesystemName(String name) {

return mreq.getFilesystemName(name);

}

public String getContentType(String name) {

return mreq.getContentType(name);

}

public File getFile(String name) {

return mreq.getFile(name);

}

}

wrapper构造了一个com.oreilly.servlet.MultipartRequest对象以处理上传分析并重载getParameter()方法族以使用MultipartRequest取代未加工的请求来读取参数值。wrapper也定义了不同的getFile()方法以使一个servlet接收打包过的请求以能通过调用其他方法来处理上传的文件。

Web.xml部署描述器用如下代码来添加此过滤器：

multipartFilter

com.oreilly.servlet.MultipartFilter

uploadDir

/tmp

multipartFilter

/*

uploadTest

UploadTest

uploadTest

/uploadTest

UploadText servlet如下：

import java.io.*;

import java.util.*;

import javax.servlet.*;

import javax.servlet.http.*;

import com.oreilly.servlet.*;

public class UploadTest extends HttpServlet {

public void doPost(HttpServletRequest req, HttpServletResponse res)

throws ServletException, IOException {

res.setContentType("text/html");

PrintWriter out = res.getWriter();

out.println("");

out.println("<head></head>");

out.println("<body>");

out.println("

UploadTest

// Parameters can now be read the same way for both

// application/x-www-form-urlencoded and multipart/form-data requests!

out.println("

Request Parameters:

");


                  
    Enumeration enum = req.getParameterNames();

                  
    while (enum.hasMoreElements()) {

                  
      String name = (String) enum.nextElement();

                  
      String values[] = req.getParameterValues(name);

                  
      if (values != null) {

                  
        for (int i = 0; i < values.length; i++) {

                  
          out.println(name + " (" + i + "): " + values[i]);

                  
        }

                  
      }

                  
    }

                  
    out.println("

// Files can be read if the request class is MultipartWrapper

// Init params to MultipartWrapper control the upload handling

if (req instanceof MultipartWrapper) {

try {

// Cast the request to a MultipartWrapper

MultipartWrapper multi = (MultipartWrapper) req;

// Show which files we received

out.println("

Files:

out.println("

");


                  
        Enumeration files = multi.getFileNames();

                  
        while (files.hasMoreElements()) {

                  
          String name = (String)files.nextElement();

                  
          String filename = multi.getFilesystemName(name);

                  
          String type = multi.getContentType(name);

                  
          File f = multi.getFile(name);

                  
          out.println("name: " + name);

                  
          out.println("filename: " + filename);

                  
          out.println("type: " + type);

                  
          if (f != null) {

                  
            out.println("length: " + f.length());

                  
          }

                  
          out.println();

                  
        }

                  
        out.println("

}

catch (Exception e) {

out.println("

");


                  
        e.printStackTrace(out);

                  
        out.println("

}

}

out.println("</body>");

}

}

servlet的前一半显示了过滤器如何将参数数据毫无改变的传送给接收的servlet。后半部分则显示了一个servlet是如何将请求向下传送给MultipartWrapper以获得附加的文件访问方法。

一个驱动此servlet的HTML例子如下：

<form ACTION="uploadTest" ENCTYPE="multipart/form-data" METHOD=POST>

What is your name? <input TYPE=TEXT NAME=submitter>

What is your age? <input TYPE=TEXT NAME=age>

Which file do you want to upload? <input TYPE=FILE NAME=file1>

Any other file to upload? <input TYPE=FILE NAME=file2>

<input TYPE=SUBMIT>

</form>

这是可能的输出：

UploadTest

Request Parameters:

submitter (0): Jason

age (0): 28

Files:

name: file1

filename: 4008b21.tif

type: application/octet-stream

length: 39396

name: file2

filename: null

type: null

你们也许会疑惑我们如何确信由过滤器设置的MultipartWrapper能正确的传送给接下来的servlet。在2号发布稿规范和Tomcat 4.0 beta 5中，那是不确定的。实际上，如果你试图用/servlet/UploadTest去访问此servlet，你将注意到过滤并没有正确工作，因为/servlet的调用将MultipartWrapper转给Tomcat自己的特殊wrapper了。这允许参数能被正确解析，但文件访问方法却不能正确工作。在Servlet API专家组的讨论中，我们决定servlet容器不能对过滤器的wrapper做更多的包装。这个servlet规范将被修改的更清楚。在Tomcat 4.0以后版本中将澄清这些规则。短期的办法是在请求wrapper中使用getRequest()方法来“沿着”请求去找到这个隐藏的multipart wrapper。

从如下地址下载该WAR文件：

http://www.javaworld.com/jw-06-2001/Filters/multipart.war

过滤器能力

Servlet过滤器提供了一中强大的能力来控制请求的操作和响应的发生，提供新的servlet功能而不需要太多的代码。我希望通过这些已经向你展示使用过滤器的可能情况，并教给你一些关于如何更有效的使用新的过滤器机能的技巧。

感谢这些过滤器的作者以及其他对过滤器提供有用建议的的人：Amy Roh,Criag McClanahan,Serge Knystautas,以及OpenSymphony成员。

↑返回目录
前一篇: 一个简单的投票程序
后一篇: 在Servlet中使用两种输出机制