Java基础加强-(注解，动态代理，类加载器，servlet3.0新特性)

2023-08-19 17:26:34

1. Annotation注解

1.1. Annotation概述

Annotation是JDK 5.0以后提供对元数据的支持，可以在编译、加载和运行时被读取，并执行相应的处理。所谓Annotation就是提供了一种为程序元素设置元数据的方法，可用于修饰包、类、构造器、方法、成员变量、参数和局部变量的声明，这些信息被存储在Annotation的“name=value”对中。

Annotation能被用来为程序元素（类、方法、成员变量等）设置元数据，比如一段代码的作者或者告诉编译器禁止一些特殊的错误，不会影响代码的执行。

1.2. 基本Annotation

在Java中提供了3个基本Annotation的用法，使用Annotation时要在其前面增加@符号，并把该Annotation当作一个修饰符使用，用于修饰它支持的程序元素。这3个基本Annotation都定义在java.lang包下，可以通过查看API文档来了解。

@Override：限定重写父类方法。

@Override就是用来指定方法覆载的，它可以强制一个子类必须覆盖父类的方法。

public class Fruit {

    public void info(){

        System.out.println("这是一个水果,想吃吗?");

    }

}

public class Apple extends Fruit {

    @Override

    public void info() {

        System.out.println("这不仅是一个水果,它是苹果.");

    }

如果Apple类的info()方法名写成了inf()的话，编译器会报错。值得注意的是，@Override只能修饰方法，不能修饰其他程序元素。

@Deprecated：标示已过时。

@Deprecated用于表示某个程序元素已过时，当其他程序使用已过时的类、方法时，编译器将会给出警告。

public class Fruit {

    @Deprecated

    public void info(){

        System.out.println("这是一个水果,想吃吗?");

    }

}

public class DeprecatedTest {

    public static void main(String[] args) {

        // 使用info()方法时将会出现划线,表示该方法已过时.

        new Fruit().info();

    }

}

@SuppressWarnings：抑制编译器警告。

@SuppressWarnings表示被该Annotation修饰的代码取消显示指定的编译器警告。

public class SuppressWarningsTest {

    public static void main(String[] args) {

        @SuppressWarnings("rawtypes")

        /*

         * List集合在定义时,没有指定泛型类型.

         *  * 默认情况下,出现编译器警告.

         *  * 使用@SuppressWarnings注释后,取消警告信息.

         */

        List list = new ArrayList();

    }

}

关于jdk的注解@SuppressWarnings详解

@SuppressWarnings
J2SE 提供的一个批注或者注解。该批注的作用是给编译器一条指令，告诉它对被批注的代码元素内部的某些警告保持静默，即忽略这些警告信息。

在平常的编码过程中，我们经常使用到的是unchecked,serial这些。

@SuppressWarnings()中可传入一个字符串数组，数组中列出需要忽略的情况。
如果传入多种情况，这几种情况的处理同时执行。例如：

@SuppressWarnings({"unchecked","serial"})
public void test(){
//
}

若是只忽略一种情况的话，就可以写成这样

@SuppressWarnings("unchecked")
public void test(){
//
}

以下是主要的几种情况：
关键字用途
deprecation 使用了已过时或者不推荐使用的类或方法时的警告
unchecked 执行了未检查的转换时的警告，例如当使用集合时没有用泛型 (Generics) 来指定集合保存的类型
fallthrough 当 Switch 程序块直接通往下一种情况而没有 Break 时的警告
path 在类路径、源文件路径等中有不存在的路径时的警告
serial 当在可序列化的类上缺少 serialVersionUID 定义时的警告
all 关于以上所有情况的警告

1.3. 自定义Annotation

自定义一个Annotation类型使用@interface关键字，定义一个新的Annotation类型与定义一个接口非常像（只是多了一个@符号）。

// 自定义一个Annotation类型

public @interface Test {

}

在自定义一个Annotation类型通常可以用于修饰程序中的类、方法、变量、接口等。一般情况下，使用Annotation会在代码之前使用。

// 自定义Annotation类型定义在类上.

@Test

public class AnnotationTest {

    // 自定义Annotation类型定义在成员变量上.

    @Test

    private int i;

    // 自定义Annotation类型定义在构造函数上.

    @Test

    public AnnotationTest(){}

    // 自定义Annotation类型定义在方法上.

    @Test

    // 自定义Annotation类型定义在方法参数上.

    public void fun(@Test String str){

        // 自定义Annotation类型定义在变量上.

        @Test

        int z;

    }

}

1.4. Annotation属性

自定义Annotation不仅可以是这种简单形式，还可以包含成员变量。自定义的Annotation的成员变量以无形参的方法形式来声明，其方法名和返回值定义了该成员变量的名字和类型。

/**

 * 自定义带有username和password属性的Annotation

 * */

public @interface UserInfo {

    String username();

    String password();

}

使用带有属性的自定义Annotation时，必须使用其属性指定值，否则会报错。

@UserInfo(username="zhangwuji",password="123")

public class UserInfoTest {

}

自定义Annotation不仅可以设置属性，还可以为属性设置默认值，使用default关键字。

/**

 * 自定义带有username和password属性的Annotation

*  * 为username属性设置默认值.

 * @author 金云龙

 */

public @interface UserInfo {

    String username() default "zhangwuji";

    String password();

}

如果为自定义Annotation的属性设置了默认值，则在使用时可以不为该属性指定值（使用默认值）。也可以在使用该Annotation时为其属性指定值，则默认值不会起作用。

自定义Annotation中具有名为value的属性，在使用该Annotation时如果只使用value属性的话，可以不写属性名直接指定值。

@UserInfo("jiaozhu")

public class UserInfoTest {

}

Annotation的属性类型只能是基本类型、String、Enum、Class及上述类型的一维数组类型。

1.5. @Target注解

@Target修饰自定义Annotation，指定该自定义Annotation可以用于修饰哪些程序单元，例如方法、成员变量等。@Target注解包含一个ElementType类型的value属性，该属性值只能是如下几个：

ElementType.ANNOTATION_TYPE：指定该策略的Annotation只能修饰Annotation。
ElementType.CONSTRUCTOR：指定该策略的Annotation只能修饰构造器。
ElementType.FIELD：指定该策略的Annotation只能修饰成员变量。
ElementType.LOCAL_VARIABLE：指定该策略的Annotation只能修饰局部变量。
ElementType.METHOD：指定该策略的Annotation只能修饰方法定义。
ElementType.PACKAGE：指定该策略的Annotation只能修饰包定义。
ElementType.PARAMETER：指定该策略的Annotation只能修饰参数。
ElementType.TYPE：指定该策略的Annotation可以修饰类、接口或枚举定义。

以下是@Target注解的源码和ElementType的源码：

@Target(ElementType.ANNOTATION_TYPE)

public @interface Target {

    ElementType[] value();

}

public enum ElementType {

    TYPE,FIELD,METHOD,PARAMETER,CONSTRUCTOR,LOCAL_VARIABLE, ANNOTATION_TYPE, PACKAGE

}

1.6. @Retention注解

@Retention修饰自定义Annotation，指定自定义Annotation的生命周期。@Retention包含一个RetentionPolicy类型的value属性，该属性值只能是如下几个：

RetentionPolicy.CLASS：编译器将把Annotation记录在class文件中。当运行Java程序时，JVM不可获取Annotation信息。这时默认值。
RetentionPolicy.RUNTIME：编译器将把Annotation记录在class文件中。当运行Java程序时，JVM也可以获取Annotation信息，程序可以通过反射获取该Annotation信息。
RetentionPolicy.SOURCE：Annotation只保留在源代码中，编译器直接丢弃这种Annotation。

以下是@Retention注解的源码和RetentionPolicy的源码：

@Retention(RetentionPolicy.RUNTIME)

@Target(ElementType.ANNOTATION_TYPE)

public @interface Retention {

    RetentionPolicy value();

}

public enum RetentionPolicy {

    SOURCE, CLASS, RUNTIME

}

1.7. 反射读取Annotation

使用Annotation修饰了类、方法、成员变量等之后，这些Annotation不会自己生效，必须通过相应程序提取并处理Annotation信息。Java提供的Annotation接口是所有注解的父接口，在JDK 5.0新增加AnnotatedElement接口，该接口提供读取运行时Annotation的方法。只有当自定义的Annotation使用了@Retention(RetentionPolicy.RUNTIME)时，该Annotation才会在运行可见，JVM才能读取保存在class文件的Annotation信息。

以下是AnnotatedElement接口提供的方法API：

方法摘要

<T extends Annotation>
T

getAnnotation(Class<T> annotationClass)
如果存在该元素的指定类型的注释，则返回这些注释，否则返回 null。

Annotation[]

getAnnotations()
返回此元素上存在的所有注释。

Annotation[]

getDeclaredAnnotations()
返回直接存在于此元素上的所有注释。

boolean

isAnnotationPresent(Class<? extends Annotation> annotationClass)
如果指定类型的注释存在于此元素上，则返回 true，否则返回 false。

实际获取某类使用的Annotation信息的方式如下：

public class AnnotatedElementTest {

    public static void main(String[] args) throws Exception {

        // 获取对应类的Class对象.

        Class<UserInfoTest> clazz = UserInfoTest.class;

        // 获取对应类方法的Method对象.

        Method method = clazz.getMethod("fun");

        // 获取类上的注解.

        UserInfo anno1 = clazz.getAnnotation(UserInfo.class);

        // 打印该注解的username属性值.

        System.out.println(anno1.username());

        // 获取方法上的注解.

        UserInfo anno2 = method.getAnnotation(UserInfo.class);

        // 打印该注解的username属性值.

        System.out.println(anno2.password());

    }

}

1.8. 注解配置JDBC案例

使用JDBC连接MySQL数据库时，需要driverClassName、url、username和password四个参数。而之前的做法是将这四个参数写入一个配置文件，在JDBCUtils工具类中读取配置文件。目前可以将四个参数定义为一个注解，在JDBCUtils工具类中通过反射获取对应注解定义的四个参数内容。具体做法如下：

定义一个Annotation用于定义JDBC连接MySQL数据库所需的四个参数内容。

@Retention(RetentionPolicy.RUNTIME)

@Target(ElementType.METHOD)

public @interface JDBCInfo {

    String driverClassName();

    String url();

    String username();

    String password();

}

定义JDBCUtils工具类，使用Annotation配置四个参数内容，并使用反射进行读取。

public class JDBCUtils {

    @JDBCInfo(driverClassName = "com.mysql.jdbc.Driver", url = "jdbc:mysql://localhost:3306/jdbc", username = "root", password = "root")

    public static Connection getConnection() throws Exception {

        // 获取注解修饰目标对应的反射对象.

        Method method = JDBCUtils.class.getDeclaredMethod("getConnection");

        // 判断是否存在目前注解

if (method.isAnnotationPresent(JDBCInfo.class)) {

            // 获取注解信息

            JDBCInfo jdbcInfo = method.getAnnotation(JDBCInfo.class);

            // 读取注解属性信息

            String driverClassName = jdbcInfo.driverClassName();

            String url = jdbcInfo.url();

            String username = jdbcInfo.username();

            String password = jdbcInfo.password();

            // Class类加载驱动

            Class.forName(driverClassName);

            // 返回连接对象

            return DriverManager.getConnection(url, username, password);

        }

        return null;

    }

}

编写一个测试类用于测试JDBCUtils工具类是否正确。

public class JDBCTest {

    public static void main(String[] args) throws Exception {

        Connection conn = JDBCUtils.getConnection();

        String sql = "select * from products";

        PreparedStatement statement = conn.prepareStatement(sql);

        ResultSet rs = statement.executeQuery();

        while (rs.next()) {

            System.out.println(rs.getString("name") + "," + rs.getDouble("price"));

        }

        rs.close();

        statement.close();

        conn.close();

    }

}

2. 动态代理

2.1. 动态代理概述

代理模式是Java设计模式中的一种，其特征为代理类与委托类有同样的接口，代理类主要负责为委托类预处理消息、过滤消息、把消息转发给委托类，以及事后处理消息等。代理类与委托类之间通常存在关联关系，一个代理类的对象与一个委托类的对象关联，代理类的对象本身并不真正实现业务，而是通过调用委托类对象的相关方法来提供具体业务。

在Java中的java.lang.reflect包下提供了一个Proxy类和一个InvocationHandler接口，通过这个类和接口可以生成JDK动态代理或动态代理对象。

按照代理的创建时间不同，可以分为两种：

静态代理：手动创建，再对其编译。在程序运行前，代理类的.class文件就已经存在。
动态代理：在程序运行时，通过反射机制动态创建而成。

2.2. 动态代理原理

动态代理的实现原理有些类似于过滤器的实现原理，但有所不同。动态代理的代理类与委托类之间的关系更像是明星与经纪人之间的关系，也就是说，如果你想找某个明星演出的话，并不是找他本人，而是找到他的经纪人就可以了。动态代理的实现过程很类似于这个过程，具体请看下图：

2.3. Proxy代理类

Proxy类是Java的java.lang.reflect包下提供的，该类用于创建动态代理类和代理对象的静态方法，它也是所有动态代理类的父类。如果在程序中为一个或多个接口动态地生成实现类，就可以用Proxy类来创建动态代理类；如果需要为一个或多个接口动态地创建实例，也可以使用Proxy类来创建动态代理实例。

方法摘要
`static InvocationHandler`	`getInvocationHandler(Object proxy)` 返回指定代理实例的调用处理程序。
`static Class<?>`	`getProxyClass(ClassLoader loader, Class<?>... interfaces)` 返回代理类的 `java.lang.Class` 对象，并向其提供类加载器和接口数组。
`static boolean`	`isProxyClass(Class<?> cl)` 当且仅当指定的类通过 `getProxyClass` 方法或 `newProxyInstance` 方法动态生成为代理类时，返回 true。
`static Object`	`newProxyInstance(ClassLoader loader, Class<?>[] interfaces, InvocationHandler h)` 返回一个指定接口的代理类实例，该接口可以将方法调用指派到指定的调用处理程序。

static Class<?> getProxyClass(ClassLoader loader, Class<?>... interfaces)：创建一个动态代理类所对应的Class对象，该代理类将实现interfaces所指定的多个接口。第一个ClassLoader参数指定生成动态代理类的类加载器。
static Object newProxyInstance(ClassLoader
loader, Class<?>[] interfaces, InvocationHandler h)：直接创建一个动态代理对象，该代理对象的实现类实现了interfaces指定的系列接口，执行代理对象的每个方法时都会被替换执行InvocationHandler对象的invoke()方法。

2.4. InvocationHandler

InvocationHandler接口提供了invoke()方法，用于替换代理对象的每一个方法。真实业务类可以通过代理类对象调用InvocationHandler接口提供的invoke()方法，来替代调用委托类的真实方法。

以下是InvocationHandler的API内容：

方法摘要
`Object`	`invoke(Object proxy, Method method, Object[] args)` 在代理实例上处理方法调用并返回结果。

Object invoke(Object proxy, Method method, Object[] args)：在代理实例上处理方法调用并返回结果。在与方法关联的代理实例上调用方法时，将在调用处理程序上调用此方法。

² 参数proxy：表示代理类对象，也就是Proxy.newProxyInstance()方法返回的对象，通常用不上。

² 参数method：表示当前被调用方法的反射对象，

² 参数args：表示调用目标方法时传入的实参。

2.5. 实现动态代理

利用Java提供的Proxy类和InvocationHandler接口来生成动态代理类或动态代理对象，具体实现步骤如下：

定义一个业务接口，该接口提供具体业务方法的定义。

public interface Person {

    void sayMe();

    void sayHello(String name);

}

定义一个InvocationHandler接口的实现类，并重写invoke()方法。

public class MyInvocationHandler implements InvocationHandler {

    /**

     * 执行动态代理对象的所有方法时,都会被替换成执行下面的invoke()方法.

     *  * 参数proxy:代表动态代理对象.

*  * 参数method:代表正在执行的方法.

     *  * 参数args:代表调用目标方法时传入的实参.

     */

    @Override

    public Object invoke(Object proxy, Method method, Object[] args)

            throws Throwable {

        System.out.println("---正在执行的方法: "+method);

        if(args == null){

            System.out.println("当前调用的方法没有参数.");

        }else{

            System.out.println("当前调用的方法需要传入的实参为:");

            for (Object val : args) {

                System.out.println(val);

            }

        }

        return null;

    }

}

编写一个用于测试动态代理的测试类。

public class ProxyTest {

    public static void main(String[] args) {

        // 创建一个InvocationHandler对象

        InvocationHandler handler = new MyInvocationHandler();

        // 通过Proxy类使用指定的InvocationHandler来生成动态代理对象

        Person p = (Person)Proxy.newProxyInstance(Person.class.getClassLoader(), new Class[]{Person.class}, handler);

        // 调用动态代理对象的业务方法

        p.sayMe();

        p.sayHello("张无忌");

    }

}

2.6. 动态代理的作用

通过Java提供的Proxy类和InvocationHandler接口生成的动态代理类，可以阻止调用委托类的方法、过滤参数及修改对应方法的返回值等作用。实现业务接口方法的实现类即委托类，具体操作如下：

创建一个实现类，实现Person接口，并重写业务方法。

public class Fanbingbing implements Person {

    @Override

    public void sayMe() {

        System.out.println("我真的是范冰冰哦!");

    }

@Override

public String sayHello(String name) {

System.out.println("你好:"+name+",我等你很久了...");

return "我终于见到范冰冰啦!";

}

编写一个用于测试动态代理的测试类。

public class FanbingbingTest {

    public static void main(String[] args) {

        Person p = (Person) Proxy.newProxyInstance(

                Person.class.getClassLoader(),

                Fanbingbing.class.getInterfaces(), new InvocationHandler() {

                    @Override

                    public Object invoke(Object proxy, Method method,

                            Object[] args) throws Throwable {

                        // 通过method的getName()方法获取业务方法名,进行阻止.

                        if (method.getName().equals("sayMe")) {

                            System.out.println("你想多了,哪那么容易见到啊!");

                            return null;

                        }

                        // 通过args获取实参,进行修改

                        if(method.getName().equals("sayHello")){

                            String name = (String)args[0];

                            method.invoke(Class.forName("app.java.proxy.Fanbingbing").newInstance(), "某局长");

                        }

                        // 修改返回值

                        if(method.getName().equals("sayHello")){

                            return "都是假的!";

                        }

                        return null;

                    }

                });

        p.sayMe();

        p.sayHello("张无忌");

    }

}

2.7. 权限控制案例

目前已经掌握注解和动态代理的内容，下面利用注解和动态代理来完成权限控制的功能。首先，完成基本业务的功能，具体如下操作：

在MySQL数据库中创建相关数据库表及初始化必要数据记录。

CREATE TABLE userinfo(

  id INT PRIMARY KEY AUTO_INCREMENT,

  username VARCHAR(40),

  PASSWORD VARCHAR(40)

);

INSERT INTO userinfo VALUES(NULL,'zhangwuji','');

INSERT INTO userinfo VALUES(NULL,'zhouzhiruo','');

INSERT INTO userinfo VALUES(NULL,'zhaomin','');

CREATE TABLE PRIVILEGES(

   id INT PRIMARY KEY AUTO_INCREMENT,

   NAME VARCHAR(40)

);

INSERT INTO PRIVILEGES VALUES(NULL,'添加图书');

INSERT INTO PRIVILEGES VALUES(NULL,'修改图书');

INSERT INTO PRIVILEGES VALUES(NULL,'查看图书');

INSERT INTO PRIVILEGES VALUES(NULL,'删除图书');

CREATE TABLE userprivilege(

   user_id INT ,

   privilege_id INT,

   FOREIGN KEY(user_id) REFERENCES userinfo(id),

   FOREIGN KEY(privilege_id) REFERENCES PRIVILEGES(id),

   PRIMARY KEY(user_id,privilege_id)

);

INSERT INTO userprivilege VALUES(1,1);

INSERT INTO userprivilege VALUES(1,2);

INSERT INTO userprivilege VALUES(1,3);

创建一个JavaBean用于封装用户信息。

public class User {

    private int id;

    private String username;

    private String password;

    public int getId() {

        return id;

    }

    public void setId(int id) {

        this.id = id;

    }

    public String getUsername() {

        return username;

    }

    public void setUsername(String username) {

        this.username = username;

}

public String getPassword() {

return password;

}

public void setPassword(String password) {

this.password = password;

}

创建一个JSP页面用于用户登录功能的显示。

<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%>

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">

<html>

  <head>

    <title>My JSP 'login.jsp' starting page</title>

  </head>

  <body>

    <form action="../login" method="post" >

        用户名 <input type="text" name="username" />

        密码 <input type="password" name="password"/>

        <input type="submit" value="登陆" />

    </form>

  </body>

</html>

创建一个Servlet用于处理用户登录逻辑。

public class LoginServlet extends HttpServlet {

    public void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {

        try {

            User user = new User();

            BeanUtils.populate(user, request.getParameterMap());

            QueryRunner runner = new QueryRunner(JDBCUtils.getDataSource());

            String sql = "select * from userinfo where username = ? and password = ?";

            User existUser = runner.query(sql, new BeanHandler<User>(User.class), user.getUsername(), user.getPassword());

            if (existUser == null) {

                response.sendRedirect("/21_java/proxy/login.jsp");

            } else {

                request.getSession().setAttribute("user", existUser);

                response.sendRedirect("/21_java/proxy/book.jsp");

            }

        } catch (Exception e) {

            e.printStackTrace();

        }

    }

    public void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {

        doGet(request, response);

    }

}

创建一个JSP页面用于登录成功的功能列表显示

<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%>

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">

<html>

  <head>

    <title>My JSP 'book.jsp' starting page</title>

  </head>

  <body>

    <h1>图书管理</h1>

    <h2>${empty user?'未登陆':user.username }</h2>

    <a href="../book?operate=add">添加图书</a>

    <a href="../book?operate=del">删除图书</a>

    <a href="../book?operate=edit">修改图书</a>

    <a href="../book?operate=search">查看图书</a>

  </body>

</html>

创建一个Servlet用于对具体业务的操作逻辑处理。

public class BookServlet extends HttpServlet {

    public void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {

        String operate = request.getParameter("operate");

        User user = (User) request.getSession().getAttribute("user");

        BookService service = new BookServiceImpl();

        if("add".equals(operate)){

            service.addBook(user);

        }else if("del".equals(operate)){

            service.delBook(user);

        }else if("edit".equals(operate)){

            service.editBook(user);

        }else if("search".equals(operate)){

            service.searchBook(user);

        }

    }

    public void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {

        doGet(request, response);

    }

}

创建一个业务接口和业务实现类用于处理具体业务流程。

public interface BookService {

    public void addBook(User user);

    public void delBook(User user);

    public void editBook(User user);

    public void searchBook(User user);

}

public class BookServiceImpl implements BookService {

    public void addBook(User user){

        System.out.println("添加图书成功...");

    }

    public void delBook(User user){

        System.out.println("删除图书成功...");

    }

    public void editBook(User user){

        System.out.println("修改图书成功...");

    }

    public void searchBook(User user){

        System.out.println("查看图书成功...");

    }

}

配置Web工程的web.xml文件。

<?xml version="1.0" encoding="UTF-8"?>

<web-app version="3.0"

    xmlns="http://java.sun.com/xml/ns/javaee"

    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

    xsi:schemaLocation="http://java.sun.com/xml/ns/javaee

    http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd">

  <display-name></display-name>

  <servlet>

    <servlet-name>LoginServlet</servlet-name>

    <servlet-class>app.java.proxy.demo.LoginServlet</servlet-class>

  </servlet>

  <servlet>

    <servlet-name>BookServlet</servlet-name>

    <servlet-class>app.java.proxy.demo.BookServlet</servlet-class>

  </servlet>

  <servlet-mapping>

    <servlet-name>LoginServlet</servlet-name>

    <url-pattern>/login</url-pattern>

  </servlet-mapping>

  <servlet-mapping>

    <servlet-name>BookServlet</servlet-name>

    <url-pattern>/book</url-pattern>

  </servlet-mapping>

  <welcome-file-list>

    <welcome-file>index.jsp</welcome-file>

  </welcome-file-list>

</web-app>

完成到目前为止，已经将一个图书操作（增删改查）的功能完成。下面利用注解和动态代理来完成权限控制的功能，具体操作如下：

创建一个Annotation注解用于配置权限。

@Retention(RetentionPolicy.RUNTIME)

@Target(ElementType.METHOD)

@Inherited

public @interface PrivilegeInfo {

    String value();

}

利用Annotation注解为业务接口及实现类的方法配置权限。

public interface BookService {

    @PrivilegeInfo("添加图书")

    public void addBook(User user);

    @PrivilegeInfo("删除图书")

    public void delBook(User user);

    @PrivilegeInfo("修改图书")

    public void editBook(User user);

    @PrivilegeInfo("查看图书")

    public void searchBook(User user);

}

创建一个业务工厂类用于获取对应业务类实例对象。

public class ServiceFactory {

    public static BookService getBookService(){

        // 获取真实业务实现类对象

        final BookService service = new BookServiceImpl();

        // 通过Proxy代理类获取对应业务实现类的代理对象

        BookService serviceProxy = (BookService) Proxy.newProxyInstance(service.getClass().getClassLoader(), service.getClass().getInterfaces(), new InvocationHandler() {

            @Override

            public Object invoke(Object proxy, Method method, Object[] args)

                    throws Throwable {

                // 判断对应业务实现类是否存在注解信息

                if (method.isAnnotationPresent(PrivilegeInfo.class)) {

                    // 获取注解修饰对象

                    PrivilegeInfo info = method.getAnnotation(PrivilegeInfo.class);

                    // 获取注解修饰属性值(当前业务方法的权限)

                    String needPrivilege = info.value();

                    // 获取当前用户信息

                    User existUser = (User) args[0];

                    // 查询当前用户的所有权限

                    QueryRunner queryRunner = new QueryRunner(JDBCUtils.getDataSource());

                    String sql = "select privileges.name from privileges,userprivilege where privileges.id = userprivilege.privilege_id and userprivilege.user_id = ?";

                    List<Object> privilegeList = queryRunner.query(sql,new ColumnListHandler("name"), existUser.getId());

                    // 判断当前用户是否具有权限

                    for (Object userPrivilege : privilegeList) {

                        if (needPrivilege.equals(userPrivilege)) {

                            // 具有权限

                            return method.invoke(service, args);

                        }

                    }

                    // 没有权限

                    throw new RuntimeException("权限不足，无法访问");

                }

                // 不需要权限

                return method.invoke(service, args);

            }

        });

        return serviceProxy;

    }

}

修改用于对具体业务的操作逻辑处理的Servlet代码。
```
BookService service = ServiceFactory.getBookService();
```

3. 类加载器

3.0．什么是类加载器，作用是什么？

类加载器就加载字节码文件(.class）

aaarticlea/png;base64,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" alt="" />

3.1. 类加载器概述

类加载器负责加载所有的类，系统为所有被载入内存中的类生成一个java.lang.Class实例。一旦一个类被加入JVM中，同一个类就不会被再次加入了。正如一个对象有一个唯一的标识一样，一个载入JVM的类也有一个唯一的标识。在Java中，一个类用其全限定类名（包括包名和类名）作为标识；但在JVM中，一个类用其全限定类名和其类加载器作为其唯一标识。

例如以下案例，在JVM中两个同名的Person类是完全不同的，之间也互不兼容，因为类加载器不同。

上述情况转换成代码如下：

定义一个Person类。

public class Person {

    private Person instance;

    public void setPerson(Object instance) {

        this.instance = (Person) instance;

    }

}

编写一个测试方法，用于测试通过两个不同类加载器加载Person类得到不同的Class实例。

    @Test

    public void ClassIdentityTest() throws Exception{

        String classDataRootPath = "WebRoot\\WEB-INF\\classes";

        FileSystemClassLoader fscl1 = new FileSystemClassLoader(classDataRootPath);

        FileSystemClassLoader fscl2 = new FileSystemClassLoader(classDataRootPath);

        String className = "app.java.classloader.Person";

        try {

            Class<?> class1 = fscl1.findClass(className);

            Object obj1 = class1.newInstance();

            Class<?> class2 = fscl2.findClass(className);

            Object obj2 = class2.newInstance();

            Method setSampleMethod = class1.getMethod("setPerson", java.lang.Object.class);

            setSampleMethod.invoke(obj1, obj2);

        } catch (Exception e) {

            e.printStackTrace();

        }

    }

上述代码运行后，报如下错误，表示虽然两个对象的类名称相同，但是由于通过不同类加载器得到Class实例，JVM不会认为是相同的。

3.2. 类加载器分类

当JVM启动时，会形成由三个类加载器组成的初始类加载器层次结构。

Bootstrap ClassLoader：根类加载器。
Extension ClassLoader：扩展类加载器。
System ClassLoader：系统类加载器。

aaarticlea/png;base64,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*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" alt="" />

Bootstrap ClassLoader被称为引导（或原始或根）类加载器，它负责加载Java的核心类。在JVM中，当执行java.exe命令时，使用-Xbootclasspath选项或使用-D选项指定sun.boot.class.path系统属性值可以指定加载附加的类。根类加载器非常特殊，它并不是java.lang.ClassLoader的子类，而是由JVM自身实现的。

    @Test

    public void BootstrapTest(){

        // 获取根类加载器所加载的全部URL数组

        URL[] urls = sun.misc.Launcher.getBootstrapClassPath().getURLs();

        // 遍历输出根类加载器加载的全部URL

        for (int i = 0; i < urls.length; i++) {

            System.out.println(urls[i].toExternalForm());

        }

    }

Extension ClassLoader被称为扩展类加载器，它负责加载JRE的扩展目录（%JAVA_HOME%/jre/lib/ext或由java.ext.dirs系统属性指定的目录）中的JAR包的类。通过这种方式可以为Java扩展核心类以外的新功能，只要把自己开发的类打包成JAR文件，然后放入%JAVA_HOME%/jre/lib/ext路径即可。

    @Test

    public void ExtensionTest() throws Exception{

        // 位于jre/lib/ext/dnsns.jar

        DNSNameService dnsNameService = new DNSNameService();

        System.out.println(dnsNameService.getClass().getClassLoader());

    }

System ClassLoader被称为系统或应用类加载器，它负责在JVM启动时加载来自java命令的-classpath选项、java.class.path系统属性，或CLASSPATH环境变量所指定的JAR包和类径路。程序可以通过ClassLoader的静态方法getSystemClassLoader()来获取系统类加载器。如果没有特别指定，则用户自定义的类加载器都以系统类加载器作为父加载器。

    @Test

    public void SystemTest() throws Exception{

        // 获取当前类的实例对象

        ClassLoaderTest classLoaderTest = new ClassLoaderTest();

        System.out.println(classLoaderTest.getClass().getClassLoader());

    }

以下是JVM中4种类加载器的层次结构：

    @Test

    public void ClassLoaderTreeTest() throws Exception{

        // 获取当前类的类加载器

        ClassLoader classLoader = ClassLoaderTest.class.getClassLoader();

        // 判断类加载器是否为空

        while (classLoader != null) {

            // 打印当前类加载器的名称

            System.out.print(classLoader.getClass().getName()+"->");

            // 获取当前类加载器的父级

            classLoader = classLoader.getParent();

        }

        System.out.println(classLoader);

    }

上述代码中可以看出JVM中类加载器的层次结构。最后输出的是null的愿意是因为根类加载器并不是Java提供的，而是JVM提供的，所以不能获取。

3.3. 类加载机制

JVM的类加载器机制主要有如下三种：

全盘负责。所谓全盘负责，就是当一个类加载器负责加载某个Class时，该Class所依赖的和引用的其他Class也将由该类加载器负责载入，除非显式使用另外一个类加载器来载入。
父类委托。所谓父类委托，则是先让父类加载器视图加载该Class，只有在父类加载器无法加载该类时才尝试从自己的类路径中加载该类。
缓存机制。缓存机制将会保证所有加载过的Class都会被缓存，当程序中需要使用某个Class时，类加载器先从缓存区中搜索该Class，只有当缓存区中不存在该Class对象时，系统才会读取该类对应的二进制数据，并将其转换成Class对象，存入缓存区中。这也是为什么修改Class后，必须重新启动JVM，程序所做的修改才会生效的原因。

3.4. 自定义类加载器

JVM中除根类加载器之外的所有类加载器都是ClassLoader子类的实例，可以通过扩展ClassLoader的子类，并重写该ClassLoader提供的方法来实现自定义的类加载器。

ClassLoader类具有如下两个关键方法：

loadClass(String name, boolean resolve)：该方法为ClassLoader的入口点，根据指定名称来加载类，系统就是调用ClassLoader的该方法来获取指定类对应的Class对象。
findClass(String name)：根据指定名称来查找类。

由于loadClass()方法的执行步骤为1)利用findLoadedClass()方法来检查是否已经加载类。2)在父类加载器调用loadClass()方法。3)调用findClass()方法查找类。重写findClass()方法可以避免默认类加载器的父类委托和缓冲机制，这里推荐重写findClass()方法。

下面来实现一个文件系统类加载器，用于加载存储在文件系统上的Java字节代码。

public class FileSystemClassLoader extends ClassLoader {

    private String rootDir;

    public FileSystemClassLoader(String rootDir) {

        this.rootDir = rootDir;

    }

    protected Class<?> findClass(String name) throws ClassNotFoundException {

        byte[] classData = getClassData(name);

        if (classData == null) {

            throw new ClassNotFoundException();

        }

        else {

            return defineClass(name, classData, 0, classData.length);

        }

    }

    private byte[] getClassData(String className) {

        String path = classNameToPath(className);

        try {

            InputStream ins = new FileInputStream(path);

            ByteArrayOutputStream baos = new ByteArrayOutputStream();

            int bufferSize = 4096;

            byte[] buffer = new byte[bufferSize];

            int bytesNumRead = 0;

            while ((bytesNumRead = ins.read(buffer)) != -1) {

                baos.write(buffer, 0, bytesNumRead);

            }

return baos.toByteArray();

} catch (IOException e) {

e.printStackTrace();

}

return null;

}

private String classNameToPath(String className) {

return rootDir + File.separatorChar

+ className.replace('.', File.separatorChar) + ".class";

}

3.5. Tomcat类加载器

对于运行在 Java EE™容器中的 Web 应用来说，类加载器的实现方式与一般的 Java 应用有所不同。不同的 Web 容器的实现方式也会有所不同。以 Apache Tomcat 来说，每个 Web 应用都有一个对应的类加载器实例。该类加载器也使用代理模式，所不同的是它是首先尝试去加载某个类，如果找不到再代理给父类加载器。这与一般类加载器的顺序是相反的。这是 Java Servlet 规范中的推荐做法，其目的是使得 Web 应用自己的类的优先级高于 Web 容器提供的类。这种代理模式的一个例外是：Java 核心库的类是不在查找范围之内的。这也是为了保证 Java 核心库的类型安全。

绝大多数情况下，Web 应用的开发人员不需要考虑与类加载器相关的细节。下面给出几条简单的原则：

每个 Web 应用自己的 Java 类文件和使用的库的 jar 包，分别放在WEB-INF/classes和WEB-INF/lib目录下面。
多个应用共享的 Java 类文件和 jar 包，分别放在 Web 容器指定的由所有 Web 应用共享的目录下面。
当出现找不到类的错误时，检查当前类的类加载器和当前线程的上下文类加载器是否正确。

4. Servlet3.0新特性

4.1. 注解替代配置文件

需要注意的是，如果使用Servlet 3.0版本的话：首先Tomcat服务器必须使用7.0版本以上的（老版本不提供3.0版本），其次Eclipse创建Web工程时选择3.0版本。

Servlet 3.0版本允许使用注解方式来替代web.xml文件中配置Servlet、Filter和Listener的信息，首先回忆一下web.xml文件是如何配置Servlet、Filter和Listener的：

<?xml version="1.0" encoding="UTF-8"?>

<web-app version="3.0"

    xmlns="http://java.sun.com/xml/ns/javaee"

    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

    xsi:schemaLocation="http://java.sun.com/xml/ns/javaee

    http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd">

  <!-- 配置Servlet -->

  <servlet>

    <servlet-name>ServletTest</servlet-name>

    <servlet-class>app.java.servlet.ServletTest</servlet-class>

    <init-param>

        <param-name>longestory</param-name>

        <param-value>龙哥有话说</param-value>

    </init-param>

  </servlet>

  <servlet-mapping>

    <servlet-name>ServletTest</servlet-name>

    <url-pattern>/*</url-pattern>

  </servlet-mapping>

  <!-- 配置Filter -->

  <filter>

      <filter-name>FilterTest</filter-name>

      <filter-class>app.java.servlet.FilterTest</filter-class>

      <init-param>

        <param-name>longestory</param-name>

        <param-value>龙哥有话说</param-value>

    </init-param>

  </filter>

  <filter-mapping>

      <filter-name>FilterTest</filter-name>

      <url-pattern>/*</url-pattern>

  </filter-mapping>

  <!-- 配置Listener -->

  <listener>

      <listener-class>app.java.servlet.ListenerTest</listener-class>

  </listener>

</web-app>

使用注解替代web.xml文件配置Servlet。

@WebServlet(urlPatterns="/*",initParams={@WebInitParam(name="longestory",value="龙哥有话说")},loadOnStartup=0)

public class ServletTest extends HttpServlet {

    @Override

    protected void doGet(HttpServletRequest req, HttpServletResponse resp)

            throws ServletException, IOException {

        super.doGet(req, resp);

    }

}

使用注解替代web.xml文件配置Filter。

@WebFilter(urlPatterns="/*",initParams={@WebInitParam(name="longestory",value="龙哥有话说")})

public class FilterTest implements Filter {

    @Override

    public void init(FilterConfig arg0) throws ServletException {}

    @Override

    public void doFilter(ServletRequest arg0, ServletResponse arg1,

            FilterChain arg2) throws IOException, ServletException {

    }

    @Override

    public void destroy() {}

}

使用注解替代web.xml文件配置Listener。

@WebListener

public class ListenerTest implements HttpSessionListener {

    @Override

    public void sessionCreated(HttpSessionEvent arg0) {}

    @Override

    public void sessionDestroyed(HttpSessionEvent arg0) {}

}

4.2. Serlvet文件上传

Servlet 3.0的另一个新特性就是提供了处理文件上传的功能，使用Servlet 3.0的内容实现文件上传需要以下几个内容：

在处理文件上传的Servlet上增加@MultipartConfig注解，表示当前Servlet符合MIME类型的multipart/form-data。

Optional Element Summary
`int`	`fileSizeThreshold` The size threshold after which the file will be written to disk
`java.lang.String`	`location` The directory location where files will be stored
`long`	`maxFileSize` The maximum size allowed for uploaded files.
`long`	`maxRequestSize` The maximum size allowed for `multipart/form-data` requests

Part接口，表示允许接收MIME类型是multipart/form-data类型的POST请求。

Method Summary
`void`	`delete()` Deletes the underlying storage for a file item, including deleting any associated temporary disk file.
`java.lang.String`	`getContentType()` Gets the content type of this part.
`java.lang.String`	`getHeader(java.lang.String name)` Returns the value of the specified mime header as a `String`.
`java.util.Collection<java.lang.String>`	`getHeaderNames()` Gets the header names of this Part.
`java.util.Collection<java.lang.String>`	`getHeaders(java.lang.String name)` Gets the values of the Part header with the given name.
`java.io.InputStream`	`getInputStream()` Gets the content of this part as an `InputStream`
`java.lang.String`	`getName()` Gets the name of this part
`long`	`getSize()` Returns the size of this fille.
`void`	`write(java.lang.String fileName)` A convenience method to write this uploaded item to disk.

利用Servlet
3.0实现文件上传的功能，具体实现代码如下：

创建一个JSP页面用于文件上传显示。

<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%>

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">

<html>

  <head>

    <title>My JSP 'index.jsp' starting page</title>

  </head>

  <body>

    <form action="uploadFile" method="post" enctype="multipart/form-data">

        文件描述:<input type="text" name="filetext"><br>

        <input type="file" name="upload"><br>

        <input type="submit" value="上传">

    </form>

  </body>

</html>

创建一个Servlet用于处理文件上传逻辑。

@WebServlet(urlPatterns="/uploadFile")

@MultipartConfig(

fileSizeThreshold = 10 * 1024,//缓存大小，当上传的文件超出这个大小时会生成临时文件

location = "/temp",// 存放临时文件的目录

maxFileSize = 5 * 1024,// 单个文件大小限制

maxRequestSize = 10 * 1024// 整个请求大小限制

)

public class UploadFileServlet extends HttpServlet {

    @Override

    public void doPost(HttpServletRequest req, HttpServletResponse resp)

            throws ServletException, IOException {

        // 处理请求中文乱码

        req.setCharacterEncoding("utf-8");

        // 接收上传文件的描述内容

        String filetext = req.getParameter("filetext");

        // 接收上传文件的内容

        Part part = req.getPart("upload");

        // 获取上传文件的真实名称

        String cd = part.getHeader("Content-Disposition");

        int index = cd.indexOf("filename=\"") + 10;

        String filename = cd.substring(index, cd.length() - 1);

        // 读取上传目录的绝对路径

        String path = getServletContext().getRealPath("/upload");

        // 将上传文件进行保存

        part.write(path + "/" + filename);

    }

    @Override

    public void doGet(HttpServletRequest req, HttpServletResponse resp)

            throws ServletException, IOException {

        doPost(req, resp);

    }

}

4.3. Servlet异步处理

所谓异步处理就是指数据发送方发送数据给数据接收方后，不必等待数据接收方作出响应，可以继续发送下一个数据的通信方式。

Servlet 3.0版本提供了相关异步处理的功能，具体实现方式如下：

需要使用注解在对应Servlet配置asyncSupported=true，表示当前Servlet支持异步。
通过Request对象的startAsync(Request, Response)方法获取异步上下文对象。
通过异步上下文对象调用start(new Runnable(){})方法开始异步处理，Runnable类的run()方法提供具体异步的逻辑代码。

根据上述步骤，通过一个代码实例演示。

@WebServlet(urlPatterns="/async",asyncSupported=true)

public class AsyncServlet extends HttpServlet {

    @Override

    protected void doGet(HttpServletRequest req, final HttpServletResponse resp)

            throws ServletException, IOException {

        // 设置响应类型及编码格式

        resp.setContentType("text/html;charset=utf-8");

        resp.getWriter().print("马上开始：<br/>");

        // 刷新缓冲区

        resp.getWriter().flush();

        // 获取异步上下文对象

        final AsyncContext ac = req.startAsync(req, resp);

        // 开始异步处理

        ac.start(new Runnable() {

            @Override

            public void run() {

                try {

                    for (char ch = 'A'; ch <= 'Z'; ch++) {

                        resp.getWriter().print(ch);

                        resp.getWriter().flush();

                        Thread.sleep(250);

                    }

                    // 表示异步处理完毕

                    ac.complete();

                } catch (Exception e) {

                    throw new RuntimeException(e);

                }

            }

        });

    }

}

码农公寓