| 署描述文件 web.xml 的顶层标签 <web-app> 有一个 metadata-complete 属 性，该属性指定当前的部署描述文件是否是完全的。如果设置为 true，则容器在部署时将只依赖部署描 述文件，忽略所有的注解（同时也会跳过 web-fragment.xml 的扫描，亦即禁用可插性支持，具体请看后 文关于 可插性支持的讲解）；如果不配置该属性，或者将其设置为 false，则表示启用注解支持（和可 插性支持）。
@WebServlet
@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> 标签。 |
Servlet 3.0新特性详解(4)
时间:2011-09-14 IBM 张建平
下面是一个简单的示例：
@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>
</se
|
