Servlet3.0 新特性.doc

Servlet3.0 新特性 一、 概述Servlet 是 Java EE 规范体系的重要组成部分，也是 Java 开发人员必须具备的基础技能， Servlet 3.0 引入的若干重要新特性，包括异步处理、新增的注解支持、可插性支持等，为读者顺利向新版本过渡扫清障碍。Tomcat 支持servlet版本Servlet版本Tomcat版本Jdk最小版本JAVA EE版本Servlet 2.5Tomcat 61.5Java EE5Servlet 3.0Tomcat71.6Java EE6servlet3.0 的新特性包括如下方面:1. 异步处理支持：有了该特性，Servlet 线程不再需要一直阻塞，直到业务处理完毕才能再输出响应，最后才结束该 Servlet 线程。在接收到请求之后，Servlet 线程可以将耗时的操作委派给另一个线程来完成，自己在不生成响应的情况下返回至容器。针对业务处理较耗时的情况，这将大大减少服务器资源的占用，并且提高并发处理速度。2. 新增的注解支持：该版本新增了若干注解，用于简化 Servlet、过滤器（Filter）和监听器（Listener）的声明，这使得 web.xml 部署描述文件从该版本开始不再是必选的了。3. 可插性支持：开发者可以通过插件的方式很方便的扩充已有 Web 应用的功能，而不需要修改原有的应用。二、 异步处理支持异步处理特性可以应用于 Servlet 和过滤器两种组件，由于异步处理的工作模式和普通工作模式在实现上有着本质的区别，因此默认情况下，Servlet 和过滤器并没有开启异步处理特性。异步处理关键是在于将复杂业务处理另外开一个线程，而Servlet将执行好的业务先送往jsp输出，等到耗时业务做完后再送往JSP页面，即先显示一部分，好事业务处理完后再显示一部分。1. 对于使用传统的部署描述文件 (web.xml) 配置 Servlet 和过滤器的情况，Servlet 3.0 为 和 标签增加了 子标签，该标签的默认取值为 false，要启用异步处理支持，则将其设为 true 即可。以 Servlet 为例，其配置方式如下所示： DemoServlet footmark.servlet.Demo Servlet true 2. 对于使用 Servlet 3.0 提供的 WebServlet 和 WebFilter 进行 Servlet 或过滤器配置的情况，这两个注解都提供了 asyncSupported 属性，默认该属性的取值为 false，要启用异步处理支持，只需将该属性设置为 true 即可。以 WebFilter 为例，其配置方式如下所示：WebFilter(urlPatterns = /demo,asyncSupported = true) public class DemoFilter implements Filter.同步情况例子：WebServlet(name = syncServlet1, urlPatterns = /sync1)public class SyncServlet1 extends HttpServlet Override protected void doGet(final HttpServletRequest req, final HttpServletResponse resp) throws ServletException, IOException resp.setHeader(Connection, Keep-Alive); resp.setHeader(Proxy-Connection, Keep-Alive); resp.setContentType(text/html;charset=utf-8); PrintWriter out = resp.getWriter(); out.write(hello sync); out.write(); out.flush(); /假设是个耗时任务，此时必须等待 try Thread.sleep(2L * 1000); catch (InterruptedException e) e.printStackTrace(); out.write(over); 模拟异步处理的 Servlet 示例：WebServlet(urlPatterns = /demo, asyncSupported = true)public class AsyncDemoServlet extends HttpServlet Override public void doGet(HttpServletRequest req, HttpServletResponse resp) throws IOException, ServletException resp.setContentType(text/html;charset=UTF-8); PrintWriter out = resp.getWriter(); out.println(进入Servlet的时间： + new Date() + .); out.flush(); /在子线程中执行业务调用，并由其负责输出响应，主线程退出 AsyncContext ctx = req.startAsync();/设置超时时间 asyncContext.setTimeout(10L * 1000); /开始任务 /new Thread(new Executor(ctx).start();/ ctx.start(new Executor(ctx);/这样也可以 out.println(结束Servlet的时间： + new Date() + .); out.flush(); public class Executor implements Runnable private AsyncContext ctx = null; public Executor(AsyncContext ctx) this.ctx = ctx; public void run() try /等待十秒钟，以模拟业务方法的执行 Thread.sleep(10000); PrintWriter out = ctx.getResponse().getWriter(); out.println(业务处理完毕的时间： + new Date() + .); out.flush(); plete(); catch (Exception e) e.printStackTrace(); 除此之外，Servlet 3.0 还为异步处理提供了一个监听器，使用 AsyncListener 接口表示。它可以监控如下四种事件：l 异步线程开始时，调用 AsyncListener 的 onStartAsync(AsyncEvent event) 方法；l 异步线程出错时，调用 AsyncListener 的 onError(AsyncEvent event) 方法；l 异步线程执行超时，则调用 AsyncListener 的 onTimeout(AsyncEvent event) 方法；l 异步执行完毕时，调用 AsyncListener 的 onComplete(AsyncEvent event) 方法；监听器例子：AsyncContext ctx = req.startAsync(); ctx.addListener(new AsyncListener() Overridepublic void onComplete(AsyncEvent event) throws IOException / TODO Auto-generated method stubSystem.out.println(-complitet-);Overridepublic void onTimeout(AsyncEvent event) throws IOException / TODO Auto-generated method stubOverridepublic void onStartAsync(AsyncEvent event) throws IOException / TODO Auto-generated method stubOverridepublic void onError(AsyncEvent event) throws IOException / TODO Auto-generated method stub);三、 新增注解支持Servlet3.0新增了WebServlet、WebFilter、WebListener、WebInitParam、MultipartConfig注解。Servlet 3.0 的部署描述文件 web.xml 的顶层标签 有一个 metadata-complete 属性，该属性指定当前的部署描述文件是否是完全的。metadata-complete默认值为false。如果设置为 true，则容器在部署时将只依赖部署描述文件，忽略所有的注解。1. WebServletWebServlet 用于将一个类声明为 Servlet，该注解将会在部署时被容器处理，容器将根据具体的属性配置将相应的类部署为 Servlet。WebServlet 主要属性列表:例子：WebServlet(name = servlet1, urlPatterns = /s1, /s1/*, loadOnStartup = 1)public class Servlet1 extends HttpServlet private String msg; public Servlet1() System.out.println(load on startup); Override public void init() throws ServletException super.init(); msg = this.getInitParameter(msg); Override protected void doGet(final HttpServletRequest req, final HttpServletResponse resp) throws ServletException, IOException System.out.println(msg); 2. WebInitParam该注解不单独使用，而是配合 WebServlet 或者 WebFilter 使用。它的作用是为 Servlet 或者过滤器指定初始化参数，这等价于 web.xml 中 和 的 子标签。WebInitParam常用属性。例子：WebServlet(urlPatterns=/annoServlet,initParams=WebInitParam(name=msg,value=hello world),loadOnStartup=1)public class AnnoServlet extends HttpServlet private static final long serialVersionUID = 1L; /* * see HttpServlet#HttpServlet() */ public AnnoServlet() super(); / TODO Auto-generated constructor stub。Overridepublic void init(ServletConfig config) throws ServletException / TODO Auto-generated method stubsuper.init(config);String msg = config.getInitParameter(msg);System.out.println(-+msg);3. WebFilterWebFilter 用于将一个类声明为过滤器。WebFilter 的常用属性：例子：WebFilter(filterName = filter1, urlPatterns=/*, dispatcherTypes = DispatcherType.REQUEST, DispatcherType.FORWARD)public class Filter1 implements Filter Override public void init(final FilterConfig filterConfig) throws ServletException Override public void doFilter(final ServletRequest request, final ServletResponse response, final FilterChain chain) throws IOException, ServletException HttpServletRequest httpServletRequest = (HttpServletRequest) request; System.out.println(filter1= + httpServletRequest.getRequestURI(); chain.doFilter(request, response); Override public void destroy() 4. WebListener该注解用于将类声明为监听器，被 WebListener 标注的类必须实现以下至少一个接口:l ServletContextListenerl ServletContextAttributeListenerl ServletRequestListenerl ServletRequestAttributeListenerl HttpSessionListenerl HttpSessionAttributeListenerWebListener 的常用属性:例子：WebListenerpublic class ServletContextListener1 implements ServletContextListener Override public void contextInitialized(final ServletContextEvent sce) System.out.println(init servlet context); Override public void contextDestroyed(final ServletContextEvent sce) System.out.println(destroy servlet container); 5. MultipartConfig该注解主要是为了辅助 Servlet 3.0 中 HttpServletRequest 提供的对上传文件的支持。该注解标注在 Servlet 上面，以表示该 Servlet 希望处理的请求的 MIME 类型是 multipart/form-data。常用属性:四、 文件上传的支持对于处理上传文件的操作一直是让开发者头疼的问题，因为 Servlet 本身没有对此提供直接的支持，需要使用第三方框架来实现，而且使用起来也不够简单。如今这都成为了历史，Servlet 3.0 已经提供了这个功能，而且使用也非常简单。上传要用到MultipartConfig注解。MultipartConfig常用属性:例子1：MultipartConfig( location = D:Backup, /即默认为 javax.servlet.context.tempdir 如mvn jetty:run 在chapter4targettmp中 maxRequestSize = 1024 * 1024 * 2, /指定一次请求最大的上传数据量（上传的总和） 单位：字节， -1表示不限制 maxFileSize = 1024 * 1024 * 1, /设定单个文件的最大大小，-1表示不限制 fileSizeThreshold = 100000 /当上传的文件大小大于该值时才写入文件)WebServlet(name = uploadServlet2, urlPatterns = /upload2)public class UploadServlet2 extends HttpServlet Override protected void doPost(final HttpServletRequest req, final HttpServletResponse resp) throws ServletException, IOException Part part = req.getPart(file1); /写到相对于 MultipartConfig中的location位置 part.write(a.txt); /上传的文件会重命名为最后一次的文件名 part.write(b.txt); /调用完InputStream记得关闭，否则删除不掉 InputStream is = part.getInputStream(); is.close(); /不能 part.getInputStream().close();/相当于多次获取 /删除相关的文件 part.delete(); 例子2：MultipartConfig(fileSizeThreshold = 1024 * 1024, location = d:/temp, maxFileSize = 1024 * 1024, maxRequestSize = 2* 1024 * 1024)WebServlet(/UploadServlet2)public class UploadServlet2 extends HttpServlet private static final long serialVersionUID = 1L;public UploadServlet2() super();protected void doPost(HttpServletRequest request, HttpServletResponse response)throws ServletException, IOException request.setCharacterEncoding(utf-8);Part file1 = request.getPart(file1);String fileDesposit = file1.getHeader(content-disposition);String fileName = fileDesposit.substring(fileDesposit.lastIndexOf(=) + 2, fileDesposit.length() - 1);/ 文件保存/file1.write(c.txt);/ 保存到其他目录1/*FileOutputStream fos = new FileOutputStream(new File(request.getServletContext().getRealPath() +File.separator+ fileName);InputStream fis = file1.getInputStream(