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>Tommy@163.com</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的根名。但如果你指定了具体页面,是可以正常访问的。