在這篇文章里,我主要談?wù)凷ervlet2.5版本中的新特征。描述每一個(gè)變化,闡述那些必要變化產(chǎn)生的背景,并展示如何在基于Servlet的項(xiàng)目中利用這些變化?!?br>事實(shí)上,這是我為JavaWorld提供的第六篇關(guān)于Servlet API更新資料的文章。這篇文章意在兩個(gè)目的:從眼前來(lái)看,向你介紹 Servlet的新特征。從長(zhǎng)遠(yuǎn)來(lái)看,是展現(xiàn)Servlet變化的歷史概要,這樣當(dāng)你基于老的Servlet API版本進(jìn)行編碼的時(shí)候,你可以正確地決定哪些特征和功能你可以使用,而哪些特征和功能你不應(yīng)該使用。你可以參考我先前寫(xiě)的關(guān)于Servlet的文章。
注意:當(dāng)你想實(shí)踐這些Servlet的新特征和功能時(shí),你要知道的是:并不是所有的Servlet容器和Java企業(yè)級(jí)應(yīng)用服務(wù)器都能立即適用于最新版的Servlet API,寫(xiě)這篇文章時(shí)(2006年1月2日),Jetty 6 server和Sun公司的GlassFish server是公認(rèn)最好的支持Servlet2.5的容器,而Apache Tomcat5.5和Jboss 4.0目前只支持Servlet2.4。
Servlet2.5一些變化的介紹:
1) 基于最新的J2SE 5.0開(kāi)發(fā)的。
2) 支持注釋。
3) web.xml中的幾處配置更加方便。
4) 去除了少數(shù)的限制。
5) 優(yōu)化了一些實(shí)例
J2SE 5.0的產(chǎn)物:
從一開(kāi)始,Servlet 2.5 規(guī)范就列出J2SE 5.0 (JDK 1.5) 作為它最小的平臺(tái)要求。它使得Servlet2.5只能適用基于J2SE 5.0開(kāi)發(fā)的平臺(tái),這個(gè)變動(dòng)意味著所有J2SE5.0的新特性可以保證對(duì)Servlet2.5程序員有用。
傳統(tǒng)意義上,Servlet和JEE版本一直與JDK的版本保持同步發(fā)展,但是這次,Servlet的版本跳過(guò)1.4版本。專(zhuān)家組認(rèn)為版本的加速增長(zhǎng)是正當(dāng)?shù)模驗(yàn)镴2SE5.0提出一個(gè)引人注目的,Servlet和JEE規(guī)范都要利用的特征??注釋。
注釋?zhuān)?/strong>
注釋是作為JSR175的一部分提出的(一種為Java語(yǔ)言設(shè)計(jì)提供便利的Metadata)一種新的語(yǔ)言特色。它是利用Metadata為Java 編碼結(jié)構(gòu)(類(lèi),方法,域等等)裝飾的一種機(jī)制。它不能像代碼那樣執(zhí)行,但是可以用于標(biāo)記代碼,這個(gè)過(guò)程是基于Metadata信息的代碼處理機(jī),通過(guò)更新他們的事件行為來(lái)實(shí)現(xiàn)的。
我們可以憑借不同的技巧來(lái)注釋類(lèi)和方法,例如連續(xù)地標(biāo)記接口或者是@deprecated Javadoc評(píng)論。這種新式的Metadata可以便利地提供了一種標(biāo)準(zhǔn)的機(jī)制來(lái)實(shí)現(xiàn)注釋功能,以及通過(guò)庫(kù)來(lái)創(chuàng)建用戶自己的注釋類(lèi)型的變量。
下面是一個(gè)簡(jiǎn)單的Web service 注釋例子:
import javax.jws.WebService;
import javax.jws.WebMethod;
@WebService
public class HelloWorldService {
@WebMethod
public String helloWorld() {
return "Hello World!";
}
}
@WebService和@WebMethod這兩個(gè)注釋類(lèi)型,在JSR181(為Java平臺(tái)提供的Web ServicesMetadata)有詳細(xì)說(shuō)明,可以像類(lèi)一樣的引用,標(biāo)記這個(gè)類(lèi)作為一個(gè)Web service并且標(biāo)記它的helloWorld()方法做為一個(gè)Web service方法。對(duì)于他們本身來(lái)說(shuō),注釋只是寫(xiě)在那里并沒(méi)有什么作用,好像在崗位上做記錄一樣,但是,一個(gè)容器一旦加載這個(gè)類(lèi)并對(duì)那些注釋進(jìn)行二進(jìn)制編碼,就可以把這個(gè)類(lèi)連到Web service上。
注釋可以接受屬性/值這些參數(shù)。它保存著參數(shù)的信息并且可以利用這些參數(shù)來(lái)更改被請(qǐng)求的事件行為。例如下面更高級(jí)的注釋例子:
@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() { }
}
一旦加載了這個(gè)類(lèi),一個(gè)正確配置的容器就會(huì)識(shí)別出注釋及其參數(shù),并將這個(gè)做為一個(gè)PingService通過(guò)利用remote-procedure- call/literal的編碼方式與一個(gè)Foo operation相連。實(shí)際上,注釋便指明了類(lèi)和類(lèi)的容器之間的聯(lián)系。
Java本身的規(guī)范(JSR175)僅僅有少量的注釋類(lèi)型變量。而這些有趣的注釋類(lèi)型變量主要來(lái)自于其他的JSRs:
"JSR 250: Java平臺(tái)的公共注釋
"JSR 220: 企業(yè)級(jí)JavaBeans 3.0
"JSR 224: 基于XML的Java API Web Services (JAX-WS) 2.0
"JSR 181: Java平臺(tái)的Web Services Metadata
Servlet2.5中的注釋?zhuān)?br>回到Servlet2.5上來(lái),一種新的規(guī)范描述了幾種注釋在Servlet環(huán)境中是如何工作的。功能弱的Servlet容器忽略了這些規(guī)范,然而JEE容器中的Servlet卻嚴(yán)格遵守這些規(guī)范。
有的注釋提供了在XML注冊(cè)的可選擇性,否則就要注冊(cè)在配置文件web.xml中。有的作為容器的請(qǐng)求來(lái)執(zhí)行其任務(wù),否則就由Servlet親自來(lái)執(zhí)行。還有的注釋兩者都具備。
注釋準(zhǔn)確的定義不是完全固定的,因?yàn)镾ervlet本身并沒(méi)有定義注釋。它僅僅解釋了它們?nèi)绾斡绊慡ervlet環(huán)境,下面是注釋的一個(gè)簡(jiǎn)要的概述,你可以看到在JEE5中它們的用途:
"@Resource and @Resources:@Resource位于類(lèi)或變量中以對(duì)Servlet容器進(jìn)行“資源注入”。當(dāng)容器識(shí)別出這個(gè)注釋時(shí),它會(huì)在獲得服務(wù)地位之前,用適當(dāng)?shù)闹祵?shí)現(xiàn)帶注釋的變量的重新注入。通過(guò)使用這種注釋?zhuān)悴槐乩肑NDI來(lái)查找命令和在配置文件web.xml中手動(dòng)聲明資源。服務(wù)器通過(guò)Servlet的自我調(diào)整來(lái)執(zhí)行它的任務(wù)。變量的名稱(chēng)和類(lèi)型由映像機(jī)制自動(dòng)確定,盡管你可以利用注釋的參數(shù)來(lái)超越這一限制。一個(gè)注入的資源可以是數(shù)據(jù)源,Java信息服務(wù)目的文件或者是環(huán)境設(shè)置的標(biāo)量。下面是一個(gè)例子:
@Resource javax.sql.DataSource catalog;
public getData() {
Connection con = catalog.getConnection();
}
現(xiàn)在,在這段Servlet代碼變成服務(wù)之前,容器會(huì)定位JNDI變量,并對(duì)于目錄變量進(jìn)行手動(dòng)分配。
為了效率,僅僅某些類(lèi)支持資源注入,這些類(lèi)有:Servlets,Servlet過(guò)濾器,Servlet事件監(jiān)聽(tīng)器,JSP標(biāo)簽操作器,JSP庫(kù)事件監(jiān)聽(tīng)器,用于處理beans的JSF,以及一些與Serlvets無(wú)關(guān)的類(lèi)。
"@Resources注釋與@Resource相似,但是它用于一組@Resource注釋。它們都來(lái)自JSR250,是Java平臺(tái)的公共注釋。
"@PostConstruct and @PreDestroy:可以使方法成為帶有生命周期的方法。@PostConstruct方法用于資源注入初始化之后。@PreDestroy方法用于Servlet脫離服務(wù)并釋放注入的資源的時(shí)候。回收的方法必須是事實(shí)的方法,返回void并且不可以拋出任何異常。這些注釋本質(zhì)上使得任何方法都成為init()和destroy()的子方法,這些特征也來(lái)自與JSR250。
"@EJB:類(lèi)似于@Resource,設(shè)計(jì)用于注入企業(yè)級(jí)的JavaBeans。比起@Resource,它略有不同,在于@EJB的參數(shù)特定設(shè)計(jì)用來(lái)定位EJB的參數(shù)。這個(gè)注釋來(lái)自EJB3.0的規(guī)范。
"@WebServiceRef:與@Resource 和 @EJB相似,設(shè)計(jì)用于注入Web service參數(shù)。來(lái)自于JAX-WS2.0規(guī)范。
"@PersistenceContext, @PersistenceContexts, @PersistenceUnit, and @PersistenceUnits:這些注釋來(lái)自EJB3.0規(guī)范來(lái)支持Java對(duì)象的持久化。
"@DeclareRoles: 定義應(yīng)用程序中安全角色的使用。當(dāng)定義一個(gè)Servlet類(lèi)時(shí),在配置文件web.xml中<security-role>標(biāo)簽中對(duì)它進(jìn)行設(shè)置,來(lái)自JSR250。
" @RunAs:用于聲明哪個(gè)類(lèi)應(yīng)該執(zhí)行。當(dāng)定義一個(gè)Servlet類(lèi)時(shí),在配置文件web.xml中<run-as>標(biāo)簽中對(duì)它進(jìn)行設(shè)置。來(lái)自于JSR250。
注釋的執(zhí)行:
不論你使用注釋與否??尤其在你不使用時(shí)??它對(duì)于理解服務(wù)器上程序的執(zhí)行有著重要意義。為了讓服務(wù)器識(shí)別類(lèi)中的注釋?zhuān)仨毤虞d這些類(lèi),這就意味著服務(wù)器必須是啟動(dòng)著的,服務(wù)器通過(guò)WEB-INF/classes目錄下和WEB-INF/lib目錄下的所有類(lèi)文件來(lái)查找注釋。(每個(gè)規(guī)范下,服務(wù)器不必查找這兩個(gè)目錄以外的目錄。)你可以通過(guò)下面的方法指明<web-app>根的屬性而不必使用如何進(jìn)行注釋?zhuān)?br><web-app xmlns="http://java.sun.com/xml/ns/javaee"
version="2.5" full="true">
</web-app>
web.xml的便利:
Servlet2.5對(duì)于web.xml引入幾個(gè)小的變動(dòng),使得它更加方便。
Servlet名稱(chēng)的通配符化:
首先,當(dāng)你寫(xiě)<filter-mapping>,你現(xiàn)在可以在<Servlet-name>標(biāo)簽中使用*號(hào)來(lái)代表所有的Servlets。而以前,你必須一次把一個(gè)Servlet綁定到過(guò)濾器上,像這樣:
<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>
映射的復(fù)合模式:
其次,當(dāng)我們寫(xiě)<Servlet-mapping> 或者 <filter-mapping>時(shí),你現(xiàn)在可以在同一的標(biāo)簽中采用復(fù)合匹配的標(biāo)準(zhǔn)。以前一個(gè)<Servlet-mapping>只支持一個(gè)<url-pattern>元素,現(xiàn)在它不只支持一個(gè),例如:
<Servlet-mapping>
<Servlet-name>color</Servlet-name>
<url-pattern>/color/*</url-pattern>
<url-pattern>/colour/*</url-pattern>
</Servlet-mapping>
同樣地,以前<filter-mapping>也是只支持一個(gè)<url-pattern> 或者一個(gè) <Servlet-name>?,F(xiàn)在它對(duì)于每個(gè)元素都可以支持任意多個(gè):
<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方法名放進(jìn)<http-method>元素中。當(dāng)你使用這些方法時(shí),<http- method>將指明<security-constraint>標(biāo)記里的方法應(yīng)該被應(yīng)用。從以前來(lái)看,它僅限于HTTP/1.1的7 個(gè)標(biāo)準(zhǔn)方法:GET,POST,PUT,DELETE,HEAD,OPTIONS和TRACE。但是,HTTP/1.1允許對(duì)方法進(jìn)行擴(kuò)展,WebDAV 是用于這種擴(kuò)展的普遍技術(shù)。在Servlet2.5中,你可以安全地約束任何可能的HTTP方法名,標(biāo)準(zhǔn)及擴(kuò)展,包括WebDAV方法,例如:LOCK, UNLOCK,COPY及MOVE。
如果你寫(xiě)一個(gè)WebDAV的Servlet,你不必使用doLock()和doCopy()方法。你必須寫(xiě)自己的service()方法及分派request.getMethod()方法。正由于這種變化,你不必管理系統(tǒng)的安全性。
去除限制:
Servlet2.5去除了關(guān)于錯(cuò)誤處理和回話跟蹤的一些限制。對(duì)于錯(cuò)誤處理,Servlet2.5之前,配置在<error- page>中的錯(cuò)誤處理頁(yè)面不能通過(guò)調(diào)用setStatus()方法來(lái)修改觸發(fā)他們的錯(cuò)誤代碼,而Servlet2.5減弱了這一規(guī)范。這樣的規(guī)范的產(chǎn)生于這樣的觀點(diǎn),就是錯(cuò)誤頁(yè)面的工作是指出每個(gè)錯(cuò)誤而不是修改錯(cuò)誤。但是,實(shí)際使用中,錯(cuò)誤頁(yè)面不只是用于指出錯(cuò)誤,而是還能做更多的事情,或許可以代替在線幫助來(lái)幫助用戶解決問(wèn)題。這個(gè)規(guī)范將不再限制錯(cuò)誤頁(yè)面所產(chǎn)生的反饋信息。
對(duì)于會(huì)話跟蹤,Servlet2.5之前,調(diào)用RequestDispatcher.include()的Servlet不能設(shè)置響應(yīng)的標(biāo)題頭,而 Servlet2.5減弱了這一規(guī)范。原規(guī)范的目的是使內(nèi)部的Servlets限制在自己的頁(yè)面空間中,不可以影響外部的頁(yè)面。現(xiàn)在這個(gè)規(guī)范已經(jīng)減弱,允許在內(nèi)部的Servlet中使用request.getSession()命令,這個(gè)命令可以悄悄地創(chuàng)建一個(gè)會(huì)話跟蹤cookie的標(biāo)題頭。邏輯上要求限制內(nèi)部的資源,但邏輯上也要求這些限制不應(yīng)該取消其啟動(dòng)session的這一功能。這個(gè)變動(dòng)對(duì)于Portlet規(guī)范來(lái)說(shuō)顯得尤其重要。作用是:如果響應(yīng)已經(jīng)有效,則getSession()命令就會(huì)拋出一個(gè)IllegalStateException(異常),而在此之前,就沒(méi)有這個(gè)功能。
優(yōu)化:
最近,新的規(guī)范優(yōu)化了一些實(shí)例,使得Servlets更加方便而且保證了更好地按要求工作。
終止響應(yīng):
第一處優(yōu)化細(xì)小又深?yuàn)W,但做為規(guī)范中的一個(gè)例子還有蠻有趣的。Servlet2.4規(guī)范規(guī)定響應(yīng)在這幾種情況下應(yīng)該是有效的,包括:在響應(yīng)的 setContentLength方法中內(nèi)容已經(jīng)明確說(shuō)明,以及內(nèi)容已經(jīng)寫(xiě)進(jìn)了響應(yīng)中。這種情況只有你的代碼像下面這樣才可以使響應(yī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ū)域的標(biāo)題頭,因?yàn)閮?nèi)容滿足0字節(jié)長(zhǎng)度,響應(yīng)就會(huì)立即生效。而在它開(kāi)始之前,響應(yīng)就已失效了!Servlet容器通常拒絕執(zhí)行這種行為,而Servlet2.5版本增加了“長(zhǎng)度必須大于0”這個(gè)原則。
實(shí)例編碼:
Servlet2.4規(guī)范規(guī)定必須在調(diào)用request.getReader()方法之前調(diào)用 request.setCharacterEncoding()方法。但是,如果你忽略這個(gè)原則而在其之后去調(diào)用 request.setCharacterEncoding()方法,那么會(huì)產(chǎn)生什么后果,這個(gè)問(wèn)題規(guī)范里并沒(méi)有說(shuō)。為了簡(jiǎn)便,現(xiàn)在消除這種情況!
Cross-context sessions(不同上下文目錄間的會(huì)話):
最近,關(guān)于Cross-context會(huì)話處理的規(guī)則已經(jīng)明確說(shuō)明。當(dāng)Servlets指派從一個(gè)上下文到其他上下文的請(qǐng)求時(shí),這個(gè)規(guī)則就發(fā)揮了作用??在目標(biāo)調(diào)用過(guò)程中,包括哪些會(huì)話。這個(gè)版本的出現(xiàn)使得一個(gè)上下文目錄的主頁(yè)里的portlets可以通過(guò)幾種內(nèi)部的命令來(lái)對(duì)別的上下文目錄里的 portlets起作用。Servlet2.5明確指出一個(gè)上下文目錄里的資源可以訪問(wèn)其他上下文目錄的session(會(huì)話),而不用考慮這個(gè)請(qǐng)求從哪里開(kāi)始的。這意味著portlets可以脫離主頁(yè)的范圍而在自己的范圍里運(yùn)行,而且這個(gè)規(guī)范還會(huì)應(yīng)用在不兼容的Serlvet容器中。
期待:
由于Servlet2.5版本要保持一些舊的性質(zhì),幾個(gè)大的概念不得不延后到下一個(gè)階段。它們包括:
"新的輸入/輸出(NIO)支持:使NIO通道更有利于Servlets進(jìn)行客戶端通信成為可能。
"過(guò)濾器wrap-under或wrap-over語(yǔ)義:有時(shí)用過(guò)濾器包裝請(qǐng)求,和/或者響應(yīng)對(duì)象去修改方法行為或者啟用新的方法。當(dāng)把這種包裝和服務(wù)器對(duì)請(qǐng)求和響應(yīng)的包裝結(jié)合起來(lái)時(shí),又應(yīng)該怎么包裝在一起?
"用于歡迎的Servlets文件:做為索引應(yīng)該充當(dāng)歡迎作用的文件嗎?在此之前,這個(gè)回答是肯定的。但是規(guī)范沒(méi)有明確說(shuō)明如何使用這個(gè)功能,尤其在沒(méi)有索引的情況下。
"用于歡迎的文件的分派規(guī)則:如何分派歡迎文件,這個(gè)細(xì)節(jié)并沒(méi)有完全說(shuō)明,而是遺留了一些開(kāi)放的缺口來(lái)應(yīng)對(duì)不兼容問(wèn)題。
"登陸后選擇默認(rèn)頁(yè)面:如果用戶通過(guò)他們的書(shū)簽訪問(wèn)Servlet的登陸頁(yè)面,那么在成功登陸后頁(yè)面應(yīng)該轉(zhuǎn)向哪里呢?這個(gè)問(wèn)題至今尚未明確說(shuō)明。
"用戶的主題日志:在通過(guò)網(wǎng)站正確地注冊(cè)之后,不通過(guò)傳統(tǒng)地登陸方式?jīng)]有辦法使Servlet信任用戶。
結(jié)束語(yǔ):
如果拋開(kāi)注釋來(lái)看Servlet2.5的變化,可見(jiàn)在配置文件web.xml中去除了一些限制,是有利的,同時(shí)又優(yōu)化了實(shí)例行為使其更適合更便于開(kāi)發(fā)Web系統(tǒng)(網(wǎng)頁(yè))。
Servlet2.5中注釋的作用更加戲劇化。Servlets本身不能聲明注釋類(lèi)型的變量,甚至性能弱的Servlet容器都不支持注釋。然而在 JEE5環(huán)境下的Servlets編寫(xiě)者可以看到,通過(guò)公共的注釋及EJB3.0和JAX-WS2.0規(guī)范而引入的注釋類(lèi)型會(huì)對(duì)代碼產(chǎn)生很大變化,并且這也將對(duì)Servlet如何管理外部資源,對(duì)象的持久化及EJB的構(gòu)成產(chǎn)生重大影響
J2EE的兩種重要的表現(xiàn)層技術(shù)JSP和JSF發(fā)布了新技術(shù)規(guī)范的預(yù)覽版本,其中最重要的一點(diǎn)是兩者將表達(dá)式語(yǔ)言(Expression Language,EL)部分合二為一。在不久的將來(lái),這兩種技術(shù)有可能更進(jìn)一步地彼此融合,成為一種統(tǒng)一的表現(xiàn)層技術(shù)。然而在J2EE社群的普遍觀點(diǎn)中,如果單單作為一種視圖技術(shù),JSP并不是最佳的選擇,Velocity和XSLT等基于模板的視圖技術(shù)通常比JSP更方便;而基于組件的JSF也面臨廣泛的信任危機(jī)。兩者的組合是否能得到業(yè)界的認(rèn)可,還需要時(shí)間的檢驗(yàn)。
jsp 2.1
我們很高興向大家宣告,JavaServer Pages、JSR-245下開(kāi)發(fā)的Faces.JavaServer Pages(JSP)2.1和JSR-252下開(kāi)發(fā)的JavaServer Faces(Faces)1.2的新版規(guī)范的Early Draft Review發(fā)布。
JSP 2.1把Expression Language(EL)輸出到它自己各自分離的文檔中,在技術(shù)上,這些文檔是JSP規(guī)范的子文檔。這些統(tǒng)一的EL規(guī)范定義了一個(gè)更高層的java 包,javax.el。這個(gè)包與使用它的技術(shù)之間完全獨(dú)立,并且允許此技術(shù)將自身插入EL處理過(guò)程。更改的JSP規(guī)范遵從使用標(biāo)準(zhǔn)化EL的規(guī)范。
對(duì)于前面提到的JSR-252,這個(gè)規(guī)范并沒(méi)什么新特性。Faces 1.2支持新的標(biāo)準(zhǔn)化EL,還包含一些bug修復(fù)的相關(guān)規(guī)范。
Faces和JSP在JSRs下的結(jié)盟帶來(lái)了一些新功能,也為將來(lái)的發(fā)展打下了堅(jiān)實(shí)的基礎(chǔ)。例如,在同時(shí)使用Faces和JSP的web應(yīng)用中,網(wǎng)頁(yè)僅使用JSP(不包含任何faces內(nèi)容)來(lái)訪問(wèn)Managed Beans成為可能。在JSP規(guī)范的附錄E中和Faces規(guī)范的前言中都可以看到更改內(nèi)容的細(xì)節(jié)。