No_0616 Java进阶学习——Java注解学习_jdk1.6 自定义注解,在方法上使用-CSDN博客

本文链接：https://blog.csdn.net/lutianfeiml/article/details/51697008

文档版本	开发工具	测试平台	工程名字	日期	作者	备注
V1.0				2016.06.16	lutianfei	none

注解

什么是注解，它有什么作用?
- @xxx就是一个注解。
注释:它是用于描述当前代码功能，是给程序员使用的。
注解：它是描述程序如果运行，是给编译器，解释器，jvm使用。
jdk中自带三个注解
1.@Override :是给编译器使用，用于描述当前的方法是一个重写的方法。
- 注意:在jdk1.5与jdk1.6中有区别
- jdk1.5中@Override它只能描述继承中的重写.
- jdk1.6中@Override它不仅能描述继承中的重写，还可以描述实现中的重写
2.@Deprecated : 用于描述方法过时。
方法什么时候过时?
- 1.有新的版本的方法替换旧版本方法。
- 2.在旧的版本中存在安全隐患的方法
3.`@SuppressWarning : 去除程序中的警告信息,常用属性如下：
- unused 变量未使用
- deprecation 使用了不赞成使用的类或方法时的警告
- unchecked 执行了未检查的转换时的警告，例如当使用集合时没有用泛型 (Generics) 来指定集合保存的类型。
- fallthrough 当 Switch 程序块直接通往下一种情况而没有 Break 时的警告。
- path 在类路径、源文件路径等中有不存在的路径时的警告。?
- serial 当在可序列化的类上缺少 serialVersionUID 定义时的警告。?
- finally 任何 finally 子句不能正常完成时的警告。
- all 关于以上所有情况的警告。

定义注解

1.定义注解
- @interface 名称 : 就定义了一个注解，要想使用在类，方法，属性上直接 @名称.
问题:@interface 名称,是声明了一个注解，它的本质是什么?
- @Myannotation的本质

    import java.lang.annotation.Annotation;
    interface MyAnnotation extends Annotation
    {
    }

注解的本质就是一个接口，它继承了Annotation接口。
所的的注解都实现了这个接口，但是，不能手动实现。
注解是jdk1.5的新特性.

注解中的成员

接口中的成员:
- 属性 : public static final
- 方法 : public abstract
注解成员
- 1.可以有属性
  - 注解中可以有属性，但是基本不使用。
- 2.可以有方法
  - 在开发中，一般使用注解时，只研究它的方法，我们一般管它叫做注解中的属性.
1.关于注解中的属性（方法）的类型问题（返回值）
它的类型只能是以下几种:
- 1.基本类型
  - 整型:byte short int long
  - 浮点:float double
  - 字符:char
  - 逻辑:boolean
- 2.String
- 3.Class
- 4.enum
- 5.Annotation
- 6.以上类型的一维数组。
2.关于注解中有属性，使用的问题
- 如果一个注解中有属性，并且属性没有默认值，那么我们在使用注解时，必须给注解的属性赋值.
关于属性赋值方式:
- 1.默认值问题
  - String st() default "abc";
- 2.如果是单值 :注解 (属性名称=值)
  - 例如:@MyAnnotation3(i=1)
- 3.如果是数组
  - 1.如果只赋一个值 注解(属性名称=值)
    - 例如:@MyAnnotation3(i=1)
  - 2.如果要赋多个值 注解(属性名称={值1,值2,…})
    - 例如:@MyAnnotation3(i={1,2,3})
- 4.关于属性名称value问题
  - 可以省略属性名称
  - 例如 @MyAnnotation3("hello");
  - 如果value属性是一个数组: @MyAnnotation3({"a","b"})
  - 如果注解中有value属性，还有其它属性: 那么value属性名称不能在省略.

元注解 — 修饰注解的注解

1.@Retention
- 作用:是指定注解给谁使用.
- 它的属性值只能是以下三个
  - RetentionPolicy.SOURCE : 给编译器使用使用后抛弃
  - RetentionPolicy.CLASS : 给解析器使用。当jvm加载完成后，就抛弃.
  - RetentionPolicy.RUNTIME : 给程序员使用，jvm加载完成后，还存在。开发人员可以通过反射来获取注解相关信息.
- 2.@Target
- 作用:就是定义注解在什么位置使用
- 指定注解修饰目标对象类型 TYPE 类、接口 FIELD 成员变量 METHOD 方法
3.@Documented
- 作用:是通过javadoc生成的文档中是否抽取注解描述.
4.@Inherited
- 作用:是描述当前注解是否具有继承性
想要开发，有功能的注解，对于程序员，一定会使用的元注解是:
- @Retention
- @Target

注解案例—银行最大转账金额

目的:
- 1.怎样通过反射来操作注解
- 2.注解可以替换配置文件。
代码实现:
- 1.将银行最大转账金额，定义在配置文件中，使用时，直接从配置文件中读取.
- 2.使用注解来替换配置文件。
流程如下：
1.定义一个注解(BankInfo.java)

@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.METHOD)
public @interface BankInfo {

    int maxMoney();
}

2.通过反射来获取注解信息
- 1.获取当前方法的Method对象。
  - 1.得到Class对象
    - 1.类名.class
    - 2.对象.getClass()
    - 3.Class.forName(String className);
  - 2.得到Method对象
    - Class.getDeclaredMethod(String methodName,Class…paramClass);
- 2.在Method类中有一个 getAnnotation(Class annotationClass)，可以获取一个注解对象.
- 3.通过注解对象来调用其属性.
eg:

// name1向name2转账money元--使用注解
    @BankInfo(maxMoney = 100000)
    public void account(String name1, String name2, int money)
            throws NoSuchMethodException, SecurityException {

        // 1.获取当前方法的Method对象。

        // 1.1 获取当前类的Class对象
        Class clazz = this.getClass();

        // 1.2 获取当前方法的Method对象.
        Method method = clazz.getDeclaredMethod("account", String.class,
                String.class, int.class);

        boolean flag = method.isAnnotationPresent(BankInfo.class); // 判断当前方法上是否有BankInfo这个注解.
        if (flag) {
            // 2.在Method类中有一个 getAnnotation(Class annotationClass)，可以获取一个注解对象.
            BankInfo bif = method.getAnnotation(BankInfo.class);

            // 3.通过注解对象来调用其属性.
            int maxMoney = bif.maxMoney();

            if (money > maxMoney) {
                throw new RuntimeException("最大转账金额为:" + maxMoney + "元");
            }

            System.out.println(name1 + "向" + name2 + "转账:" + money + "元");
        }
    }

注解可以替换配置文件，替换的是什么?
- 配置文件的出现，它的主要目的就是解耦合。但是随着现在开发程序越来越庞大，配置文件的缺点就出现了，配置文件内容越来越庞大，就不利于我们开发与阅读.这时就出现了注解，因为注解可以直接写在代码上，并且，通过注解也可以解耦合。

注解示例2–jdbc连接

数据库建立：

create table products(
   id int primary key auto_increment,
   name varchar(40),
   price double
);

insert into products values(null,'冰箱',3000);
insert into products values(null,'洗衣机',2000);
insert into products values(null,'电视',5000);

JdbcInfo.java

@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.METHOD)
public @interface JdbcInfo {

    String driverClassName();
    String url();
    String username();
    String password();
}

JdbcUtils.java

@JdbcInfo(driverClassName = "com.mysql.jdbc.Driver", url = "jdbc:mysql:///day24", username = "root", password = "abc")
    public static Connection getConnectionByAnnotation(String[] args) throws Exception {

        System.out.println(Arrays.toString(args));
        // 得到当前方法上的注解JdbcInfo
        Method method = JdbcUtils.class
                .getDeclaredMethod("getConnectionByAnnotation",String[].class);
        JdbcInfo jif = method.getAnnotation(JdbcInfo.class);

        String driverClassName = jif.driverClassName();
        String url = jif.url();
        String username = jif.username();
        String password = jif.password();
        // 1.加载驱动
        Class.forName(driverClassName);
        // 2.获取连接
        Connection con = DriverManager.getConnection(url, username, password);

        return con;
    }