Servlet 3.0概述-优快云博客

介绍了 Servlet 3.0 的新特性，包括简化配置、支持注释、增强异步处理能力等内容。并展示了如何使用注释定义 Servlet、过滤器及监听器。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

2019独角兽企业重金招聘Python工程师标准>>>

转自：http://hi.baidu.com/jackfrued/blog/item/eed1b9108cd00b0a213f2e29.html

本文将向读者简要介绍Servlet 3.0中引入的各种新特性。然后，我们将通过示例代码详细讲解Servlet 3.0的过滤器和监听器的用法。同时，我们还将讨论如何将框架及其他程序库插入一个web应用中。本文最后简要讨论Servlet 3.0对异步处理的支持，以及对现有API的重要改进之处。

一、Servlet 3.0新特性简述

Servlet 3.0规范为使用它的开发人员实现了以下目标：

简单性
减轻开发工作量
遵循web 2.0原则

为了使开发过程更加轻松，Servlet 3.0引入了注释。类似于EJB 3.1的改变，注释的引入使得web部署描述符web.xml成为可选项。

可插性

每当我们使用第三方框架如Struts、JSF或者Spring的时候，我们需要在web.xml中为相应的Servlet添加相应的条目，这使得web部署描述符变得繁琐并且难以维护。 Servlet 3.0中引入的可插性使得web应用程序更加模块化，也更加易于维护。由于可插性是通过web片段来实现的，所以它使得开发人员不必再在web.xml中建立太多的Servlet配置条目。

异步处理

新的Servlet规范中的另一项重大变化是支持异步处理，这对于AJAX应用程序来说是一个非常有用的特性。当Servlet创建发送请求的线程的时候，它通常必须等待诸如数据库或者消息连接等资源返回响应，之后它才能在这个线程中执行其他操作。异步处理通过允许线程执行其它的操作而避免了这样的阻塞式请求。

除了上面提到的特性之外，新规范还对现有的API做了改进处理，相关内容将在本文末尾部分进行详细介绍。

注意：为了运行使用Servlet 3.0开发的Servlet，我们的servlet 容器应该运行在Java SE 6或更高版本中。

二、Servlet中的注释

Servlet 3.0中的重大革新之一是支持注释。通过使用注释定义Servlet和过滤器，就无需在web部署描述符(web.xml)中建立Servlet/过滤器条目了。

@WebServlet

为了在web应用中定义Servlet组件，我们可以使用@WebServlet。我们可以将其用于继承类javax.servlet.http.HttpServlet的类。注释@WebServlet具有许多属性。例如name、urlPatterns和initParams，我们可以通过它们来定义Servlet的行为。对于url模式，我们必须规定注释本身，或者规定注释的属性。

我们可以利用@WebServlet定义一个简单的Servlet，如下所示：

@WebServlet(name = " GetQuoteServlet " , urlPatterns = { " /getquote " })
public class GetQuoteServlet extends HttpServlet{
     @Override
     protected void doGet(HttpServletRequest request, HttpServletResponse response)
             throws ServletException, IOException {
         PrintWriter out = response.getWriter();
         try {
             String symbol = request.getParam eter ("symbol" );
             out.println( "Stock Price is " + StockQuoteBean.getPrice(symbol);
         } finally {
             out.close();
         }
     }
}

public class StockQuoteBean {
private StockQuoteServiceEntity serviceEntity = new StockQuoteServiceEntity();
     public double getPrice(String symbol) {
         if (symbol != null )   {
return serviceEntity.getPrice(symbol);
         } else {
             return 0.0 ;
         }
     }
}

我们可以修改这个Servlet，让它使用注释属性处理来自多个url的请求。

@WebServlet(name = " GetQuoteServlet " ,   urlPatterns = { " /getquote " ,   " /stockquote " } )
public class GetQuoteServlet extends HttpServlet {
     @Override
     protected void doGet(HttpServletRequest request, HttpServletResponse response)
             throws ServletException, IOException {
         PrintWriter out = response.getWriter();
         try {
             String symbol = request.getParameter( " symbol " );
             out.println( "Stock Price is" + StockQuoteBean.getPrice(symbol);
         } finally {
             out.close();
         }
     }
}

@WebFilter

我们可以使用注释@WebFilter来定义过滤器。这个注释还具有可选参数。我们可以在任何实现了javax.servlet.Filter接口的类上使用@WebFilter。类似于@WebServlet注释，我们也必须为这个注释指定url模式。

@WebFilter(filterName = " AuthenticateFilter " , urlPatterns = { " /stock.jsp " , " /getquote " })
public class AuthenticateFilter implements Filter {

     public void doFilter(ServletRequest request, ServletResponse response,
             FilterChain chain)      throws IOException, ServletException {
         String username = ((HttpServletRequest) request).getParameter( " uname " );
         String password = ((HttpServletRequest) request).getParameter( " password " );
           if (username == null || password == null ) {
                 ((HttpServletResponse) response).sendRedirect( " index.jsp " );             }
if (username.equals( " admin " ) && password.equals( " admin " )) {
                 chain.doFilter(request, response);       }
else {
                 ((HttpServletResponse) response).sendRedirect( " index.jsp " );         }
         }

     public void destroy() {
     }
     public void init(FilterConfig filterConfig) {
     }
}

@WebInitParam

我们可以使用注释@WebInitParam把init参数指定为Servlet或者过滤器。另外，我们还可以使用注释@WebFilter和@WebServlet 的initParam属性来规定init参数。

@WebServlet(name = " GetQuoteServlet " , urlPatterns = { " /getquote " })
@WebInitParam(name = " default_market " , value = " NASDAQ " )
public class GetQuoteServlet extends HttpServlet {
     @Override
     protected void doGet(HttpServletRequest request, HttpServletResponse response)
             throws ServletException, IOException {
         response.setContentType( " text/html;charset=UTF-8 " );
         PrintWriter out = response.getWriter();
         try {
             String market = getInitParameter( " default_market " );
             String symbol = request.getParameter( " symbol " );
             out.println("S tock Price in" + market + "is" + StockQuoteBean.getPrice(symbol, market));

         } finally {
             out.close();
         }
     }
}

下面是一个将注释@WebInitParam用作@WebServlet和@WebFilter initParams 属性的一部分的例子：

@WebServlet(name = " GetQuoteServlet " ,
             urlPatterns = { " /getquote " },
             initParams = {@WebInitParam(name = " default_market " ,   value = " NASDAQ " )}
           )
public class GetQuoteServlet extends HttpServlet {
     @Override
     protected void doGet(HttpServletRequest request, HttpServletResponse response)
             throws ServletException, IOException {
         response.setContentType( " text/html;charset=UTF-8 " );
         PrintWriter out = response.getWriter();
         try {
             String market = getInitParameter( " default_market " );
             String symbol = request.getParameter( " symbol " );
             out.println( " Stock Price in" +market + "is " + StockQuoteBean.getPrice(symbol, market));
         } finally {
             out.close();
         }
     }
}

@WebListener

我们可以将注释@WebListener用于充当给定web应用上下文中各种web应用事件的监听器的类。我们可以使用@WebListener来标注一个实现ServletContextListener、ServletContextAttributeListener、ServletRequestListener、ServletRequestAttributeListener、HttpSessionListener和HttpSessionAttributeListener的类。下面是一个使用ServletContextListener的例子：

@WebListener
public class QuoteServletContextListener implements ServletContextListener {
public void contextInitialized(ServletContextEvent sce) {
ServletContext context = sce.getServletContext();
context.setInitParameter(“default_market”, “NASDAQ”);
}
public void contextDestroyed(ServletContextEvent sce) {
}
}

@MultipartConfig

使用注释@MultipartConfig可以为Servlet指定多部分组成的MIME类型请求。MIME附件是从该请求对象中读取的。

三、元数据和通用注释

除了上面描述的特定于Servlet的注释之外，Servlet 3.0还支持所有定义为JSR 175(Java元数据规范)和JSR 250(用于Java平台通用注释) 的一部分的注释，包括：

与安全有关的注释，诸如@DeclareRoles 和@RolesAllowed
使用EJB的注释，诸如@EJB和@EJBs
用于资源注入的注释，诸如@resource和@Resources
使用JPA的注释，诸如@PersistenceContext、@PersistenceContexts、@PersistenceUnit和@PersistenceUnits
生命周期注释，诸如@PostConstruct 和@PreDestroy
提供web服务索引的注释，诸如@WebServiceRef 和@WebServiceRefs

四、注释，还是web.xml?

注释的引入使得web部署描述符(web.xml)成为配置web组件时的可选项，而非强制性的。然而，如果您必须对配置进行修改或者更新的话，您可能仍然会使用部署描述符。容器将根据描述符web.xml中的metadata-complete元素的值来决定使用web.xml或者注释。如果该属性的值为true，那么容器就不会处理注释和web片段;部署描述符是所有的元数据信息的唯一来源。只有当该元素metadata-complete不存在或其值不为true时才，容器才会处理注释和web片段。

五、针对Web框架的可插性

就像前面所说的那样，Servlet 3.0的某些改进使得我们可以将框架和程序库插入一个web应用。这个特性减少了配置的数量，并为web应用程序提供了更好的模块性。 Servlet 3.0是通过web模块部署描述符片段(或者简称web片段)来实现可插性的。

Web片段是框架JAR的META-INF目录中的web.xml文件的一部分。web片段提供了web应用的逻辑划分，而不必编辑特定框架组件的web部署描述符。

用于web片段的元素(标签)跟用于部署描述符的元素(标签)几乎完全一样，只是根元素(父标签)除外。Web片段的根元素应该为web-fragment，并且该文件应该名为web-fragment.xml。容器只会从WEB-INF\lib文件夹中的JAR文件中查找web-fragment.xml文件。如果lib目录中的JAR文件含有任何web-fragment.xml文件，容器将加载所需的类，并进行处理。

恰如Servlet名称应该在给定web.xml文件中保持唯一性一样，web片段也应如此。此外，Servlet名称必须在整个web应用中保持唯一，包括web.xml连同其他一切web片段。

作为一个例子，以下web-fragment.xml将被放到框架的jars\META-INF目录中：

web-fragment.xml
< web-fragment >
< servlet >
< servlet-name > ControllerServlet servlet-name >
< servlet-class > com.app.control.ControllerServlet servlet-class >
servlet >
< listener >
< listener-class > com.listener.AppServletContextListener listener-class >
listener >
web-fragment >

框架的JAR 文件被放置于WEB-INF\lib文件夹下面。Servlet 3.0规范没有定义web-fragment.xml和注释的配置顺序，不过它定义了web.xml和web-fragment.xml的配置次序，如下所示：

1. 绝对顺序

2. 相对顺序

图 1. Servlet 3.0中的绝对顺序：您可以利用web.xml文件中的元素来实现绝对顺序

您可以利用web.xml文件中的元素来实现绝对顺序，如图1所示。这个元素具有一个子元素，它可以用来规定web片段的名称，并且按照web片段的绝对顺序进行处理。如果多个web片段具有相同的名称，容器会忽略重复的web片段。

web.xml
< web-app >
< name > DemoApp name >
< absolute-ordering >
< name > WebFragment1 name >
< name > WebFragment2 name >
absolute-ordering >
...
web-app >

图 2. Servlet 3.0中的相对顺序：您可以利用web-fragment.xml文件中的元素来实现相对顺序

您可以利用web-fragment.xml文件中的元素来实现相对顺序，如图2所示。只有当web.xml中没有元素时，容器才会查看此元素。web片段的顺序是由、和元素决定的。如果某web片段具有一个子元素的话，该文件就会被移动到已排序文档列表的开头部分。同样，如果某web片段具有一个子元素的话，该文档就会被移动到已排序文档列表的末尾部分。

为了更好的理解相对顺序，可以考察一些例子。下面的示例假定三个JAR文件都具有一个web-fragment.xml文件。

web-fragment.xml
< web-fragment >
< name > WebFragment1 name >
< ordering >< after > WebFragment2 after > ordering >
...
web-fragment >

web-fragment.xml
< web-fragment >
< name

转载于:https://my.oschina.net/flynewton/blog/12497