web.xml配置详细说明4_在编写web应用程序时要在web.xml中完整的配置4个信息如-CSDN博客

本文链接：https://blog.csdn.net/jiangtie/article/details/1754649

web.xml配置详细说明4

9.3 分配角色名
迄今为止，讨论已经集中到完全由容器（服务器）处理的安全问题之上了。但 servlet 以及 JSP 页面也能够处理它们自己的安全问题。
例如，容器可能允许用户从 bigwig 或 bigcheese 角色访问一个显示主管人员额外紧贴的页面，但只允许 bigwig 用户修改此页面的参数。完成这种更细致的控制的一种常见方法是调用 HttpServletRequset 的 isUserInRole 方法，并据此修改访问。
Servlet 的 security-role-ref 子元素提供出现在服务器专用口令文件中的安全角色名的一个别名。例如，假如编写了一个调用 request.isUserInRole （ "boss" ）的 servlet ，但后来该 servlet 被用在了一个其口令文件调用角色 manager 而不是 boss 的服务器中。下面的程序段使该 servlet 能够使用这两个名称中的任何一个。
<servlet>

<security-role-ref>
<role-name>boss</role-name> 
<role-link>manager</role-link> 
</security-role-ref>
</servlet>
也可以在 web-app 内利用 security-role 元素提供将出现在 role-name 元素中的所有安全角色的一个全局列表。分别地生命角色使高级 IDE 容易处理安全信息。
10 控制会话超时
如果某个会话在一定的时间内未被访问，服务器可把它扔掉以节约内存。可利用 HttpSession 的 setMaxInactiveInterval 方法直接设置个别会话对象的超时值。如果不采用这种方法，则缺省的超时值由具体的服务器决定。但可利用 session-config 和 session- timeout 元素来给出一个适用于所有服务器的明确的超时值。超时值的单位为分钟，因此，下面的例子设置缺省会话超时值为三个小时（ 180 分钟）。
<session-config>
<session-timeout>180</session-timeout>
</session-config>
11 Web 应用的文档化
越来越多的开发环境开始提供 servlet 和 JSP 的直接支持。例子有 Borland Jbuilder Enterprise Edition 、 Macromedia UltraDev 、 Allaire JRun Studio （写此文时，已被 Macromedia 收购）以及 IBM VisuaAge for Java 等。
大量的 web.xml 元素不仅是为服务器设计的，而且还是为可视开发环境设计的。它们包括 icon 、 display-name 和 discription 等。
可回忆一下，在 web.xml 内以适当地次序声明 web-app 子元素很重要。不过，这里只要记住 icon 、 display-name 和 description 是 web.xml 的 web-app 元素内的前三个合法元素即可。
l icon
icon 元素指出 GUI 工具可用来代表 Web 应用的一个和两个图像文件。可利用 small-icon 元素指定一幅 16 x 16 的 GIF 或 JPEG 图像，用 large-icon 元素指定一幅 32 x 32 的图像。下面举一个例子：
<icon>
<small-icon>/images/small-book.gif</small-icon>
<large-icon>/images/tome.jpg</large-icon>
</icon>
l display-name
display-name 元素提供 GUI 工具可能会用来标记此 Web 应用的一个名称。下面是个例子。
<display-name>Rare Books</display-name>
l description
description 元素提供解释性文本，如下所示：
<description>
This Web application represents the store developed for
rare-books.com, an online bookstore specializing in rare
and limited-edition books.
</description>
12 关联文件与 MIME 类型
服务器一般都具有一种让 Web 站点管理员将文件扩展名与媒体相关联的方法。例如，将会自动给予名为 mom.jpg 的文件一个 image/jpeg 的 MIME 类型。但是，假如你的 Web 应用具有几个不寻常的文件，你希望保证它们在发送到客户机时分配为某种 MIME 类型。 mime-mapping 元素（具有 extension 和 mime-type 子元素）可提供这种保证。例如，下面的代码指示服务器将 application/x-fubar 的 MIME 类型分配给所有以 .foo 结尾的文件。
<mime-mapping>
<extension>foo</extension>
<mime-type>application/x-fubar</mime-type>
</mime-mapping>
或许，你的 Web 应用希望重载（ override ）标准的映射。例如，下面的代码将告诉服务器在发送到客户机时指定 .ps 文件作为纯文本（ text/plain ）而不是作为 PostScript （ application/postscript ）。
<mime-mapping>
<extension>ps</extension>
<mime-type>application/postscript</mime-type>
</mime-mapping>
13 定位 TLD
JSP taglib 元素具有一个必要的 uri 属性，它给出一个 TLD （ Tag Library Descriptor ）文件相对于 Web 应用的根的位置。 TLD 文件的实际名称在发布新的标签库版本时可能会改变，但我们希望避免更改所有现有 JSP 页面。此外，可能还希望使用保持 taglib 元素的简练性的一个简短的 uri 。这就是部署描述符文件的 taglib 元素派用场的所在了。 Taglib 包含两个子元素： taglib-uri 和 taglib-location 。 taglib-uri 元素应该与用于 JSP taglib 元素的 uri 属性的东西相匹配。 Taglib-location 元素给出 TLD 文件的实际位置。例如，假如你将文件 chart-tags- 1.3beta.tld 放在 WebApp/WEB-INF/tlds 中。现在，假如 web.xml 在 web-app 元素内包含下列内容。
<taglib>
<taglib-uri>/charts.tld</taglib-uri>
<taglib-location>
/WEB-INF/tlds/chart-tags-1.3beta.tld
</taglib-location>
</taglib>
给出这个说明后， JSP 页面可通过下面的简化形式使用标签库。
<%@ taglib uri="/charts.tld" prefix="somePrefix" %>
14 指定应用事件监听程序
应用事件监听器程序是建立或修改 servlet 环境或会话对象时通知的类。它们是 servlet 规范的版本 2.3 中的新内容。这里只简单地说明用来向 Web 应用注册一个监听程序的 web.xml 的用法。
注册一个监听程序涉及在 web.xml 的 web-app 元素内放置一个 listener 元素。在 listener 元素内， listener-class 元素列出监听程序的完整的限定类名，如下所示：
<listener>
<listener-class>package.ListenerClass</listener-class>
</listener>
虽然 listener 元素的结构很简单，但请不要忘记，必须正确地给出 web-app 元素内的子元素的次序。 listener 元素位于所有的 servlet 元素之前以及所有 filter-mapping 元素之后。此外，因为应用生存期监听程序是 serlvet 规范的 2.3 版本中的新内容，所以必须使用 web.xml DTD 的 2.3 版本，而不是 2.2 版本。
例如，程序清单 5-20 给出一个名为 ContextReporter 的简单的监听程序，只要 Web 应用的 Servlet-Context 建立（如装载 Web 应用）或消除（如服务器关闭）时，它就在标准输出上显示一条消息。程序清单 5-21 给出此监听程序注册所需要的 web.xml 文件的一部分。

程序清单 5-20 ContextReporterjava
package moreservlets;

import javax.servlet.*;
import java.util.*;
/** Simple listener that prints a report on the standard output
* when the ServletContext is created or destroyed.
* <P>
* Taken from More Servlets and JavaServer Pages
* from Prentice Hall and Sun Microsystems Press,
* http://www.moreservlets.com/.
* © 2002 Marty Hall; may be freely used or adapted.
*/

public class ContextReporter implements ServletContextListener {
public void contextInitialized(ServletContextEvent event) {
System.out.println("Context created on " +
new Date() + ".");
}
public void contextDestroyed(ServletContextEvent event) {
System.out.println("Context destroyed on " +
new Date() + ".");
}
}
程序清单 5-21 web.xml （声明一个监听程序的摘录）
<?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>

<filter-mapping> … </filter-mapping>
<listener>
<listener-class>package.ListenerClass</listener-class>
</listener>
<servlet> ... </servlet>

</web-app>
15 J2EE 元素
本节描述用作 J2EE 环境组成部分的 Web 应用的 web.xml 元素。这里将提供一个简明的介绍，详细内容可以参阅 http://java.sun.com/j2ee/j2ee-1_3-fr-spec.pdf 的 Java 2 Plantform Enterprise Edition 版本 1.3 规范的第 5 章。
l distributable
distributable 元素指出， Web 应用是以这样的方式编程的：即，支持集群的服务器可安全地在多个服务器上分布 Web 应用。例如，一个可分布的应用必须只使用 Serializable 对象作为其 HttpSession 对象的属性，而且必须避免用实例变量（字段）来实现持续性。 distributable 元素直接出现在 discription 元素之后，并且不包含子元素或数据，它只是一个如下的标志。
<distributable />
l resource-env-ref
resource -env-ref 元素声明一个与某个资源有关的管理对象。此元素由一个可选的 description 元素、一个 resource-env-ref- name 元素（一个相对于 java:comp/env 环境的 JNDI 名）以及一个 resource-env-type 元素（指定资源类型的完全限定的类），如下所示：
<resource-env-ref>
<resource-env-ref-name>
jms/StockQueue
</resource-env-ref-name>
<resource-env-ref-type>
javax.jms.Queue
</resource-env-ref-type>
</resource-env-ref>
l env-entry
env -entry 元素声明 Web 应用的环境项。它由一个可选的 description 元素、一个 env-entry-name 元素（一个相对于 java: comp/env 环境 JNDI 名）、一个 env-entry-value 元素（项值）以及一个 env-entry-type 元素（ java.lang 程序包中一个类型的完全限定类名， java.lang.Boolean 、 java.lang.String 等）组成。下面是一个例子：
<env-entry>
<env-entry-name>minAmout</env-entry-name>
<env-entry-value>100.00</env-entry-value>
<env-entry-type>minAmout</env-entry-type>
</env-entry>
l ejb-ref
ejb -ref 元素声明对一个 EJB 的主目录的应用。它由一个可选的 description 元素、一个 ejb-ref-name 元素（相对于 java: comp/env 的 EJB 应用）、一个 ejb-ref-type 元素（ bean 的类型， Entity 或 Session ）、一个 home 元素（ bean 的主目录接口的完全限定名）、一个 remote 元素（ bean 的远程接口的完全限定名）以及一个可选的 ejb-link 元素（当前 bean 链接的另一个 bean 的名称）组成。
l ejb-local-ref
ejb-local-ref 元素声明一个 EJB 的本地主目录的引用。除了用 local-home 代替 home 外，此元素具有与 ejb-ref 元素相同的属性并以相同的方式使用