Servlet2.5版本的特征淺析
在這篇文章里，我主要談談Servlet2.5版本中的特征。描述每一個變化，闡述那些必要變化產(chǎn)生的背景，并展示如何在基于Servlet的項目中利用這些變化。向你介紹Servlet的新特征。你可以正確地決定哪些特征和功能你可以使用，而哪些特征和功能你不應該使用。
注意：當你想實踐這些Servlet的特征和功能時，你要知道的是：并不是所有的Servlet容器和Java企業(yè)級應用服務器都能立即適用于新版的Servlet API，Apache Tomcat5.5和Jboss 4.0目前只支持Servlet2.4。
版權(quán)聲明：任何獲得Matrix授權(quán)的網(wǎng)站，轉(zhuǎn)載時請務必保留以下作者信息和鏈接
作者:evenbetter
原文:http://www.javaworld.com/javaworld/jw-01-2006/jw-0102-servlet.html
譯文:http://www.matrix.org.cn/resource/article/44/44208_Servlet+2.5.html
關(guān)鍵字:Servlet;2.5
Servlet2.5一些變化的介紹：
◆基于最新的J2SE 5.0開發(fā)的。
◆支持annotations 。
◆web.xml中的幾處配置更加方便。
◆去除了少數(shù)的限制。
◆優(yōu)化了一些實例
J2SE 5.0的產(chǎn)物
從一開始，Servlet 2.5 規(guī)范就列出J2SE 5.0 (JDK 1.5) 作為它最小的平臺要求。它使得Servlet2.5只能適用基于J2SE 5.0開發(fā)的平臺，這個變動意味著所有J2SE5.0的特性可以保證對Servlet2.5程序員有用。
傳統(tǒng)意義上，Servlet和JEE版本一直與JDK的版本保持同步發(fā)展，但是這次，Servlet的版本跳過1.4版本。專家組認為版本的加速增長是正當?shù)模驗镴2SE5.0提出一個引人注目的，Servlet和JEE規(guī)范都要利用的特征—Annotations。
Annotations
Annotations是作為JSR175的一部分提出的（一種為Java語言設計提供便利的Metadata）一種新的語言特色。它是利用Metadata為Java編碼結(jié)構(gòu)（類，方法，域等等）裝飾的一種機制。它不能像代碼那樣執(zhí)行，但是可以用于標記代碼，這個過程是基于Metadata信息的代碼處理機，通過更新他們的事件行為來實現(xiàn)的。
我們可以憑借不同的技巧來注釋類和方法，例如連續(xù)地標記接口或者是@deprecated Javadoc評論。這種新式的Metadata可以便利地提供了一種標準的機制來實現(xiàn)注釋功能，以及通過庫來創(chuàng)建用戶自己的注釋類型的變量。
下面是一個簡單的Web service 注釋例子：
- import javax.jws.WebService;
- import javax.jws.WebMethod;
- @WebServicepublic class HelloWorldService {
- @WebMethod public String helloWorld() {
- return "Hello World!"; }}
@WebService和@WebMethod這兩個注釋類型，在JSR181（為Java平臺提供的Web ServicesMetadata）有詳細說明，可以像類一樣的引用，標記這個類作為一個Web service并且標記它的helloWorld（）方法做為一個Web service方法。對于他們本身來說，注釋只是寫在那里并沒有什么作用，好像在崗位上做記錄一樣，但是，一個容器一旦加載這個類并對那些注釋進行二進制編碼，就可以把這個類連到Web service上。
注釋可以接受屬性/值這些參數(shù)。它保存著參數(shù)的信息并且可以利用這些參數(shù)來更改被請求的事件行為。例如下面更高級的注釋例子：
- @WebService( name = "PingService", targetNamespace=http://acme.com/ping)
- @SOAPBinding( style=SOAPBinding.Style.RPC, use=SOAPBinding.Use.LITERAL)
- public class Ping { @WebMethod(operationName = "Foo")
- public void foo() { }}
一旦加載了這個類，一個正確配置的容器就會識別出注釋及其參數(shù)，并將這個做為一個PingService通過利用remote-procedure-call/literal的編碼方式與一個Foo operation相連。實際上，注釋便指明了類和類的容器之間的聯(lián)系。
Java本身的規(guī)范（JSR175）僅僅有少量的注釋類型變量。而這些有趣的注釋類型變量主要來自于其他的JSRs：
◆JSR 250: Java平臺的公共注釋
◆JSR 220: 企業(yè)級JavaBeans 3.0
◆JSR 224: 基于XML的Java API Web Services (JAX-WS) 2.0
◆JSR 181: Java平臺的Web Services Metadata
Servlet2.5中的注釋：
回到Servlet2.5上來，一種新的規(guī)范描述了幾種注釋在Servlet環(huán)境中是如何工作的。功能弱的Servlet容器忽略了這些規(guī)范，然而JEE容器中的Servlet卻嚴格遵守這些規(guī)范。
有的注釋提供了在XML注冊的可選擇性，否則就要注冊在配置文件web.xml中。有的作為容器的請求來執(zhí)行其任務，否則就由Servlet親自來執(zhí)行。還有的注釋兩者都具備。
注釋準確的定義不是完全固定的，因為Servlet本身并沒有定義注釋。它僅僅解釋了它們?nèi)绾斡绊慡ervlet環(huán)境，下面是注釋的一個簡要的概述，你可以看到在JEE5中它們的用途：
◆@Resource and @Resources：@Resource位于類或變量中以對Servlet容器進行“資源注入”。當容器識別出這個注釋時，它會在獲得服務地位之前，用適當?shù)闹祵崿F(xiàn)帶注釋的變量的重新注入。通過使用這種注釋，你不必利用JNDI來查找命令和在配置文件web.xml中手動聲明資源。服務器通過Servlet的自我調(diào)整來執(zhí)行它的任務。變量的名稱和類型由映像機制自動確定，盡管你可以利用注釋的參數(shù)來超越這一限制。一個注入的資源可以是數(shù)據(jù)源，Java信息服務目的文件或者是環(huán)境設置的標量。下面是一個例子：
- @Resource javax.sql.DataSource catalog;
- public getData() { Connection con = catalog.getConnection();}
現(xiàn)在，在這段Servlet代碼變成服務之前，容器會定位JNDI變量，并對于目錄變量進行手動分配。
為了效率，僅僅某些類支持資源注入，這些類有：Servlets，Servlet過濾器，Servlet事件監(jiān)聽器，JSP標簽操作器，JSP庫事件監(jiān)聽器，用于處理beans的JSF，以及一些與Serlvets無關(guān)的類。
◆@Resources注釋與@Resource相似，但是它用于一組@Resource注釋。它們都來自JSR250，是Java平臺的公共注釋。
◆@PostConstruct and @PreDestroy：可以使方法成為帶有生命周期的方法。@PostConstruct方法用于資源注入初始化之后。@PreDestroy方法用于Servlet脫離服務并釋放注入的資源的時候。回收的方法必須是事實的方法，返回void并且不可以拋出任何異常。這些注釋本質(zhì)上使得任何方法都成為init()和destroy()的子方法，這些特征也來自與JSR250。
◆@EJB：類似于@Resource，設計用于注入企業(yè)級的JavaBeans。比起@Resource，它略有不同，在于@EJB的參數(shù)特定設計用來定位EJB的參數(shù)。這個注釋來自EJB3.0的規(guī)范。
◆@WebServiceRef：與@Resource 和 @EJB相似，設計用于注入Web service參數(shù)。來自于JAX-WS2.0規(guī)范。
◆@PersistenceContext, @PersistenceContexts, @PersistenceUnit, and @PersistenceUnits：這些注釋來自EJB3.0規(guī)范來支持Java對象的持久化。
◆@DeclareRoles: 定義應用程序中安全角色的使用。當定義一個Servlet類時，在配置文件web.xml中﹤security-role﹥標簽中對它進行設置，來自JSR250。
◆ @RunAs：用于聲明哪個類應該執(zhí)行。當定義一個Servlet類時，在配置文件web.xml中﹤run-as﹥標簽中對它進行設置。來自于JSR250。
Annotation的效率
不論你使用注釋與否——尤其在你不使用時——它對于理解服務器上程序的執(zhí)行有著重要意義。為了讓服務器識別類中的注釋，它必須加載這些類，這就意味著服務器必須是啟動著的，服務器通過WEB-INF/classes目錄下和WEB－INF/lib目錄下的所有類文件來查找注釋。（每個規(guī)范下，服務器不必查找這兩個目錄以外的目錄。）你可以通過下面的方法指明﹤web-app﹥根的屬性而不必使用如何進行注釋：
- ﹤web-app xmlns="http://java.sun.com/xml/ns/javaee" version="2.5" full="true"﹥
- ﹤/web-app﹥
web.xml的便利
Servlet2.5對于web.xml引入幾個小的變動，使得它更加方便。
Servlet名稱的通配符化
首先，當你寫﹤filter-mapping﹥,你現(xiàn)在可以在﹤Servlet-name﹥標簽中使用*號來代表所有的Servlets。而以前，你必須一次把一個Servlet綁定到過濾器上，像這樣：
- ﹤filter-mapping﹥
- ﹤filter-name﹥Image Filter﹤/filter-name﹥
- ﹤Servlet-name﹥ImageServlet﹤/Servlet-name﹥
- ﹤/filter-mapping﹥
現(xiàn)在，你可以一次綁定所有的Servlets：
- ﹤filter-mapping﹥
- ﹤filter-name﹥Image Filter﹤/filter-name﹥
- ﹤Servlet-name﹥*﹤/Servlet-name﹥
- ﹤!—新特征 --﹥
- ﹤/filter-mapping﹥
這有著很大用途，例如：
- ﹤filter-mapping﹥
- ﹤filter-name﹥Dispatch Filter﹤/filter-name﹥
- ﹤Servlet-name﹥*﹤/Servlet-name﹥
- ﹤dispatcher﹥FORWARD﹤/dispatcher﹥
- ﹤/filter-mapping﹥
映射的復合模式
其次，當我們寫﹤Servlet-mapping﹥ 或者 ﹤filter-mapping﹥時，你現(xiàn)在可以在同一的標簽中采用復合匹配的標準。以前一個﹤Servlet-mapping﹥只支持一個﹤url-pattern﹥元素，現(xiàn)在它不只支持一個，例如：
- ﹤Servlet-mapping﹥
- ﹤Servlet-name﹥color﹤/Servlet-name﹥
- ﹤url-pattern﹥/color/*﹤/url-pattern﹥
- ﹤url-pattern﹥/colour/*﹤/url-pattern﹥
- ﹤/Servlet-mapping﹥
同樣地，以前﹤filter-mapping﹥也是只支持一個﹤url-pattern﹥ 或者一個 ﹤Servlet-name﹥。現(xiàn)在它對于每個元素都可以支持任意多個：
- ﹤filter-mapping﹥
- ﹤filter-name﹥Multipe Mappings Filter﹤/filter-name﹥
- ﹤url-pattern﹥/foo/*﹤/url-pattern﹥
- ﹤Servlet-name﹥Servlet1﹤/Servlet-name﹥
- ﹤Servlet-name﹥Servlet2﹤/Servlet-name﹥
- ﹤url-pattern﹥/bar/*﹤/url-pattern﹥
- ﹤/filter-mapping﹥
HTTP方法名
最近，你可以將合法的HTTP/1.1方法名放進﹤http-method﹥元素中。當你使用這些方法時，﹤http-method﹥將指明﹤security-constraint﹥標記里的方法應該被應用。從以前來看，它僅限于HTTP/1.1的7個標準方法：GET，POST，PUT，DELETE，HEAD，OPTIONS和TRACE。但是，HTTP/1.1允許對方法進行擴展，WebDAV是用于這種擴展的普遍技術(shù)。在Servlet2.5中，你可以安全地約束任何可能的HTTP方法名，標準及擴展，包括WebDAV方法，例如：LOCK，UNLOCK，COPY及MOVE。
如果你寫一個WebDAV的Servlet，你不必使用doLock()和doCopy()方法。你必須寫自己的service()方法及分派request.getMethod()方法。正由于這種變化，你不必管理系統(tǒng)的安全性。
去除限制
Servlet2.5去除了關(guān)于錯誤處理和回話跟蹤的一些限制。對于錯誤處理，Servlet2.5之前，配置在﹤error-page﹥中的錯誤處理頁面不能通過調(diào)用setStatus()方法來修改觸發(fā)他們的錯誤代碼，而Servlet2.5減弱了這一規(guī)范。這樣的規(guī)范的產(chǎn)生于這樣的觀點，就是錯誤頁面的工作是指出每個錯誤而不是修改錯誤。但是，實際使用中，錯誤頁面不只是用于指出錯誤，而是還能做更多的事情，或許可以代替在線幫助來幫助用戶解決問題。這個規(guī)范將不再限制錯誤頁面所產(chǎn)生的反饋信息。
對于會話跟蹤，Servlet2.5之前，調(diào)用RequestDispatcher.include()的Servlet不能設置響應的標題頭，而Servlet2.5減弱了這一規(guī)范。原規(guī)范的目的是使內(nèi)部的Servlets限制在自己的頁面空間中，不可以影響外部的頁面。現(xiàn)在這個規(guī)范已經(jīng)減弱，允許在內(nèi)部的Servlet中使用request.getSession()命令，這個命令可以悄悄地創(chuàng)建一個會話跟蹤cookie的標題頭。邏輯上要求限制內(nèi)部的資源，但邏輯上也要求這些限制不應該取消其啟動session的這一功能。這個變動對于Portlet規(guī)范來說顯得尤其重要。作用是：如果響應已經(jīng)有效，則getSession()命令就會拋出一個IllegalStateException(異常)，而在此之前，就沒有這個功能。
Clarifications
最近，新的規(guī)范對一些邊緣方法進行了說明，使得Servlets更加方便而且保證了更好地按要求工作。
終止響應
第一處說明細小又深奧，但做為規(guī)范中的一個例子還有蠻有趣的。Servlet2.4規(guī)范規(guī)定響應在這幾種情況下應該是有效的，包括：在響應的setContentLength方法中內(nèi)容已經(jīng)明確說明，以及內(nèi)容已經(jīng)寫進了響應中。這種情況只有你的代碼像下面這樣才可以使響應重新定向：
- response.setHeader("Host", "localhost")；
- response.setHeader("Pragma", "no-cache")；
- response.setHeader("Content-Length", "0")；
- response.setHeader("Location", "http://www.apache.org")；
Servlet技術(shù)忽略特定區(qū)域的標題頭，因為內(nèi)容滿足0字節(jié)長度，響應就會立即生效。而在它開始之前，響應就已失效了！
Servlet容器通常拒絕執(zhí)行這種行為，而Servlet2.5版本增加了“長度必須大于0”這個原則。
實例編碼
Servlet2.4規(guī)范規(guī)定必須在調(diào)用request.getReader()方法之前調(diào)用request.setCharacterEncoding()方法。但是，如果你忽略這個原則而在其之后去調(diào)用request.setCharacterEncoding()方法，那么會產(chǎn)生什么后果，這個問題規(guī)范里并沒有說。為了簡便，現(xiàn)在消除這種情況！
Cross-context sessions(不同上下文目錄間的會話)
最近，關(guān)于Cross-context會話處理的規(guī)則已經(jīng)明確說明。當Servlets指派從一個上下文到其他上下文的請求時，這個規(guī)則就發(fā)揮了作用——在目標調(diào)用過程中，包括哪些會話。這個版本的出現(xiàn)使得一個上下文目錄的主頁里的portlets可以通過幾種內(nèi)部的命令來對別的上下文目錄里的portlets起作用。Servlet2.5明確指出一個上下文目錄里的資源可以訪問其他上下文目錄的session(會話)，而不用考慮這個請求從哪里開始的。這意味著portlets可以脫離主頁的范圍而在自己的范圍里運行，而且這個規(guī)范還會應用在不兼容的Serlvet容器中。
期待
由于Servlet2.5版本要保持一些舊的性質(zhì)，幾個大的概念不得不延后到下一個階段。它們包括：
◆新的輸入/輸出(NIO)支持：使NIO通道更有利于Servlets進行客戶端通信成為可能。
◆過濾器wrap-under或wrap-over語義：有時用過濾器包裝請求，和/或者響應對象去修改方法行為或者啟用新的方法。當把這種包裝和服務器對請求和響應的包裝結(jié)合起來時，又應該怎么包裝在一起？
◆用于歡迎的Servlets文件：做為索引應該充當歡迎作用的文件嗎？在此之前，這個回答是肯定的。但是規(guī)范沒有明確說明如何使用這個功能，尤其在沒有索引的情況下。
◆用于歡迎的文件的分派規(guī)則：如何分派歡迎文件，這個細節(jié)并沒有完全說明，而是遺留了一些開放的缺口來應對不兼容問題。
◆登陸后選擇默認頁面：如果用戶通過他們的書簽訪問Servlet的登陸頁面，那么在成功登陸后頁面應該轉(zhuǎn)向哪里呢？這個問題至今尚未明確說明。
◆用戶的主題日志：在通過網(wǎng)站正確地注冊之后，不通過傳統(tǒng)地登陸方式?jīng)]有辦法使Servlet信任用戶。
結(jié)束語
如果拋開注釋來看Servlet2.5的變化，可見在配置文件web.xml中去除了一些限制，是有利的，同時又優(yōu)化了實例行為使其更適合更便于開發(fā)Web系統(tǒng)(網(wǎng)頁)。
Servlet2.5中注釋的作用更加戲劇化。Servlets本身不能聲明注釋類型的變量，甚至性能弱的Servlet容器都不支持注釋。然而在JEE5環(huán)境下的Servlets編寫者可以看到，通過公共的注釋及EJB3.0和JAX-WS2.0規(guī)范而引入的注釋類型會對代碼產(chǎn)生很大變化，并且這也將對Servlet如何管理外部資源，對象的持久化及EJB的構(gòu)成產(chǎn)生重大影響。
【編輯推薦】
