web.xml
文件是用來配置:歡迎頁、servlet、filter等的。
那麼web.xml
能做的所有事情都有那些?
其實,web.xml
的模式(Schema
)文件中定義了多少種標籤元素,web.xml
中就可以出現它的模式文件所定義的標籤元素,它就能擁有定義出來的那些功能。
web.xml
的模式文件是由Sun
公司定義的,每個web.xml
文件的根元素<web-app>
中,都必須標明這個web.xml
使用的是哪個模式文件。
如:
<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_4_0.xsd"
version="4.0">
</web-app>
下面列出web.xml
常用的標籤元素及這些標籤元素的功能:
<welcome-file-list>
<welcome-file>index.jsp</welcome-file>
<welcome-file>index1.jsp</welcome-file>
</welcome-file-list>
上面的例子指定了2個歡迎頁面,顯示時按順序從第一個找起,如果第一個存在,就顯示第一個,後面的不起作用。如果第一個不存在,就找第二個,以此類推。
我們可以爲Servlet
和JSP文件
命名並定製URL
,其中定製URL
是依賴一命名的,命名必須在定製URL
前。
下面拿serlet
來舉例:
- 爲
Servlet
命名:
<servlet>
//設置servlet名字
<servlet-name>servlet</servlet-name>
//設置servlet類名
<servlet-class>net.test.TestServlet</servlet-class>
</servlet>
- 爲
Servlet
定製URL
//用於映射上面<servlet>中的對外訪問路徑
<servlet-mapping>
//設置servlet的名稱
<servlet-name>servlet</servlet-name>
//設置servlet的請求路徑
<url-pattern>*.do</url-pattern>
</servlet-mapping>
- 定製初始化參數:可以定製
servlet
、JSP
、Context
的初始化參數,然後可以在servlet
、JSP
、Context
中獲取這些參數值。下面拿servlet
來舉例:
<servlet>
<servlet-name>servlet1</servlet-name>
<servlet-class>net.test.TestServlet</servlet-class>
<init-param>
<param-name>userName</param-name>
<param-value>Tommy</param-value>
</init-param>
<init-param>
<param-name>E-mail</param-name>
<param-value>[email protected]</param-value>
</init-param>
</servlet>
經過上面的配置,在servlet
中能夠調用getServletConfig().getInitParameter("param1")
獲得參數名對應的值。
<error-page>
<error-code>404</error-code>
<location>/error404.jsp</location>
</error-page>
<error-page>
<exception-type>java.lang.Exception<exception-type>
<location>/exception.jsp<location>
</error-page>
<filter>
<filter-name>XXXCharaSetFilter</filter-name>
<filter-class>net.test.CharSetFilter</filter-class>
</filter>
<filter-mapping>
<filter-name>XXXCharaSetFilter</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
<listener>
<listener-class>net.test.XXXLisenet</listener-class>
</listener>
<session-config>
<session-timeout>60</session-timeout>
</session-config>
關於歡迎頁面:
訪問一個網站時,默認看到的第一個頁面就叫歡迎頁,一般情況下是由首頁來充當歡迎頁的。
一般情況下,我們會在web.xml中指定歡迎頁。但web.xml並不是一個Web的必要文件,沒有web.xml,網站仍然是可以正常工作的。
只不過網站的功能複雜起來後,web.xml的確有非常大用處,所以,默認創建的動態web工程在WEB-INF文件夾下面都有一個web.xml文件。
對於tomcat來說,當你只指定一個web的根名,沒有指定具體頁面,去訪問時一個web時, 如果web.xml文件中配置了歡迎頁,那麼就返回指定的那個頁面作爲歡迎頁,而在文中沒有web.xml文件,或雖然有web.xml,但web.xml也沒指定歡迎頁的情況下,它默認先查找index.html文件,如果找到了,就把index.html作爲歡迎頁還回給瀏覽器。
如果沒找到index.html,tomcat就去找index.jsp。找到index.jsp就把它作爲歡迎頁面返回。而如果index.html和index.jsp都沒找到,又沒有用web.xml文件指定歡迎頁面,那此時tomcat就不知道該返回哪個文件了,它就顯示The requested resource (/XXX) is not available的頁面。
其中XXX表示web的根名。但如果你指定了具體頁面,是可以正常訪問的。