Java注解在Android中必须学习的细节知识

前言

对于注解，相信你们都不陌生了，可是这种熟悉对于Android开发者来讲，也就是仅仅是它认识你，你不认识它吧，由于，咱们几乎都停留在用上了。像dagger2，像retrofit，像greenDao，他们都是满满的使用了注解，而咱们只是停留在知其然缺不知其因此然的层面，那么我本次分享讲分红几批博客共享给你们一个体系的又不失针对Android平台须要的恰到好处的给你们整理真正须要掌握的知识体系。面试

注解

注解的定义

Java 注解用于为 Java 代码提供元数据。做为元数据，注解不直接影响你的代码执行，但也有一些类型的注解实际上能够用于这一目的。Java 注解是从 Java5 开始添加到 Java 的。数组

注解即标签

若是把代码想象成一个具备生命的个体，注解就是给这些代码的某些个体打标签bash

如何自定义注解

注解经过 @interface关键字进行定义。

public @interface Test {
}复制代码

它的形式跟接口很相似，不过前面多了一个 @ 符号。上面的代码就建立了一个名字为 Test 的注解。微信

你能够简单理解为建立了一张名字为 Test的标签。markdown

使用注解

@Test
public class TestAnnotation {
}复制代码

建立一个类 TestAnnotation,而后在类定义的地方加上 @Test就能够用 Test注解这个类了架构

你能够简单理解为将 Test 这张标签贴到 TestAnnotation这个类上面。工具

元注解

元注解是能够注解到注解上的注解，或者说元注解是一种基本注解，可是它可以应用到其它的注解上面。spa

若是难于理解的话，你能够这样理解。元注解也是一张标签，可是它是一张特殊的标签，它的做用和目的就是给其余普通的标签进行解释说明的。code

元标签有 @Retention、@Documented、@Target、@Inherited、@Repeatable 5 种。orm

@Retention
Retention 的英文意为保留期的意思。当 @Retention 应用到一个注解上的时候，它解释说明了这个注解的的存活时间。
它的取值以下：

RetentionPolicy.SOURCE 注解只在源码阶段保留，在编译器进行编译时它将被丢弃忽视。
RetentionPolicy.CLASS 注解只被保留到编译进行的时候，它并不会被加载到 JVM 中。
RetentionPolicy.RUNTIME 注解能够保留到程序运行的时候，它会被加载进入到 JVM 中，因此在程序运行时能够获取到它们

@Target
Target 是目标的意思，@Target 指定了注解运用的地方
你能够这样理解，当一个注解被 @Target 注解时，这个注解就被限定了运用的场景。
类比到标签，本来标签是你想张贴到哪一个地方就到哪一个地方，可是由于 @Target 的存在，它张贴的地方就很是具体了，好比只能张贴到方法上、类上、方法参数上等等。@Target 有下面的取值

ElementType.ANNOTATION_TYPE 能够给一个注解进行注解
ElementType.CONSTRUCTOR 能够给构造方法进行注解
ElementType.FIELD 能够给属性进行注解
ElementType.LOCAL_VARIABLE 能够给局部变量进行注解
ElementType.METHOD 能够给方法进行注解
ElementType.PACKAGE 能够给一个包进行注解
ElementType.PARAMETER 能够给一个方法内的参数进行注解

@Documented
顾名思义，这个元注解确定是和文档有关。它的做用是可以将注解中的元素包含到 Javadoc 中去。ElementType.TYPE 能够给一个类型进行注解，好比类、接口、枚举
@Inherited
Inherited 是继承的意思，可是它并非说注解自己能够继承，而是说若是一个超类被 @Inherited 注解过的注解进行注解的话，那么若是它的子类没有被任何注解应用的话，那么这个子类就继承了超类的注解。
@Repeatable
Repeatable 天然是可重复的意思。@Repeatable 是 Java 1.8 才加进来的，因此算是一个新的特性。
什么样的注解会屡次应用呢？一般是注解的值能够同时取多个。

注解的属性

注解的属性也叫作成员变量。注解只有成员变量，没有方法。

须要注意的是，在注解中定义属性时它的类型必须是 8 种基本数据类型外加类、接口、注解及它们的数组

注解中属性能够有默认值，默认值须要用 default 关键值指定

@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
public @interface Test{
int id() default -1;
String msg() default "Hello";
}复制代码

上面代码定义了 TestAnnotation 这个注解中拥有 id 和 msg 两个属性。在使用的时候，咱们应该给它们进行赋值。

赋值的方式是在注解的括号内以 value="" 形式，多个属性以前用，隔开

@Test(id=1,msg="hello annotation")
public class TestAnnotation {
}复制代码

注解的提取

注解与反射。

注解经过反射获取。首先能够经过 Class 对象的 isAnnotationPresent() 方法判断它是否应用了某个注解

public boolean isAnnotationPresent(Class<? extends Annotation> annotationClass) {}复制代码

而后经过 getAnnotation() 方法来获取 Annotation 对象。

public <A extends Annotation> A getAnnotation(Class<A> annotationClass) {复制代码

或者是 getAnnotations() 方法。

public Annotation[] getAnnotations() {}复制代码

前一种方法返回指定类型的注解，后一种方法返回注解到这个元素上的全部注解。

若是获取到的 Annotation 若是不为 null，则就能够调用它们的属性方法了。好比

@Test()
public class TestDemo{
public static void main(String[] args) {
    boolean hasAnnotation =                  TestDemo.class.isAnnotationPresent(Test.class);
        if ( hasAnnotation ) {
            TestAnnotation testAnnotation =     TestDemo.class.getAnnotation(Test.class);
            System.out.println("id:"+testAnnotation.id());
            System.out.println("msg:"+testAnnotation.msg());
        }
    }
}复制代码

注解的使用场景

提供信息给编译器：编译器能够利用注解来探测错误和警告信息
编译阶段时的处理：软件工具能够用来利用注解信息来生成代码、Html文档或者作其它相应处理。
运行时的处理：某些注解能够在程序运行的时候接受代码的提取
值得注意的是，注解不是代码自己的一部分。

最后

读到这的朋友以为不错能够点赞关注下，感谢您的支持，之后会不停更新更多精选干货及资讯分享，欢迎你们在评论区留言讨论！

欢迎关注享学课堂online微信公众号，天天会持续更新技术干货，热点，吐槽等文章，还有免费的Android架构视频资料和面试专题资料免费领取分享，后台回复关键字【Android资料】，免费获取Android架构面试专题文档资料、电子书及更多架构进阶视频资料（视频+笔记）