web.xml 总结
web-app中元素的顺序以及作用、举例
?
?
Web.xml中出现的顺序（全小写）
作用与使用举例
Icon
指定IDE和GUI工具表示web应用的一两个图像文件的位置
<icon>
<small-icon></small-icon>
<large-icon></large-icon>
<!--可以用small-icon指定16*16的图gif或JPEG图像，large-icon指定32*32的。 -->
</icon>
Display-name
GUI工具标记这个web应用的一个名称
Description
描述这个应用。
Context-param
应用范围内的初始化参数.(与init-param的区别是：这个是整个web应用里可用的。Init-param只是在那个指定的jsp或servlet中可用。 )
Eg.
<context-param>
<param-name>contextParamName</param-name>
<param-value>contextParamValue</param-value>
</context-param>
Filter
过滤器元素。将一个名字与一个实现了javax.servlet.Filter接口的类相关联。
需要在web.xml中使用2.3或以上版本的DTD。
过滤器可截取和修改一个servlet或jsp和请求或从中发出的响应。在执行servlet和jsp之前，必须先执行第一个相关的过滤器的doFilter方法。FilterChain对象调用doFilter方法时，执行链中的下一个过滤器至最后一个，然后servlet或jsp才被执行。过滤器具有对到来的ServletRequest对象的全部访问权。
新建一个类implements Filter:
Eg.
public class MyFilter implements Filter {
?
public void destroy() {
?
}
?
/* (non-Javadoc)
?* @see javax.servlet.Filter#doFilter(javax.servlet.ServletRequest, javax.servlet.ServletResponse, javax.servlet.FilterChain)
?*/
public void doFilter(ServletRequest request, ServletResponse response,
FilterChain chain) throws IOException, ServletException {
HttpServletRequest req=(HttpServletRequest)request;//可以全权操作这个到来的request
System.out.println("这里可以在执行servlet之前进行操作，而且具有对到来的servletRequest对象的所有访问权。"+req.getRemoteHost());
chain.doFilter(request, response);//执行完了doFilet再去执行相应的原servlet或jsp
}
?
public void init(FilterConfig arg0) throws ServletException {
?
}
?
}
filter在web.xml中的声明与servlet相似：
<filter>
<filter-name>myFilter</filter-name>
<filter-class>guoxp.ajax.servlet.MyFilter</filter-class>
</filter>
?
<filter-mapping>
<filter-name>myFilter</filter-name>
<url-pattern>/*</url-pattern><!--或是指定某个访问路径-->
</filter-mapping>
?
但它的filter-mapping有两种方式，上面的是与servlet相似的声明方式，它还可以直接声明它截取的servlet或jsp的名字（不过这个servlet或jsp的名字要在这个web.xml中稍后进行声明），即用下面的方式：
<filter-mapping>
<filter-name>myFilter</filter-name>
<servlet-name>AJAXServer</servlet-name>
</filter-mapping>
Filter-mapping
将过滤器的名字与一个或多个servlet或jsp页面相关联。
例子如上。
Listener
指出监听程序类。事件监听程序在建立、修改和删除会话或servlet环境时得到通知。web应用的Servlet-Context建立或消除时，就会触发该监听器。
<listener>
<listener-class>guoxp.ajax.servlet.MyListener</listener-class>
</listener>
?
MyListener.java:
public class MyListener implements ServletContextListener {
?
public void contextDestroyed(ServletContextEvent event) {
System.out.println("destroyed....");
}
?
public void contextInitialized(ServletContextEvent event) {
System.out.println("created....");
}
?
}
Servlet
命名一个servlet或jsp页面
Eg.
? <servlet>
??? <servlet-name>AJAXServer</servlet-name>
??? <servlet-class>guoxp.ajax.servlet.AJAXServer</servlet-class>? <!-- 如果是jsp页面，就使用<jsp-file> 代替<servlet-class>。这样的配置可以使多个url共同用一个jsp处理，或是使得在url中去掉.jsp扩展名-->
<load-on-startup>1</load-on-startup><!--指定装载servlet或是jsp时的顺序，因为有的jsp，servlet需要init较长的时间，按数字从小到大确定先后顺序。-->
? </servlet>
?
Servlet-mapping
为这个servlet名提供一个缺省的url
Eg.
? <servlet-mapping>
??? <servlet-name>AJAXServer</servlet-name>
??? <url-pattern>/AJAXServer</url-pattern>? ??<!-- 必须以斜杠‘/’开始，还可以包含通配符，如/*.jsp,则这样的.jsp的访问都会请求到这个AJAXServer-->
<init-param>
<param-name>paramName</param-name>
<param-value>paramValue</param-value><!--可以向servlet 提供初始化参数。
在servlet中相应的得到这个参数的方法：
在init()方法中，
public void init() throws ServletException {
ServletConfig config=getServletConfig();
String value=config.getInitParameter("paramName");
}
在jsp中相应的用jspInit()方法：
<%!private String paramValue;
?
public void jspInit() {
ServletConfig config = getServletConfig();
paramValue = config.getInitParameter("paramName");
}%>
-->
</init-param>
?
? </servlet-mapping>
?
Session-config
设定会话的超时时间。或用HttpSession的setMaxInactiveInterval方法明确设置单个会话对象的超时值。
Eg.
<session-config>
<session-timeout>120</session-timeout>
</session-config>
Mime-mapping
为web应用的特殊文件保证 分配特定的mime类型。
Eg.
<mime-mapping>
<extension>txt</extension>
<mime-type>application/txt</mime-type>
</mime-mapping>
?
附：常见的MIME类型
?
超文本标记语言文本 .htm,.html text/html
普通文本 .txt text/plain
RTF文本 .rtf application/rtf
GIF图形 .gif image/gif
JPEG图形 .ipeg,.jpg image/jpeg
au声音文件 .au audio/basic
MIDI音乐文件 mid,.midi audio/midi,audio/x-midi
RealAudio音乐文件 .ra, .ram audio/x-pn-realaudio
MPEG文件 .mpg,.mpeg video/mpeg
AVI文件 .avi video/x-msvideo
GZIP文件 .gz application/x-gzip
TAR文件 .tar application/x-tar
Welcome-file-list
访问目录名时的起始文件。
Eg.
<welcome-file-list>
<welcome-file>modules/frame/frame.jsp</welcome-file>
<welcome-file>index.jsp</welcome-file>/* 可以指定多个欢迎页，从上向下试用*/
</welcome-file-list>
Error-page
Error-code或特定异常时，订制显示的页面。注意location必须以斜线/开头，也就是相对于整个应用的。两个方式：error-code和exception-type
?
<error-page>
<error-code>404</error-code>
<location>/error404.jsp</location><!--关于指定错误处理页面，也可以在jsp中指定
<%@?page?errorPage="error.jsp"?%>??-->
</error-page>
?
<error-page>
<exception-type>
javax.servlet.ServletException
</exception-type>
<location>/exception.jsp</location>
</error-page>
?
里面有三个属性可供处理异常时使用，分别是：status_code、message、与exception_type
指定显示处理异常的页面exception.jsp，isErrorPage="true"指定举例：
<%@ page language="java" pageEncoding="UTF-8"
contentType="text/html; charset=UTF-8" isErrorPage="true"%>
<%--指定了isErrorPage就可以在EL中使用隐式对象${pageContext.exception}
--%>
<html>
<head>
<title>错误与例外处理页面</title>
</head>
<body>
错误码：
<%=request.getAttribute("javax.servlet.error.status_code")%>
<br />
错误信息：
<%=request.getAttribute("javax.servlet.error.message")%>
<br />
异常：
<%=request.getAttribute("javax.servlet.error.exception_type")%>
<br />
</body>
</html>
Jsp-config
<taglib>对标记库文件指定别名.当标记库名改变时可以不改变jsp中的引用名。2.4中,<tablib>已经作为<jsp-config>的子元素。
Eg.
<jsp-config>
<taglib>
<taglib-uri>/dhtmlxgrid.tld</taglib-uri>
<taglib-location>/WEB-INF/dhtmlxgrid.tld</taglib-location>
</taglib>
</jsp-config>
Resource-env-ref
声明与资源相关的一个管理对象
Resource-ref
声明资源工厂使用的外部资源
Secuity-constraint
制订应该保护的url
Login-config
指定如何给试图访问受保护页面 用户授权。
Secuity-role
给出安全角色列表
Env-entry
web应用的环境项
Ejb-ref
声明EJB主目录的引用
Ejb-local-ref
声明一个EJB的本地主目录的应用
?
3.?? 重新映射/servlet/URL模式
????? 在一个特定的Web应用中禁止以http://host/webAppPrefix/servlet/ 开始的URL的处理非常简单。所需做的事情就是建立一个错误消息servlet，并使用url-pattern元素将所有匹配请求转向该servlet。只要简单地使用：
<url-pattern>/servlet/*</url-pattern>
