Servlet 3.0特性详解(3)

[b]属性名类型描述[/b]

1.filterNameString指定过滤器的name属性,等价于<filter-name>。

2.valueString[]该属性等价于urlPatterns属性。但是两者不应该同时使用。

3.urlPatternsString[]指定一组过滤器的URL匹配模式。等价于<url-pattern>标签。

4.servletNamesString[]指定过滤器将应用于哪些Servlet。取值是@WebServlet中的name属性的取值,或者是web.xml中<servlet-name>的取值。

5.dispatcherTypesDispatcherType指定过滤器的转发模式。具体取值包括:

◆ASYNC、ERROR、FORWARD、INCLUDE、REQUEST。

◆initParamsWebInitParam[]指定一组过滤器初始化参数,等价于<init-param>标签。

◆asyncSupportedboolean声明过滤器是否支持异步操作模式,等价于<async-supported>标签。

◆descriptionString该过滤器的描述信息,等价于<description>标签。

◆displayNameString该过滤器的显示名,通常配合工具使用,等价于<display-name>标签。

下面是一个简单的示例:
@WebFilter(servletNames={"SimpleServlet"},filterName="SimpleFilter")  publicclassLessThanSixFilterimplementsFilter{...} 

如此配置之后,就可以不必在web.xml中配置相应的<filter>和<filter-mapping>元素了,容器会在部署时根据指定的属性将该类发布为过滤器。它等价的web.xml中的配置形式为:

<filter>
<filter-name>SimpleFilter</filter-name>
<filter-class>xxx</filter-class>
</filter>
<filter-mapping>
<filter-name>SimpleFilter</filter-name>
<servlet-name>SimpleServlet</servlet-name>
</filter-mapping>


[b]@WebListener[/b]

该注解用于将类声明为监听器,被@WebListener标注的类必须实现以下至少一个接口:

ServletContextListener  
ServletContextAttributeListener
ServletRequestListener
ServletRequestAttributeListener
HttpSessionListener
HttpSessionAttributeListener


该注解使用非常简单,其属性如下:

[b]属性名类型是否可选描述[/b]

valueString是该监听器的描述信息。

一个简单示例如下:
@WebListener("Thisisonlyademolistener")  publicclassSimpleListenerimplementsServletContextListener{...} 

如此,则不需要在web.xml中配置<listener>标签了。它等价的web.xml中的配置形式如下:

<listener>
<listener-class>footmark.servlet.SimpleListener</listener-class> </listener>


@MultipartConfig

该注解主要是为了辅助Servlet 3.0中HttpServletRequest提供的对上传文件的支持。该注解标注在Servlet上面,以表示该Servlet希望处理的请求的MIME类型是multipart/form-data。另外,它还提供了若干属性用于简化对上传文件的处理。具体如下:

属性名类型是否可选描述

◆fileSizeThresholdint是当数据量大于该值时,内容将被写入文件。

◆locationString是存放生成的文件地址。

◆maxFileSizelong是允许上传的文件最大值。默认值为-1,表示没有限制。

◆maxRequestSizelong是针对该multipart/form-data请求的最大数量,默认值为-1,表示没有限制。

可插性支持

如果说3.0版本新增的注解支持是为了简化Servlet/过滤器/监听器的声明,从而使得web.xml变为可选配置,那么新增的可插性(pluggability)支持则将Servlet配置的灵活性提升到了新的高度。熟悉Struts2的开发者都知道,Struts2通过插件的形式提供了对包括Spring在内的各种开发框架的支持,开发者甚至可以自己为Struts2开发插件,而Servlet的可插性支持正是基于这样的理念而产生的。使用该特性,现在我们可以在不修改已有Web应用的前提下,只需将按照一定格式打成的JAR包放到WEB-INF/lib目录下,即可实现新功能的扩充,不需要额外的配置。

Servlet 3.0引入了称之为“Web模块部署描述符片段”的web-fragment.xml部署描述文件,该文件必须存放在JAR文件的META-INF目录下,该部署描述文件可以包含一切可以在web.xml中定义的内容。JAR包通常放在WEB-INF/lib目录下,除此之外,所有该模块使用的资源,包括class文件、配置文件等,只需要能够被容器的类加载器链加载的路径上,比如classes目录等。

现在,为一个Web应用增加一个Servlet配置有如下三种方式(过滤器、监听器与Servlet三者的配置都是等价的,故在此以Servlet配置为例进行讲述,过滤器和监听器具有与之非常类似的特性):

1.编写一个类继承自HttpServlet,将该类放在classes目录下的对应包结构中,修改web.xml,在其中增加一个Servlet声明。这是最原始的方式;

2.编写一个类继承自HttpServlet,并且在该类上使用@WebServlet注解将该类声明为Servlet,将该类放在classes目录下的对应包结构中,无需修改web.xml文件。

3.编写一个类继承自HttpServlet,将该类打成JAR包,并且在JAR包的META-INF目录下放置一个web-fragment.xml文件,该文件中声明了相应的Servlet配置。web-fragment.xml文件示例如下:

<?xmlversionxmlversion="1.0"encoding="UTF-8"?>]
<web-fragment xmlns=http://java.sun.com/xml/ns/javaee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"version="3.0" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-fragment_3_0.xsd" metadata-complete="true">
<servlet>
<servlet-name>fragment</servlet-name>
<servlet-class>footmark.servlet.FragmentServlet</servlet-class> </servlet>
<servlet-mapping>
<servlet-name>fragment</servlet-name>
<url-pattern>/fragment</url-pattern>
</servlet-mapping>
</web-fragment>


从上面的示例可以看出,web-fragment.xml与web.xml除了在头部声明的XSD引用不同之外,其主体配置与web.xml是完全一致的。由于一个Web应用中可以出现多个web-fragment.xml声明文件,加上一个web.xml文件,加载顺序问题便成了不得不面对的问题。Servlet规范的专家组在设计的时候已经考虑到了这个问题,并定义了加载顺序的规则。

web-fragment.xml包含了两个可选的顶层标签,<name>和<ordering>,如果希望为当前的文件指定明确的加载顺序,通常需要使用这两个标签,<name>主要用于标识当前的文件,而<ordering>则用于指定先后顺序。一个简单的示例如下:


<web-fragment...>
<name>FragmentA</name>
<ordering>
<after>
<name>FragmentB</name>
<name>FragmentC</name>
</after>
<before>
<others/
</before>
</ordering> ...
</web-fragment>


如上所示,<name>标签的取值通常是被其它web-fragment.xml文件在定义先后顺序时引用的,在当前文件中一般用不着,它起着标识当前文件的作用。在<ordering>标签内部,我们可以定义当前web-fragment.xml文件与其他文件的相对位置关系,这主要通过<ordering>的<after>和<before>子标签来实现的。在这两个子标签内部可以通过<name>标签来指定相对应的文件。比如:


<after>
<name>FragmentB</name>
<name>FragmentC</name>
</after>


以上片段则表示当前文件必须在FragmentB和FragmentC之后解析。<before>的使用于此相同,它所表示的是当前文件必须早于<before>标签里所列出的web-fragment.xml文件。除了将所比较的文件通过<name>在<after>和<begin>中列出之外,Servlet还提供了一个简化的标签<others/>。它表示除了当前文件之外的其他所有的web-fragment.xml文件。该标签的优先级要低于使用<name>明确指定的相对位置关系。
  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值