Java注解-注解处理器、servlet3.0|乐字节

大家好，我是乐字节的小乐，上次给大家带来了Java注解-元数据、注解分类、内置注解和自定义注解|乐字节，这次接着往下讲注解处理器和servlet3.0

一、注解处理器

使用注解的过程中，很重要的一部分就是创建于使用注解处理器。Java SE5扩展了反射机制的API，以帮助程序员快速的构造自定义注解处理器。

1、注解处理器类库java.lang.reflect.AnnotatedElement

Java使用Annotation接口来代表程序元素前面的注解，该接口是所有Annotation类型的父接口。除此之外，Java在java.lang.reflect 包下新增了AnnotatedElement接口，该接口代表程序中可以接受注解的程序元素，该接口主要有如下几个实现类：

Class：类定义
Constructor：构造器定义
Field：累的成员变量定义
Method：类的方法定义
Package：类的包定义

java.lang.reflect 包下主要包含一些实现反射功能的工具类，实际上，java.lang.reflect 包所有提供的反射API扩充了读取运行时Annotation信息的能力。当一个Annotation类型被定义为运行时的Annotation后，该注解才能是运行时可见，当class文件被装载时被保存在class文件中的Annotation才会被虚拟机读取。

AnnotatedElement 接口是所有程序元素（Class、Method和Constructor）的父接口，所以程序通过反射获取了某个类的AnnotatedElement对象之后，程序就可以调用该对象的如下四个个方法来访问Annotation信息：

①<T extends Annotation> T getAnnotation(Class<T> annotationClass): 返回该程序元素上存在的、指定类型的注解，如果该类型注解不存在，则返回null。

②Annotation[] getAnnotations():返回该程序元素上存在的所有注解。

③boolean is AnnotationPresent(Class<?extends Annotation> annotationClass):判断该程序元素上是否包含指定类型的注解，存在则返回true，否则返回false.

④Annotation[] getDeclaredAnnotations()：返回直接存在于此元素上的所有注释。与此接口中的其他方法不同，该方法将忽略继承的注释。（如果没有注释直接存在于此元素上，则返回长度为零的一个数组。）该方法的调用者可以随意修改返回的数组；这不会对其他调用者返回的数组产生任何影响。

2、解析实例

public class ParseCoder {
    public static void main(String[] args) {
        String coderName="名称：";
        String coderType="类型：";
        String coderProvider="厂家信息如下 ";
        Field [] fields=Coder.class.getDeclaredFields();
        for(Field field:fields){
            if(field.isAnnotationPresent(Programmer.class)){
                Programmer pro=(Programmer)field.getAnnotation(Programmer.class);
                coderName=coderName+pro.value();
                System.out.println(coderName);
            }else if(field.isAnnotationPresent(ProgrammerType.class)){
                ProgrammerType type=(ProgrammerType)field.getAnnotation(ProgrammerType.class);
                coderType=coderType+type.type().toString();
                System.out.println(coderType);
            }else if(field.isAnnotationPresent(ProgrammerProductor.class)){
                ProgrammerProductor fruitProvider=(ProgrammerProductor)field.getAnnotation(ProgrammerProductor.class);
                coderProvider+="编号："+fruitProvider.id()+" 名称："+fruitProvider.name()+" 地址:"+fruitProvider.address();
                System.out.println(coderProvider);
            }
        }
    }
}

二、 Servlet3.0

1、@WebServlet

使用注解达到零配置，开发servlet项目，使用@WebServlet将一个继承于javax.servlet.http.HttpServlet的类定义为Servlet组件。在Servlet3.0中，可以使用@WebServlet注解将一个继承于javax.servlet.http.HttpServlet的类标注为可以处理用户请求的Servlet。

@WebServlet注解的相关属性

Servlet的访问URL是Servlet的必选属性，可以选择使用urlPatterns或者value定义。如一个Servlet可以描述成:

@WebServlet(name="ServletDemo",value="/ServletDemo")。

也定义多个URL访问：如

@WebServlet(name="ServletDemo",urlPatterns={"/ServletDemo","/ServletDemo2"})

或者：

@WebServlet(name="AnnotationServlet",value={"/ServletDemo","/ServletDemo2"})

initParams可以用来指定当前Servlet的初始化参数，它是一个数组， 里面每一个@WebInitParam表示一个参数。

@WebServlet(value="/servlet/init-param", initParams={@WebInitParam(name="param1", value="value1")})

测试实例如下

/**
 * 使用@WebServlet将一个继承于javax.servlet.http.HttpServlet的类定义为Servlet组件。
如@WebServlet有很多的属性：
1、asyncSupported：    声明Servlet是否支持异步操作模式。
2、description：　　    Servlet的描述。
3、displayName：       Servlet的显示名称。
4、initParams：        Servlet的init参数。
5、name：　　　　       Servlet的名称。
6、urlPatterns：Servlet的访问URL。
7、value：　　　        Servlet的访问URL。
Servlet的访问URL是Servlet的必选属性，可以选择使用urlPatterns或者value定义。
如@WebServlet(name="TestServlet",value="/TestServlet")，也定义多个URL访问：
如@WebServlet(name="TestServlet",urlPatterns={"/TestServlet","/Test"})
或@WebServlet(name="TestServlet",value={"/TestServlet","/Test"})
 */
@WebServlet(name="/TestServlet",urlPatterns={"/test"})
public class TestServlet extends HttpServlet {
    private static final long serialVersionUID = 1L;
    protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        response.getWriter().print("hello servlet3");
    }
    protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        doGet(request, response);
    }
}

初始化参数

@WebServlet(value="/init", 
initParams={@WebInitParam(name="param1", value="sxt")})
public class TestInit extends HttpServlet {
    private static final long serialVersionUID = 1L;
    protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
      Enumeration<String> paramNames = this.getServletConfig().getInitParameterNames();  
      String paramName;  
      while (paramNames.hasMoreElements()) {  
         paramName = paramNames.nextElement();  
         response.getWriter().append(paramName + " = " + this.getServletConfig().getInitParameter(paramName));  
      }  
      response.getWriter().close();  
    }
    protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        doGet(request, response);
    }
}

2、@WebFilter

/**
 * 使用注解标注过滤器:@WebFilter将一个实现了javax.servlet.Filter
 * 接口的类定义为过滤器，属性filterName声明过滤器的名称,可选
 * 属性urlPatterns指定要过滤 的URL模式,也可使用属性value来声明.
 * (指定要过滤的URL模式是必选属性),
 * 可以指定多种过滤模式@WebFilter(filterName="TestFilter",
 * urlPatterns={"/User","/index.jsp"})
 * @author Administrator
 */
@WebFilter(filterName="TestFilter",urlPatterns="/*")
public class TestFilter implements Filter  {
    @Override
    public void destroy() {
        System.out.println("过滤器销毁");
    }
    @Override
    public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain)
            throws IOException, ServletException {
        System.out.println("执行过滤操作");
        chain.doFilter(request, response);
    }
    @Override
    public void init(FilterConfig arg0) throws ServletException {
         System.out.println("过滤器初始化");
    }
}

3、@MultipartConfig

使用注解@MultipartConfig将一个Servlet标识为支持文件上传。Servlet3.0将multipart/form-data的POST请求封装成Part，通过Part对上传的文件进行操作。

注意:Servlet3没有提供直接获取文件名的方法,需要从请求头中解析出来

1)、页面制作

<%@ page language="java" contentType="text/html; charset=UTF-8"
    pageEncoding="UTF-8"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>文件上传</title>
</head>
<body>
    <fieldset>
        <legend>上传文件</legend>
        <!-- 文件上传时必须要设置表单的enctype="multipart/form-data" -->
        <form action="${pageContext.request.contextPath}/upload" method="post" enctype="multipart/form-data">
            上传文件:<input type="file" name="file1"><br/>
            上传文件:<input type="file" name="file2"><br/>
            <input type="submit" value="上传">
        </form>
    </fieldset>
</body>
</html>

2)、编写Servlet

/**
 * Servlet3.0将multipart/form-data的POST请求封装成Part，
 * 通过Part对上传的文件进行操作,Servlet3没有提供直接获取文件名的方法,
 * 需要从请求头中解析出来,获取请求头，请求头的格式：
 * 火狐和google浏览器下：form-data; name="file"; filename="snmp4j--api.zip"
* @author Administrator
 */
@WebServlet(name = "TestUpload", urlPatterns = "/upload")
@MultipartConfig
public class TestUpload extends HttpServlet {
    public void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        request.setCharacterEncoding("utf-8");
        response.setCharacterEncoding("utf-8");
        response.setContentType("text/html;charset=utf-8");
        // 存储路径
String savePath = request.getServletContext().getRealPath("/WEB-INF/upload");
        // 获取上传的文件集合
        Collection<Part> parts = request.getParts();
        //上传单个文件
        if (parts.size()==1) {
            //通过文件名获取文件
            Part part = request.getPart("file");
            //从请求头中获取文件
            String header = part.getHeader("content-disposition");
            //获取文件名
            String fileName = getFileName(header);
            //把文件写到指定路径
            part.write(savePath+File.separator+fileName);
        }else{
             for (Part part : parts) {//循环处理上传的文件
//请求头的格式：form-data; name="file"; filename="snmp4j--api.zip"
                 String header = part.getHeader("content-disposition");
                 //获取文件名
String fileName = getFileName(header);
                if(!fileName.equals("")){
                    //把文件写到指定路径
                    part.write(savePath+File.separator+fileName);
                }                 
             }
        }
        PrintWriter out = response.getWriter();
        out.println("上传成功");
        out.flush();
        out.close();
    }
    @Override
    protected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
        this.doGet(req,resp);
    }
    /**
     * 获取文件名
* 火狐和google浏览器下：form-data; name="file"; filename="snmp4j--api.zip"
     * @param header
     * @return
     */
    private  String getFileName(String header) {
        String[] headArr = header.split(";")[2].split("=");
        //获取文件名，兼容各种浏览器的写法        
        return headArr[1].substring(headArr[1].lastIndexOf("\\")+1).replaceAll("\"", "");
        
    }
}

4、@WebListener

Servlet3.0提供@WebListener注解将一个实现了特定监听器接口的类定义为监听器。将实现了ServletContextListener接口的MyServletContextListener标注为监听器。

@WebListener
public class TestListener implements ServletContextListener {
    @Override
    public void contextDestroyed(ServletContextEvent event) {
         System.out.println("ServletContext销毁");
    }
    @Override
    public void contextInitialized(ServletContextEvent event) {
         System.out.println("ServletContex初始化");
         System.out.println(event.getServletContext().getServerInfo());
    }
}

有关注解就介绍到这里了，感谢各位老板的光顾和学习。

请继续关注乐字节，后续不断更新Java干货资料和视频。