第十七章_Web注解

1、HandlesTypes

这个注解类型用来声明ServletContainerInitializer能够处理哪些类型的类。它有一个属性、一个值。用来声明类的类型。比如，以下的ServletContainerInitializer用@HandleTypes进行标注，声明初始化程序能够处理UsefulServlet。

@HandlesTypes({UsefulServlet.class})

public class MyInitializer implements ServletContainerInitializer{

...

}

2、HttpConstraint

HttpConstraint注解类型表示适用于没有相应HttpMethodConstraint元素的全部HTTP协议方法的安全约束。这个注解类型必须放在ServletSecurity注解中。

它的属性例如以下：

rolesAllowed：表示授权角色的一个字符串数组。

transportGuarantee：表示是否有必须满足的数据保护要求。有效值为ServletSecurity.TransportGuarantee枚举的成员之中的一个

value：默认的授权语义

比如。下列HttpConstraint标注声明被标注的Servlet仅仅能由属于manager角色的用户进行訪问。

因为没有HttpMethodConstraint标注。这条约束将应用于全部的HTTP方法。

@ServletSecurity(@HttpConstraint(rolesAllowed=”manager”))

3、HttpMethodConstraint

这个注解类型表示特定HTTP方法中的一个安全约束。HttpMethodConstraint标注仅仅能出如今ServletSecurity注解中。

HttpMethodConstraint的属性例如以下：

emptyRoleSemantic：这是默认的授权语义，这个值必须是ServletSecurity.EmptyRoleSemantic枚举的成员之中的一个（DENY或PERMIT）

rolesAllowed：表示授权角色的一个字符串数组

transportGuarantee：表示是否有必须满足的数据保护要求，它的有效值为ServletSecurity.TransportGuarantee枚举的成员之中的一个（CONFIDENTIAL或者NONE）

value：受影响的HTTP方法

比如。下列ServletSecurity注解使用了value和httpMethodConstraints这两个属性。HttpConstraint注解定义了能够訪问被标注Servlet的角色，HttpMethodConstraint注解（没有rolesAllowed属性）覆盖了Get方法的约束。因此。不论什么用户都能够通过Get訪问这个Servlet。

还有一方面。通过其它全部HTTP方法进行訪问的权限仅限于manager角色的用户。

@ServletSecurity(value=@HttpConstraint(rolesAllowed=”manager”),

httpMethodConstraints={@HttpMethodConstraint(“GET”)})

可是。假设HttpMethodConstraint标注类型的emptyRoleSemantic属性值为EmptyRoleSemantic.DENY。那么该方法将限制全部用户的訪问。比如，用下面ServletSecurity注解进行标注的Servlet将阻止通过Get方法进行訪问。可是同意member角色中的全部用户通过其它HTTP方法进行訪问。

@ServletSecurity(value=@HttpConstraint(rolesAllowed=”member”),

httpMethodConstraints={@HttpMethodConstraint(value=”GET”,

emptyRoleSemantic=EmptyRoleSemantic.DENY)})

4、MultipartConfig

MultipartConfig注解类型用来标注一个Servlet。表示这个Servlet的实例是否可以处理multipart/form-data MIME类型。一般在上传文件时会用到。

下列MultipartConfig标注规定，能够上传的最大文件容量是一百万个字节

@MultipartConfig(maxFileSize = 1000000)

属性为：

fileSizeThreshold：超过这个容量界限之后。所上传的文件将被写入磁盘

location：上传的文件被存入磁盘时保存的位置

maxFileSize：上传文件的最大容量。

大于指定值的文件会被拒绝。

maxFileSize的默认值为-1，表示不受限制。

maxRequestSize：表示同意multipart HTTP请求的最大容量，默认值为-1，表示不受限制

5、ServletSecurity

ServletSecurity注解类型用来标注Servlet类，并对这个Servlet上应用安全约束。在ServletSecurity标注中可能出现的属性例如以下所看到的：

httpMethodConstraints：指定HTTP方法特定约束的一组HttpMethodConstraint

value：HttpConstraint注解定义了应用于没有对应HttpMethodConstraint的全部HTTP方法的安全约束。

比如。下面ServletSecurity注解中包括了一个HttpConstraint标注，表示被标注的Servlet仅仅能由manager角色中的用户訪问。

@ServletSecurity(value=@HttpConstraint(rolesAllowed=”manager”))

6、WebFilter

WebFilter注解类型用来标注一个过滤器，以下是它的属性：

asyncSupported：表示该过滤器是否支持异步处理

description：该过滤器的描写叙述

dispatcherTypes：该过滤器应用到的一组DispatcherTypes

displayName：该过滤器的显示名称

filterName：该过滤器的名称

initParams：该过滤器的初始參数

largeIcon：该过滤器的大图标

servletNames：该过滤器应用到的几个Servlet的名称

smallIcon：该过滤器的小图标

urlPatterns：该过滤器应用到的URL模式

value：该过滤器应用到的URL模式

7、WebInitParam

这个注解类型用于给Servlet或Filter传递初始化參数。

WebInitParam注解中可能出现的属性例如以下：

description：初始化參数的描写叙述

name：初始化參数的名称

value：初始化參数的值

8、WebListener

这个注解类型用来给监听器进行标注。

它的唯一属性value是可选的，当中包括这个监听器的描写叙述。

9、WebServlet

这个注解类型用来标注Servlet，属性例如以下：

asyncSupported：表明该Servlet是否支持异步处理

description：该Servlet的描写叙述

displayName：该Servlet的显示名称

initParams：该Servlet的初始化參数

largeIcon：该Servlet的大图标

loadOnStarpup：在一个包括多个Servlet的应用程序中，各Servlet的载入顺序

name：该Servlet的名称

smallIcon：该Servlet的小图标

urlPatterns：调用该Servlet的URL模式

value：调用该Servlet的URL模式