servlet3.0

1 servlet3.0

 

1.1了解

Servlet 3.0 作为 Java EE 6 规范体系中一员，随着 Java EE 6 规范一起发布。该版本在前一版本（Servlet 2.5）的基础上提供了若干新特性用于简化 Web 应用的开发和部署。其中有几项特性的引入让开发者感到非常兴奋，同时也获得了 Java 社区的一片赞誉之声：

 

异步处理支持：有了该特性，Servlet 线程不再需要一直阻塞，直到业务处理完毕才能再输出响应，最后才结束该 Servlet 线程。在接收到请求之后，Servlet 线程可以将耗时的操作委派给另一个线程来完成，自己在不生成响应的情况下返回至容器。针对业务处理较耗时的情况，这将大大减少服务器资源的占用，并且提高并发处理速度。

新增的注解支持：该版本新增了若干注解，用于简化 Servlet、过滤器（Filter）和监听器（Listener）的声明，这使得 web.xml 部署描述文件从该版本开始不再是必选的了。

可插性支持：熟悉 Struts2 的开发者一定会对其通过插件的方式与包括 Spring 在内的各种常用框架的整合特性记忆犹新。将相应的插件封装成 JAR 包并放在类路径下，Struts2 运行时便能自动加载这些插件。现在 Servlet 3.0 提供了类似的特性，开发者可以通过插件的方式很方便的扩充已有 Web 应用的功能，而不需要修改原有的应用。

1.2 常用的注解

[1]创建一个支持3.0的项目

注意的几个步骤

Dynamic web module version 选择3.0以上的版本

选择是否生成web.xml

项目结构：

WEB-INF下是没有web.xml文件

[2] @WebServlet

创建一个servlet

创建一个类继承HttpServlet

在servlet的上方通过@WebServlet配置

@WebServlet("/user") public class UserServlet extends HttpServlet {     protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {        System.out.println("UserServlet-doGet");     }     protected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {        this.doGet(req, resp);     } }

 

@WebServlet 用于将一个类声明为 Servlet，该注解将会在部署时被容器处理，容器将根据具体的属性配置将相应的类部署为 Servlet。该注解具有下表给出的一些常用属性（以下所有属性均为可选属性，但是 vlaue 或者 urlPatterns 通常是必需的，且二者不能共存，如果同时指定，通常是忽略 value 的取值）

@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> 标签。

@WebInitParam

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

@WebInitParam 的常用属性

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

 

案例：

@WebServlet(urlPatterns= {"/user","/users"},        initParams= {@WebInitParam(name="n1",value="v1"),@WebInitParam(name="n2",value="v2")}) public class UserServlet extends HttpServlet {     protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {        System.out.println("UserServlet-doGet");        String v1 = this.getInitParameter("n1");        String v2 = this.getInitParameter("n2");        System.out.println(v1+"--"+v2);     }     protected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {        this.doGet(req, resp);     } }

 

注解要比配置灵活简单，但是当配置复杂的时候，很明显配置文件要比注解的可读性更强一些。

[3]webFilter注解

@WebFilter 用于将一个类声明为过滤器，该注解将会在部署时被容器处理，容器将根据具体的属性配置将相应的类部署为过滤器。该注解具有下表给出的一些常用属性 ( 以下所有属性均为可选属性，但是 value、urlPatterns、servletNames 三者必需至少包含一个，且 value 和 urlPatterns 不能共存，如果同时指定，通常忽略 value 的取值 )：

@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> 标签。

 

其中的filterName，value，urlPatterns和WebServlet中的完全一致，不再赘述。

案例：

@WebFilter(servletNames= {"userServlet"}) public class MyFilter implements Filter {       public void init(FilterConfig filterConfig) throws ServletException {       }       public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain)            throws IOException, ServletException {        System.out.println("执行MyFilter-doFilter");        chain.doFilter(request, response);     }       public void destroy() {       }   }

 

这个案例中，我们通过配置servletNames进行过滤。 前提条件是serlvet中必须配置了name属性。

Filter的执行顺序：

Web.xml中先配置，先执行。

注解之后：

谁在上面执行谁。按照类的名称顺序执行。

[4]@WebListener

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

• ServletContextListener
• ServletContextAttributeListener
• ServletRequestListener
• ServletRequestAttributeListener
• HttpSessionListener
• HttpSessionAttributeListener

该注解使用非常简单，其属性如下：

@WebListener 的常用属性

属性名	类型	是否可选	描述
value	String	是	该监听器的描述信息。

案例：

@WebListener public class MyApplicationListener implements ServletContextListener {     @Override     public void contextInitialized(ServletContextEvent sce) {        System.out.println("创建application");     }       @Override     public void contextDestroyed(ServletContextEvent sce) {        System.out.println("销毁application");     } }

[5] @MultipartConfig

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

@MultipartConfig 的常用属性

属性名	类型	是否可选	描述
fileSizeThreshold	int	是	当数据量大于该值时，内容将被写入文件。
location	String	是	存放生成的文件地址。
maxFileSize	long	是	允许上传的文件最大值。默认值为 -1，表示没有限制。
maxRequestSize	long	是	针对该 multipart/form-data 请求的最大数量，默认值为 -1，表示没有限制。

使用MultipartConfig处理文件上传

@WebServlet("/upload") @MultipartConfig //表示该servlet支持文件上传 public class UploadServlet extends HttpServlet {     protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {        doPost(request, response);     }     protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {        //获取非文件域的数据        String uname = request.getParameter("uname");        String upass = request.getParameter("upass");        System.out.println(uname+":"+upass);        //获取上传的文件  (包含了所有的表单域)        Collection<Part> parts = request.getParts();        //遍历parts处理上传的文件        for (Part part : parts) {            String disposition = part.getHeader("Content-Disposition");            System.out.println(disposition);            if(disposition.indexOf("filename=")!=-1) {//说明是文件域               //获取域的名称               String name = part.getName();               System.out.println(name);               //获取文件名称               String fileName = part.getSubmittedFileName();               System.out.println(fileName);               //将文件写入目标文件               //截取文件的后缀。               String ext = fileName.substring(fileName.lastIndexOf(".")+1);               //生产一个文件的名称               fileName = UUID.randomUUID().toString()+"."+ext;               ServletContext application = this.getServletContext();               //获取服务器下的绝对路径               String realPath = application.getRealPath("upload/");               fileName = realPath+fileName;               System.out.println(fileName);               part.write(fileName);//将文件写入目标文件            }        }     } }