`
mqzsweet
  • 浏览: 134880 次
  • 性别: Icon_minigender_1
  • 来自: 江苏
社区版块
存档分类
最新评论

转贴:web.xml元素介绍

阅读更多

原文地址:http://blog.csdn.net/imnol/archive/2007/08/16/1747406.aspx<wbr></wbr>

 

我将自己知道的web.xml的元素整理了一下: 

web.xml首先是肯定要包含它的schema. 

xml 代码
  1. <web-app xmlns="http://java.sun.com/xml/ns/j2ee"  
  2.   
  3.     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"  
  4.   
  5.     xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd"  
  6.   
  7.     version="2.4">  
  8.   
  9. </web-app>  

其它的元素都放在<web-app></web-app>之中。

<discription></discription> 是对站台的描述

<display-name></display-name> 定义站台的名称

<distributable/> 是指定该站台是否可分布式处理

<context-param></context-param> 用来设定web站台的环境参数,它包含两个子元素:

    <param-name></param-name> 用来指定参数的名称

   <param-value></param-value> 用来设定参数值
比如:<context-param>    <param-name>my_param</param-name>    <param-value>hello</param-value></context-param>

在此设定的参数,可以在servlet中用 getServletContext().getInitParameter("my_param") 来取得


<filter></filter> 是用来声明filter的相关设定,它包含以下子元素:
    <filter-name></filter-name> 这当然就是指定filter的名字
    <filter-class></filter-class> 这是用来定义filter的类的名称
    <init-param></init-param> 用来定义参数,它有两个子元素:
        <param-name></param-name> 用来指定参数的名称
        <param-value></param-value> 用来设定参数值

比如:<filter>        <filter-name>setCharacterEncoding</filter-name>        <filter-class>com.myTest.setCharacterEncodingFilter</filter-class>        <init-param>            <param-name>encoding</param-name>            <param-value>GB2312</param-value>        </init-param></filter>

与<filter></filter>同时使用的是<filter-mapping></filter-mapping> 用来定义filter所对应的URL,它有两个子元素:
    <filter-name></filter-name> 指定filter的名字
    <url-pattern></url-pattern> 指定filter所对应的URL
比如:
<filter-mapping>
        <filter-name>setCharacterEncoding</filter-name>
        <url-pattern>/*</url-pattern>
</filter-mapping>


<listener></listener> 用来设定Listener接口,它的主要子元素为
    <listener-class></listener-class> 定义Listener的类名称
比如:<listener>    <listener-class>com.myTest.ContextListener</listener-class> </listener>


<servlet></servlet> 用来声明一个servlet的数据,主要有以下子元素:
    <servlet-name></servlet-name> 指定servlet的名称
    <servlet-class></servlet-class> 指定servlet的类名称
    <jsp-file></jsp-file> 指定web站台中的某个JSP网页的完整路径
    <init-param></init-param> 用来定义参数,和前面的<init-param>差不多

同样,与<servlet></servlet>一起使用的是<servlet-mapping></servlet-mapping> 用来定义servlet所对应的URL,包含两个子元素:
    <servlet-name></servlet-name> 指定servlet的名称
    <url-pattern></url-pattern> 指定servlet所对应的URL

比如:<servlet>        <servlet-name>ShoppingServlet</servlet-name>        <servlet-class>com.myTest.ShoppingServlet</servlet-class></servlet>    <servlet-mapping>        <servlet-name>ShoppingServlet</servlet-name>        <url-pattern>/shop/ShoppingServlet</url-pattern></servlet-mapping>


<session-config></session-config> 用来定义web站台中的session参数,包含一个子元素:    <session-timeout></session-timeout> 用来定义这个web站台所有session的有效期限,单位为                                                              分钟<mime-mapping></mime-mapping> 定义某一个扩展名和某一个MIME Type做对映,包含两个                                                        子元素:    <extension></extension> 扩展名的名称    <mime-type></mime-type> MIME格式

比如:

xml 代码
  1. <mime-mapping>  
  2.     <extension>doc</extension>  
  3.     <mime-type>application/vnd.ms-word</mime-type></mime-mapping>    
  4. <mime-mapping>  
  5.     <extension>xls</extension>  
  6.     <mime-type>application/vnd.ms-excel</mime-type></mime-mapping>   




<welcome-file-list></welcom-file-list> 用来定义首页的列单,包含一个子元素:    <welcome-file></welcome-file> 指定首页的文件名称

比如:

xml 代码
  1. <welcome-file-list>  
  2.     <welcome-file>index.jsp</welcome-file>  
  3.     <welcome-file>index.html</welcome-file></welcom-file-list>  



<error-page></error-page> 用来处理错误代码或异常的页面,有三个子元素:    <error-code></error-code> 指定错误代码    <exception-type></exception-type> 指定一个JAVA异常类型    <location></location> 指定在web站台内的相关资源路径
比如:

xml 代码
  1. <error-page>  
  2.     <error-code>404</error-code>  
  3.     <location>/error404.jsp</location></error-page>  
  4. <error-page>  
  5.     <exception-type>java.lang.Exception</exception-type>    <location>/exception.jsp</location></error-page>  




<taglib></taglib> 用来设定JSP网页所用到的Tag Library路径,有两个子元素:
    <taglib-uri></taglib-uri> 定义TLD文件的URI,在JSP网页中用taglib指令便可取得该URI的                                              TLD文件
    <taglib-location></taglib-location> 指定TLD文件相对于web站台的存放位置

比如:<taglib>      <taglib-uri>myTaglib</taglib-uri>      <taglib-location>/WEB-INF/tlds/MyTaglib.tld</taglib-location></taglib>


<resource-ref></resource-ref> 定义利用JNDI取得站台可利用的资源,有五个子元素:
    <description></description> 资源说明
    <rec-ref-name></rec-ref-name> 资源名称
    <res-type></res-type> 资源种类
    <res-auth></res-auth> 资源经由Application或Container来许可
    <res-sharing-scope></res-sharing-scope> 资源是否可以共享,有Shareable和Unshareable两个值,默认为Shareable

比如,配置数据库连接池就可在此配置:<resource-ref>        <description>JNDI JDBC DataSource of shop</description>        <res-ref-name>jdbc/sample_db</res-ref-name>        <res-type>javax.sql.DataSource</res-type>        <res-auth>Container</res-auth></resource-ref>



<jsp-config> 包括<taglib> 和<jsp-property-group> 两个子元素。<wbr></wbr>

    其中<taglib>元素在JSP 1.2时就已经存在;而<jsp-property-group>是JSP 2.0 新增的元素。<wbr></wbr>
    <jsp-property-group>元素主要有八个子元素,它们分别为:<wbr></wbr>

    1.<description>:设定的说明;<wbr></wbr>
    2.<display-name>:设定名称;<wbr></wbr>
    3.<url-pattern>:设定值所影响的范围,如:/CH2 或 /*.jsp;<wbr></wbr>
    4.<el-ignored>:若为true,表示不支持EL 语法;<wbr></wbr>
    5.<scripting-invalid>:若为true,表示不支持<% scripting %>语法;<wbr></wbr>
    6.<page-encoding>:设定JSP 网页的编码;<wbr></wbr>
    7.<include-prelude>:设置JSP 网页的抬头,扩展名为.jspf;<wbr></wbr>
    8.<include-coda>:设置JSP 网页的结尾,扩展名为.jspf。<wbr></wbr>


一个简单的<jsp-config>元素完整配置:<wbr></wbr>


xml 代码

 

  1. <jsp-config>  
  2.     <taglib>  
  3.         <taglib-uri>Taglib</taglib-uri>  
  4.         <taglib-location>/WEB-INF/tlds/MyTaglib.tld</taglib-location>  
  5.     </taglib>  
  6.     <jsp-property-group>  
  7.         <description>Special property group for JSP Configuration JSP example.</description>  
  8.         <display-name>JSPConfiguration</display-name>  
  9.         <url-pattern>/jsp/* </url-pattern>  
  10.         <el-ignored>true</el-ignored>  
  11.         <page-encoding>GB2312</page-encoding>  
  12.         <scripting-invalid>true</scripting-invalid>  
  13.         <include-prelude>/include/prelude.jspf</include-prelude>  
  14.         <include-coda>/include/coda.jspf</include-coda>  
  15.     </jsp-property-group>  
  16. </jsp-config>intLen){strTemp+=strContent.substr(0,intLen)+"   
  17. ";  strC.substr(intLen,strContent.length);  }strTemp+="   
  18. "+strContent;obj.innerHTML=strTemp;}if(document.getElementById  &&  !document.all)  toBreakWord(37)]]>    




配置web.xml来限制对某些servlet的请求
有时我们只希望通过认证的用户才能请求某些servlet的话,就可以在web.xml中来进行相应的配置,来达到此目的。

这就要用到<security-constraint></security-constraint>元素。
对于tomcat,中web.xml使用security-constraint元素需要在位于<Tomcat-installation-directory>/conf/tomcat-users.xml的XML文件中创建用户名和密码。比如下面的这个tomcat-users.xml文件:

xml 代码
  1. <?xml version='1.0' encoding='utf-8'?><tomcat-users>  <role rolename="tomcat"/>  <role rolename="manager"/>  <role rolename="admin"/>  <user username="tomcat" password="tomcat" roles="tomcat"/>  <user username="both" password="tomcat" roles="tomcat,manager"/>  <user username="admin" password="admin" roles="admin"/></tomcat-users>  



此XML片段包括一个tomcat-users根元素,它包含一个或多个role和user元素。


然后在Web应用程序的web.xml中创建security-constraint、login-config和security-role元素。

<security-constraint>      <web-resource-collection>          <web-resource-name>HelloServlet</web-resource-name>          <url-pattern>/HelloServlet</url-pattern>          <http-method>GET</http-method>          <http-method>POST</http-method>      </web-resource-collection>      <auth-constraint>          <description>This applies only to the "tomcat" security role</description>          <role-name>admin</role-name>      </auth-constraint>      <user-data-constraint>          <transport-guarantee>NONE</transport-guarantee>      </user-data-constraint>  </security-constraint>    <login-config>      <auth-method>BASIC</auth-method>  </login-config>  <security-role>      <role-name>admin</role-name>  </security-role>

其中security-constraint元素包含一个或多个web-resource-collection元素,它是描述Web应用程序中的哪些web资源受到指定安全限制的保护。http-method元素指定安全限制覆盖的HTTP方法。上面的例子中,当我们对/HelloServlet的GET或POST请求时将触发配置的安全机制。
auth-constraint元素用于描述允许访问Web组件的安全角色。此例中安全角色的例子有tomcat、manager、admin。而只有当作为admin角色的用户才可以访问HelloServlet。

Web应用程序通过login-config元素来认证用户,并确认该用户是否为正确的角色。
longin-config包含的transport-guarantee子元素用来指定认证方法,BASIC是一种常见的Web认证方式,浏览器给用户提示一个对话框,要求输入用户名和密码,随后Tomcat将给出的用户名和密码与tomcat-users.xml中的用户名和密码进行比较,然后使用前面的security-constraint配置来确定用户是否可访问受保护的servlet。

(除BASIC外,还可以是FORM、CLIENT-CERT、DIGEST等)

其实这种认证方法实际上有两个步骤:
1、检查提供的用户名和密码是否正确。
2、判断用户是否映射到特定的安全角色。例如,用户可能提供了正确的用户名和密码,但没有映射到特定的安全角色,也将被禁止访问特定的Web资源。



通过此次整理,对web.xml中元素有了更清楚的了解,以后继续努力...<wbr></wbr>

分享到:
评论

相关推荐

    动网转贴.e.rar

    【标题】"动网转贴.e.rar"是一个压缩文件,很可能包含了有关动网论坛或社区的相关资源、数据或用户帖子的备份。动网是中国早期知名的网络论坛软件之一,提供了丰富的社区功能,允许用户发帖、回帖、互动等。这个...

    转贴:随心所欲的Web页面打印技术

    随心所欲的Web页面打印技术是针对基于B/S架构的应用程序中客户端页面打印问题的一种解决方案。传统的Web页面打印方式,如使用IE的内置打印功能或水晶报表,往往无法满足特定的排版和定位需求。因此,本文探讨了一种...

    易语言动网转贴.rar

    由于压缩包文件名为“易语言动网转贴.rar”,我们可以推测这可能是一个软件开发资源,包含了一些源代码、教程或者是相关插件。 在易语言中,"动网"通常指的是动网论坛,这是一个曾经非常流行的网络社区平台。"转贴...

    转贴:利用钩子技术控制进程创建.txt

    根据提供的文件信息,可以看出标题与描述均指向了“利用钩子技术控制进程创建”的主题,但实际内容似乎并未直接涉及这一技术细节,而是包含了大量非结构化和个人化的文本信息。因此,下面将基于标题和描述中提及的...

    明小子4.3.3网站漏洞检测工具

    Domain4.3(明小子)10.10.10更新版主要更新内容如下: 1.驱除部分死连接,恢复部分...转贴是一种美德!分享也是一种快乐,工具仅做辅助作用请勿用在非法用途上! 程序自带本BLOG连接,启动比较慢!不喜勿用!谢谢合作!

    电子政务-导电泡棉转贴装置.zip

    5. **技术标准与规范**:介绍相关行业的技术标准,如EMC(电磁兼容性)标准,以及安装导电泡棉转贴装置时应遵循的操作规范。 6. **维护与保养**:提供关于导电泡棉及转贴装置的日常维护、清洁、替换等方面的指导,...

    银行分行业务发展规划.docx

    3. 票据直贴30亿元,票据转贴300亿元。 4. 中间业务收入达到800万元。 5. 新增有效账户200户。 6. 其他转型指标全面完成总行下达的任务。 主要工作规划: 1. 建立并强化公司管理体系,推动存款、贷款、中间业务收入...

    Domain4.3(明小子)检测漏洞

    Domain4.3(明小子)10.10.10更新版主要更新内容如下: 1.驱除部分死连接,恢复部分...转贴是一种美德!分享也是一种快乐,工具仅做辅助作用请勿用在非法用途上! 程序自带本BLOG连接,启动比较慢!不喜勿用!谢谢合作!

    Domain4.3(明小子)

    Domain4.3(明小子)10.10.10更新版主要...转贴是一种美德!分享也是一种快乐,工具仅做辅助作用请勿用在非法用途上! 程序自带本BLOG连接,启动比较慢!不喜勿用!谢谢合作! 程序所有权归: &lt;明小子&gt; 程序修改:宝宝

    明小子工具4.3

    Domain4.3(明小子)10.10.10更新版主要...转贴是一种美德!分享也是一种快乐,工具仅做辅助作用请勿用在非法用途上! 程序自带本BLOG连接,启动比较慢!不喜勿用!谢谢合作! 程序所有权归: &lt;明小子&gt; 程序修改:宝宝

    明小子(网络探测)

    Domain4.3(明小子)10.10.10更新版主要...转贴是一种美德!分享也是一种快乐,工具仅做辅助作用请勿用在非法用途上! 程序自带本BLOG连接,启动比较慢!不喜勿用!谢谢合作! 程序所有权归: &lt;明小子&gt; 程序修改:宝宝

    Spark 入门实战系列

    Spark 入门实战系列,适合初学者,文档包括十部分内容,质量很好,为了感谢文档作者,也为了帮助更多的人入门,传播作者的心血,特此友情转贴: 1.Spark及其生态圈简介.pdf 2.Spark编译与部署(上)--基础环境搭建....

    易语言源码动网转贴.rar

    2. **数据格式解析**:在互联网上,数据通常以JSON或XML等格式传输。动网转贴可能需要解析这些数据来获取帖子的信息,如标题、内容、作者等,并将它们封装到转发请求中。 3. **用户身份验证**:为了确保用户权限和...

    Struts-menu源码分析(转贴).rar

    Struts-menu是一个基于Apache Struts框架的菜单管理组件,它为Web应用提供了动态生成和管理菜单的功能。在分析Struts-menu的源码时,我们可以深入理解Struts框架的工作原理、MVC模式的应用以及如何实现自定义标签库...

    关于嵌入式系统方向!【转贴】.doc

    点在于: 1. 技术更新快:嵌入式领域的新技术和处理器不断涌现,需要开发者持续学习和跟进,保持技术的前沿性。 2. 工作压力:虽然工作强度相对较低,但在产品开发周期紧张时,开发者仍需面对高压,确保按时交付高...

    动易系统的论坛转贴工具 -ASP源码.zip

    标题中的“动易系统的论坛转贴工具 -ASP源码.zip”揭示了这是一个基于ASP(Active Server Pages)...通过分析源码,不仅可以理解论坛转贴工具的工作原理,还可以提升自己在ASP编程、数据库管理和Web安全等方面的能力。

Global site tag (gtag.js) - Google Analytics