java web.xml详解

最新推荐文章于 2024-07-04 09:24:51 发布

风影simple

最新推荐文章于 2024-07-04 09:24:51 发布

阅读量1k

点赞数

分类专栏： java 文章标签： java servlet struts jsp filter 服务器

本文链接：https://blog.csdn.net/wxxy20071547/article/details/6858187

版权

java 专栏收录该内容

12 篇文章 0 订阅

订阅专栏

容易忘的东西，记录下来，对自己对别人都有帮助

正文

struts1 web.xml配置

web.xml文件对于配置任何Java Web应用都必需的。
（1）配置Struts的ActionServlet

<servlet>元素来声明ActionServlet
<servlet-name>元素：用来定义Servlet的名称
<servlet-class>元素:用来指定Servlet的完整类名

<servlet>
<servlet-name>action</servlet-name>
<servlet-class>org.apache.struts.action.ActionServlet</servlet-class>
</servlet>

还要配置 <servlet-mapping> 元素 , 它用来指定 ActionServlet 可以处理哪些 URL

<servlet-mapping>
<servlet-name>action</servlet-name>
<url-pattern>*.do</url-pattern>
</servlet-mapping>

注意 :(1)<servlet-mapping> 和 <servlet> 中的 <servlet- name>?</servlet-name> 的要填写一致，它就是一根线，把 <servlet-mapping> 和 <servlet> 联接在一起的。
(2) 在 Struts 框架中只能有一个 Servlet, 因为 Servlet 支持多线程。而 <servlet- class>org.apache.struts.action.ActionServlet</servlet-class> 中的 ActionServlet 是在 Struts.jar 包中的 . 在导入 Struts 包时会导入。
(3) 在显示层所有以 *.do 为扩展名提交的 URL ，都会交由这个 Servlet 来处理。 *.do 可以改写成你想要的任何形式，例如 :/do/* ，此时该 Servlet 会处理所有以 "/do" 为前缀的 URL ，如 http://localhost:8080/helloapp/do /helloWord,
扩展 (1) 我们可以继承 org.apache.struts.action.ActionServlet 得到我们可以扩展的子类，在子类中重写一个方法 init() 。这时 <servlet-class>?</servlet- class> 中的？是我们新建的类的路径，同样只能存在一个。
(2) 声明 ActionServlet 的初始化参数
初始化参数用来对 Servlet 的运行时环境进行初始配置。 <servlet> 的 <init-param> 子元素用于配置 Servlet 初始化参数。

config ：以相对路径的方式指明 Struts 应用程序的配置文件位置 , 如不设置，则默认值为 /WEB-INF/struts-config.xml
debug : 设置 Servlet 的 debug 级别 , 控制日志记录的详细程度。默认为 0 ，记录相对最少的日志信息。
detail : 设置 Digester 的 debug 级别， Digester 是 Struts 框架所使用的用来解析 xml 配置文件的一个框架，通过此设置，可以查看不同详细等级的解析日志。默认为 0 ，记录相对最少的日志信息。
<load-on-startup> ？ </load-on-startup> 中？号的值是此 ActionServlet 在服务器开启时加载的次序，数值越低，越先加载。

<servlet>
<servlet-name>action</servlet-name>
<servlet-class>org.apache.struts.action.ActionServlet</servlet-class>
<init-param>
<param-name>config</param-name>
<param-value>/WEB-INF/struts-config.xml</param-value>
</init-param>
<init-param>
<param-name>debug</param-name>
<param-value>3</param-value>
</init-param>
<init-param>
<param-name>detail</param-name>
<param-value>3</param-value>
</init-param>
<load-on-startup>0</load-on-startup>
</servlet>

扩展： (1) 当服务器启动后，加载 ActionServlet ，而 ActionServlet 会调用相关的方法去，会根据它下面的参数的初始值，对这个 ActionServlet 中的参数时行初始化
(2) 当多人协作开发项目时可以对 Strutst 的配置文件进行适当的扩充，但必须为 config 开头。如

<init-param>
<param-name>config/XXXXXXXXX</param-name>
<param-value>/WEB-INF/XXXXX.xml</param-value>
</init-param>

(3) 配置欢迎文件清单
当客户访问 Web 应用时，如果仅仅给出 Web 应用的 Root URL, 没有指定具体的文件名。 Web 容器会自动调用 Web 应用的欢迎文件。 <welcome-file-list> 是用来设置此项 .

<welcome-file-list>
<welcome-file>welcome.jsp</welcome-file>
</welcome-file-list>

说明 : 在 <welcome-file-list> 下可以有多个 <welcom-file> 。 Web 容器会依次寻找欢迎界面，直到找到为止。但如果不存在会向客户端返回 ”HTTP 404 NOT Found“ 错误信息。

由于在 <welcome-file-list> 元素中不能配置 Servlet 映射，则不能直接把 Struts 的 Action 作为欢迎文件。但可以通过 Struts 中的全局的 (global) 转发项来配置。
A ： welcome.jsp 页面 ( 可换文件名 )

<%@ taglib uri="http://jakarta.apache.org/struts/tags-logic" prefix="logic"%>
<html>
<body>
<logic:forward name="welcome"/>
</body>
</html>

B: web.xml

<welcome-file-list>
<welcome-file>welcome.jsp</welcome-file>
</welcome-file-list>

C: struts-config.xml

<global-forwards>
<forward name="welcome" path="hello.do">
</global-forwards>

(4) 配置错误处理
Struts 框架中不能处理所有的错误或异常。当 Struts 框架发生不能处理所有的错误或异常时，就把错误抛给 Web 容器。在默认情况下， Web 容器会向用户浏览器直接返回原始的错误，为了避免可以使用 <error-page> 。

<erro-page>
<error-code>4040</error-code>
<location>/commmon/404.jsp</location>
</error-page>
<erro-page>
<error-code>4040</error-code>
<location>/commmon/404.jsp</location>
</error-page>

Weg 容器捕获的 Java 异常配置 <error-page> ，这时需要设置 <exception-type> 子元素，它用于指定 Java 异常类。 Web 容器可能捕获如下的异常 :
RuntimeException 或 Error
ServletException 或它的子类
IOException 　或它的子类

<error-page>
<exception-type>javax.servlet.ServletException</exception-type>
<location>/system_error.jsp</location>
</error-page>
<error-page>
<exception-type>java.io.IOException</exception-type>
<location>/system_ioerror.jsp</location>
</error-page>

(5) 配置 Struts 标签库
Struts 框架提供了一些实用的客户化标签标签库 , 如果在应用中使用可以在 web.xml 中配置

<taglib>
<taglib-uri>/WEB-INF/struts-bean.tld</taglib-uri>
<taglib-location>/WEB-INF/struts-bean.tld</taglib-location>
</taglib>

<taglib> 元素有两个子元素： <taglib-uri> 和 <taglib- location>.<taglib-uri> 元素指定标签库的相对或绝对 URI 地址， WEB 应用将根据这一 URI 来访问标签库； <taglib-location> 元素指定标签库描述文件在文件资源系统中的物理位置。
此外，也可以以上方式在 web.xml 文件中配置用户自定义的客户化标签库，例如：

<taglib>
<taglib-uri>/WEB-INF/mytaglib.tld</taglib-uri>
<taglib-location>/WEB-INF/mytaglib.tld</taglib-location>
</taglib>

注意： a. 不管应用中包含多少子应用，都只需要配置一个 ActionServlet. 有些开发者希望设置多个 ActionServlet 类来处理应用中不同的功能，其实这是不必要的，因为 Servlet 本身支持多线程。而且目前的 Struts 框架只允许在应用中配置一个 ActionServlet 。

web.xml 中的filter

Servlet API的2.3版本中最重要的一个新功能就是能够为servlet和JSP页面定义过滤器。过滤器提供了某些早期服务器所支持的非标准“servlet链接”的一种功能强大且标准的替代品。
过滤器是一个程序，它先于与之相关的servlet或JSP页面运行在服务器上。过滤器可附加到一个或多个servlet或JSP页面上，并且可以检查进入这些资源的请求信息。在这之后，过滤器可以作如下的选择：

1 以常规的方式调用资源（即，调用servlet或JSP页面）。

2 利用修改过的请求信息调用资源。

3 调用资源，但在发送响应到客户机前对其进行修改。

4 阻止该资源调用，代之以转到其他的资源，返回一个特定的状态代码或生成替换输出。

· 过滤器只在与servlet规范2.3版兼容的服务器上有作用。如果你的Web应用需要支持旧版服务器，就不能使用过滤器。
1．建立基本过滤器
建立一个过滤器涉及下列五个步骤：
1）建立一个实现Filter接口的类。这个类需要三个方法，分别是：doFilter、init和destroy。doFilter方法包含主要的过滤代码（见第2步），init方法建立设置操作，而destroy方法进行清楚。
2）在doFilter方法中放入过滤行为。doFilter方法的第一个参数为ServletRequest对象。此对象给过滤器提供了对进入的信息（包括表单数据、cookie和HTTP请求头）的完全访问。第二个参数为ServletResponse，通常在简单的过滤器中忽略此参数。最后一个参数为 FilterChain，如下一步所述，此参数用来调用servlet或JSP页。
3）调用FilterChain对象的doFilter方法。 Filter接口的doFilter方法取一个FilterChain对象作为它的一个参数。在调用此对象的doFilter方法时，激活下一个相关的过滤器。如果没有另一个过滤器与servlet或JSP页面关联，则servlet或JSP页面被激活。
4）对相应的servlet和JSP页面注册过滤器。在部署描述符文件（web.xml）中使用filter和filter-mapping元素。
5）禁用激活器servlet。防止用户利用缺省servlet URL绕过过滤器设置。
1.1 建立一个实现Filter接口的类
所有过滤器都必须实现javax.servlet.Filter。这个接口包含三个方法，分别为doFilter、init和destroy。

1、public void doFilter(ServletRequset request,
ServletResponse response,
FilterChain chain)
thows ServletException, IOException

每当调用一个过滤器（即，每次请求与此过滤器相关的 servlet 或 JSP 页面）时，就执行其 doFilter 方法。正是这个方法包含了大部分过滤逻辑。
第一个参数为与传入请求有关的 ServletRequest 。对于简单的过滤器，大多数过滤逻辑是基于这个对象的。如果处理 HTTP 请求，并且需要访问诸如 getHeader 或 getCookies 等在 ServletRequest 中无法得到的方法，就要把此对象构造成 HttpServletRequest 。
第二个参数为 ServletResponse 。除了在两个情形下要使用它以外，通常忽略这个参数。首先，如果希望完全阻塞对相关 servlet 或 JSP 页面的访问。可调用 response.getWriter 并直接发送一个响应到客户机。第 7 节给出详细内容，第 8 节给出一个例子。其次，如果希望修改相关的 servlet 或 JSP 页面的输出，可把响应包含在一个收集所有发送到它的输出的对象中。然后，在调用 serlvet 或 JSP 页面后，过滤器可检查输出，如果合适就修改它，之后发送到客户机。详情请参阅第 9 节。
DoFilter 的最后一个参数为 FilterChain 对象。对此对象调用 doFilter 以激活与 servlet 或 JSP 页面相关的下一个过滤器。如果没有另一个相关的过滤器，则对 doFilter 的调用激活 servlet 或 JSP 本身。

2、public void init(FilterConfig config)
thows ServletException

init 方法只在此过滤器第一次初始化时执行，不是每次调用过滤器都执行它。对于简单的过滤器，可提供此方法的一个空体，但有两个原因需要使用 init 。首先， FilterConfig 对象提供对 servlet 环境及 web.xml 文件中指派的过滤器名的访问。因此，普遍的办法是利用 init 将 FilterConfig 对象存放在一个字段中，以便 doFilter 方法能够访问 servlet 环境或过滤器名。这种处理在第 3 节描述。其次， FilterConfig 对象具有一个 getInitParameter 方法，它能够访问部署描述符文件（ web.xml ）中分配的过滤器初始化参数。初始化参数的使用在第 5 节中描述。
3 、 public void destroy( )
此方法在利用一个给定的过滤器对象永久地终止服务器（如关闭服务器）时调用。大多数过滤器简单地为此方法提供一个空体，不过，可利用它来完成诸如关闭过滤器使用的文件或数据库连接池等清除任务。
1.2 将过滤行为放入 doFilter 方法
doFilter 方法为大多数过滤器地关键部分。每当调用一个过滤器时，都要执行 doFilter 。对于大多数过滤器来说， doFilter 执行的步骤是基于传入的信息的。因此，可能要利用作为 doFilter 的第一个参数提供的 ServletRequest 。这个对象常常构造为 HttpServletRequest 类型，以提供对该类的更特殊方法的访问。
1.3 调用 FilterChain 对象的 doFilter 方法
Filter 接口的 doFilter 方法以一个 FilterChain 对象作为它的第三个参数。在调用该对象的 doFilter 方法时，激活下一个相关的过滤器。这个过程一般持续到链中最后一个过滤器为止。在最后一个过滤器调用其 FilterChain 对象的 doFilter 方法时，激活 servlet 或页面自身。
但是，链中的任意过滤器都可以通过不调用其 FilterChain 的 doFilter 方法中断这个过程。在这样的情况下，不再调用 JSP 页面的 serlvet ，并且中断此调用过程的过滤器负责将输出提供给客户机。详情请参阅第 7 节。
1.4 对适当的 servlet 和 JSP 页面注册过滤器
部署描述符文件的 2.3 版本引入了两个用于过滤器的元素，分别是： filter 和 filter-mapping 。 filter 元素向系统注册一个过滤对象， filter-mapping 元素指定该过滤对象所应用的 URL 。
1.filter 元素
filter 元素位于部署描述符文件（ web.xml ）的前部，所有 filter-mapping 、 servlet 或 servlet-mapping 元素之前。 filter 元素具有如下六个可能的子元素：
icon 这是一个可选的元素，它声明 IDE 能够使用的一个图象文件。
filter-name 这是一个必需的元素，它给过滤器分配一个选定的名字。
display-name 这是一个可选的元素，它给出 IDE 使用的短名称。
description 这也是一个可选的元素，它给出 IDE 的信息，提供文本文档。
filter-class 这是一个必需的元素，它指定过滤器实现类的完全限定名。
init-param 这是一个可选的元素，它定义可利用 FilterConfig 的 getInitParameter 方法读取的初始化参数。单个过滤器元素可包含多个 init-param 元素。

filter-mapping元素
filter-mapping元素位于web.xml文件中filter元素之后serlvet元素之前。它包含如下三个可能的子元素：：
l filter-name 这个必需的元素必须与用filter元素声明时给予过滤器的名称相匹配。
l url-pattern 此元素声明一个以斜杠（/）开始的模式，它指定过滤器应用的URL。所有filter-mapping元素中必须提供url-pattern或 servlet-name。但不能对单个filter-mapping元素提供多个url-pattern元素项。如果希望过滤器适用于多个模式，可重复整个filter-mapping元素。
l servlet-name 此元素给出一个名称，此名称必须与利用servlet元素给予servlet或JSP页面的名称相匹配。不能给单个filter-mapping元素提供多个servlet-name元素项。如果希望过滤器适合于多个servlet名，可重复这个filter-mapping元素。

基于以上的原理，在项目中遇到这样一个问题，用户只有登陆之后才能浏览resource目录下的资源，而这些resource的地址都是静态地址，这时候就用到了过滤器，

public void doFilter(ServletRequest req, ServletResponse res,
   FilterChain chain) throws IOException, ServletException {
   HttpServletRequest request = (HttpServletRequest) req;
   HttpServletResponse response = (HttpServletResponse) res;
   HttpSession session=request.getSession();
   ServletContext application=session.getServletContext();
   
      if(session.getAttribute("userSession")==null)
      {
       response.sendRedirect("error/priv_error.jsp");
       return;
      }
      else
      {
       chain.doFilter(request, response);
      }

 }

web.xml中如下配置：

<filter>
      <filter-name>PrivFilter</filter-name>
      <filter-class>com.myPriv.filter.PrivFilter</filter-class>
   </filter>

<filter-mapping>
    <filter-name>PrivFilter</filter-name>
    <url-pattern>/resource/*</url-pattern>
</filter-mapping>

在过滤器程序中判断到resource目录下的请求的用户session是否为空，如果空的话就跳转出去；

风影simple

关注

0
点赞
踩
3

收藏

觉得还不错? 一键收藏
0
评论
java web.xml详解

容易忘的东西，记录下来，对自己对别人都有帮助正文struts1 web.xml配置web.xml文件对于配置任何Java Web应用都必需的。（1）配置Struts的ActionServlet元素来声明ActionServlet元素
复制链接

扫一扫