注解学习基础掌握与简单示例使用

Posted 2022-12-12 邹奇

tags:

篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了注解学习基础掌握与简单示例使用相关的知识，希望对你有一定的参考价值。

文章目录

背景
基础掌握
- 什么是注解
- 元注解
自定义注解示例
总结
参考链接

背景

记录学习！

适合未了解过注解的同学
适合有注解使用经历，想巩固加深理解知识点的同学

基础掌握

什么是注解

定义注解使用的关键字是 @interface。
注解是元数据的一种形式，源码中就很常见注解，故注解可以添加到代码中。比如说一个类、方法、参数、变量和包都可以添加注解。
注解对它们注解的代码的操作没有直接影响。
注解(Annotation)相当于一种标记，在程序中加入注解就等于为程序打上某种标记。（也就是说：javac 编译器、开发工具和其他程序可以通过反射来了解你的类及各种元素上有无何种标记，看你的程序有什么标记，就去干相应的事）

元注解

元注解就是用来定义注解的注解.其作用就是定义注解的作用范围, 使用在什么元素上等。

元注解有4种：

【@Retention】
保留的范围（即Annotation被保留的时间）。默认值 CLASS
SOURCE：只在源码中可用
CLASS：在源码和字节码中可用
RUNTIME：在源码、字节码和运行时均可用
【@Target】
用来修饰哪些程序元素。例如：TYPE、METHOD、FIELD等。
未标注则表示可以修饰所有
【@Inherited】
是否可以被继承，默认是 false
【@Documented】
是否会保存到 javadoc 文档中

在 android 开发中，Activity 中生命周期方法会用到 Override 注解，我们看下该注解的定义。该注解源码如下：

@Target(ElementType.METHOD)
@Retention(RetentionPolicy.SOURCE)
public @interface Override

这里可以看到，Override 注解是作用于方法，并在源码中使用的。

自定义注解示例

自定义 MyAnnotation 注解

代码如下：

/**
 *  自定义 MyAnnotation 注解
 *  该注解作用于方法
 *  该注解在代码运行时可用
 */

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

    // 属性定义 并指定了缺省值（注解的属性定义方式和接口中定义方法的方式一样）
    String hello() default "hello, world!";

其中 @Target(ElementType.METHOD) 表示该注解作用在方法上。

@Retention(RetentionPolicy.RUNTIME) 表示该注解在运行时可用。

hello 是该注解的属性。给注解添加属性的语法如下：

类型 属性名() default 默认值;

这是最简单的一个属性语法，还有其他一些更高级的语法同学们可以自行学习，这里不再细说。

使用 MyAnnotation 注解

自定义一个 Hello 类，新增一个 sayHello() 方法，在该方法上使用注解。代码如下：

public class Hello 

    public Hello() 
    

    // 使用 MyAnnotation 注解，给 hello 属性赋新值："hi, imxiaoqi"
    @MyAnnotation(hello = "hi, imxiaoqi")
    public void sayHello()
        System.out.println(":> Hello call method: sayHello()");

由上可知，在 sayHello() 方法上使用注解，并给 hello 属性赋新值。

解析 MyAnnotation 注解

Retention 的值为 RUNTIME ，故注解会保留到程序运行时, 因此我们可以使用反射来解析注解。解析代码如下：

@Override
    protected void onCreate(Bundle savedInstanceState) 
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        reflect();

    

	// 通过反射解析注解
    private void reflect() 
        
        try 
            Class<?> helloClass = Class.forName("com.example.annotationdemo.Hello");
            Method method = helloClass.getDeclaredMethod("sayHello", new Class[]);
            if (method.isAnnotationPresent(MyAnnotation.class))
                // 方法存在注解，则获取注解
                MyAnnotation annotation = method.getAnnotation(MyAnnotation.class);
                //  调用注解内容
                System.out.println(":> MyAnnotation content: " + annotation.hello());
            
         catch (Exception e) 
            e.printStackTrace();