告訴容器要用哪一種驗證機制相對容易,真正實用的是「指定哪些 URL 受到保護、應該受到何種保護」,而這正是 security-constraint 元素的用途。它在 web.xml 中應緊接在 login-config 之前,包含四個可能的子元素:web-resource-collection、auth-constraint、user-data-constraint 與 display-name。
每個 security-constraint 都必須至少包含一個 web-resource-collection。它由以下元素組成:web-resource-name(任意識別名稱)、url-pattern(要保護的 URL)、http-method(此保護適用的 HTTP 命令,如 GET、POST,預設為全部方法),以及可選的 description。
<security-constraint>
<web-resource-collection>
<web-resource-name>Proprietary</web-resource-name>
<url-pattern>/proprietary/*</url-pattern>
</web-resource-collection>
<!-- ... -->
</security-constraint>
這裡有一個容易被忽略的細節:url-pattern 只對直接存取這些資源的用戶端生效。特別是,它不適用於透過 MVC 架構以 RequestDispatcher 轉發的頁面,也不適用於以 jsp:forward 之類手段存取的頁面。
這種不對稱若善加利用其實很有價值。例如 servlet 可依 MVC 架構查詢資料、放進 bean、再把請求轉發到從 bean 取值的 JSP 顯示。我們希望確保這支 JSP 絕不會被直接存取,只能透過建立該 bean 的 servlet 進入。做法很簡單:用 url-pattern 搭配 auth-constraint,宣告不允許任何使用者直接存取該 JSP。不過要留意,這種不對稱也可能讓開發者鬆懈,不小心替應受保護的資源開了不受限的後門。
web-resource-collection 說明了哪些 URL 該保護,auth-constraint 則說明哪些使用者有權存取。它應包含一個或多個 role-name 元素標識具存取權的角色,以及可選的 description。
<security-constraint>
<web-resource-collection> ... </web-resource-collection>
<auth-constraint>
<role-name>administrator</role-name>
<role-name>kahuna</role-name>
</auth-constraint>
</security-constraint>
上面的設定表示只有被指定為 administrator 或 kahuna(或兩者兼具)的使用者能存取該資源。
值得注意的是,可攜性的部分到此為止。伺服器如何判定哪些使用者屬於哪個角色、又如何存放使用者密碼,完全取決於具體實作。以 Tomcat 為例,它使用 install_dir/conf/tomcat-users.xml 把使用者名稱與角色、密碼關聯起來:
<tomcat-users> <user name="joe" password="bigshot" roles="administrator,kahuna" /> <user name="jane" password="enaj" roles="kahuna" /> </tomcat-users>
這個可選元素用來要求存取相關資源時採用傳輸層保護,必須包含一個 transport-guarantee 子元素(合法值為 NONE、INTEGRAL 或 CONFIDENTIAL),並可附帶 description。
NONE 表示不限制通訊協議。INTEGRAL 表示資料必須以能防止截取者閱讀的方式傳送。原理上(並且未來的 HTTP 版本中)INTEGRAL 與 CONFIDENTIAL 可能有差別,但在當時的實務上兩者都只是要求使用 SSL。
<security-constraint>
<!-- ... -->
<user-data-constraint>
<transport-guarantee>CONFIDENTIAL</transport-guarantee>
</user-data-constraint>
</security-constraint>
這段設定指示伺服器只允許以 HTTPS 連線存取相關資源。
這個少用的子元素為安全限制項目取一個名稱,供 GUI 工具顯示之用。
前面的討論都集中在完全由容器處理的安全機制上,但 servlet 與 JSP 也能自行處理部分安全判斷。
舉例來說,容器可能允許 bigwig 與 bigcheese 兩種角色存取一個顯示主管專屬資訊的頁面,卻只允許 bigwig 修改頁面上的參數。實作這種更細緻的控制,常見做法是呼叫 HttpServletRequest.isUserInRole() 並據此調整行為。
Servlet 的 security-role-ref 子元素,能為出現在伺服器專屬帳密檔中的角色名稱建立別名。假設你寫了一支呼叫 request.isUserInRole("boss") 的 servlet,後來它被部署到一個角色名為 manager 而非 boss 的伺服器上,下面的寫法讓這支 servlet 同時吃這兩個名稱:
<servlet>
<!-- ... -->
<security-role-ref>
<role-name>boss</role-name> <!-- 別名 -->
<role-link>manager</role-link> <!-- 實際名稱 -->
</security-role-ref>
</servlet>
此外,也可以在 web-app 內用 security-role 元素,為所有出現在 role-name 中的安全角色提供一份全域清單。分別宣告這些角色,能讓高階 IDE 更容易處理安全資訊。
若某個工作階段在一段時間內沒有被存取,伺服器可以丟掉它以節省記憶體。你可以直接呼叫 HttpSession.setMaxInactiveInterval() 設定個別工作階段的逾時值;若不這麼做,預設值由伺服器決定。想讓所有伺服器都有一致行為,可用 session-config 與 session-timeout 明確指定。單位是分鐘,下面的例子把預設逾時設為三小時:
<session-config> <session-timeout>180</session-timeout> </session-config>
當時愈來愈多開發環境直接支援 servlet 與 JSP,例如 Borland JBuilder Enterprise Edition、Macromedia UltraDev、Allaire JRun Studio(撰文時已被 Macromedia 收購)以及 IBM VisualAge for Java。
web.xml 中有不少元素並非給伺服器看,而是給視覺化開發環境用的,包括 icon、display-name 與 description。要記得 web.xml 中 web-app 子元素的順序至關重要,而這三個正好是 web-app 內合法順序的前三名。
icon:指出 GUI 工具可用來代表這個 Web 應用的圖檔。small-icon 指定 16×16 的 GIF 或 JPEG,large-icon 指定 32×32 的圖。
<icon> <small-icon>/images/small-book.gif</small-icon> <large-icon>/images/tome.jpg</large-icon> </icon>
display-name:提供 GUI 工具標示此 Web 應用的名稱。
<display-name>Rare Books</display-name>
description:提供說明性文字。
<description> This Web application represents the store developed for rare-books.com, an online bookstore specializing in rare and limited-edition books. </description>
伺服器一般都提供方法讓站點管理者把副檔名關聯到媒體類型,例如 mom.jpg 會自動獲得 image/jpeg。但若你的應用有幾個不常見的檔案,需要確保它們送出時帶上正確的 MIME 類型,mime-mapping(含 extension 與 mime-type 子元素)就能派上用場:
<mime-mapping> <extension>foo</extension> <mime-type>application/x-fubar</mime-type> </mime-mapping>
這段設定把 application/x-fubar 指派給所有以 .foo 結尾的檔案。同理,你也可以覆寫標準關聯,例如把 .ps 檔以純文字而非 PostScript 送出:
<mime-mapping> <extension>ps</extension> <mime-type>text/plain</mime-type> </mime-mapping>
JSP 的 taglib 指令有一個必要的 uri 屬性,用來給出 TLD(Tag Library Descriptor)檔相對於 Web 應用根節點的位置。問題是 TLD 的實際檔名在標籤庫升版時可能改變,而你不希望去改動所有既有的 JSP;此外,你也會想在 JSP 頁面中保持 uri 簡潔。這正是部署描述符中 taglib 元素的用武之地。
它包含兩個子元素:taglib-uri 要與 JSP 中 taglib 指令的 uri 值一致;taglib-location 則給出 TLD 檔的實際位置。假設你把 chart-tags-1.3beta.tld 放在 WEB-INF/tlds 中:
<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" %>
應用事件監聽器是在 servlet 環境或工作階段物件建立、修改時被通知的類別,這是 Servlet 規範 2.3 版新增的功能。註冊方式是在 web.xml 的 web-app 內放一個 listener 元素,其中 listener-class 列出監聽器的完整限定類名:
<listener> <listener-class>package.ListenerClass</listener-class> </listener>
結構雖簡單,仍要注意 web-app 子元素的順序:listener 位於所有 servlet 元素之前、所有 filter-mapping 元素之後。另外,由於應用生命週期監聽器是 2.3 版的新功能,必須使用 2.3 版的 web.xml DTD,而非 2.2 版。
以下是一個名為 ContextReporter 的簡單監聽器,只要 Web 應用的 ServletContext 建立(例如載入應用)或消滅(例如伺服器關機)時,就在標準輸出上顯示一則訊息。
package moreservlets;
import javax.servlet.*;
import java.util.*;
/** 當 ServletContext 建立或消滅時,於標準輸出印出報告 */
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() + ".");
}
}
對應的 web.xml 片段:
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE web-app
PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
"https://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>
以下元素屬於 J2EE 環境下的 Web 應用設定,更完整的說明可參考 Java 2 Platform Enterprise Edition 1.3 規範第 5 章。
distributable:宣告這個 Web 應用是以「可被分散部署」的方式撰寫,支援叢集(cluster)的伺服器可以安全地把它部署到多台機器上。例如可分散的應用必須只把 Serializable 物件作為 HttpSession 的屬性,並避免用實例變數維持狀態。它緊接在 description 之後,沒有子元素也沒有內容,只是一個標記:
<distributable />
resource-env-ref:宣告一個與資源相關的管理物件,由可選的 description、resource-env-ref-name(相對於 java:comp/env 的 JNDI 名稱)與 resource-env-ref-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:宣告 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>minAmount</env-entry-name> <env-entry-value>100.00</env-entry-value> <env-entry-type>java.lang.String</env-entry-type> </env-entry>
ejb-ref:宣告對某個 EJB Home 的引用,由可選的 description、ejb-ref-name(相對於 java:comp/env 的 EJB 引用名)、ejb-ref-type(bean 型別,Entity 或 Session)、home(Home 介面的完整限定名)、remote(Remote 介面的完整限定名)與可選的 ejb-link(連結到同應用中另一個 bean 的名稱)組成。
ejb-local-ref:宣告對 EJB 本地 Home 的引用。除了以 local-home 取代 home 之外,其餘屬性與用法與 ejb-ref 相同。