首页 > 代码库 > JDK1.5新特性之注解

JDK1.5新特性之注解

 

时间:2017-1-2 20:14

 

——注解的概述

    注释是给人看的,而注解是给程序(框架)看的。
    在Servlet3.0中可以使用注解来替代配置文件,开发者就不用再写配置文件了,而是写注解,然后Tomcat来读取注解。

    注解也是类,需要定义了才能使用。
    在Servlet3.0中又一个注解类是@WebServlet,然后我们就可以在Servlet中使用@WebServlet这个注解了,这个朱姐就是用来替代<servlet>,然后Tomcat会通过反射来读取注解中的信息。

 
——Java中的注解
 
    *   @Overrid:作用在方法上的注解,当方法不是重写父类的方法时会报错。
    *   @Deprecated:作用在方法上,标记该方法为作废方法(已过时)。
    *   @SuppressWarnings:作用在方法上,压制警告。
 
——定义注解类

    定义注解类不能使用class、enum和interface,而是使用@interface

    >   public @interface MyAnn{ }

——使用注解目标

    所有注解都是Annotation的子类。

    注解可以作用在:类(接口或枚举)、属性、方法、构造器、包、参数、局部变量

    *   定义注解类:框架的工作
    *   使用注解:我们的工作
    *   读取注解(反射):框架的工作

——注解的定义

    *   定义属性
        >   格式:类型 属性名()
        @interface MyAnno1{
            String name();
            int age();
        }

    *   使用注解时给属性赋值
        >   @MyAnno(name="zhangsan", age=20)

    *   注解属性的默认值
        >   int age() default 100;
        >   在使用注解时,可以不给带有默认值的属性赋值。

    *   名为value的属性的特权
        >   在使用注解时,如果只给名为value的属性赋值,那么可以不给出属性的名称而直接赋值,当存在其他属性时,必须加上“value=http://www.mamicode.com/”。
        >   @MyAnno("zhangsan"):表示给value="http://www.mamicode.com/zhangsan"赋值。

    *   注解属性的类型
        >   8种基本类型
        >   String类型
        >   枚举类型
        >   Class类型
        >   注解类型
        >   以上类型的一维数组类型

        >   定义:
            @MyAnno1{
                int a();
                String b();
                MyEnum c();
                Class d();
                MyAnno2 e();
                String f();
            }

        >   使用:
            @MyAnno1(
                a=100,
                b="zhangsan",
                c=MyEnum.option,
                d=String.class,
                e=@MyAnno2(age=20,name="zhangsan"),
                f={"123", "456"}
            )

——注解的作用目标限定以及保存策略限定

1、目标限定
    让一个注解的作用目标只能在类上,而不能在方法上,这就叫作用目标的限定。

    在定义注解时,给注解添加注解,这个注解时@Target
    Target注解有一个属性:ElementType[] value(),这个属性是一个枚举类型。

    使用方法:
        @Target(value=http://www.mamicode.com/{ElementType.TYPE, ElementType.METHOD, ElementType/FIELD})
        @interface MyAnno{ }

2、保留策略
    *   源代码文件(SOURCE)
        >   注解只在源代码中存在,当编译时就被忽略了(不能被反射)

    *   字节码文件(CLASS)
        >   注解在源代码中存在,编译时会把注解信息放到class文件中,但JVM在加载类时,会忽略注解。

    *   JVM中(RUNTIME)
        >   注解在源代码、字节码文件中存在,并且在JVM加载类时,会把注解加载到JVM内存中(它是唯一可以反射的注解)

    限定注解的保留策略:
        使用RetentionPolicy注解:
            @Retention(RetentionPolicy.RUNTIME)

——读取注解(反射)

1、要求:
    注解的保留策略必须是RUNTIME

2、反射注解需要从作用目标上反射
    *   类上的注解,需要使用Class来获取
    *   方法上的注解,需要用Method来返回
    *   构造器上的注解,需要用Constructor来获取
    *   成员上的注解,需要用Field来获取

Class类方法概要:
    <T extends Annotation>  getAnnotation(Class<A> annotationClass)
        如果存在该元素的指定类型的注解,则返回这些注解,否则返回null。

    Annotation[]  getAnnotations()
        返回此元素上存在的所有注解。


Method、Field、Constructor:
    这三个类都是AccessibleObject的子类。 

AccessibleObject类方法概要:
    <T extends Annotation>  getAnnotation(Class<T> annotationClass)
        如果存在该元素的指定类型的注解,则返回这些注解,否则返回null。

    Annotation[]  getAnnotations()
        返回此元素上存在的所有注解。

    Annotation[]  getDeclaredAnnotations()
        返回直接存在于此元素上的所有注解。

示例代码:
 
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.reflect.Field;
 
import org.junit.Test;
 
public class Demo {
    @Test
    public void fun1() {
        /*
         * 1、得到作用目标
         */
        Class<A> c = A.class;
        /*
         * 2、获取指定类型的注解
         */
        MyAnno1 myAnno1 = c.getAnnotation(MyAnno1.class);
 
        System.out.println(myAnno1.name() + ", " + myAnno1.age());
    }
 
    @Test
    public void fun2() throws Exception {
        /*
         * 1、得到作用目标
         */
        Class<A> c = A.class;
        // Field权限必须为public
        Field field = c.getField("name");
 
        /*
         * 2、获取指定类型的注解
         */
        MyAnno1 myAnno1 = field.getAnnotation(MyAnno1.class);
        System.out.println(myAnno1.name() + ", " + myAnno1.age());
    }
}
 
@MyAnno1(name = "zhangsan", age = 20)
class A {
    @MyAnno1(name = "lisi", age = 21)
    public String name;
 
}
 
@Retention(RetentionPolicy.RUNTIME)
@interface MyAnno1 {
    String name();
    int age();
}
 
——反射泛型信息

    public Type getGenericSuperclass()
        返回表示此Class所表示的实体(类、接口、基本类型或void)的直接父类的Type。
        获取传递给父类的泛型信息。
        返回的类型是Type接口的子接口:ParameterizedType(参数化类型) == A<String>

    1、子类:得到当前类的Class对象:this.getClass()
    2、Class:得到当前类父类的参数化类型(A<String, Integer...>):Type  getGenericSuperclass(),因为返回值是ParameterizedType,所以需要强制类型转换。
    3、ParameterizedType:得到所有的类型参数<String, Integer...>:Type[]  getActualTypeArguments()
 
示例代码:

package demo2;
 
import java.lang.reflect.ParameterizedType;
import java.lang.reflect.Type;
 
import org.junit.Test;
 
public class Demo1 {
    @Test
    public void fun() {
        new B();
        new C();
    }
}
 
abstract class A<T> {
    public A() {
        /*
         * 在这里获取子类传递的泛型信息,得到一个Class对象
         */
 
        Class c = this.getClass(); // 得到子类的类型
 
        // 得到的type就是A<String>
        Type type = c.getGenericSuperclass();
 
        // 因为type的类型是ParameterizedType,所以需要强转
        ParameterizedType pType = (ParameterizedType) type;
 
        // 获取类参数,得到的是一个数组<String, Integer...>
        Type[] types = pType.getActualTypeArguments();
 
        // 得到String
        Class c2 = (Class) types[0];
 
        System.out.println(c2); // String或者Integer
 
        // 简写
        Class c3 = (Class) ((ParameterizedType) this.getClass().getGenericSuperclass()).getActualTypeArguments()[0];

        System.out.println(c3);
    }
}
 
class B extends A<String> {
 
}
 
class C extends A<Integer> {
 
}  
 
 

——反射泛型和反射注解的应用案例


User类:

package demo2;
 
@Table("tb_user") // 它的值表示当前类所对应的表
public class User {
    @ID("u_id") // 表示当前属性对应的列名,而且说明这个字段是主键字段
    private String uid;
    @Column("username")
    private String username;
    @Column("password")
    private String password;

    @Test
    public void fun(){
        Class<User> c = User.class;
        Table a = c.getAnnotation(Table.class);
        System.out.println(a.value());
 
  Field f = c.getDeclaredField("uid");
  f.setAccessible(true);
  ID id = f.getAnnotation(ID.class);
  System.out.println(id.value());
    } 
}
----------------------------------------------------------------------------------------------------------------------------

Table注解:

package demo2;
@Retention(RetentionPolicy.RUNTIME)
public @interface Table {
    String value();
}
 


----------------------------------------------------------------------------------------------------------------------------

ID注解:

package demo2;
@Retention(RetentionPolicy.RUNTIME)
public @interface ID {
    String value();
}


----------------------------------------------------------------------------------------------------------------------------

Column注解:

package demo2;
@Retention(RetentionPolicy.RUNTIME)
public @interface Column {
    String value();
}
 
----------------------------------------------------------------------------------------------------------------------------

BaseDAO:

package demo2;
 
import java.lang.reflect.Field;
import java.lang.reflect.ParameterizedType;
import java.util.List;

-------------------------

public class Demo2 {
    private QueryRunner qr = new TxQueryRunner();
 
    /*
     * 使用dbutils
     */
    public void addUser(User user) {
        String sql = "";
        Object[] params = {};
        qr.update(sql, params);
    }
 
    public void addCustomer(Customer customer) {
        String sql = "";
        Object[] params;
        qr.update(sql, params);
    }
}

-------------------------

/**
 * 因为普通DAO有许多重复的工作
 * 所以可以考虑编写一个BaseDAO来完成重复操作
 * 功能与BaseServlet相似。
 * @author WYC
 *
 * @param <T>
 */
class BaseDAO<T> {
    private QueryRunner qr = new TxQueryRunner();
    private Class<T> beanClass;
    private int length;
 
    public BaseDAO() {
        // 获取泛型参数,用于获得表名
        this.beanClass = (Class) ((ParameterizedType) this.getClass().getGenericSuperclass()).getActualTypeArguments()[0];
 
        // 获取属性个数,用于获得参数个数、参数值、参数列名
        Field[] fields = beanClass.getDeclaredFields();
        this.length = fields.length;
 
    }
 
    public void add(T bean) {
        // 可以将表名作为注解配置到类上,然后通过反射注解来获取配置的表名信息
        String sql = "insert into " + beanClass.getSimpleName() + " values(";
 
        // 指定参数个数
        for (int i = 0; i < this.length; i++) {
            if (i == length - 1) {
                sql += "?)";
            } else {
                sql += "?,";
            }
        }
 
        // 可以通过反射Field来获取参数值
        Object[] params = {/* 参数值是什么 */};
        qr.update(sql, params);
    }
 
    public void update(T bean) {
 
    }
 
    public void delete(String uuid) {
 
    }
 
    public T load(String uuid) {
        return null;
    }
 
    public List<T> findAll() {
        return null;
    }
}

-------------------------

class UserDAO extends BaseDAO<User> {
    public void addUser(User user) {
        super.add(user);
    }

JDK1.5新特性之注解