welcome-file-list元素

當用户在瀏覽器中輸入的URL不包含某個servlet名或JSP頁面時，welcome-file-list元素可指定顯示的默認文件。

<!ELEMENT welcome-file-list (welcome-file+)>

<!ELEMENT welcome-file (#PCDATA)>

舉個例子説明，假設用户在瀏覽器的地址框中輸入http://www.mycompany.com/appName/等地址。如果在Web應用的部署描述符中沒有指定welcome-file-list元素，用户就會看到一個權限錯誤消息，或者是應用目錄下的文件和目錄列表。如果定義了welcome-file-list元素，用户就能看到由該元素指定的具體文件。

welcome-file子元素用於指定默認文件的名稱。welcome-file-list元素可以包含一個或多個welcome-file子元素。如果在第一個welcome-file元素中沒有找到指定的文件，Web容器就會嘗試顯示第二個，以此類推。

下面是一個包含welcome-file-list元素的部署描述符。該元素包含兩個welcome-file元素：第一個指定應用目錄中的main.html文件，第二個定義jsp目錄下的welcom.jsp文件，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>

<welcome-file-list>

<welcome-file>main.html</welcome-file>

<welcome-file>jsp/welcome.jsp</welcome-file>

</welcome-file-list>

</web-app>

如果用户鍵入的URL不包含servlet名稱、JSP頁面或其他資源，會在應用目錄中找main.html文件，如果找不到main.html文件，這時就會顯示jsp目錄下的welcome.jsp文件。