servlet3.0以下的规范什么意思

Question

如题所述

Answer 1

servlet3.0规范：（配置文件可以看出）

1.1版本要求
jdk1.6+
tomcate7.0+

1.2增加内容：看规范
1.2.1增加注解支持
@WebServlet。 用于将一个类声明为 Servlet，该注解将会在部署时被容器处理，容器将根据具体的属性配置将相应的类部署为 Servlet。
该注解具有下表给出的一些常用属性（以下所有属性均为可选属性，但是 vlaue 或者 urlPatterns 通常是必需的，且二者不能共存，如果
同时指定，通常是忽略 value 的取值）：
表 1. @WebServlet 主要属性列表
属性名 类型
描述
name String
指定 Servlet 的 name 属性，等价于 <servlet-name>。如果没有显式指定，则该 Servlet 的取值即为类的全限定名。
value String[]
该属性等价于 urlPatterns 属性。两个属性不能同时使用。
urlPatterns String[] 指定一组 Servlet 的 URL 匹配模式。等价于 <url-pattern> 标签。
loadOnStartup int 指定 Servlet 的加载顺序，等价于 <load-on-startup> 标签。
initParams WebInitParam[] 指定一组 Servlet 初始化参数，等价于 <init-param> 标签。
asyncSupported
boolean 声明 Servlet 是否支持异步操作模式，等价于 <async-supported> 标签。
description String 该 Servlet 的描述信息，等价于 <description> 标签。
displayName String 该 Servlet 的显示名，通常配合工具使用，等价于 <display-name> 标签。

下面是一个简单的示例：
@WebServlet(urlPatterns = {"/simple"}, asyncSupported = true,
loadOnStartup = -1, name = "SimpleServlet", displayName = "ss",
initParams = {@WebInitParam(name = "username", value = "tom")}
)
public class SimpleServlet extends HttpServlet{ … }
如此配置之后，就可以不必在 web.xml 中配置相应的 <servlet> 和 <servlet-mapping> 元素了，容器会在部署时根据指定的属性将该类发布为 Servlet。
它的等价的 web.xml 配置形式如下：
<servlet>
<display-name>ss</display-name>
<servlet-name>SimpleServlet</servlet-name>
<servlet-class>footmark.servlet.SimpleServlet</servlet-class>
<load-on-startup>-1</load-on-startup>
<async-supported>true</async-supported>
<init-param>
<param-name>username</param-name>
<param-value>tom</param-value>
</init-param>
</servlet>
<servlet-mapping>
<servlet-name>SimpleServlet</servlet-name>
<url-pattern>/simple</url-pattern>
</servlet-mapping>

@WebInitParam
该注解通常不单独使用，而是配合 @WebServlet 或者 @WebFilter 使用。它的作用是为 Servlet 或者过滤器指定初始化参数，这等价于 web.xml 中 <servlet>
和 <filter> 的 <init-param> 子标签。@WebInitParam 具有下表给出的一些常用属性：

表 2. @WebInitParam 的常用属性
属性名 类型
是否可选 描述
name String
否 指定参数的名字，等价于 <param-name>。
value String
否 指定参数的值，等价于 <param-value>。
description String 是 关于参数的描述，等价于 <description>。

@WebFilter
@WebFilter 用于将一个类声明为过滤器，该注解将会在部署时被容器处理，容器将根据具体的属性配置将相应的类部署为过滤器。该注解具有下表给出的一
些常用
属性 ( 以下所有属性均为可选属性，但是 value、urlPatterns、servletNames 三者必需至少包含一个，且 value 和 urlPatterns 不能共存，如果同时指定，通
常忽略 value 的取值 )：
表 3. @WebFilter 的常用属性
属性名 类型
描述
filterName String 指定过滤器的 name 属性，等价于 <filter-name>
value String[]
该属性等价于 urlPatterns 属性。但是两者不应该同时使用。
urlPatterns String[] 指定一组过滤器的 URL 匹配模式。等价于 <url-pattern> 标签。
servletNames String[] 指定过滤器将应用于哪些 Servlet。取值是 @WebServlet 中的 name 属性的取值，是 web.xml 中 <servlet-name> 的取值。
dispatcherTypes
DispatcherType 指定过滤器的转发模式。具体取值包括：
ASYNC、ERROR、FORWARD、INCLUDE、REQUEST。
initParams WebInitParam[] 指定一组过滤器初始化参数，等价于 <init-param> 标签。
asyncSupported
boolean 声明过滤器是否支持异步操作模式，等价于 <async-supported> 标签。
description String 该过滤器的描述信息，等价于 <description> 标签。
displayName String 该过滤器的显示名，通常配合工具使用，等价于 <display-name> 标签。
下面是一个简单的示例：
@WebFilter(servletNames = {"SimpleServlet"},filterName="SimpleFilter")
public class LessThanSixFilter implements Filter{...}
等价于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>

@WebListener
该注解用于将类声明为监听器，被 @WebListener 标注的类必须实现以下至少一个接口：
• ServletContextListener
• ServletContextAttributeListener
• ServletRequestListener
• ServletRequestAttributeListener
• HttpSessionListener
• HttpSessionAttributeListener
表 4. @WebListener 的常用属性
属性名 类型
是否可选 描述
value String
是 该监听器的描述信息。
例子：
@WebListener("This is only a demo listener")
public class SimpleListener implements ServletContextListener{...}
等价于：
<listener>
<listener-class>footmark.servlet.SimpleListener</listener-class>
</listener>

@MultipartConfig
该注解主要是为了辅助 Servlet 3.0 中 HttpServletRequest 提供的对上传文件的支持。该注解
标注在 Servlet 上面，以表示该 Servlet 希望处理的请求的 MIME 类型是 multipart/form-data。
另外，它还提供了若干属性用于简化对上传文件的处理。具体如下：
表 5. @MultipartConfig 的常用属性
属性名 类型
是否可选 描述
fileSizeThreshold
int 是 当数据量大于该值时，内容将被写入文件。
location String 是 存放生成的文件地址。
maxFileSize long 是 允许上传的文件最大值。默认值为 -1，表示没有限制。
maxRequestSize
long 是 针对该 multipart/form-data 请求的最大数量，默认值为 -1，表示没有限制。

1.2.2增加文件上传下载支持：增加Part类，其实是fileUpload类的封装
@WebServlet(urlPatterns = {"/servletDemo1"}, asyncSupported = true,
loadOnStartup = -1, name = "SimpleServlet", displayName = "ss"
)
@MultipartConfig
public class ServletDemo1 extends HttpServlet {
private static final long serialVersionUID = 1L;

protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
//response.getOutputStream().write("ss".getBytes());
Part part = request.getPart("file");
String name = part.getName();
String filename = name.substring(name.lastIndexOf("\\")+1, name.length()-1);
part.write(filename);
}
<form action="${pageContext.request.contextPath}/servletDemo1" method="post" enctype="multipart/form-data"><!--form表单记得添加en..-->
<input type="text" name="input" /><br>
<input type="file" name ="file"><br>
<input type="submit" value="submit">
</form>

1.2.3增加通过servletContext初始化servlet、filter
待学

1.2.4增加异步处理支持（暂时无用，使用Ajax）
1.2.5增加可插性：
使用该特性，现在我们可以在不修改已有 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 配置为例进行讲述，过滤器 和监听器具有与之非常类似的特性 )：
• 编写一个类继承自 HttpServlet，将该类放在 classes 目录下的对应包结构中，修改 web.xml，在其中增加一个 Servlet 声明。这是最原始的方式；
• 编写一个类继承自 HttpServlet，并且在该类上使用 @WebServlet 注解将该类声明为 Servlet，将该类放在 classes 目录下的对应包结构中，无需修改 web.xml 文件。
• 编写一个类继承自 HttpServlet，将该类打成 JAR 包，并且在 JAR 包的 META-INF 目录下放置一个 web-fragment.xml 文件，该文件中声明了相应的 Servlet 配 置。web-fragment.xml 文件

web-fragment.xml 文件示例如下：
<?xml version="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>

1.2.51加载顺序问题
由于一个 Web 应用中可以出现多个 web-fragment.xml 声明文件，加上一个 web.xml 文件，加载顺序问题便成了不得不面对的问题。

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>