servlet web.xml配置选项详解
一般的web工程中都会用到web.xml,web.xml主要包括一些配置标签,例如Filter、Listener、Servlet等,可以用来预设容器的配置,可以方便的开发web工程。但是web.xml并不是必须的,一个web工程可以没有web.xml文件<web-app><?xml version=&
一般的web工程中都会用到web.xml,web.xml主要包括一些配置标签,例如Filter、Listener、Servlet等,可以用来预设容器的配置,可以方便的开发web工程。但是web.xml并不是必须的,一个web工程可以没有web.xml文件
<web-app>
<?xml version="1.0" encoding="UTF-8"?>
<web-app version="2.4"
xmlns="http://java.sun.com/xml/ns/j2ee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee
http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd">
</web-app>
这是整个配置文件的根标签,web.xml的模式文件是由Sun公司定义的,它必须标明web.xml使用的是哪个模式文件。
<display-name>
<display-name>serTest</display-name>
它标注了该web项目的名字,提供GUI工具可能会用来标记这个特定的Web应用的一个名称
<welcome-list-file>
<welcome-file-list>
<welcome-file>index.html</welcome-file>
<welcome-file>index.htm</welcome-file>
<welcome-file>index.jsp</welcome-file>
<welcome-file>default.html</welcome-file>
<welcome-file>default.htm</welcome-file>
<welcome-file>default.jsp</welcome-file>
</welcome-file-list>
<welcome-file-list>定义了首页文件,也就是用户直接输入域名时跳转的页面(如http://localhost:8080/)
<servlet>
用来声明一个servlet的数据,主要有以下子元素:
- <servlet-name>
指定servlet的名称 - <servlet-class>
指定servlet的类名称 - <jsp-file>
指定web站台中的某个JSP网页的完整路径 - <init-param>
用来定义初始化参数,可有多个init-param。在servlet类中通过ServletConfig对象传入init函数,通过- getInitParamenter(String name)方法访问初始化参数
例如使用<init-param>来初始化数据库连接参数
public void init(ServletConfig config) throws SevletException{
super(config);
String driver = config.getInitParameter("driver");
String url = config.getInitParameter("url");
String username = config.getInitParameter("username");
String passwd = config.getInitParameter("passwd");
try{
Class.forName(driver).newInstance();
this.conn = DriverManager.getConnection(url, username, passwd);
System.out.println("Connection successful...");
} catch(SQLExceprion se){
System.out.println("se");
} catch(Exception e){
e.printStackTrace():
}
}
此时servlet配置为
<servlet>
<servlet-name>myServlet</servlet-name>
<servlet-class>*.myservlet</servlet-class>
<init-param>
<param-name>driver</param-name>
<param-value>com.mysql.jdbc.Driver</param-value>
</init-param>
<init-param>
<param-name>url</param-name>
<param-value>jdbc:mysql://localhost:3306/myDatabase</param-value>
</init-param>
<init-param>
<param-name>username</param-name>
<param-value>tang</param-value>
</init-param>
<init-param>
<param-name>passwd</param-name>
<param-value>whu</param-value>
</init-param>
</servlet>
- <load-on-startup>
指定当Web应用启动时,装载Servlet的次序。当值为正数或零时:Servlet容器先加载数值小的servlet,再依次加载其他数值大的servlet。当值为负或未定义:Servlet容器将在Web客户首次访问这个servlet时加载它。 - <servlet-mapping>
用来定义servlet所对应的URL,包含两个子元素 - <servlet-name>
指定servlet的名称 - <url-pattern>
指定servlet所对应的URL
<!-- 基本配置 -->
<servlet>
<servlet-name>myServlet</servlet-name>
<servlet-class>*.myservlet</servlet-class>
</servlet>
<servlet-mapping>
<servlet-name>myServlet</servlet-name>
<url-pattern>/myServlet</url-pattern>
</servlet-mapping>
<!-- 高级配置 -->
<servlet>
<servlet-name>myServlet</servlet-name>
<servlet-class>*.myservlet</servlet-class>
<init-param>
<param-name>foo</param-name>
<param-value>bar</param-value>
</init-param>
<run-as>
<description>Security role for anonymous access</description>
<role-name>tomcat</role-name>
</run-as>
</servlet>
<servlet-mapping>
<servlet-name>myServlet</servlet-name>
<url-pattern>/myServlet</url-pattern>
</servlet-mapping>
需要特别注意的是</servlet-mapping>元素,这个元素规定了一个servlet-name和url-pattern,如果请求的url能够匹配该url-pattern,则使用servlet-name指定的servlet处理该请求。
url-pattern匹配规则
按照优先级从高到低排列:
- 精确匹配:类似于/myServlet的精确路径
- 通配符匹配:/*
- 扩展名匹配:*.html,*.jpg ,.do ,.action之类的
- 默认匹配(/)——当之前匹配都不成功时
当servlet收到来自客户端的url请求时,先把请求url减去当前项目上下文路径,然后再与url-pattern进行匹配,匹配按照上面列出的优先级顺序进行,只要有一个匹配成功就停止,不再继续匹配其他的。
(注:/*.action这种匹配式是错误的,容器无法识别同时拥有两种匹配规则的pattern)
例子:
<!-- 配置-->
<servlet>
<servlet-name>myServlet</servlet-name>
<servlet-class>*.myservlet</servlet-class>
</servlet>
myServlet
<servlet-name>myServlet</servlet-name>
<url-pattern>/myServlet</url-pattern>
</servlet-mapping>
收到来自客户端的请求http://localhost:8080/serTest/myServlet/index.html,首先将该请求url减去项目上下文得到/myServlet/index.html,之后与url-pattern进行匹配,发现/myServlet匹配成功,之后便把该请求交由servlet-name指定的myServlet处理。
另一方面,<servlet-mapping>并不是必须的,例如在如下项目中:
src文件夹中是定义的两个servlet类(Test和Img)和一个逻辑事务处理类(Output),如果我们都不设置<servlet-mapping>,则可以像如下方法进行请求
请求使用Test处理:http://localhost:8080/serTest/Test
请求使用Img处理:http://localhost:8080/serTest/Img
请求静态图片文件:http://localhost:8080/serTest/img/img.jpg
<filter>
过滤器元素将一个名字与一个实现javax.servlet.Filter接口的类相关联。
<listener>
Listener元素指出事件监听程序类
<session-config>
配置会话超时,单位是分钟
<session-config>
<session-timeout>120</session-timeout>
</session-config>
<error-page>
在返回特定HTTP状态代码时,或者特定类型的异常被抛出时,能够制定将要显示的页面。
更多元素参见 https://blog.csdn.net/xiuwu0423/article/details/54861184
更多推荐
所有评论(0)