当前位置:文档之家› web_xml标签介绍

web_xml标签介绍

Web.xml文件标签介绍说明
●<description>
用于为父元素提供一个文本描述。

这个元素不仅可以在<web-app>元素中出现,还可以在其他多个元素中出现。

他有一个可选的属性xml:lang,用于指示在描述中使用的语言,该属性的默认值是en(英语)。

●<display-name>
为这个web应用程序指定一个简短的名字,这个名字可以被一些工具所显示。

他有一个可选的属性xml:lang,用于指示在描述中使用的语言,该属性的默认值是en(英语)。

●<icon>
包含了<small-icon>和<large-icon>两个元素,用于指定大小图标(GIF或JPEG格式的图标)的文件名。

指定的图标在图形界面工具中将用于表示父元素
●<distributable>
是一个空元素,用于指示这个web应用程序可以被部署到分布式的servlet容器中
●<context-param>
用于声明web应用程序servlet上下文的初始化参数。

他包含两个子元素<param-name>和<param-value>。

<param-name>用于指定参数的名字,<param-value>用于指定参数的值。

在servlet中可以使用getServletContext().getInitParameter(“”);来获取初始化参数。

●<filter>
用于在web应用程序中声明一个过滤器。

包括<description><display-name><icon><filter-name><filter-class><init-param><param-name><para m-value>。

<filter-name>为过滤器指定一个名字,该元素的内容不能为空。

<filter-class>元素用于指定过滤器的完整的限定类名。

<init-param>元素用于指定过滤器的初始化参数,他的子元素<param-name>指定参数的名字,<param-value>指定参数的值。

过滤器在运行时,通过FilterConfig接口对象访问初始化参数。

●<filter-mapping>
元素用于设置过滤器负责过滤的URL或者Servlet。

包括<filter-name><url-pattern><servlet-name><dispatcher>。

<filter-name>子元素的值必须在<filter>元素中已声明过的过滤器的名字。

<url-pattern>元素和<servlet-name>元素可以选择一个,<url-pattern>元素指定过滤器对应的URL,<servlet-name>元素指定过滤器对应的Servlet。

<dispatcher>元素指定过滤器对应的请求方式,可以是REQUEST,INCLUDE,FORWARD,ERROR4种之一,默认为REQUEST。

●<listener>
用于指定web应用程序的监听类。

可以包含0个或者多个
<description>,<display-name>,<icon>元素,必须包含<listener-class>元素。

<listener-class>元素指定监听器类的完整的限定类名。

●<servlet>
用于声明一个Servlet。

<Servlet-name>指定servlet的名字,这个名字在同一个web应用程序中必须是唯一的。

<servlet-class>指定servlet类的完整限定名。

<jsp-file>指定在web应用程序中的jsp文件的完整路径,该路径以斜杠(/)开始。

如果要一个JSP文件做URL映射,就会用到这个元素。

在<servlet>元素中,<servlet-class>元素和<jsp-file>元素只能选择其中之一。

如果<servlet>元素包含了<jsp-file>元素和<load-on-startup>元素,则jsp文件价将被预编译并加载。

<init-param>元素用于指定servlet的初始化参数。

<load-on-startup>元素指定当web应用程序启动时,servlet被加载的次序。

元素的内容必须是一个整型值,如果这个值是一个负数,或者没有设定这个元素,servlet容器将在客户端首次请求这个servlet时加载它;如果这个值是正数或者0,容器将在web应用程序部署时加载和初始化这个servlet,并且先加载数值晓的servlet,后加载数值大的servlet。

<run-as>指定用于执行servlet的角色,他的子元素<role-name>指定角色名。

<security-role-ref>元素声明在组件或者部署的组件的代码中的安全角色引用,其子元素<role-name>指定角色名,可选的子元素<role-link>指定到一个安全角色的引用。

●<servlet-mapping>
在servlet和URL样式之间定义一个映射。

他包含了两个元素<servlet-name>和<url-pattern>。

<servlet-name>元素给出的servlet名字必须是在<servlet>元素中声明过的servlet的名字。

<url-pattern>元素指定对应servlet的URL路径,该路径是相对于web应用程序上下文根的路径。

●<session-config>
为web应用程序定义session参数。

他包含一个子元素<session-timeout>,用于定义在web 应用中创建的所有session的默认超时时间间隔,以分钟为单位。

如果超时值设为0或者负数,那么session将没有超时值,也就是说,session不会因为用户长时间没有提交请求而失效。

●<welcome-file-list>
用于设定一个有序的欢迎文件列表。

他包含一个或多个<welcome-file>子元素,该子元素指定作为默认的欢迎文件的文件名。

当我们访问一个web应用程序的时候,如果只给出了web应用程序的上下文路径,没有给出具体的文件名,servlet容器就会自动调用在部署描述符中配置的欢迎文件。

Servlet容器会按照配置的欢迎文件的顺序来调用页面,如果找不到第一个<welcome-file>所指定的文件,就会依次寻找下一个<welcome-file>所指定的文件。

●<error-page>
在错误代码或异常类型与web应用程序的资源路径之间定义一个映射。

<error-code>元素指定HTTP错误代码。

<exception-type>元素指定java异常的完整限定名。

<location>元素给出用于响应HTTP错误代码或者java异常的资源的路径,该路径相对于web应用程序的跟路径,必须以斜杠(/)开头
●<jsp-config>
用于为web应用程序中的jsp文件提供全局的配置信息。

其中<taglib>元素指定jsp页面使用的标签库信息。

他有两个元素<taglib-uri>和<taglib-location>。

<taglib-uri>指定在web应用程序中使用的标签库的URI标识,jsp页面的taglib指令通过这个URI读取到TLD文件。

<taglib-location>元素指定TLD文件的位置。

<jsp-property-group>有9个子元素:<description><display-name><url-pattern><el-ignored><scripting-invalid><page-encoding><incl uding-prelude><include-coda><is-xml>。

<el-ignored>元素指定是否忽略EL表达式。

如果为true,标识不支持EL表达式;如果为false,表示支持EL表达式。

<scripting-invalid>指定是否在jsp页面中禁止脚本,如果为true,标识禁止脚本,在jsp页面中,就不能使用<%...%>语法了,如果为false标识支持。

<page-encoding>标识jsp页面编码。

相关主题