利用clickstream跟踪用户

自己翻译的，不正确的地方大家别笑话，请帮着指出来啊，谢谢。

项目主页：http://www.opensymphony.com/clickstream/
具体的例子可以看clickstream-1.0.2.war

Clickstream 概述

一个用来跟踪正在你的站点上访问的用户所到达位置细节的工具。它允许你跟踪访问你的站点的“点击流”或者“传输路径”。请访问JIRA的更新日志 来了解Clickstream最近的发展。

特性

• 当用户会话产生时，开始跟踪点击流。(通过一个监听器)
• 跟踪用户产生的每次点击信息。(通过一个过滤器)
• 当用户会话终止时，将完整的点击流记录到文件或者PrintStream中。
• 设法发现用户是不是机器人，并进行适当的过滤（目前可以检测252种机器人）

安装

把clickstream-1.0.2.jar and commons-logging.jar放到[web应用程序根目录]/WEB-INF/lib里，把下面的代码加到[web应用程序根目录]/WEB-INF/web.xml里面：

    clickstream
    com.opensymphony.clickstream.ClickstreamFilter



    clickstream
    *.jsp



    clickstream
    *.html



com.opensymphony.clickstream.ClickstreamListener

根据上面的配置，Clickstream会跟踪所有对jsp或者html文件的请求.无论什么时候，只要一个HttpSession失效了，对那个会话的完整点击流就会被记录。如果你想跟踪对其他类型的点击(例如.txt或者pdf文件)，只需要添加更多的filter-mapping就可以了。

下面是一个完整的web.xml的例子

  
   
  
  Opensymphony Clickstream Example 
  
    clickstream 
    com.opensymphony.clickstream.ClickstreamFilter 
  
  
    clickstream 
    /* 
  

  
    com.opensymphony.clickstream.ClickstreamListener
  
  

你可以利用clickstreams.jsp

<%@ page import="java.util.*,
                 com.opensymphony.clickstream.Clickstream" %>

<%
    Map clickstreams = (Map) application.getAttribute("clickstreams");

    String showbots = "false";
    if ("true".equalsIgnoreCase(request.getParameter("showbots")))
        showbots = "true";
    else if ("both".equalsIgnoreCase(request.getParameter("showbots")))
        showbots = "both";
%>

    
        
    

    
        
All Clickstreams

        No Bots |
        All Bots |
        Both

        
        
        <% if (clickstreams.isEmpty()) { %>
          No clickstreams in progress.
        <% } else {
            synchronized(clickstreams) {
                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.getHostname() != null &&  
!stream.getHostname().equals("") ? stream.getHostname() : "Stream") %> [<%= stream.getStream().size()  
%> reqs]

                <%
                    }
                    catch (Exception e)
                    {
                %>
                    An error occurred - <%= e %>

                <%
                    }
                }
            }
        }
        %>
        
    

和viewstream.jsp来显示系统当前的Clickstream活动。

<%@ page import="java.util.*,
                 com.opensymphony.clickstream.Clickstream,
                 com.opensymphony.clickstream.ClickstreamRequest" %>

<%
if (request.getParameter("sid") == null)
{
  response.sendRedirect("clickstreams.jsp");
  return;
}

Map clickstreams = (Map)application.getAttribute("clickstreams");

Clickstream stream = null;

if (clickstreams.get(request.getParameter("sid")) != null)
{
  stream = (Clickstream)clickstreams.get(request.getParameter("sid"));
}

if (stream == null)
{
  response.sendRedirect("clickstreams.jsp");
  return;
}
%>


    
        
    

    
        
All streams

        
Clickstream for <%= stream.getHostname() %>

        Initial Referrer: <%= stream.getInitialReferrer() %>

        Hostname: <%= stream.getHostname() %>

        Session ID: <%= request.getParameter("sid") %>

        Bot: <%= stream.isBot() ? "Yes" : "No" %>

        Stream Start: <%= stream.getStart() %>

        Last Request: <%= stream.getLastRequest() %>


        <% long streamLength = stream.getLastRequest().getTime() - stream.getStart().getTime(); %>
        Session Length:
          <%= (streamLength > 3600000 ?
            " " + (streamLength / 3600000) + " hours" : "") +
          (streamLength > 60000 ?
            " " + ((streamLength / 60000) % 60) + " minutes" : "") +
          (streamLength > 1000 ?
            " " + ((streamLength / 1000) % 60) + " seconds" : "") %>


        # of Requests: <%= stream.getStream().size() %>

        
Click stream:

        
        <%
        synchronized(stream) {
            Iterator clickstreamIt = stream.getStream().iterator();

            int count = 0;
            while (clickstreamIt.hasNext())
            {
                count++;
                String click = ((ClickstreamRequest)clickstreamIt.next()).toString();
            %>

            <%
            }
        }
        %>
            
<%= count %>:
<%= click %>
        
    

配置

日志功能是非常基本的(你可以与 log4j集成)。如果你需要更多更高级的日志功能，那就需要实现 com.opensymphony.clickstream.logger.ClickstreamLogger接口并且提供任何你所希望的持久化方法。

默认情况下，Clickstream使用 com.opensymphony.clickstream.logger.SimpleClickstreamLogger这个类来处理日志。这个logger只能向Jakarta的 Commons Logging工具发送一个INFO日志声明，Commons Logging可以依次通知多个日志provider，包括 log4j。

可以通过创建一个clickstream.xml配置文件并且把它放在你应用程序的类路径中（通常是[web应用程序根目录]/WEB-INF/classes）来改变这种默认的行为。配置文件可能是如下的形式：

如果你希望提供你自己的logger，请查看Clickstream 的 javadoc文档。

和容器有关的特定问题

当从控制台停止Clickstream应用程序时，BEA WebLogic 8.1 (SP2)会抛出NullPointerException异常(when setting the attribute NULL for the clickstreams in the ServletContext on contextDestroyed— 这句话不会翻译，谁能帮帮忙)，需要应用CR133558这个补丁(已经包含在weblogic的sp3中)。

外部文档
• 使用EAServer跟踪你的用户—Berndt Hamboeck所著的Sybase白皮书
• Servlet2.3 模型的过滤器代码—Jason Hunter所著的“谁在你的站点上，他们正在干什么”的一段。

by hitdemo2002