jimphei學習工作室

import java.util.Map;

import org.apache.velocity.app.VelocityEngine;
import org.springframework.ui.velocity.VelocityEngineUtils;

public class MsgBean ...{
    private VelocityEngine velocityEngine;

    private String msg;

    private Map model; // 用來保存velocity中的參數值

    private String encoding; // 編碼

    private String templateLocation; // 注入的velocity模塊

    public String getEncoding() ...{
        return encoding;
    }

    public void setEncoding(String encoding) ...{
        this.encoding = encoding;
    }

    public String getTemplateLocation() ...{
        return templateLocation;
    }

    public void setTemplateLocation(String templateLocation) ...{
        this.templateLocation = templateLocation;
    }

    public Map getModel() ...{
        return model;
    }

    public void setModel(Map model) ...{
        this.model = model;
    }

    public String getMsg() ...{
        // return title;
        // 將參數值注入到模塊后的返回值
        return VelocityEngineUtils.mergeTemplateIntoString(velocityEngine,
                templateLocation, encoding, model);

    }

    public void setMsg(String msg) ...{
        this.msg = msg;
    }

    public VelocityEngine getVelocityEngine() ...{
        return velocityEngine;
    }

    public void setVelocityEngine(VelocityEngine velocityEngine) ...{
        this.velocityEngine = velocityEngine;
    }

}

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-2.0.xsd">

 

   
 <bean id="velocityEngine" class="org.springframework.ui.velocity.VelocityEngineFactoryBean"> 
   <property name="resourceLoaderPath">
            <value>classpath:velocity</value>
     </property>
    <property name="velocityProperties">
                 <props>
                       <prop key="resource.loader">class</prop>
                       <prop key="class.resource.loader.class">
                             org.apache.velocity.runtime.resource.loader.ClasspathResourceLoader
                       </prop>
                       <prop key="velocimacro.library"></prop>
                       <prop key="input.encoding">GBK</prop>
                       <prop key="output.encoding">GBK</prop>
                       <prop key="default.contentType">text/html; charset=GBK</prop>
                 </props>
           </property>
</bean>

<bean id="msgBean" class="MsgBean">
        <property name="templateLocation" value="test.vm"></property>
        <property name="encoding" value="GBK"></property>
        <property name="velocityEngine" ref="velocityEngine"></property>
</bean>

</beans>

import java.io.File;
import java.io.IOException;
import java.util.HashMap;
import java.util.Map;

import org.apache.commons.io.FileUtils;
import org.springframework.context.ApplicationContext;
import org.springframework.context.support.ClassPathXmlApplicationContext;

public class TestVeloctiy ...{
    public static void main(String[] args) ...{
        // TODO Auto-generated method stub
        ApplicationContext ctx=new ClassPathXmlApplicationContext("test3.xml");
        MsgBean    msgBean=((MsgBean)ctx.getBean("msgBean"));
        Map<String, String> data = new HashMap<String, String>();
        data.put("me","yourname");
        msgBean.setModel(data);
        System.out.println(msgBean.getMsg());
       
        
        //根據apache common IO 組件直接將內容寫到一個文件中去.
         File dest = new File( "test.html" );         
          try ...{
            FileUtils.writeStringToFile( dest, msgBean.getMsg(), "GBK" );
        } catch (IOException e) ...{
            // TODO Auto-generated catch block
            e.printStackTrace();
        }

    }
}

本文來自CSDN博客，轉載請標明出處：http://blog.csdn.net/pengchua/archive/2008/01/17/2049490.aspx

引用自：http://blog.csdn.net/axzywan/archive/2008/07/12/2643921.aspx

取Session中的值

<c:out value="${sessionScope.user.userId}"></c:out><br>  

<c:out value="${user.userLoginName}"></c:out><br>    

<s:property value="#session.user.userId"/><br>  

${session.user.userId}<br> 

${sessionScope.user.userId}<br>

OGNL

OGNL 是Object Graph Navigation Language 的簡稱，詳細相關的信息可以參考：http://www.ognl.org 。這里我們只涉及Struts2 框架中對OGNL 的基本支持。

 

OGNL 是一個對象，屬性的查詢語言。在OGNL 中有一個類型為Map 的Context （稱為上下文），在這個上下文中有一個根元素（root ），對根元素的屬性的訪問可以直接使用屬性名字，但是對于其他非根元素屬性的訪問必須加上特殊符號# 。

 

在Struts2 中上下文為ActionContext ，根元素位Value Stack （值堆棧，值堆棧代表了一族對象而不是一個對象，其中Action 類的實例也屬于值堆棧的一個）。ActionContext 中的內容如下圖：

              |

              |--application

              |

              |--session

context map---|

               |--value stack(root)

              |

              |--request

              |

              |--parameters

              |

              |--attr (searches page, request, session, then application scopes)

              |

因為Action 實例被放在Value Stack 中，而Value Stack 又是根元素（root ）中的一個，所以對Action 中的屬性的訪問可以不使用標記# ，而對其他的訪問都必須使用# 標記。

 

引用Action 的屬性

<s:property value="postalCode"/>

ActionContext 中的其他非根（root ）元素的屬性可以按照如下的方式訪問：

<s:property value="#session.mySessionPropKey"/> or

<s:property value="#session["mySessionPropKey"]"/> or

<s:property value="#request["mySessionPropKey"]/>

 

Action 類可以使用ActionContext 中的靜態方法來訪問ActionContext 。

ActionContext.getContext().getSession().put("mySessionPropKey", mySessionObject);

 

OGNL 與Collection （Lists ，Maps ，Sets ）

 

生成List 的語法為: {e1,e2,e3}.

<s:select label="label" name="name"

list="{'name1','name2','name3'}" value="%{'name2'}" />

上面的代碼生成了一個HTML Select 對象，可選的內容為： name1 ，name2 ，name3 ，默認值為：name2 。

 

生成Map 的語法為：#{key1:value1,key2:value2}.

<s:select label="label" name="name"

list="#{'foo':'foovalue', 'bar':'barvalue'}" />

上面的代碼生成了一個HTML Select 對象,foo 名字表示的內容為：foovalue ，bar 名字表示的內容為：barvalue 。

 

判斷一個對象是否在List 內存在：

<s:if test="'foo' in {'foo','bar'}">

   muhahaha

</s:if>

<s:else>

   boo

</s:else>

 

<s:if test="'foo' not in {'foo','bar'}">

   muhahaha

</s:if>

<s:else>

   boo

</s:else>

 

取得一個List 的一部分：

?   –   所有滿足選擇邏輯的對象

^   -    第一個滿足選擇邏輯的對象

$   -    最后一個滿足選擇邏輯的對象

例如：

person.relatives.{? #this.gender == 'male'}

上述代碼取得這個人（person ）所有的男性（this.gender==male ）的親戚(relatives)

 

 

Lambda 表達式

 

OGNL 支持簡單的Lambda 表達式語法，使用這些語法可以建立簡單的lambda 函數。

 

例如：

Fibonacci:

if n==0 return 0;

elseif n==1 return 1;

else return fib(n-2)+fib(n-1);

fib(0) = 0

fib(1) = 1

fib(11) = 89

 

OGNL 的Lambda 表達式如何工作呢？

Lambda 表達式必須放在方括號內部，#this 表示表達式的參數。例如：

<s:property value="#fib =:[#this==0 ? 0 : #this==1 ? 1 : #fib(#this-2)+#fib(#this-1)], #fib(11)" />

 

#fib =:[#this==0 ? 0 : #this==1 ? 1 : #fib(#this-2)+#fib(#this-1)] 定義了一個Lambda 表達式，

#fib(11) 調用了這個表達式。

 

所以上述代碼的輸出為：89

 

在JSP2.1 中# 被用作了JSP EL （表達式語言）的特殊記好，所以對OGNL 的使用可能導致問題，

一個簡單的方法是禁用JSP2.1 的EL 特性，這需要修改web.xml 文件：

<jsp-config>

    <jsp-property-group>

      <url-pattern>*.jsp</url-pattern>

      <el-ignored>true</el-ignored>

    </jsp-property-group>

</jsp-config>

關于EL表達式語言的簡單總結
 

基本語法

一、EL簡介
  1.語法結構
    ${expression}
  2.[]與.運算符
    EL 提供.和[]兩種運算符來存取數據。
    當要存取的屬性名稱中包含一些特殊字符，如.或?等并非字母或數字的符號，就一定要使用 []。例如：
        ${user.My-Name}應當改為${user["My-Name"] }
    如果要動態取值時，就可以用[]來做，而.無法做到動態取值。例如：
        ${sessionScope.user[data]}中data 是一個變量
  3.變量
    EL存取變量數據的方法很簡單，例如：${username}。它的意思是取出某一范圍中名稱為username的變量。
    因為我們并沒有指定哪一個范圍的username，所以它會依序從Page、Request、Session、Application范圍查找。
    假如途中找到username，就直接回傳，不再繼續找下去，但是假如全部的范圍都沒有找到時，就回傳null。
    屬性范圍在EL中的名稱
        Page         PageScope
        Request         RequestScope
        Session         SessionScope
        Application     ApplicationScope
       
二、EL隱含對象
  1.與范圍有關的隱含對象
  與范圍有關的EL 隱含對象包含以下四個：pageScope、requestScope、sessionScope 和applicationScope；
  它們基本上就和JSP的pageContext、request、session和application一樣；
  在EL中，這四個隱含對象只能用來取得范圍屬性值，即getAttribute(String name)，卻不能取得其他相關信息。
 
  例如：我們要取得session中儲存一個屬性username的值，可以利用下列方法：
    session.getAttribute("username") 取得username的值，
  在EL中則使用下列方法
    ${sessionScope.username}

  2.與輸入有關的隱含對象
  與輸入有關的隱含對象有兩個：param和paramValues，它們是EL中比較特別的隱含對象。
 
  例如我們要取得用戶的請求參數時，可以利用下列方法：
    request.getParameter(String name)
    request.getParameterValues(String name)
  在EL中則可以使用param和paramValues兩者來取得數據。
    ${param.name}
    ${paramValues.name}

  3.其他隱含對象
 
  cookie
  JSTL并沒有提供設定cookie的動作，
  例：要取得cookie中有一個設定名稱為userCountry的值，可以使用${cookie.userCountry}來取得它。

  header和headerValues
  header 儲存用戶瀏覽器和服務端用來溝通的數據
  例：要取得用戶瀏覽器的版本，可以使用${header["User-Agent"]}。
  另外在鮮少機會下，有可能同一標頭名稱擁有不同的值，此時必須改為使用headerValues 來取得這些值。

  initParam
  initParam取得設定web站點的環境參數(Context)
  例：一般的方法String userid = (String)application.getInitParameter("userid");
    可以使用 ${initParam.userid}來取得名稱為userid

  pageContext
  pageContext取得其他有關用戶要求或頁面的詳細信息。
    ${pageContext.request.queryString}         取得請求的參數字符串
    ${pageContext.request.requestURL}         取得請求的URL，但不包括請求之參數字符串
    ${pageContext.request.contextPath}         服務的web application 的名稱
    ${pageContext.request.method}           取得HTTP 的方法(GET、POST)
    ${pageContext.request.protocol}         取得使用的協議(HTTP/1.1、HTTP/1.0)
    ${pageContext.request.remoteUser}         取得用戶名稱
    ${pageContext.request.remoteAddr }         取得用戶的IP 地址
    ${pageContext.session.new}             判斷session 是否為新的
    ${pageContext.session.id}               取得session 的ID
    ${pageContext.servletContext.serverInfo}   取得主機端的服務信息

三、EL運算符
  1.算術運算符有五個：+、-、*或$、/或div、%或mod
  2.關系運算符有六個：==或eq、!=或ne、<或lt、>或gt、<=或le、>=或ge
  3.邏輯運算符有三個：&&或and、||或or、!或not
  4.其它運算符有三個：Empty運算符、條件運算符、()運算符
    例：${empty param.name}、${A?B:C}、${A*(B+C)}
 
四、EL函數(functions)。
  語法：ns:function( arg1, arg2, arg3 …. argN)
  其中ns為前置名稱(prefix)，它必須和taglib 指令的前置名稱一置

－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－

補充：

<%@ taglib prefix="c" uri="http://java.sun.com/jstl/core_rt " %>

FOREACH:

<c:forEach items="${messages}"
var="item"
begin="0"
end="9"
step="1"
varStatus="var">
……
</c:forEach>

OUT:

<c:out value="${logininfo.username}"/>
c:out>將value 中的內容輸出到當前位置，這里也就是把logininfo 對象的
username屬性值輸出到頁面當前位置。
${……}是JSP2.0 中的Expression Language（EL）的語法。它定義了一個表達式，
其中的表達式可以是一個常量（如上），也可以是一個具體的表達語句（如forEach循環體中
的情況）。典型案例如下：
Ø ${logininfo.username}
這表明引用logininfo 對象的username 屬性。我們可以通過“.”操作符引
用對象的屬性，也可以用“[]”引用對象屬性，如${logininfo[username]}
與${logininfo.username}達到了同樣的效果。
“[]”引用方式的意義在于，如果屬性名中出現了特殊字符，如“.”或者“-”，
此時就必須使用“[]”獲取屬性值以避免語法上的沖突（系統開發時應盡量避免
這一現象的出現）。
與之等同的JSP Script大致如下：
LoginInfo logininfo =
(LoginInfo)session.getAttribute(“logininfo”);
String username = logininfo.getUsername();
可以看到，EL大大節省了編碼量。
這里引出的另外一個問題就是，EL 將從哪里找到logininfo 對象，對于
${logininfo.username}這樣的表達式而言，首先會從當前頁面中尋找之前是
否定義了變量logininfo，如果沒有找到則依次到Request、Session、
Application 范圍內尋找，直到找到為止。如果直到最后依然沒有找到匹配的
變量，則返回null.
如果我們需要指定變量的尋找范圍，可以在EL表達式中指定搜尋范圍：
${pageScope.logininfo.username}
${requestScope.logininfo.username}
${sessionScope.logininfo.username}
${applicationScope.logininfo.username}
在Spring 中，所有邏輯處理單元返回的結果數據，都將作為Attribute 被放
置到HttpServletRequest 對象中返回（具體實現可參見Spring 源碼中
org.springframework.web.servlet.view.InternalResourceView.
exposeModelAsRequestAttributes方法的實現代碼），也就是說Spring
MVC 中，結果數據對象默認都是requestScope。因此，在Spring MVC 中，
以下尋址方法應慎用：
${sessionScope.logininfo.username}
${applicationScope.logininfo.username}
Ø ${1＋2}
結果為表達式計算結果，即整數值3。
Ø ${i>1}
如果變量值i>1的話，將返回bool類型true。與上例比較，可以發現EL會自
動根據表達式計算結果返回不同的數據類型。
表達式的寫法與java代碼中的表達式編寫方式大致相同。

IF / CHOOSE:

<c:if test="${var.index % 2 == 0}">
*
</c:if>
判定條件一般為一個EL表達式。
<c:if>并沒有提供else子句，使用的時候可能有些不便，此時我們可以通過<c:choose>
tag來達到類似的目的：
<c:choose>
<c:when test="${var.index % 2 == 0}">
*
</c:when>
<c:otherwise>
!
</c:otherwise>
</c:choose>
類似Java 中的switch 語句，<c:choose>提供了復雜判定條件下的簡化處理手法。其
中<c:when>子句類似case子句，可以出現多次。上面的代碼，在奇數行時輸出“*”號，
而偶數行時輸出“!”。
－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－

再補充：

 1    EL表達式用${}表示,可用在所有的HTML和JSP標簽中 作用是代替JSP頁面中復雜的JAVA代碼.

        2   EL表達式可操作常量 變量 和隱式對象. 最常用的 隱式對象有${param}和${paramValues}. ${param}表示返回請求參數中單個字符串的值. ${paramValues}表示返回請求參數的一組值.pageScope表示頁面范圍的變量.requestScope表示請求對象的變量. sessionScope表示會話范圍內的變量.applicationScope表示應用范圍的變量.

        3   <%@  page isELIgnored="true"%> 表示是否禁用EL語言,TRUE表示禁止.FALSE表示不禁止.JSP2.0中默認的啟用EL語言.

        4   EL語言可顯示 邏輯表達式如${true and false}結果是false    關系表達式如${5>6} 結果是false     算術表達式如 ${5+5} 結果是10

        5   EL中的變量搜索范圍是:page request session application   點運算符(.)和"[ ]"都是表示獲取變量的值.區別是[ ]可以顯示非詞類的變量

本文來自CSDN博客，轉載請標明出處：http://blog.csdn.net/stonec/archive/2009/10/09/4647394.aspx

sitemesh應用Decorator模式，用filter截取request和response,把頁面組件head,content,banner結合為一個完整的視圖。通常我們都是用include標簽在每個jsp頁面中來不斷的包含各種header, stylesheet, scripts and footer，現在，在sitemesh的幫助下，我們可以開心的刪掉他們了。如下圖，你想輕松的達到復合視圖模式，那末看完本文吧。

一、在WEB-INF/web.xml中copy以下filter的定義: <?xml version="1.0" encoding="GBK"?> <web-app xmlns="http://java.sun.com/xml/ns/j2ee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd" version="2.4"> <filter>   <filter-name>sitemesh</filter-name>      <filter-class>com.opensymphony.module.sitemesh.filter.PageFilter</filter-class>   </filter>   <filter-mapping>      <filter-name>sitemesh</filter-name>      <url-pattern>/*</url-pattern>   </filter-mapping> </web-app> 二、copy所需sitemesh-2.3.jar到WEB-INF\lib下。（這里可以下載http://www.opensymphony.com/sitemesh/） 三、 建立WEB-INF/decorators.xml描述各裝飾器頁面。 <decorators defaultdir="/decorators">        <decorator name="main" page="main.jsp">            <pattern>*</pattern>        </decorator> </decorators>   上面配置文件指定了裝飾器頁面所在的路徑，并指定了一個名為main的裝飾器，該裝飾器默認裝飾web應用根路徑下的所有頁面。 四、 建立裝飾器頁面 /decorators/main.jsp <%@ page contentType="text/html; charset=GBK"%> <%@ taglib uri="http://www.opensymphony.com/sitemesh/decorator" prefix="decorator"%> <html>       <head>           <title><decorator:title default="裝飾器頁面..." /></title>           <decorator:head />       </head>      <body>         sitemesh的例子<hr>         <decorator:body />         <hr>chen56@msn.com     </body> </html>   五、建立一個的被裝飾頁面 /index.jsp(內容頁面) <%@ page contentType="text/html; charset=GBK"%> <html>      <head>        <title>Agent Test</title>      </head>      <body>        <p>本頁只有一句，就是本句.</p>      </body> </html> 最后訪問index.jsp，將生成如下頁面：     而且，所有的頁面也會如同index.jsp一樣，被sitemesh的filter使用裝飾模式修改成如上圖般模樣，卻不用再使用include標簽。

裝飾器     decorator概念

為了建立可復用的web應用程序,一個通用的方法是建立一個分層系統，如同下面一個普通的web應用： 前端:JSP和Servlets，或jakarta的velocity 。。。 控制層框架 Controller ： (Struts/Webwork) 業務邏輯 Business ：主要業務邏輯 持久化框架 ：hibernate/jdo     可糟糕的是前端的頁面邏輯很難被復用，當你在每一個頁面中用數之不盡的include來復用公共的header, stylesheet, scripts，footer時，一個問題出現了-重復的代碼，每個頁面必須用copy來復用頁面結構，而當你需要創意性的改變頁面結構時，災難就愛上了你。      sitemesh通過filter截取request和response，并給原始的頁面加入一定的裝飾(可能為header,footer...)，然后把結果返回給客戶端，并且被裝飾的原始頁面并不知道sitemesh的裝飾，這也就達到了脫耦的目的。      據說即將新出臺的Portlet規范會幫助我們標準的實現比這些更多更cool的想法，但可憐的我還不懂它到底是一個什末東東，有興趣的人可以研究 jetspeed，或JSR (Java Specification Request) 168,但我想sitemesh如此簡單，我們不妨先用著。

讓我們看看怎樣配置環境

除了要copy到WEB-INF/lib中的sitemesh.jar外，還有2個文件要建立到WEB-INF/： sitemesh.xml (可選)   decorators.xml sitemesh.xml 可以設置2種信息: Page Parsers ：負責讀取stream的數據到一個Page對象中以被SiteMesh解析和操作。(不太常用，默認即可) Decorator Mappers : 不同的裝飾器種類，我發現2種比較有用都列在下面。一種通用的mapper,可以指定裝飾器的配置文件名，另一種可打印的裝飾器，可以允許你當用http://localhost/aaa/a.html?printable=true方式訪問時給出原始頁面以供打印(免得把header,footer等的花哨的圖片也搭上) (但一般不用建立它，默認設置足夠了：com/opensymphony/module/sitemesh/factory/sitemesh-default.xml）： 范例： <sitemesh>      <page-parsers>        <parser default="true" class="com.opensymphony.module.sitemesh.parser.DefaultPageParser" />        <parser content-type="text/html" class="com.opensymphony.module.sitemesh.parser.FastPageParser" />        <parser content-type="text/html;charset=ISO-8859-1" class="com.opensymphony.module.sitemesh.parser.FastPageParser" />      </page-parsers>      <decorator-mappers>        <mapper class="com.opensymphony.module.sitemesh.mapper.ConfigDecoratorMapper">          <param name="config" value="/WEB-INF/decorators.xml" />        </mapper>          <mapper class="com.opensymphony.module.sitemesh.mapper.PrintableDecoratorMapper">             <param name="decorator" value="printable" />             <param name="parameter.name" value="printable" />                     <param name="parameter.value" value="true" />          </mapper>   </decorator-mappers> </sitemesh> decorators.xml ：定義構成復合視圖的所有頁面構件的描述(主要結構頁面，header,footer...)，如下例： <decorators defaultdir="/decorators">      <decorator name="main" page="main.jsp">        <pattern>*</pattern>      </decorator>      <decorator name="printable" page="printable.jsp" role="customer" webapp="aaa" /> </decorators> defaultdir: 包含裝飾器頁面的目錄 page : 頁面文件名 name : 別名 role : 角色，用于安全 webapp : 可以另外指定此文件存放目錄 Patterns : 匹配的路徑，可以用*,那些被訪問的頁面需要被裝飾。

最重要的是寫出裝飾器本身(也就是那些要復用頁面，和結構頁面)。

其實，重要的工作就是制作裝飾器頁面本身(也就是包含結構和規則的頁面)，然后把他們描述到decorators.xml中。     讓我們來先看一看最簡單的用法：其實最常用也最簡單的用法就是我們的hello例子，面對如此眾多的技術，我想只要達到功能點到為止即可，沒必要去研究太深(除非您有更深的需求)。 <%@ page contentType="text/html; charset=GBK"%> <%@ taglib uri="http://www.opensymphony.com/sitemesh/decorator" prefix="decorator" %> <html>      <head>        <title><decorator:title default="裝飾器頁面..." /></title>        <decorator:head />      </head>      <body>        sitemesh的例子<hr>        <decorator:body />        <hr>chen56@msn.com      </body> </html> 我們在裝飾器頁面只用了2個標簽： <decorator:title default="裝飾器頁面..." />       ： 把請求的原始頁面的title內容插入到<title></title>中間。 <decorator:body /> ： 把請求的原始頁面的body內的全部內容插入到相應位置。 然后我們在decorator.xml中加入以下描述即可： <decorator name="main" page="main.jsp">        <pattern>*</pattern> </decorator> 這樣，請求的所有頁面都會被重新處理，并按照main.jsp的格式重新展現在你面前。

讓我們看看更多的用法。(抄襲sitemesh文檔)

以下列著全部標簽： Decorator Tags Page Tags 被用于建立裝飾器頁面. 被用于從原始內容頁面訪問裝飾器. <decorator:head /> <decorator:body /> <decorator:title /> <decorator:getProperty /> <decorator:usePage /> <page:applyDecorator /> <page:param 　 <decorator:head /> 插入原始頁面(被包裝頁面)的head標簽中的內容(不包括head標簽本身)。 <decorator:body /> 插入原始頁面(被包裝頁面)的body標簽中的內容。 <decorator:title [ default="..." ] /> 插入原始頁面(被包裝頁面)的title標簽中的內容，還可以添加一個缺省值。 例： /decorator/main.jsp中 （裝飾器頁面）: <title><decorator:title default="卻省title-hello"     /> - 附加標題</title> /aaa.jsp中 (原始頁面)：<title>aaa頁面</title> 訪問/aaa.jsp的結果：<title>aaa頁面 - 附加標題</title> <decorator:getProperty property="..." [ default="..." ] [ writeEntireProperty="..." ]/> 在標簽處插入原始頁面(被包裝頁面)的原有的標簽的屬性中的內容，還可以添加一個缺省值。 sitemesh文檔中的例子很好理解： The decorator: <body bgcolor="white"<decorator:getProperty property="body.onload" writeEntireProperty="true" />> The undecorated page: <body onload="document.someform.somefield.focus();"> The decorated page: <body bgcolor="white" onload="document.someform.somefield.focus();"> 注意，writeEntireProperty="true"會在插入內容前加入一個空格。 <decorator:usePage id="..." /> 象jsp頁面中的<jsp:useBean>標簽一樣，可以使用被包裝為一個Page對象的頁面。 (懶的用) 例：可用<decorator:usePage id="page" /> ：<%=page.getTitle()%>達到<decorator:title/>的訪問結果。 <page:applyDecorator name="..." [ page="..." title="..." ] > <page:param name="..."> ... </page:param> <page:param name="..."> ... </page:param> </page:applyDecorator> 應用包裝器到指定的頁面上，一般用于被包裝頁面中主動應用包裝器。這個標簽有點不好理解，我們來看一個例子： 包裝器頁面 /decorators/panel.jsp：<p><decorator:title /></p>     ... <p><decorator:body /></p>      并且在decorators.xml中有<decorator name="panel" page="panel.jsp"/> 一個公共頁面，即將被panel包裝：/public/date.jsp:        ... <%=new java.util.Date()%>     ...<decorator:getProperty property="myEmail" /> 被包裝頁面 /page.jsp ：      <title>page的應用</title>      .....        <page:applyDecorator name="panel" page="/_public/date.jsp" >        <page:param name="myEmail"> chen_p@neusoft.com </page:param>      </page:applyDecorator> 最后會是什末結果呢？除了/page.jsp會被默認的包裝頁面包裝上header,footer外，page.jsp頁面中還內嵌了date.jsp頁面，并且此date.jsp頁面還會被panel.jsp包裝為一個title加body的有2段的頁面，第1段是date.jsp的title，第2段是date.jsp的body內容。 另外，page:applyDecorator中包含的page:param標簽所聲明的屬性值還可以在包裝頁面中用decorator:getProperty標簽訪問到。

---

可打印的界面裝飾

前面說過有1種可打印的裝飾器，可以允許你當用http://localhost/aaa/a.html?printable=true方式訪問時，應用其他的裝飾器(自己指定)，給出原始頁面以供打印(免得把header,footer等的花哨的圖片也搭上)。 讓我們來看一看怎樣實現他： 1.首先在WEB-INFO/sitemesh.xml中設置：      <mapper class="com.opensymphony.module.sitemesh.mapper.PrintableDecoratorMapper">        <param name="decorator" value="printable" />        <param name="parameter.name" value="printable" />        <param name="parameter.value" value="true" />      </mapper> 這樣就可以通過?printable=true來使用名為printable的裝飾器，而不是用原來的裝飾器。 2.在WEB-INFO/decorators.xml中定義相應的printable裝飾器      <decorator name="printable" page="printable.jsp"/> 3.最后編寫printable裝飾器/decorators/printable.jsp <%@ taglib uri="sitemesh-decorator" prefix="decorator" %> <html> <head>      <title><decorator:title /></title>      <decorator:head /> </head> <body>      <h1><decorator:title /></h1>      <p align="right"><i>(printable version)</i></p>      <decorator:body /> </body> </html> 這樣就可以讓一個原始頁面通過?printable=true開關來切換不同的裝飾器頁面。

中文問題

由于sitemesh內部所使用的缺省字符集為iso-8859-1，直接使用會產生亂碼，我們可以通過以下方法糾正之： 方法1：可以在您所用的application server的配置文件中找一找，有沒有設置encoding或charset的項目，然后設成gbk或gb2312即可 方法2：這也是我們一直使用的方法。 1.在每一個jsp頁里設置: <%@ page contentType="text/html; charset=gbk"%> 來告訴server你所要求的字符集。 2.在每個jsp頁的head中定義：<META HTTP-EQUIV="content-type" CONTENT="text/html; charset=gbk"> 來告訴瀏覽器你所用的字符集。

總結：使用sitemesh最通常的途徑：

1.配置好環境， 2.在WEB-INFO/decroators.xml中描述你將建立的包裝器。 3.開發在decroators.xml中描述的包裝器，最好存放在/_decorators目錄下 4.ok ，可以看看辛勤的成果了 :)

Linux+Apache+PHP+MySQL是一個低成本效率高而又穩定的WEB Server，但是我們絕大部分開發都是在Windows環境下完成開發，然后移植到Linux或者Unix下。現在依據個人體驗來說明一下Windows XP＋IIS下安裝Apache2＋PHP 5。沒有IIS安裝就更加簡單，除去IIS相關步驟就可以了。

一、關閉IIS，如果不關閉IIS安裝Apache會出錯。apache整合tomcat配置

關閉IIS有兩種方法，任意一種都可以：

1. 控制面板－－性能和維護－－管理工具－－服務中，關閉IIS Admin服務。
   
2. 在開始－－運行中直接輸入如下代碼，或者先輸入cmd，在彈出的窗口中輸入也行net stop iisadmin上述命令關閉了iis相關的所有服務器，比如web sites 、smtp等。net stop iisadmin /y避免輸入上面那個命令后需要在輸入y如果用net stop w3svc只是關閉一個站點3w服務器，但是如果是多個web站點就不行。

如果開啟IIS可以在控制面板中找到interet信息服務打開網站服務的方法，也可以用命名，net start w3svc都可以。注意如果直接在服務中打開IIS Admin服務或者運動net start iisadmin，是可以打開IIS Admin服務，但是3w服務沒有打開，所以依舊需要用上面的方法打開3w服務，因為在打開IIS Admin服務沒有打開3w服務，但是打開3w服務肯定就打開了IIS Admin服務。

二、安裝Apache2。

ps，Apache 2不能在Windows 95上運行；在Windows 98上勉強能夠運行，但不能作為服務使用。從4.3版本開始，PHP也不再支持Windows 95。所以，你的Windows操作系統必須是Windows NT、2000或者XP。

1. Apache可以到http://www.apache.org/dyn/closer.cgi/httpd/binaries/win32/下載
2. 對于本機開發Network Domain，ServerName都填入localhost就可以了，填入email地址即可。
   
3. 上圖中的單項選擇，對于初學者來說，不管Apache的服務是否使用80單口，建議都選第一個，這樣就直接把Apache注冊為系統服務，穩定方便。然后下一步選擇Typical。
4. 安裝路徑一般會默認為c:\Programme Files\Apache Group改成c:\web或者其他符合8.3格式的名稱，這樣以來以后每次輸入Apache安裝路徑不用加引號，并且Apache安裝時會自動生成Apache2文件夾，所以文件會安裝到c:\web\apache2，這樣以后也可以把PHP，MySQL都安裝到web下便于幾種管理。
5. 由于Apache＆IIS都默認WEB服務端口是80，所以其中一個必須修改其端口，一般改成8080
   修改IIS端口直接在IIS管理工具中就可以了。可以在控制面板中找，或者在運行中輸入inetmgr
   修改Apache端口，通過開始－所有程序－Apache－Configure Apache Server打開httpd.conf文件，

   找到 #Listen 12.34.56.78:80   #是注釋符號
       Listen 80  改成  Listen 8080
       然后找到  ServerName localhost:80   改成  ServerName localhost:8080  即可

6. 在瀏覽器中輸入localhost，如果修改了端口就輸入localhost:8080能夠看到apache頁面，就說明安裝成功了。

ps[2005.9.29].利用apache的proxy模塊實現隱藏iis的端口

1. 按照上面的方法，apache使用默認端口80，修改iis使用端口為8080，當然你也可以采用其他的合理端口。
2. 修改apache的http.conf文件，去掉下面兩行代碼前的注釋符號#，啟動代理模塊

   LoadModule proxy_module modules/mod_proxy.so
       LoadModule proxy_http_module modules/mod_proxy_http.so

3. 在該文件添加上如下兩行代碼，使輸入http://localhost/iis/轉向http://localhost:8080

   ProxyPass /iis/ http://127.0.0.1:8080/
       ProxyPassReverse /iis http://127.0.0.1:8080

   這樣就可以在瀏覽器中輸入localhost訪問apache，輸入localhost/iis/訪問iis了而隱藏了8080端口

4. 另外，可以通過設置虛擬主機來訪問apache或者iis

   <VirtualHost *:80>
       ServerAdmin kavenyan@163.com
       DocumentRoot E:/www/dancewithnet
       ServerName www.dancewithnet.com
       ServerAlias dancewithnet.com
       DefaultLanguage zh-CN
       AddDefaultCharset UTF-8
       </VirtualHost>
       <VirtualHost *:80>
       ServerAdmin kavenyan@163.com
       ServerName iis.dancewithnet.com
       DefaultLanguage zh-CN
       AddDefaultCharset GB2312
       ProxyPass / http://127.0.0.1:8080/  or http://服務器ip:8080/
       ProxyPassReverse / http://127.0.0.1:8080/   or http://服務器ip:8080/
       </VirtualHost>

   這樣就可以使用www.dancewithnet.com訪問apache,iis.dancewithnet.com訪問iss,而隱藏了8080端口

   三、配置PHP環境

   1. 在www.php.net上下載php5的zip安裝包，將其文件解壓放到c:\web\php5中即可

      ps， Apache 2可采取2種方式來運行PHP程序：通過一個CGI接口來運行（外部調用Php.exe），或者使用PHP的DLL文件在Apache的內部運行。后一種方式的速度較快。所以，針對每個版本的PHP，都會提供2個Windows二進制發行包。較小的是.msi包，它會安裝CGI可執行程序Php.exe，但其中拿掉了通過Apache DLL來運行PHP腳本所需的模塊。較大的.zip包則包含了所有這些東西

   2. 最好是無論使用何種接口（CGI 或者 SAPI）都確保 php5ts.dll 可用，因此必須將此文件放到 Windows 路徑中。最好的位置是 Windows 的 system 目錄（%windir%\System）：

      c:\\winnt\\system32 for Windows NT/2000
              或者
              c:\\winnt40\\system32 for Windows NT/2000 服務器版
              c:\\windows\\system32 for Windows XP

      ps，也有把php文件中所有的dll文件都拷到%windir%\System中的，那樣的配置和我介紹的方法稍微有點不同，但是我覺得那樣比較雜亂，就不再說明，有興趣的朋友可以自己研究。

   3. 接著實設定有效的PHP 配置文件，php.ini。壓縮包中包括兩個 ini 文件，php.ini-dist 和 php.ini-recommended。建議使用 php.ini-recommended，因為此文件對默認設置作了性能和安全上的優化。將選擇的 ini 文件拷貝到 PHP 能夠找到的目錄下并改名為 php.ini。PHP 默認在 Windows 目錄（%WINDIR% 或 %SYSTEMROOT% ）下搜索 php.ini：

      c:\\winnt 或 c:\\winnt40  for Windows NT/2000 服務器版
              c:\windows  for Windows XP
              

   4. 停止Apache，打開httpd.conf進行編輯。
      如果是使用CGI二進制文件的形式來使用php，添入代碼如下（注意代碼間的空格）：

       

      ScriptAlias /php/ "c:/web/php5/"
              AddType application/x-httpd-php .php
              Action application/x-httpd-php "/php5/php.exe"
              

      如果作為模塊（推薦這種方式），添加代碼如下：

      LoadModule php5_module "c:/web/php5/php5apache2.dll"
              AddType application/x-httpd-php .php
              

   5. 保存httpd.conf，啟動Apache

   四、測試PHP

   1. 編寫文件index.php放入C:\web\Apache2\htdocs中，代碼如下：
      
   2. 在瀏覽中輸入http://localhost/index.php效果如下，則說明安裝成功：
      

這個是mysql版本不同的問題

1、后臺ajax在應用（特別是提交中文時要用encodeURI(encodeURI(typename))提交，然后后臺用URLDecoder.decode(strtypename, "utf-8")取值。
2、java-fckeditor在應用與配置。
3、jquery的應用。
4、二級目錄與多級目錄的學習。
5、驗證碼生成技術。

Struts2+JQuery+JSON集成

細節部分我就不多講了，因為我也不會，就講講我是如何調試出來我的第一個JSON使用的吧

采用的框架有：Struts2 、 JQuery 、 JSON

按著步驟來吧：

 1.新建一個Web工程

導入包列表：

 

 目錄結構如圖：

 

 2.建立實體類User

package model;

public class User

private String name;

private int age;

 //省略相應的get和set方法
 

 3.建立Action JsonAction

public class JsonAction extends ActionSupport{

private static final long serialVersionUID =

 7044325217725864312L;

private User user;

//用于記錄返回結果

private String result;

//省略相應的get和set方法

@SuppressWarnings("static-access")

public String execute() throws Exception {

//將要返回的user實體對象進行json處理

JSONObject jo = JSONObject.fromObject(this.user);

//打印一下，格式如下

//{"name":"風達","age":23}

System.out.println(jo);

//調用json對象的toString方法轉換為字符串然后賦值給result

this.result = jo.toString();

return this.SUCCESS;

}

}
 

 4.建立struts.xml文件

<?xml version="1.0" encoding="UTF-8"?>

<!DOCTYPE struts PUBLIC

    "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN"

    "http://struts.apache.org/dtds/struts-2.0.dtd">

<struts>

<constant name="struts.i18n.encoding" value="UTF-8"></constant>

<package name="ttttt" extends="json-default">

<action name="jsonAction" class="action.JsonAction">

<result type="json" >

<!-- 因為要將reslut的值返回給客戶端，所以這樣設置 -->

<!-- root的值對應要返回的值的屬性 -->

<param name="root">

result

</param>

</result>

</action>

</package>

</struts>

 

 5.編寫index.jsp文件

<%@ page language="java" pageEncoding="UTF-8"%>

<%@ taglib prefix="s" uri="/struts-tags"%>

<%

String path = request.getContextPath();

String basePath = request.getScheme() + "://"

+ request.getServerName() + ":" + request.getServerPort()

+ path + "/";

%>

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">

<html>

<head>

<base href="<%=basePath%>">

<title>My JSP 'index.jsp' starting page</title>

<meta http-equiv="pragma" content="no-cache">

<meta http-equiv="cache-control" content="no-cache">

<meta http-equiv="expires" content="0">

<meta http-equiv="keywords" content="keyword1,keyword2,keyword3">

<meta http-equiv="description" content="This is my page">

<!-- basePath用來獲取js文件的絕對路徑 -->

<script type="text/javascript" src="<%=basePath%>js/jquery.js"></script>

<script type="text/javascript" src="<%=basePath%>js/index.js"></script>

<s:head theme="ajax" />

</head>

<body>

<div id="result">

</div>

<s:form name="userForm" action="" method="post">

<s:textfield label="用戶名" name="user.name" />

<s:textfield label="年齡" name="user.age" />

<button>

提交

</button>

</s:form>

</body>

</html>

 

 6.在WebRoot目錄下建立js文件件，將jquery.js文件放到文件夾下，然后再建立文件index.js

$(document).ready(function() {

// 直接把onclick事件寫在了JS中

$("button").click(function() {

// 序列化表單的值

var params = $("input").serialize();

$.ajax({

// 后臺處理程序

url : "jsonAction.action",

// 數據發送方式

type : "post",

// 接受數據格式

dataType : "json",

// 要傳遞的數據

data : params,

// 回傳函數

success : update_page

});

});

});

function update_page(result) {

var json = eval( "("+result+")" );

var str = "姓名:" + json.name + "<br />"; str += "年齡:"

+ json.age + "<br />";

$("#result").html(str);

}
 

 7.運行前效果:

 

要的是效果，布局就不整了

 

運行后效果：

 

 

網上相關的信息太少了，很多Struts2+JQuery+JSON的教程，點開鏈接之后都是那幾篇文章轉了又轉，遇到問題真的很想找到有用的信息，或許是我太笨了，找不到，或許就是網上相關的信息就很少。這個實例很簡單是不是，但是為了調試出這個程序，我費了一天的時間。

上面的實例成功了，但是問題又出來了

視圖類型僅僅設置了json

那么輸入校驗出錯的時候怎么顯示？

本文來自CSDN博客，轉載請標明出處：http://blog.csdn.net/fengda2870/archive/2009/04/06/4052527.aspx

今天看到某人寫的分頁類，結果發現批人家的人不少，沒有必要，好的東西吸收學習，感覺不實用可以不用，何必發帖子挖苦人家。我前段時間也自己設計了一個分頁的方法，絕對是自己想到的，如果網上有一樣的，說明大家都思考了，有可取度，提供給大家參考。
首先寫了一個分頁的類，其實只有主要屬性的setter和getter方法
/**
* 分頁類
* @author qinglin876
*
*/
public class Pagination {
private int start;
//一次取得的數量
private int size;
//要取得頁數
private int currentPage = 1;
//總的記錄頁數
private int totalPage = 0;
//總的記錄條數
private int totalRecord;
public int getTotalRecord() {
return totalRecord;
}
public void setTotalRecord(int totalRecord) {
this.totalRecord = totalRecord;
}
public Pagination(){

}
public Pagination(int size){
this.size = size;
}
public int getSize() {
return size;
}
public void setSize(int size) {
this.size = size;
}
public int getStart() {
return start;
}
public void setStart(int start) {
this.start = start;
}
public int getCurrentPage() {
return currentPage;
}
public void setCurrentPage(int currentPage) {
this.currentPage = currentPage;
}
public int getTotalPage() {
return totalPage;
}
public void setTotalPage(int totalPage) {
this.totalPage = totalPage;
}

}

另外pagination.jsp由pagination類填充

<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%>

<%@ taglib prefix="s" uri="/struts-tags"%>
<SCRIPT type="text/javascript">

      function trim(str){
return str.replace(/(^\s*)|(\s*$)/g, "");
}

function selectPage(input){

var value = trim(input.value);
if(value == ""){
return;
}

if(/\d+/.test(value)){

input.form.submit();
return;
}
alert("請輸入正確的頁數");
input.focus();

}
   
</SCRIPT>
<div class="pagech">

<s:if test="pagination.totalPage != 0">
<s:url action="%{#request.url}" id="first">
<s:param name="pagination.currentPage" value="1"></s:param>
</s:url>
<s:url action="%{#request.url}" id="next"  >
<s:param name="pagination.currentPage"
value="pagination.currentPage+1">
</s:param>
</s:url>
<s:url action="%{#request.url}" id="prior" >
<s:param name="pagination.currentPage"
value="pagination.currentPage-1"></s:param>
</s:url>
<s:url action="%{#request.url}" id="last">
<s:param name="pagination.currentPage" value="pagination.totalPage"></s:param>
</s:url>
<s:if test="pagination.currentPage == 1">
<span class="current">首頁</span>
<span class="current">上一頁</span>
</s:if>
<s:else>
<s:a href="%{first}">首頁</s:a>
<s:a href="%{prior}">上一頁</s:a>
</s:else>
<s:if
test="pagination.currentPage == pagination.totalPage || pagination.totalPage == 0">
<span class="current">下一頁</span>
<span class="current">末頁</span>
</s:if>
<s:else>
<s:a href="%{next}">下一頁</s:a>&nbsp;&nbsp;
                  <s:a href="%{last}">末頁</s:a>
</s:else>
<span class="jumplabel">跳轉到</span>
<s:form action="%{#request.url}" theme="simple"
cssStyle="display:inline">
<s:hidden name="pagination.totalPage" value="%{pagination.totalPage}"></s:hidden>
<input type="text" name="pagination.currentPage" size="2"
onblur="selectPage(this)" />
</s:form>

<span class="jumplabel">頁</span>
<span class="jumplabel">共<s:property
value="pagination.totalRecord" />條</span>
<span class="jumplabel">當前是第<s:property
value="pagination.currentPage" />/<s:property value="pagination.totalPage"/>頁</span>


</s:if>

</div>

用的時候，在頁面include進去，注意上面的"%{#request.url}"，即是在struts2的action里面有一個setter和getter方法，下面看action中的某個方法
public String showNotices() throws Exception{

if(tip != null){
tip = new String(tip.getBytes("iso8859-1"),"utf-8");
}
if(notices == null)
this.notices = new ArrayList<Notice>();
int size = Integer.valueOf(this.getText("per_page_notice_size"));
if (pagination == null) {
pagination = new Pagination(size);
}
pagination.setSize(size);
if (pagination.getCurrentPage() <= 0) {
pagination.setCurrentPage(1);
}
if (pagination.getTotalPage() != 0
&& pagination.getCurrentPage() > pagination.getTotalPage()) {
pagination.setCurrentPage(pagination.getTotalPage());
}
url = "goto_showNotices.action"; this.notices.addAll(this.noticeDAO.showAll(pagination));
if(this.notices.size() == 0 && pagination.getCurrentPage() != 1){
pagination.setCurrentPage(pagination.getCurrentPage()-1);
this.notices.addAll(this.noticeDAO.showAll(pagination));
}
return "success";
}

在上面的this.noticeDAO.showAll(pagination))中填充pagination，具體如下
/*
* 顯示所有的通告
* @see com.qinglin.dao.NoticeDAO#showAll(com.qinglin.util.Pagination)
*/
@SuppressWarnings("unchecked")
public List<Notice> showAll(final Pagination pagination) {
String hql = "from Notice as n";
this.getHibernateTemplate().setCacheQueries(true);
int totalRecord = ((Long) this.getSession().createQuery(
"select count(*) " + hql).uniqueResult()).intValue();
int totalPage = totalRecord % pagination.getSize() == 0 ? totalRecord
/ pagination.getSize() : totalRecord / pagination.getSize() + 1;
pagination.setTotalRecord(totalRecord);
pagination.setTotalPage(totalPage);
hql += " order by n.add_date desc";
final String hql1 = hql;

return (List<Notice>) this.getHibernateTemplate().execute(
new HibernateCallback() {
public Object doInHibernate(Session session)
throws HibernateException, SQLException {
Query query = session.createQuery(hql1);
query.setFirstResult((pagination.getCurrentPage() - 1)
* pagination.getSize());
query.setMaxResults(pagination.getSize());
return query.list();
}
});
}


基本上就這些，當然請求的action里面需要設置pagination的setter和getter方法
這個分頁方法特點是簡單，只需在action中指明請求的url，用某種方法填充pagination，在顯示的頁面包含pagination.jsp即可。



package com.shop.bean;

import java.util.List;

public class PageView <T> {

private int currentPage = 1;

private long totalPage = 1;

private long totalRecord = 1;

private List <T> records;

private int firstIndex = 1;

private PageIndex pageIndex;

private int maxResult = 12;

public PageView(int currentPage, int maxResult) {
this.currentPage = currentPage;
this.maxResult = maxResult;
this.firstIndex = currentPage * maxResult;
}

public int getCurrentPage() {
return currentPage;
}

public void setCurrentPage(int currentPage) {
this.currentPage = currentPage;
}

public void setQueryResult(QueryResult <T> qr){
setTotalRecord(qr.getTotal());
setRecords(qr.getDatas());
}

public long getTotalPage() {
return totalPage;
}

public void setTotalPage(long totalPage) {
this.totalPage = totalPage;
this.pageIndex = WebTool.getPageIndex(this.maxResult, this.currentPage, this.totalPage);
}

public long getTotalRecord() {
return totalRecord;
}

public void setTotalRecord(long totalRecord) {
this.totalRecord = totalRecord;
setTotalPage(totalRecord / this.maxResult == 0 ? totalRecord / this.maxResult : totalRecord / this.maxResult + 1);
}

public List <T> getRecords() {
return records;
}

public void setRecords(List <T> records) {
this.records = records;
}

public int getFirstIndex() {
return firstIndex;
}
public PageIndex getPageIndex() {
return pageIndex;
}

public void setPageIndex(PageIndex pageIndex) {
this.pageIndex = pageIndex;
}

public int getMaxResult() {
return maxResult;
}

public void setMaxResult(int maxResult) {
this.maxResult = maxResult;
}

public void setFirstIndex(int firstIndex) {
this.firstIndex = firstIndex;
}
}


畫面的代碼：
<s:iterator value="#request.pageView.pageIndex.pageList">
      <s:if test="#request.pageView.currentPage == 4"> <b> <font color="#FFFFFF">第 <s:property/>頁 </font> </b> </s:if>
    <s:if test="#request.pageView.currentPage != 4"> <a href="javascript:topage( <s:property/>)" class="a03">第 <s:property/>頁 </a> </s:if>
</s:iterator>

action中的代碼：
Map <String, Object> request = (Map <String, Object>)ActionContext.getContext().get("request");
request.put("pageView", pageView);




<s:iterator value="#request.pageView.pageIndex.pageList">中="#request.pageView.pageIndex.pageList值能正常獲取，可是  <s:if test="#request.pageView.currentPage == 4"> 中的="#request.pageView.currentPage值獲取不到正確的值，這是什么原因啊？
問題補充：
  <s:iterator value="#request.pageView.pageIndex.pageList">
    <s:if test="{#request.pageView.currentPage == 4}"><b><font color="#FFFFFF">第<s:property/>頁</font></b></s:if>
    <s:if test="{#request.pageView.currentPage != 4}"><a href="javascript:topage(<s:property/>)" class="a03">第<s:property/>頁</a></s:if>
</s:iterator>

在地址欄輸入javascript:document.body.contentEditable='true'; document.designMode='on'; void 0就可以編輯網頁了，哈哈

1 定義頭和根元素
      部署描述符文件就像所有XML文件一樣，必須以一個XML頭開始。這個頭聲明可以使用的XML版本并給出文件的字符編碼。

      DOCYTPE聲明必須立即出現在此頭之后。這個聲明告訴服務器適用的servlet規范的版本（如2.2或2.3）并指定管理此文件其余部分內容的語法的DTD(Document Type Definition，文檔類型定義)。

      所有部署描述符文件的頂層（根）元素為web-app。請注意，XML元素不像HTML，他們是大小寫敏感的。因此，web-App和WEB-APP都是不合法的，web-app必須用小寫。

       2 部署描述符文件內的元素次序

       XML元素不僅是大小寫敏感的，而且它們還對出現在其他元素中的次序敏感。例如，XML頭必須是文件中的第一項，DOCTYPE聲明必須是第二項，而web-app元素必須是第三項。在web-app元素內，元素的次序也很重要。服務器不一定強制要求這種次序，但它們允許（實際上有些服務器就是這樣做的）完全拒絕執行含有次序不正確的元素的Web應用。這表示使用非標準元素次序的web.xml文件是不可移植的。

      下面的列表給出了所有可直接出現在web-app元素內的合法元素所必需的次序。例如，此列表說明servlet元素必須出現在所有servlet-mapping元素之前。請注意，所有這些元素都是可選的。因此，可以省略掉某一元素，但不能把它放于不正確的位置。

icon icon元素指出IDE和GUI工具用來表示Web應用的一個和兩個圖像文件的位置。
display-name display-name元素提供GUI工具可能會用來標記這個特定的Web應用的一個名稱。
description description元素給出與此有關的說明性文本。
context-param context-param元素聲明應用范圍內的初始化參數。
filter 過濾器元素將一個名字與一個實現javax.servlet.Filter接口的類相關聯。
filter-mapping 一旦命名了一個過濾器，就要利用filter-mapping元素把它與一個或多個servlet或JSP頁面相關聯。
listener servlet API的版本2.3增加了對事件監聽程序的支持，事件監聽程序在建立、修改和刪除會話或servlet環境時得到通知。Listener元素指出事件監聽程序類。
servlet 在向servlet或JSP頁面制定初始化參數或定制URL時，必須首先命名servlet或JSP頁面。Servlet元素就是用來完成此項任務的。
servlet-mapping 服務器一般為servlet提供一個缺省的URL：http://host/webAppPrefix/servlet/ServletName。但是，常常會更改這個URL，以便servlet可以訪問初始化參數或更容易地處理相對URL。在更改缺省URL時，使用servlet-mapping元素。
session-config 如果某個會話在一定時間內未被訪問，服務器可以拋棄它以節省內存。可通過使用HttpSession的setMaxInactiveInterval方法明確設置單個會話對象的超時值，或者可利用session-config元素制定缺省超時值。
mime-mapping 如果Web應用具有想到特殊的文件，希望能保證給他們分配特定的MIME類型，則mime-mapping元素提供這種保證。
welcom-file-list welcome-file-list元素指示服務器在收到引用一個目錄名而不是文件名的URL時，使用哪個文件。
error-page error-page元素使得在返回特定HTTP狀態代碼時，或者特定類型的異常被拋出時，能夠制定將要顯示的頁面。
taglib taglib元素對標記庫描述符文件（Tag Libraryu Descriptor file）指定別名。此功能使你能夠更改TLD文件的位置，而不用編輯使用這些文件的JSP頁面。
resource-env-ref resource-env-ref元素聲明與資源相關的一個管理對象。
resource-ref resource-ref元素聲明一個資源工廠使用的外部資源。
security-constraint security-constraint元素制定應該保護的URL。它與login-config元素聯合使用
login-config 用login-config元素來指定服務器應該怎樣給試圖訪問受保護頁面的用戶授權。它與sercurity-constraint元素聯合使用。
security-role security-role元素給出安全角色的一個列表，這些角色將出現在servlet元素內的security-role-ref元素的role-name子元素中。分別地聲明角色可使高級IDE處理安全信息更為容易。
env-entry env-entry元素聲明Web應用的環境項。
ejb-ref ejb-ref元素聲明一個EJB的主目錄的引用。
ejb-local-ref ejb-local-ref元素聲明一個EJB的本地主目錄的應用。

      3 分配名稱和定制的UL

      在web.xml中完成的一個最常見的任務是對servlet或JSP頁面給出名稱和定制的URL。用servlet元素分配名稱，使用servlet-mapping元素將定制的URL與剛分配的名稱相關聯。

      3.1 分配名稱

      為了提供初始化參數，對servlet或JSP頁面定義一個定制URL或分配一個安全角色，必須首先給servlet或JSP頁面一個名稱。可通過servlet元素分配一個名稱。最常見的格式包括servlet-name和servlet-class子元素（在web-app元素內），如下所示：

<servlet>
<servlet-name>Test</servlet-name>
<servlet-class>moreservlets.TestServlet</servlet-class>
</servlet>

      這表示位于WEB-INF/classes/moreservlets/TestServlet的servlet已經得到了注冊名Test。給servlet一個名稱具有兩個主要的含義。首先，初始化參數、定制的URL模式以及其他定制通過此注冊名而不是類名引用此servlet。其次,可在URL而不是類名中使用此名稱。因此，利用剛才給出的定義，URL http://host/webAppPrefix/servlet/Test 可用于 http://host/webAppPrefix/servlet/moreservlets.TestServlet 的場所。

 

請記住：XML元素不僅是大小寫敏感的，而且定義它們的次序也很重要。例如，web-app元素內所有servlet元素必須位于所有servlet-mapping元素（下一小節介紹）之前，而且還要位于5.6節和5.11節討論的與過濾器或文檔相關的元素（如果有的話）之前。類似地，servlet的servlet-name子元素也必須出現在servlet-class之前。5.2節"部署描述符文件內的元素次序"將詳細介紹這種必需的次序。
      例如，程序清單5-1給出了一個名為TestServlet的簡單servlet，它駐留在moreservlets程序包中。因為此servlet是扎根在一個名為deployDemo的目錄中的Web應用的組成部分，所以TestServlet.class放在deployDemo/WEB-INF/classes/moreservlets中。程序清單5-2給出將放置在deployDemo/WEB-INF/內的web.xml文件的一部分。此web.xml文件使用servlet-name和servlet-class元素將名稱Test與TestServlet.class相關聯。圖5-1和圖5-2分別顯示利用缺省URL和注冊名調用TestServlet時的結果。

程序清單5-1 TestServlet.java
package moreservlets;

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

/** Simple servlet used to illustrate servlet naming
* and custom URLs.
* <P>
* Taken from More Servlets and JavaServer Pages
* from Prentice Hall and Sun Microsystems Press,
* http://www.moreservlets.com/.
* © 2002 Marty Hall; may be freely used or adapted.
*/

public class TestServlet extends HttpServlet {
public void doGet(HttpServletRequest request,
HttpServletResponse response)
throws ServletException, IOException {
response.setContentType("text/html");
PrintWriter out = response.getWriter();
String uri = request.getRequestURI();
out.println(ServletUtilities.headWithTitle("Test Servlet") +
"<BODY BGCOLOR=\"#FDF5E6\">\n" +
"<H2>URI: " + uri + "</H2>\n" +
"</BODY></HTML>");
}
}

程序清單5-2 web.xml（說明servlet名稱的摘錄）
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE web-app
PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
"http://java.sun.com/dtd/web-app_2_3.dtd">

<web-app>
<!-- … -->
<servlet>
<servlet-name>Test</servlet-name>
<servlet-class>moreservlets.TestServlet</servlet-class>
</servlet>
<!-- … -->
</web-app>

      3.2 定義定制的URL

       大多數服務器具有一個缺省的serlvet URL：
http://host/webAppPrefix/servlet/packageName.ServletName。雖然在開發中使用這個URL很方便，但是我們常常會希望另一個URL用于部署。例如，可能會需要一個出現在Web應用頂層的URL（如，http://host/webAppPrefix/Anyname），并且在此URL中沒有servlet項。位于頂層的URL簡化了相對URL的使用。此外，對許多開發人員來說，頂層URL看上去比更長更麻煩的缺省URL更簡短。

事實上，有時需要使用定制的URL。比如，你可能想關閉缺省URL映射，以便更好地強制實施安全限制或防止用戶意外地訪問無初始化參數的servlet。如果你禁止了缺省的URL，那么你怎樣訪問servlet呢？這時只有使用定制的URL了。
       為了分配一個定制的URL，可使用servlet-mapping元素及其servlet-name和url-pattern子元素。Servlet-name元素提供了一個任意名稱，可利用此名稱引用相應的servlet；url-pattern描述了相對于Web應用的根目錄的URL。url-pattern元素的值必須以斜杠（/）起始。

       下面給出一個簡單的web.xml摘錄，它允許使用URL http://host/webAppPrefix/UrlTest而不是http://host/webAppPrefix/servlet/Test或
http://host/webAppPrefix/servlet/moreservlets.TestServlet。請注意，仍然需要XML頭、DOCTYPE聲明以及web-app封閉元素。此外，可回憶一下，XML元素出現地次序不是隨意的。特別是，需要把所有servlet元素放在所有servlet-mapping元素之前。

<servlet>
<servlet-name>Test</servlet-name>
<servlet-class>moreservlets.TestServlet</servlet-class>
</servlet>
<!-- ... -->
<servlet-mapping>
<servlet-name>Test</servlet-name>
<url-pattern>/UrlTest</url-pattern>
</servlet-mapping>

        URL模式還可以包含通配符。例如，下面的小程序指示服務器發送所有以Web應用的URL前綴開始，以..asp結束的請求到名為BashMS的servlet。

<servlet>
<servlet-name>BashMS</servlet-name>
<servlet-class>msUtils.ASPTranslator</servlet-class>
</servlet>
<!-- ... -->
<servlet-mapping>
<servlet-name>BashMS</servlet-name>
<url-pattern>/*.asp</url-pattern>
</servlet-mapping>

       3.3 命名JSP頁面

       因為JSP頁面要轉換成sevlet，自然希望就像命名servlet一樣命名JSP頁面。畢竟，JSP頁面可能會從初始化參數、安全設置或定制的URL中受益，正如普通的serlvet那樣。雖然JSP頁面的后臺實際上是servlet這句話是正確的，但存在一個關鍵的猜疑：即，你不知道JSP頁面的實際類名（因為系統自己挑選這個名字）。因此，為了命名JSP頁面，可將jsp-file元素替換為servlet-calss元素，如下所示：

<servlet>
<servlet-name>Test</servlet-name>
<jsp-file>/TestPage.jsp</jsp-file>
</servlet>

      命名JSP頁面的原因與命名servlet的原因完全相同：即為了提供一個與定制設置（如，初始化參數和安全設置）一起使用的名稱，并且，以便能更改激活JSP頁面的URL（比方說，以便多個URL通過相同頁面得以處理，或者從URL中去掉.jsp擴展名）。但是，在設置初始化參數時，應該注意，JSP頁面是利用jspInit方法，而不是init方法讀取初始化參數的。

      例如，程序清單5-3給出一個名為TestPage.jsp的簡單JSP頁面，它的工作只是打印出用來激活它的URL的本地部分。TestPage.jsp放置在deployDemo應用的頂層。程序清單5-4給出了用來分配一個注冊名PageName，然后將此注冊名與http://host/webAppPrefix/UrlTest2/anything 形式的URL相關聯的web.xml文件（即，deployDemo/WEB-INF/web.xml）的一部分。

程序清單5-3 TestPage.jsp
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML>
<HEAD>
<TITLE>
JSP Test Page
</TITLE>
</HEAD>
<BODY BGCOLOR="#FDF5E6">
<H2>URI: <%= request.getRequestURI() %></H2>
</BODY>
</HTML>

程序清單5-4 web.xml（說明JSP頁命名的摘錄）
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE web-app
PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
"http://java.sun.com/dtd/web-app_2_3.dtd">

<web-app>
<!-- ... -->
<servlet>
<servlet-name>PageName</servlet-name>
<jsp-file>/TestPage.jsp</jsp-file>
</servlet>
<!-- ... -->
<servlet-mapping>
<servlet-name> PageName </servlet-name>
<url-pattern>/UrlTest2/*</url-pattern>
</servlet-mapping>
<!-- ... -->
</web-app>

4 禁止激活器servlet
      對servlet或JSP頁面建立定制URL的一個原因是，這樣做可以注冊從init（servlet）或jspInit（JSP頁面）方法中讀取得初始化參數。但是，初始化參數只在是利用定制URL模式或注冊名訪問servlet或JSP頁面時可以使用，用缺省URL http://host/webAppPrefix/servlet/ServletName 訪問時不能使用。因此，你可能會希望關閉缺省URL，這樣就不會有人意外地調用初始化servlet了。這個過程有時稱為禁止激活器servlet，因為多數服務器具有一個用缺省的servlet URL注冊的標準servlet，并激活缺省的URL應用的實際servlet。

       有兩種禁止此缺省URL的主要方法：

在每個Web應用中重新映射/servlet/模式。
全局關閉激活器servlet。

      重要的是應該注意到，雖然重新映射每個Web應用中的/servlet/模式比徹底禁止激活servlet所做的工作更多，但重新映射可以用一種完全可移植的方式來完成。相反，全局禁止激活器servlet完全是針對具體機器的，事實上有的服務器（如ServletExec）沒有這樣的選擇。下面的討論對每個Web應用重新映射/servlet/ URL模式的策略。后面提供在Tomcat中全局禁止激活器servlet的詳細內容。

      4.1 重新映射/servlet/URL模式

      在一個特定的Web應用中禁止以http://host/webAppPrefix/servlet/ 開始的URL的處理非常簡單。所需做的事情就是建立一個錯誤消息servlet，并使用前一節討論的url-pattern元素將所有匹配請求轉向該servlet。只要簡單地使用：

<url-pattern>/servlet/*</url-pattern> 

      作為servlet-mapping元素中的模式即可。

      例如，程序清單5-5給出了將SorryServlet servlet（程序清單5-6）與所有以http://host/webAppPrefix/servlet/ 開頭的URL相關聯的部署描述符文件的一部分。

程序清單5-5 web.xml（說明JSP頁命名的摘錄）
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE web-app
PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
"http://java.sun.com/dtd/web-app_2_3.dtd">

<web-app>
<!-- ... -->
<servlet>
<servlet-name>Sorry</servlet-name>
<servlet-class>moreservlets.SorryServlet</servlet-class>
</servlet>
<!-- ... -->
<servlet-mapping>
<servlet-name> Sorry </servlet-name>
<url-pattern>/servlet/*</url-pattern>
</servlet-mapping>
<!-- ... -->
</web-app>

程序清單5-6 SorryServlet.java
package moreservlets;

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

/** Simple servlet used to give error messages to
* users who try to access default servlet URLs
* (i.e., http://host/webAppPrefix/servlet/ServletName)
* in Web applications that have disabled this
* behavior.
* <P>
* Taken from More Servlets and JavaServer Pages
* from Prentice Hall and Sun Microsystems Press,
* http://www.moreservlets.com/.
* © 2002 Marty Hall; may be freely used or adapted.
*/

public class SorryServlet extends HttpServlet {
public void doGet(HttpServletRequest request,
HttpServletResponse response)
throws ServletException, IOException {
response.setContentType("text/html");
PrintWriter out = response.getWriter();
String title = "Invoker Servlet Disabled.";
out.println(ServletUtilities.headWithTitle(title) +
"<BODY BGCOLOR=\"#FDF5E6\">\n" +
"<H2>" + title + "</H2>\n" +
"Sorry, access to servlets by means of\n" +
"URLs that begin with\n" +
"http://host/webAppPrefix/servlet/\n" +
"has been disabled.\n" +
"</BODY></HTML>");
}

public void doPost(HttpServletRequest request,
HttpServletResponse response)
throws ServletException, IOException {
doGet(request, response);
}
}

4.2 全局禁止激活器：Tomcat
      Tomcat 4中用來關閉缺省URL的方法與Tomcat 3中所用的很不相同。下面介紹這兩種方法：

      1．禁止激活器： Tomcat 4

      Tomcat 4用與前面相同的方法關閉激活器servlet，即利用web.xml中的url-mapping元素進行關閉。不同之處在于Tomcat使用了放在install_dir/conf中的一個服務器專用的全局web.xml文件，而前面使用的是存放在每個Web應用的WEB-INF目錄中的標準web.xml文件。

      因此，為了在Tomcat 4中關閉激活器servlet，只需在install_dir/conf/web.xml中簡單地注釋出/servlet/* URL映射項即可，如下所示：

<!--
<servlet-mapping>
<servlet-name>invoker</servlet-name>
<url-pattern>/servlet/*</url-pattern>
</servlet-mapping>
-->

      再次提醒，應該注意這個項是位于存放在install_dir/conf的Tomcat專用的web.xml文件中的，此文件不是存放在每個Web應用的WEB-INF目錄中的標準web.xml。

      2．禁止激活器：Tomcat3

      在Apache Tomcat的版本3中，通過在install_dir/conf/server.xml中注釋出InvokerInterceptor項全局禁止缺省servlet URL。例如，下面是禁止使用缺省servlet URL的server.xml文件的一部分。

<!--
<RequsetInterceptor
className="org.apache.tomcat.request.InvokerInterceptor"
debug="0" prefix="/servlet/" />
-->

      5 初始化和預裝載servlet與JSP頁面

      這里討論控制servlet和JSP頁面的啟動行為的方法。特別是，說明了怎樣分配初始化參數以及怎樣更改服務器生存期中裝載servlet和JSP頁面的時刻。

      5.1 分配servlet初始化參數

      利用init-param元素向servlet提供初始化參數，init-param元素具有param-name和param-value子元素。例如，在下面的例子中，如果initServlet servlet是利用它的注冊名（InitTest）訪問的，它將能夠從其方法中調用getServletConfig().getInitParameter("param1")獲得"Value 1"，調用getServletConfig().getInitParameter("param2")獲得"2"。

<servlet>
<servlet-name>InitTest</servlet-name>
<servlet-class>moreservlets.InitServlet</servlet-class>
<init-param>
<param-name>param1</param-name>
<param-value>value1</param-value>
</init-param>
<init-param>
<param-name>param2</param-name>
<param-value>2</param-value>
</init-param>
</servlet>

       在涉及初始化參數時，有幾點需要注意：

返回值。GetInitParameter的返回值總是一個String。因此，在前一個例子中，可對param2使用Integer.parseInt獲得一個int。
JSP中的初始化。JSP頁面使用jspInit而不是init。JSP頁面還需要使用jsp-file元素代替servlet-class。
缺省URL。初始化參數只在通過它們的注冊名或與它們注冊名相關的定制URL模式訪問Servlet時可以使用。因此，在這個例子中，param1和param2初始化參數將能夠在使用URL http://host/webAppPrefix/servlet/InitTest 時可用，但在使用URL http://host/webAppPrefix/servlet/myPackage.InitServlet 時不能使用。

 
web.xml 詳解二
例如，程序清單5-7給出一個名為InitServlet的簡單servlet，它使用init方法設置firstName和emailAddress字段。程序清單5-8給出分配名稱InitTest給servlet的web.xml文件。
程序清單5-7 InitServlet.java
package moreservlets;

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

/** Simple servlet used to illustrate servlet
* initialization parameters.
* <P>
* Taken from More Servlets and JavaServer Pages
* from Prentice Hall and Sun Microsystems Press,
* http://www.moreservlets.com/.
* © 2002 Marty Hall; may be freely used or adapted.
*/

public class InitServlet extends HttpServlet {
private String firstName, emailAddress;

public void init() {
ServletConfig config = getServletConfig();
firstName = config.getInitParameter("firstName");
emailAddress = config.getInitParameter("emailAddress");
}

public void doGet(HttpServletRequest request,
HttpServletResponse response)
throws ServletException, IOException {
response.setContentType("text/html");
PrintWriter out = response.getWriter();
String uri = request.getRequestURI();
out.println(ServletUtilities.headWithTitle("Init Servlet") +
"<BODY BGCOLOR=\"#FDF5E6\">\n" +
"<H2>Init Parameters:</H2>\n" +
"<UL>\n" +
"<LI>First name: " + firstName + "\n" +
"<LI>Email address: " + emailAddress + "\n" +
"</UL>\n" +
"</BODY></HTML>");
}
}

程序清單5-8 web.xml（說明初始化參數的摘錄）
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE web-app
PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
"http://java.sun.com/dtd/web-app_2_3.dtd">

<web-app>
<!-- ... -->
<servlet>
<servlet-name>InitTest</servlet-name>
<servlet-class>moreservlets.InitServlet</servlet-class>
<init-param>
<param-name>firstName</param-name>
<param-value>Larry</param-value>
</init-param>
<init-param>
<param-name>emailAddress</param-name>
<param-value>Ellison@Microsoft.com</param-value>
</init-param>
</servlet>
<!-- ... -->
</web-app>

 

5.2 分配JSP初始化參數
      給JSP頁面提供初始化參數在三個方面不同于給servlet提供初始化參數。

      1）使用jsp-file而不是servlet-class。因此，WEB-INF/web.xml文件的servlet元素如下所示：

<servlet>
<servlet-name>PageName</servlet-name>
<jsp-file>/RealPage.jsp</jsp-file>
<init-param>
<param-name>...</param-name>
<param-value>...</param-value>
</init-param>
...
</servlet>

       2)幾乎總是分配一個明確的URL模式。對servlet，一般相應地使用以http://host/webAppPrefix/servlet/ 開始的缺省URL。只需記住，使用注冊名而不是原名稱即可。這對于JSP頁面在技術上也是合法的。例如，在上面給出的例子中，可用URL http://host/webAppPrefix/servlet/PageName 訪問RealPage.jsp的對初始化參數具有訪問權的版本。但在用于JSP頁面時，許多用戶似乎不喜歡應用常規的servlet的URL。此外，如果JSP頁面位于服務器為其提供了目錄清單的目錄中（如，一個既沒有index.html也沒有index.jsp文件的目錄），則用戶可能會連接到此JSP頁面，單擊它，從而意外地激活未初始化的頁面。因此，好的辦法是使用url-pattern（5.3節）將JSP頁面的原URL與注冊的servlet名相關聯。這樣，客戶機可使用JSP頁面的普通名稱，但仍然激活定制的版本。例如，給定來自項目1的servlet定義，可使用下面的servlet-mapping定義：

<servlet-mapping>
<servlet-name>PageName</servlet-name>
<url-pattern>/RealPage.jsp</url-pattern>
</servlet-mapping>

      3）JSP頁使用jspInit而不是init。自動從JSP頁面建立的servlet或許已經使用了inti方法。因此，使用JSP聲明提供一個init方法是不合法的，必須制定jspInit方法。

      為了說明初始化JSP頁面的過程，程序清單5-9給出了一個名為InitPage.jsp的JSP頁面，它包含一個jspInit方法且放置于deployDemo Web應用層次結構的頂層。一般，http://host/deployDemo/InitPage.jsp 形式的URL將激活此頁面的不具有初始化參數訪問權的版本，從而將對firstName和emailAddress變量顯示null。但是，web.xml文件（程序清單5-10）分配了一個注冊名，然后將該注冊名與URL模式/InitPage.jsp相關聯。

程序清單5-9 InitPage.jsp
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML>
<HEAD><TITLE>JSP Init Test</TITLE></HEAD>
<BODY BGCOLOR="#FDF5E6">
<H2>Init Parameters:</H2>
<UL>
<LI>First name: <%= firstName %>
<LI>Email address: <%= emailAddress %>
</UL>
</BODY></HTML>
<%!
private String firstName, emailAddress;

public void jspInit() {
ServletConfig config = getServletConfig();
firstName = config.getInitParameter("firstName");
emailAddress = config.getInitParameter("emailAddress");
}
%>

程序清單5-10 web.xml（說明JSP頁面的init參數的摘錄）
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE web-app
PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
"http://java.sun.com/dtd/web-app_2_3.dtd">

<web-app>
<!-- ... -->
<servlet>
<servlet-name>InitPage</servlet-name>
<jsp-file>/InitPage.jsp</jsp-file>
<init-param>
<param-name>firstName</param-name>
<param-value>Bill</param-value>
</init-param>
<init-param>
<param-name>emailAddress</param-name>
<param-value>gates@oracle.com</param-value>
</init-param>
</servlet>
<!-- ... -->
<servlet-mapping>
<servlet-name> InitPage</servlet-name>
<url-pattern>/InitPage.jsp</url-pattern>
</servlet-mapping>
<!-- ... -->
</web-app>

5.3 提供應用范圍內的初始化參數
      一般，對單個地servlet或JSP頁面分配初始化參數。指定的servlet或JSP頁面利用ServletConfig的getInitParameter方法讀取這些參數。但是，在某些情形下，希望提供可由任意servlet或JSP頁面借助ServletContext的getInitParameter方法讀取的系統范圍內的初始化參數。

      可利用context-param元素聲明這些系統范圍內的初始化值。context-param元素應該包含param-name、param-value以及可選的description子元素，如下所示：

<context-param>
<param-name>support-email</param-name>
<param-value>blackhole@mycompany.com</param-value>
</context-param>

      可回憶一下，為了保證可移植性，web.xml內的元素必須以正確的次序聲明。但這里應該注意，context-param元素必須出現任意與文檔有關的元素（icon、display-name或description）之后及filter、filter-mapping、listener或servlet元素之前。

      5.4 在服務器啟動時裝載servlet

      假如servlet或JSP頁面有一個要花很長時間執行的init（servlet）或jspInit（JSP）方法。例如，假如init或jspInit方法從某個數據庫或ResourceBundle查找產量。這種情況下，在第一個客戶機請求時裝載servlet的缺省行為將對第一個客戶機產生較長時間的延遲。因此，可利用servlet的load-on-startup元素規定服務器在第一次啟動時裝載servlet。下面是一個例子。

<servlet>
<servlet-name> … </servlet-name>
<servlet-class> … </servlet-class> <!-- Or jsp-file -->
<load-on-startup/>
</servlet>

      可以為此元素體提供一個整數而不是使用一個空的load-on-startup。想法是服務器應該在裝載較大數目的servlet或JSP頁面之前裝載較少數目的servlet或JSP頁面。例如，下面的servlet項（放置在Web應用的WEB-INF目錄下的web.xml文件中的web-app元素內）將指示服務器首先裝載和初始化SearchServlet，然后裝載和初始化由位于Web應用的result目錄中的index.jsp文件產生的servlet。

<servlet>
<servlet-name>Search</servlet-name>
<servlet-class>myPackage.SearchServlet</servlet-class> <!-- Or jsp-file -->
<load-on-startup>1</load-on-startup>
</servlet>
<servlet>
<servlet-name>Results</servlet-name>
<servlet-class>/results/index.jsp</servlet-class> <!-- Or jsp-file -->
<load-on-startup>2</load-on-startup>
</servlet>

       6 聲明過濾器

       servlet版本2.3引入了過濾器的概念。雖然所有支持servlet API版本2.3的服務器都支持過濾器，但為了使用與過濾器有關的元素，必須在web.xml中使用版本2.3的DTD。
過濾器可截取和修改進入一個servlet或JSP頁面的請求或從一個servlet或JSP頁面發出的相應。在執行一個servlet或JSP頁面之前，必須執行第一個相關的過濾器的doFilter方法。在該過濾器對其FilterChain對象調用doFilter時，執行鏈中的下一個過濾器。如果沒有其他過濾器，servlet或JSP頁面被執行。過濾器具有對到來的ServletRequest對象的全部訪問權，因此，它們可以查看客戶機名、查找到來的cookie等。為了訪問servlet或JSP頁面的輸出，過濾器可將響應對象包裹在一個替身對象（stand-in object）中，比方說把輸出累加到一個緩沖區。在調用FilterChain對象的doFilter方法之后，過濾器可檢查緩沖區，如有必要，就對它進行修改，然后傳送到客戶機。

      例如，程序清單5-11帝國難以了一個簡單的過濾器，只要訪問相關的servlet或JSP頁面，它就截取請求并在標準輸出上打印一個報告（開發過程中在桌面系統上運行時，大多數服務器都可以使用這個過濾器）。

程序清單5-11 ReportFilter.java
package moreservlets;

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

/** Simple filter that prints a report on the standard output
* whenever the associated servlet or JSP page is accessed.
* <P>
* Taken from More Servlets and JavaServer Pages
* from Prentice Hall and Sun Microsystems Press,
* http://www.moreservlets.com/.
* © 2002 Marty Hall; may be freely used or adapted.
*/

public class ReportFilter implements Filter {
public void doFilter(ServletRequest request,
ServletResponse response,
FilterChain chain)
throws ServletException, IOException {
HttpServletRequest req = (HttpServletRequest)request;
System.out.println(req.getRemoteHost() +
" tried to access " +
req.getRequestURL() +
" on " + new Date() + ".");
chain.doFilter(request,response);
}

public void init(FilterConfig config)
throws ServletException {
}

public void destroy() {}
}

web.xml 詳解三
一旦建立了一個過濾器，可以在web.xml中利用filter元素以及filter-name（任意名稱）、file-class（完全限定的類名）和（可選的）init-params子元素聲明它。請注意，元素在web.xml的web-app元素中出現的次序不是任意的；允許服務器（但不是必需的）強制所需的次序，并且實際中有些服務器也是這樣做的。但這里要注意，所有filter元素必須出現在任意filter-mapping元素之前，filter-mapping元素又必須出現在所有servlet或servlet-mapping元素之前。
      例如，給定上述的ReportFilter類，可在web.xml中作出下面的filter聲明。它把名稱Reporter與實際的類ReportFilter（位于moreservlets程序包中）相關聯。

<filter>
<filter-name>Reporter</filter-name>
<filter-class>moresevlets.ReportFilter</filter-class>
</filter>

      一旦命名了一個過濾器，可利用filter-mapping元素把它與一個或多個servlet或JSP頁面相關聯。關于此項工作有兩種選擇。

      首先，可使用filter-name和servlet-name子元素把此過濾器與一個特定的servlet名（此servlet名必須稍后在相同的web.xml文件中使用servlet元素聲明）關聯。例如，下面的程序片斷指示系統只要利用一個定制的URL訪問名為SomeServletName的servlet或JSP頁面，就運行名為Reporter的過濾器。

<filter-mapping>
<filter-name>Reporter</filter-name>
<servlet-name>SomeServletName</servlet-name>
</filter-mapping>

      其次，可利用filter-name和url-pattern子元素將過濾器與一組servlet、JSP頁面或靜態內容相關聯。例如，相面的程序片段指示系統只要訪問Web應用中的任意URL，就運行名為Reporter的過濾器。

<filter-mapping>
<filter-name>Reporter</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>

      例如，程序清單5-12給出了將ReportFilter過濾器與名為PageName的servlet相關聯的web.xml文件的一部分。名字PageName依次又與一個名為TestPage.jsp的JSP頁面以及以模式http://host/webAppPrefix/UrlTest2/ 開頭的URL相關聯。TestPage.jsp的源代碼已經JSP頁面命名的談論在前面的3節"分配名稱和定制的URL"中給出。事實上，程序清單5-12中的servlet和servlet-name項從該節原封不動地拿過來的。給定這些web.xml項，可看到下面的標準輸出形式的調試報告（換行是為了容易閱讀）。

audit.irs.gov tried to access
http://mycompany.com/deployDemo/UrlTest2/business/tax-plan.html
on Tue Dec 25 13:12:29 EDT 2001.

程序清單5-12 Web.xml（說明filter用法的摘錄）
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE web-app
PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
"http://java.sun.com/dtd/web-app_2_3.dtd">

<web-app>
<filter>
<filter-name>Reporter</filter-name>
<filter-class>moresevlets.ReportFilter</filter-class>
</filter>
<!-- ... -->
<filter-mapping>
<filter-name>Reporter</filter-name>
<servlet-name>PageName</servlet-name>
</filter-mapping>
<!-- ... -->
<servlet>
<servlet-name>PageName</servlet-name>
<jsp-file>/RealPage.jsp</jsp-file>
</servlet>
<!-- ... -->
<servlet-mapping>
<servlet-name> PageName </servlet-name>
<url-pattern>/UrlTest2/*</url-pattern>
</servlet-mapping>
<!-- ... -->
</web-app>

 

 7 指定歡迎頁

      假如用戶提供了一個像http://host/webAppPrefix/directoryName/ 這樣的包含一個目錄名但沒有包含文件名的URL，會發生什么事情呢？用戶能得到一個目錄表？一個錯誤？還是標準文件的內容？如果得到標準文件內容，是index.html、index.jsp、default.html、default.htm或別的什么東西呢？

       Welcome-file-list元素及其輔助的welcome-file元素解決了這個模糊的問題。例如，下面的web.xml項指出，如果一個URL給出一個目錄名但未給出文件名，服務器應該首先試用index.jsp，然后再試用index.html。如果兩者都沒有找到，則結果有賴于所用的服務器（如一個目錄列表）。

<welcome-file-list>
<welcome-file>index.jsp</welcome-file>
<welcome-file>index.html</welcome-file>
</welcome-file-list>

      雖然許多服務器缺省遵循這種行為，但不一定必須這樣。因此，明確地使用welcom-file-list保證可移植性是一種良好的習慣。

     8 指定處理錯誤的頁面

      現在我了解到，你在開發servlet和JSP頁面時從不會犯錯誤，而且你的所有頁面是那樣的清晰，一般的程序員都不會被它們的搞糊涂。但是，是人總會犯錯誤的，用戶可能會提供不合規定的參數，使用不正確的URL或者不能提供必需的表單字段值。除此之外，其它開發人員可能不那么細心，他們應該有些工具來克服自己的不足。

      error-page元素就是用來克服這些問題的。它有兩個可能的子元素，分別是：error-code和exception-type。第一個子元素error-code指出在給定的HTTP錯誤代碼出現時使用的URL。第二個子元素excpetion-type指出在出現某個給定的Java異常但未捕捉到時使用的URL。error-code和exception-type都利用location元素指出相應的URL。此URL必須以/開始。location所指出的位置處的頁面可通過查找HttpServletRequest對象的兩個專門的屬性來訪問關于錯誤的信息，這兩個屬性分別是

javax.servlet.error.status_code和javax.servlet.error.message。

      可回憶一下，在web.xml內以正確的次序聲明web-app的子元素很重要。這里只要記住，error-page出現在web.xml文件的末尾附近，servlet、servlet-name和welcome-file-list之后即可。

     8.1 error-code元素

      為了更好地了解error-code元素的值，可考慮一下如果不正確地輸入文件名，大多數站點會作出什么反映。這樣做一般會出現一個404錯誤信息，它表示不能找到該文件，但幾乎沒提供更多有用的信息。另一方面，可以試一下在www.microsoft.com、www.ibm.com 處或者特別是在www.bea.com 處輸出未知的文件名。這是會得出有用的消息，這些消息提供可選擇的位置，以便查找感興趣的頁面。提供這樣有用的錯誤頁面對于Web應用來說是很有價值得。事實上rm-error-page子元素）。由form-login-page給出的HTML表單必須具有一個j_security_check的ACTION屬性、一個名為j_username的用戶名文本字段以及一個名為j_password的口令字段。

      例如，程序清單5-19指示服務器使用基于表單的驗證。Web應用的頂層目錄中的一個名為login.jsp的頁面將收集用戶名和口令，并且失敗的登陸將由相同目錄中名為login-error.jsp的頁面報告。

程序清單5-19 web.xml（說明login-config的摘錄）
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE web-app
PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
"http://java.sun.com/dtd/web-app_2_3.dtd">

<web-app>
<!-- ... -->
<security-constraint> ... </security-constraint>
<login-config>
<auth-method> FORM </auth-method>
<form-login-config>
<form-login-page>/login.jsp</form-login-page>
<form-error-page>/login-error.jsp</form-error-page>
</form-login-config>
</login-config>
<!-- ... -->
</web-app>

 

9.2 限制對Web資源的訪問

      現在，可以指示服務器使用何種驗證方法了。"了不起，"你說道，"除非我能指定一個來收到保護的URL，否則沒有多大用處。"沒錯。指出這些URL并說明他們應該得到何種保護正是security-constriaint元素的用途。此元素在web.xml中應該出現在login-config的緊前面。它包含是個可能的子元素，分別是：web-resource-collection、auth-constraint、user-data-constraint和display-name。下面各小節對它們進行介紹。

      web-resource-collection

      此元素確定應該保護的資源。所有security-constraint元素都必須包含至少一個web-resource-collection項。此元素由一個給出任意標識名稱的web-resource-name元素、一個確定應該保護的URL的url-pattern元素、一個指出此保護所適用的HTTP命令（GET、POST等，缺省為所有方法）的http-method元素和一個提供資料的可選description元素組成。例如，下面的Web-resource-collection項（在security-constratint元素內）指出Web應用的proprietary目錄中所有文檔應該受到保護。

<security-constraint>
<web-resource-coolection>
<web-resource-name>Proprietary</web-resource-name>
<url-pattern>/propritary/*</url-pattern>
</web-resource-coolection>
<!-- ... -->
</security-constraint>

      重要的是應該注意到，url-pattern僅適用于直接訪問這些資源的客戶機。特別是，它不適合于通過MVC體系結構利用RequestDispatcher來訪問的頁面，或者不適合于利用類似jsp:forward的手段來訪問的頁面。這種不勻稱如果利用得當的話很有好處。例如，servlet可利用MVC體系結構查找數據，把它放到bean中，發送請求到從bean中提取數據的JSP頁面并顯示它。我們希望保證決不直接訪問受保護的JSP頁面，而只是通過建立該頁面將使用的bean的servlet來訪問它。url-pattern和auth-contraint元素可通過聲明不允許任何用戶直接訪問JSP頁面來提供這種保證。但是，這種不勻稱的行為可能讓開發人員放松警惕，使他們偶然對應受保護的資源提供不受限制的訪問。

      auth-constraint

      盡管web-resource-collention元素質出了哪些URL應該受到保護，但是auth-constraint元素卻指出哪些用戶應該具有受保護資源的訪問權。此元素應該包含一個或多個標識具有訪問權限的用戶類別role-name元素，以及包含（可選）一個描述角色的description元素。例如，下面web.xml中的security-constraint元素部門規定只有指定為Administrator或Big Kahuna（或兩者）的用戶具有指定資源的訪問權。

<security-constraint>
<web-resource-coolection> ... </web-resource-coolection>
<auth-constraint>
<role-name>administrator</role-name>
<role-name>kahuna</role-name>
</auth-constraint>
</security-constraint>

      重要的是認識到，到此為止，這個過程的可移植部分結束了。服務器怎樣確定哪些用戶處于任何角色以及它怎樣存放用戶的口令，完全有賴于具體的系統。

      例如，Tomcat使用install_dir/conf/tomcat-users.xml將用戶名與角色名和口令相關聯，正如下面例子中所示，它指出用戶joe（口令bigshot）和jane（口令enaj）屬于administrator和kahuna角色。

<tomcat-users>
<user name="joe" password="bigshot" roles="administrator,kahuna" />
<user name="jane" password="enaj" roles="kahuna" />
</tomcat-users>

      user-data-constraint

      這個可選的元素指出在訪問相關資源時使用任何傳輸層保護。它必須包含一個transport-guarantee子元素（合法值為NONE、INTEGRAL或CONFIDENTIAL），并且可選地包含一個description元素。transport-guarantee為NONE值將對所用的通訊協議不加限制。INTEGRAL值表示數據必須以一種防止截取它的人閱讀它的方式傳送。雖然原理上（并且在未來的HTTP版本中），在INTEGRAL和CONFIDENTIAL之間可能會有差別，但在當前實踐中，他們都只是簡單地要求用SSL。例如，下面指示服務器只允許對相關資源做HTTPS連接：

<security-constraint>
<!-- ... -->
<user-data-constraint>
<transport-guarantee>CONFIDENTIAL</transport-guarantee>
</user-data-constraint>
</security-constraint>

display-name

     security-constraint的這個很少使用的子元素給予可能由GUI工具使用的安全約束項一個名稱。

     9.3 分配角色名

      迄今為止，討論已經集中到完全由容器（服務器）處理的安全問題之上了。但servlet以及JSP頁面也能夠處理它們自己的安全問題。

      例如，容器可能允許用戶從bigwig或bigcheese角色訪問一個顯示主管人員額外緊貼的頁面，但只允許bigwig用戶修改此頁面的參數。完成這種更細致的控制的一種常見方法是調用HttpServletRequset的isUserInRole方法，并據此修改訪問。

      Servlet的security-role-ref子元素提供出現在服務器專用口令文件中的安全角色名的一個別名。例如，假如編寫了一個調用request.isUserInRole（"boss"）的servlet，但后來該servlet被用在了一個其口令文件調用角色manager而不是boss的服務器中。下面的程序段使該servlet能夠使用這兩個名稱中的任何一個。

<servlet>
<!-- ... -->
<security-role-ref>
<role-name>boss</role-name> <!-- New alias -->
<role-link>manager</role-link> <!-- Real name -->
</security-role-ref>
</servlet>

      也可以在web-app內利用security-role元素提供將出現在role-name元素中的所有安全角色的一個全局列表。分別地生命角色使高級IDE容易處理安全信息。

      10 控制會話超時

      如果某個會話在一定的時間內未被訪問，服務器可把它扔掉以節約內存。可利用HttpSession的setMaxInactiveInterval方法直接設置個別會話對象的超時值。如果不采用這種方法，則缺省的超時值由具體的服務器決定。但可利用session-config和session-timeout元素來給出一個適用于所有服務器的明確的超時值。超時值的單位為分鐘，因此，下面的例子設置缺省會話超時值為三個小時（180分鐘）。

<session-config>
<session-timeout>180</session-timeout>
</session-config>

      11 Web應用的文檔化

      越來越多的開發環境開始提供servlet和JSP的直接支持。例子有Borland Jbuilder Enterprise Edition、Macromedia UltraDev、Allaire JRun Studio（寫此文時，已被Macromedia收購）以及IBM VisuaAge for Java等。

      大量的web.xml元素不僅是為服務器設計的，而且還是為可視開發環境設計的。它們包括icon、display-name和discription等。
可回憶一下，在web.xml內以適當地次序聲明web-app子元素很重要。不過，這里只要記住icon、display-name和description是web.xml的web-app元素內的前三個合法元素即可。

       icon

      icon元素指出GUI工具可用來代表Web應用的一個和兩個圖像文件。可利用small-icon元素指定一幅16 x 16的GIF或JPEG圖像，用large-icon元素指定一幅32 x 32的圖像。下面舉一個例子：

<icon>
<small-icon>/images/small-book.gif</small-icon>
<large-icon>/images/tome.jpg</large-icon>
</icon>

      display-name

      display-name元素提供GUI工具可能會用來標記此Web應用的一個名稱。下面是個例子。

<display-name>Rare Books</display-name>

      description

      description元素提供解釋性文本，如下所示：

<description>
This Web application represents the store developed for
rare-books.com, an online bookstore specializing in rare
and limited-edition books.
</description>

12 關聯文件與MIME類型

      服務器一般都具有一種讓Web站點管理員將文件擴展名與媒體相關聯的方法。例如，將會自動給予名為mom.jpg的文件一個image/jpeg的MIME類型。但是，假如你的Web應用具有幾個不尋常的文件，你希望保證它們在發送到客戶機時分配為某種MIME類型。mime-mapping元素（具有extension和mime-type子元素）可提供這種保證。例如，下面的代碼指示服務器將application/x-fubar的MIME類型分配給所有以.foo結尾的文件。

<mime-mapping>
<extension>foo</extension>
<mime-type>application/x-fubar</mime-type>
</mime-mapping>

       或許，你的Web應用希望重載（override）標準的映射。例如，下面的代碼將告訴服務器在發送到客戶機時指定.ps文件作為純文本（text/plain）而不是作為PostScript（application/postscript）。

<mime-mapping>
<extension>ps</extension>
<mime-type>application/postscript</mime-type>
</mime-mapping>

      13 定位TLD

      JSP taglib元素具有一個必要的uri屬性，它給出一個TLD（Tag Library Descriptor）文件相對于Web應用的根的位置。TLD文件的實際名稱在發布新的標簽庫版本時可能會改變，但我們希望避免更改所有現有JSP頁面。此外，可能還希望使用保持taglib元素的簡練性的一個簡短的uri。這就是部署描述符文件的taglib元素派用場的所在了。Taglib包含兩個子元素：taglib-uri和taglib-location。taglib-uri元素應該與用于JSP taglib元素的uri屬性的東西相匹配。Taglib-location元素給出TLD文件的實際位置。例如，假如你將文件chart-tags-1.3beta.tld放在WebApp/WEB-INF/tlds中。現在，假如web.xml在web-app元素內包含下列內容。

<taglib>
<taglib-uri>/charts.tld</taglib-uri>
<taglib-location>
/WEB-INF/tlds/chart-tags-1.3beta.tld
</taglib-location>
</taglib>

      給出這個說明后，JSP頁面可通過下面的簡化形式使用標簽庫。

<%@ taglib uri="/charts.tld" prefix="somePrefix" %>

      14 指定應用事件監聽程序

      應用事件監聽器程序是建立或修改servlet環境或會話對象時通知的類。它們是servlet規范的版本2.3中的新內容。這里只簡單地說明用來向Web應用注冊一個監聽程序的web.xml的用法。

      注冊一個監聽程序涉及在web.xml的web-app元素內放置一個listener元素。在listener元素內，listener-class元素列出監聽程序的完整的限定類名，如下所示：

<listener>
<listener-class>package.ListenerClass</listener-class>
</listener>

      雖然listener元素的結構很簡單，但請不要忘記，必須正確地給出web-app元素內的子元素的次序。listener元素位于所有的servlet元素之前以及所有filter-mapping元素之后。此外，因為應用生存期監聽程序是serlvet規范的2.3版本中的新內容，所以必須使用web.xml DTD的2.3版本，而不是2.2版本。

      例如，程序清單5-20給出一個名為ContextReporter的簡單的監聽程序，只要Web應用的Servlet-Context建立（如裝載Web應用）或消除（如服務器關閉）時，它就在標準輸出上顯示一條消息。程序清單5-21給出此監聽程序注冊所需要的web.xml文件的一部分。

程序清單5-20 ContextReporterjava
package moreservlets;

import javax.servlet.*;
import java.util.*;

/** Simple listener that prints a report on the standard output
* when the ServletContext is created or destroyed.
* <P>
* Taken from More Servlets and JavaServer Pages
* from Prentice Hall and Sun Microsystems Press,
* http://www.moreservlets.com/.
* © 2002 Marty Hall; may be freely used or adapted.
*/

public class ContextReporter implements ServletContextListener {
public void contextInitialized(ServletContextEvent event) {
System.out.println("Context created on " +
new Date() + ".");
}

public void contextDestroyed(ServletContextEvent event) {
System.out.println("Context destroyed on " +
new Date() + ".");
}
}

 

程序清單5-21 web.xml（聲明一個監聽程序的摘錄）
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE web-app
PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
"http://java.sun.com/dtd/web-app_2_3.dtd"> 

<web-app>
<!-- ... -->
<filter-mapping> … </filter-mapping>
<listener>
<listener-class>package.ListenerClass</listener-class>
</listener>
<servlet> ... </servlet>
<!-- ... -->
</web-app>

      15 J2EE元素

      本節描述用作J2EE環境組成部分的Web應用的web.xml元素。這里將提供一個簡明的介紹，詳細內容可以參閱http://java.sun.com/j2ee/j2ee-1_3-fr-spec.pdf的Java 2 Plantform Enterprise Edition版本1.3規范的第5章。

      distributable

      distributable元素指出，Web應用是以這樣的方式編程的：即，支持集群的服務器可安全地在多個服務器上分布Web應用。例如，一個可分布的應用必須只使用Serializable對象作為其HttpSession對象的屬性，而且必須避免用實例變量（字段）來實現持續性。distributable元素直接出現在discription元素之后，并且不包含子元素或數據，它只是一個如下的標志。
<distributable />

      resource-env-ref

     resource-env-ref元素聲明一個與某個資源有關的管理對象。此元素由一個可選的description元素、一個resource-env-ref-name元素（一個相對于java:comp/env環境的JNDI名）以及一個resource-env-type元素（指定資源類型的完全限定的類），如下所示：

<resource-env-ref>
<resource-env-ref-name>
jms/StockQueue
</resource-env-ref-name>
<resource-env-ref-type>
javax.jms.Queue
</resource-env-ref-type>
</resource-env-ref>

      env-entry

      env-entry元素聲明Web應用的環境項。它由一個可選的description元素、一個env-entry-name元素（一個相對于java:comp/env環境JNDI名）、一個env-entry-value元素（項值）以及一個env-entry-type元素（java.lang程序包中一個類型的完全限定類名，java.lang.Boolean、java.lang.String等）組成。下面是一個例子：
<env-entry>
<env-entry-name>minAmout</env-entry-name>
<env-entry-value>100.00</env-entry-value>
<env-entry-type>minAmout</env-entry-type>
</env-entry>

      ejb-ref

      ejb-ref元素聲明對一個EJB的主目錄的應用。它由一個可選的description元素、一個ejb-ref-name元素（相對于java:comp/env的EJB應用）、一個ejb-ref-type元素（bean的類型，Entity或Session）、一個home元素（bean的主目錄接口的完全限定名）、一個remote元素（bean的遠程接口的完全限定名）以及一個可選的ejb-link元素（當前bean鏈接的另一個bean的名稱）組成。

      ejb-local-ref
ejb-local-ref元素聲明一個EJB的本地主目錄的引用。除了用local-home代替home外，此元素具有與ejb-ref元素相同的屬性并以相同的方式使用。

本文來自CSDN博客，轉載請標明出處：http://blog.csdn.net/tanghc1983/archive/2007/05/08/1601247.aspx

1、建立數據庫連接

      首先要建立一個到想要使用的DBMS的連接。這包括兩個步驟：(1) 加載驅動程序；(2) 創建連接。

   (1) 加載驅動程序 
         Class.forName("sun.jdbc.odbc.JdbcOdbcDriver"); //字符串為他驅動程序的類名

  (2) 創建連接

      創建連接的第二步是使用合適的驅動程序連接到DBMS。如下代碼行示范了一般的用法：

            //url字符串為使用的子協議，也就是在JDBC URL中放在jdbc:之后的東西 
          Connection con = DriverManager.getConnection(url,"myLogin", "myPassword"); 

 2、創建和執行JDBC語句

   Statement對象可將SQL語句發送到DBMS。這只要創建一個Statement對象，將想要執行的SQL語句傳遞給適當的執行方法，
然后執行該Statement對象。
      Statement stmt = con.createStatement();
 
   對于SELECT語句，使用的方法是executeQuery。對于創建或修改表的語句，使用的方法是executeUpdate。
   //strSQL字符串是一條DDL（數據描述語言）語句
   stmt.executeUpdate(strSQL);
 
3、處理結果
   JDBC將結果集返回給ResultSet對象
   //strSQL字符串是一條查詢語句   
   ResultSet rs = stmt.executeQuery(strSQL);
   1)next方法
   變量rs（ResultSet的一個實例）包含了結果集中顯示的表。為訪問名稱和單價要移動到每一行，根據它們的類型檢索數值。
next方法將光標移到下一行，使那行（稱為當前行）成為可在其上操作的行。由于光標初始定位于ResultSet對象第一行的上面，
所以第一次調用next方法將光標移到第一行，使它成為當前行。接下來調用next方法將使光標從上至下每次移動一行。
   2)getXXX方法
   適當類型的getXXX方法可用于檢索列中的數值。檢索VARCHAR SQL類型數值的方法是getString。檢索該類型數值的方法是getFloat。
每次調用next方法，下一行就成為當前行，循環一直持續到rs中再也沒有可向前移動的行為止。
while (rs.next()) 
{
    String s = rs.getString(strColumnName1 );//strColumnName1為strSQL字符串中的列名
    float n = rs.getFloat(strColumnName2)//strColumnName2為strSQL字符串中的列名
    System.out.println(s + " " + n);
}
JDBC使用兩種方法標識getXXX方法檢索數值的列。一種是指定列名，這也是前面例子所做的。
另一種是指定列索引（列的序號），1表示第一列，2表示第二列，以此類推。
   String s = rs.getString(1); float n = rs.getFloat(2);
   3)getString方法
   盡管推薦使用getString方法檢索CHAR和VARCHAR SQL類型的數據，但也可能用它檢索其他基本SQL類型的數據
（但不可用它檢索新的SQL3數據類型。本教程后面將討論SQL3類型）。用getString檢索所有數值有很多優點但也有局限。
如果用它檢索numeric類型的數據，getString將把numeric值轉換成Java的String對象，這樣一來，在數據要作為數字前就必須轉換回numeric類型。
在數值一直當成字符串的場合，這是無可非議的。如果想讓程序檢索除了SQL3類型之外的任何標準SQL類型，就可用getString方法。
 
4、關閉連接
   connection.close();
 
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
下面是個完整的例子：
1）下載并安裝Microsoft JDBC (http://download.microsoft.com/download/SQLSVR2000/Install/2.2.0022/NT5XP/EN-US/setup.exe)
2) 安裝完成Microsoft JDBC后，將安裝目錄中的lib目錄下三個jar文件msbase.jar, mssqlserver.jar, msutil.jar引入項目中 
3）建立數據庫tempdb，建立表COFFEES，SQL語句為：
   CREATE TABLE COFFEES (COF_NAME VARCHAR(32), SUP_ID INTEGER, PRICE FLOAT, SALES INTEGER, TOTAL INTEGER) 
4）給表COFFEES添加一些數據，如：
   INSERT INTO COFFEES VALUES ('Colombian', 101, 7.99, 0, 0); 
5）輸入以下源文件，并執行
import java.sql.*;
/**

 * @author liujun TODO To change the template for this generated type comment go

 *         to Window - Preferences - Java - Code Style - Code Templates

 */

public class JDBC_01

{
    public static void main(String[] args)

    {

        showTable();

    }
    public static void showTable()

    {
        //String strDriver="sun.jdbc.odbc.JdbcOdbcDriver";

        String strDriver = "com.microsoft.jdbc.sqlserver.SQLServerDriver";

        //String strConnUrl="jdbc:odbc:TempDataSources";

        String strConnUrl = "jdbc:microsoft:sqlserver://localhost:1433;DatabaseName=tempdb";

        String strSQL = "select * from COFFEES";
        try

        {

            //加載驅動程序

            Class.forName(strDriver);

            //創建連接

            Connection objConn = DriverManager.getConnection(strConnUrl, "sa",

                    "");

            //創建Statement對象

            Statement objStatement = objConn.createStatement();

            //JDBC將結果集返回給ResultSet對象

            ResultSet objSet = objStatement.executeQuery(strSQL);

            //獲得查詢結果的列數

            int lCloumnCount = objSet.getMetaData().getColumnCount();

            System.out.println("查詢結果如下所示");

            //顯示列名

            for (int i = 1; i <= lCloumnCount; i++)

            {

                System.out.print(objSet.getMetaData().getColumnName(i)

                        + "       ");

            }

            System.out.println();

            //顯示結果

            while (objSet.next())

            {

                //顯示COF_NAME

                System.out.print("" + objSet.getString(1));

                //顯示SUP_ID PRICE SALES TOTAL

                System.out.print("        " + objSet.getInt(2));

                //顯示 PRICE

                System.out.print("         " + objSet.getFloat(3));

                //顯示SALES

                System.out.print("         " + objSet.getInt(4));

                //顯示 TOTAL

                System.out.print("        " + objSet.getInt(5));
            }
       objConn.close();
        }

        catch (Exception e)

        {

            System.out.print(e.getMessage());

        }

    }
}
5、使用預備語句
   PreparedStatement對象是包含一條預編譯過的SQL語句。DBMS不必編譯就可直接運行PreparedStatement的SQL語句。所以代替Statement對象一般會縮短執行時間。盡管paredStatement對象可用于不帶參數的SQL語句，但在多數場合是用于帶參數的SQL語句。其用法如下：
   String strUpdateSales="UPDATE COFFEES SET SALES = ? WHERE COF_NAME LIKE ?";
   PreparedStatement updateSales = con.prepareStatement(strUpdateSales);
   updateSales.setInt(1, 75);//給上面的SQL語句的第一個問號付值
   updateSales.setString(2, "Colombian");//給上面的SQL語句的第二個問號付值
   updateSales.executeUpdate();//執行UPDATE COFFEES SET SALES = 75 WHERE COF_NAME LIKE ‘Colombian’
因此，可用該對象制作成模板實現一次構造多條帶參數的SQL語句，簡化編碼。
 
6、executeUpdate方法的返回值
   executeQuery返回一個ResultSet對象，但executeUpdate返回的是一個整數值，指出了表中已更新的行數
如果executeUpdate的返回值為0表明如下兩種情況：(1) 執行的語句是一不影響任何行的更新語句；(2) 執行的是一DLL語句。
 
 7、使用事務
   一個事務是作為一個單元執行的一組語句（一條或多條語句），因此它們要么全部執行，要么全部不執行。要讓兩條或更多條語句組成
一個事務就要禁用自動提交模式，具體用方法con.setAutoCommit(false);一旦禁用了自動提交模式，就沒有SQL語句會提交了，
除非您顯式調用con.commit()方法，實現提交事務。
   使用事務可以保持數據完整性。調用rollback方法可取消一個事務，將修改的任何數據返還到以前的值。如果在執行一個事務
中的一條或多條語句時得到了SQLException。就應該調用rollback方法取消事務，從頭開始整個事務。一般要在catch塊中調用
rollback，以避免可能使用不正確的數據。
 
8、檢索警告
   SQLWarning對象是SQLException的子類，用于處理數據庫訪問警告。就像異常一樣，警告并不終止程序的執行；它們只是提醒
用戶——發生了一些未預料的事情。Connection對象、Statement對象（包括PreparedStatement和CallableStatement對象）
或ResultSet對象都會報告警告。這些類都有getWarnings方法，為查看調用對象報告的第一個警告，就必須調用該方法。如果
getWarnings返回一個警告，就可在其上調用SQLWarning方法getNextWarning取得其他警告。自動執行一條語句會清除前一條語句
的警告，因此警告不會迭加。但這也表明提取一條語句報告的警告必須在執行下一語句之前進行。
 
9、存儲過程
   存儲過程是一組SQL語句組成的邏輯單元，用于執行特定的任務。存儲過程用于封裝數據庫服務器上執行的一組操作或查詢。
存儲過程可以編譯，然后使用不同的參數和結果執行，這些參數和結果可以是輸入、輸出和輸入/輸出參數的任意組合。
   1)用SQL語句創建存儲過程
   如下所示，其方法同其他的DDL語句相同：
   String createProcedure = "create procedure SHOW_SUPPLIERS " +
       "as " +"select SUPPLIERS.SUP_NAME, COFFEES.COF_NAME " + 
       "from SUPPLIERS, COFFEES " +"where SUPPLIERS.SUP_ID = COFFEES.SUP_ID " +
       "order by SUP_NAME"; 
   Statement stmt = con.createStatement();
   stmt.executeUpdate(createProcedure);
   2)從JDBC調用存儲過程
   第一步是創建一個CallableStatement對象。CallableStatement對象包含了存儲過程的一個調用；但它不包含存儲過程
本身。接著使用連接con創建了存儲過程的一個調用。花括號內的那部分就是存儲過程的轉義語法。當驅動程序碰到
“{call SHOW_SUPPLIERS}”時，它將把這個轉義語法轉換成數據庫使用的本地SQL，以調用call 后面的的存儲過程。
如下所示：
   CallableStatement cs = con.prepareCall("{call SHOW_SUPPLIERS}"); 
   ResultSet rs = cs.executeQuery();
   注意，用于執行cs的方法是executeQuery，因為cs調用的存儲過程包含一個查詢，執行后產生一個結果集。如果存儲過程
包含一條更新或一條DLL語句，那就要使用executeUpdate方法。但有時一個存儲過程包含多條SQL語句，因而它產生的不只是
一個結果集、不只是一個更新計數或產生一些結果集和更新計數的組合。這樣就有多個結果集，這時就應該使用execute方法
來執行CallableStatement。 CallableStatement類是PreparedStatement的子類，因此CallableStatement對象可與
PreparedStatement對象一樣帶有輸入參數。此外，CallableStatement對象還可帶輸出參數或輸入/輸出參數