自定义注解之运行时注解(RetentionPolicy.RUNTIME)
对注解概念不了解的可以先看这个:Java注解基础概念总结
前面有提到注解按生命周期来划分可分为3类:
1、RetentionPolicy.SOURCE:注解只保留在源文件,当Java文件编译成class文件的时候,注解被遗弃;
2、RetentionPolicy.CLASS:注解被保留到class文件,但jvm加载class文件时候被遗弃,这是默认的生命周期;
3、RetentionPolicy.RUNTIME:注解不仅被保存到class文件中,jvm加载class文件之后,仍然存在;
这3个生命周期分别对应于:Java源文件(.java文件) ---> .class文件 ---> 内存中的字节码。
那怎么来选择合适的注解生命周期呢?
首先要明确生命周期长度 SOURCE < CLASS < RUNTIME ,所以前者能作用的地方后者一定也能作用。一般如果需要在运行时去动态获取注解信息,那只能用 RUNTIME 注解;如果要在编译时进行一些预处理操作,比如生成一些辅助代码(如 ButterKnife),就用 CLASS注解;如果只是做一些检查性的操作,比如 @Override
和 @SuppressWarnings,则可选用 SOURCE 注解。
下面来介绍下运行时注解的简单运用。
获取注解
你需要通过反射来获取运行时注解,可以从 Package、Class、Field、Method...上面获取,基本方法都一样,几个常见的方法如下:
- /**
- * 获取指定类型的注解
- */
- public <A extends Annotation> A getAnnotation(Class<A> annotationType);
- /**
- * 获取所有注解,如果有的话
- */
- public Annotation[] getAnnotations();
- /**
- * 获取所有注解,忽略继承的注解
- */
- public Annotation[] getDeclaredAnnotations();
- /**
- * 指定注解是否存在该元素上,如果有则返回true,否则false
- */
- public boolean isAnnotationPresent(Class<? extends Annotation> annotationType);
- /**
- * 获取Method中参数的所有注解
- */
- public Annotation[][] getParameterAnnotations();
要使用这些函数必须先通过反射获取到对应的元素:Class、Field、Method 等。
自定义注解
来看下自定义注解的简单使用方式,这里先定义3个运行时注解:
- // 适用类、接口(包括注解类型)或枚举
- @Retention(RetentionPolicy.RUNTIME)
- @Target(ElementType.TYPE)
- public @interface ClassInfo {
- String value();
- }
- // 适用field属性,也包括enum常量
- @Retention(RetentionPolicy.RUNTIME)
- @Target(ElementType.FIELD)
- public @interface FieldInfo {
- int[] value();
- }
- // 适用方法
- @Retention(RetentionPolicy.RUNTIME)
- @Target(ElementType.METHOD)
- public @interface MethodInfo {
- String name() default "long";
- String data();
- int age() default 27;
- }
这3个注解分别适用于不同的元素,并都带有不同的属性,在使用注解是需要设置这些属性值。
再定义一个测试类来使用这些注解:
- /**
- * 测试运行时注解
- */
- @ClassInfo("Test Class")
- public class TestRuntimeAnnotation {
- @FieldInfo(value = {1, 2})
- public String fieldInfo = "FiledInfo";
- @FieldInfo(value = {10086})
- public int i = 100;
- @MethodInfo(name = "BlueBird", data = "Big")
- public static String getMethodInfo() {
- return TestRuntimeAnnotation.class.getSimpleName();
- }
- }
使用还是很简单的,最后来看怎么在代码中获取注解信息:
- /**
- * 测试运行时注解
- */
- private void _testRuntimeAnnotation() {
- StringBuffer sb = new StringBuffer();
- Class<?> cls = TestRuntimeAnnotation.class;
- Constructor<?>[] constructors = cls.getConstructors();
- // 获取指定类型的注解
- sb.append("Class注解:").append("\n");
- ClassInfo classInfo = cls.getAnnotation(ClassInfo.class);
- if (classInfo != null) {
- sb.append(Modifier.toString(cls.getModifiers())).append(" ")
- .append(cls.getSimpleName()).append("\n");
- sb.append("注解值: ").append(classInfo.value()).append("\n\n");
- }
- sb.append("Field注解:").append("\n");
- Field[] fields = cls.getDeclaredFields();
- for (Field field : fields) {
- FieldInfo fieldInfo = field.getAnnotation(FieldInfo.class);
- if (fieldInfo != null) {
- sb.append(Modifier.toString(field.getModifiers())).append(" ")
- .append(field.getType().getSimpleName()).append(" ")
- .append(field.getName()).append("\n");
- sb.append("注解值: ").append(Arrays.toString(fieldInfo.value())).append("\n\n");
- }
- }
- sb.append("Method注解:").append("\n");
- Method[] methods = cls.getDeclaredMethods();
- for (Method method : methods) {
- MethodInfo methodInfo = method.getAnnotation(MethodInfo.class);
- if (methodInfo != null) {
- sb.append(Modifier.toString(method.getModifiers())).append(" ")
- .append(method.getReturnType().getSimpleName()).append(" ")
- .append(method.getName()).append("\n");
- sb.append("注解值: ").append("\n");
- sb.append("name: ").append(methodInfo.name()).append("\n");
- sb.append("data: ").append(methodInfo.data()).append("\n");
- sb.append("age: ").append(methodInfo.age()).append("\n");
- }
- }
- System.out.print(sb.toString());
- }
所做的操作都是通过反射获取对应元素,再获取元素上面的注解,最后得到注解的属性值。
看一下输出情况,这里我直接显示在手机上:
这个自定义运行时注解是很简单的例子,有很多优秀的开源项目都有使用运行时注解来处理问题,有兴趣可以找一些来研究。因为涉及到反射,所以运行时注解的效率多少会受到影响,现在很多的开源项目使用的是编译时注解,关于编译时注解后面再来详细介绍。
自定义注解之运行时注解(RetentionPolicy.RUNTIME)的更多相关文章
- Java 进阶巩固:什么是注解以及运行时注解的使用
这篇文章 2016年12月13日星期二 就写完了,当时想着等写完另外一篇关于自定义注解的一起发.结果没想到这一等就是半年多 - -. 有时候的确是这样啊,总想着等条件更好了再干,等准备完全了再开始,结 ...
- Android运行时注解
Android的注解有编译时注解和运行时注解,本文就介绍下运行时注解. 其实非常简单,直接上代码:本文主要是替代传统的findViewById()的功能,就是在我们Activity中不需要再使用fin ...
- [转帖]运行时库(runtime library)
运行时库(runtime library) https://blog.csdn.net/xitie8523/article/details/82712105 没学过这些东西 或者当时上课没听 又或者 ...
- Java中Error和Exception的异同以及运行时异常(Runtime exception)与检查型异常(checked exception)的区别
一:Error和Exception的基本概念: 首先Exception和Error都是继承于Throwable 类,在 Java 中只有 Throwable 类型的实例才可以被抛出(throw)或者捕 ...
- Android中的自定义注解(反射实现-运行时注解)
预备知识: Java注解基础 Java反射原理 Java动态代理 一.布局文件的注解 我们在Android开发的时候,总是会写到setContentView方法,为了避免每次都写重复的代码,我们需要使 ...
- ILBC 运行时 (ILBC Runtime) 架构
本文是 VMBC / D# 项目 的 系列文章, 有关 VMBC / D# , 见 <我发起并创立了一个 VMBC 的 子项目 D#>(以下简称 <D#>) https:// ...
- JAVA自定义注解 和 运行时靠 反射获取注解,解决 shiro 注解型权限因子获取问题
项目的权限分配,采用的是RBAC的设计模式.后台配置权限的时候,需要获取到所有的权限因子. 不经让我想起YII框架的SRBAC模块,还有以前的一个ecshop改造系统的权限配置方式,都采用的是PHP的 ...
- 使用编译时注解简单实现类似 ButterKnife 的效果
这篇文章是学习鸿洋前辈的 Android 如何编写基于编译时注解的项目 的笔记,用于记录我的学习收获. 读完本文你将了解: 什么是编译时注解 APT 编译时注解如何使用与编写 举个例子 思路 创建注解 ...
- Kotlin编译时注解,简单实现ButterKnife
ButterKnife在之前的Android开发中还是比较热门的工具,帮助Android开发者减少代码编写,而且看起来更加的舒适,于是简单实现一下ButterKnife,相信把下面的代码都搞懂,看Bu ...
随机推荐
- Android测试基础题(三)
今天接着给大家带来的是Android测试基础题(三). 需求:定义一个排序的方法,根据用户传入的double类型数组进行排序,并返回排序后的数组 俗话说的好:温故而知新,可以为师矣 packag ...
- crodova打包apk个人总结
1.安装nodejs 2.安装 cordova npm install -g cordova 3.安装Java JDK,官网下载地址 系统变量→新建 JAVA_HOME 变量 . 变量值填写jdk的安 ...
- nodejs异步处理
采用Async.Q.Promise等第三方库处理异步回调 Async 安装 npm install async --save-dev
- 了解一下C++输入和输出的概念
我们经常用到的输入和输出,都是以终端为对象的,即从键盘输入数据,运行结果输出到显示器屏幕上.从操作系统的角度看,每一个与主机相连的输入输出设备都被看作一个文件.除了以终端为对象进行输入和输出外,还经常 ...
- phpcms首页实现轮播图
1.在你想要加轮播图的位置加入以下 <div id="flowDiagram" > <div id="button"> <span ...
- MS10-087微软OFFICE漏洞【参考拿机模拟】
[声明:以下测试仅仅为了学习用途,模仿尝试与博主无关] 工 具:metasploit 目标机:windows xp sp3 步骤: 1.使用msf创建特殊代码的doc文档 命令: msfconso ...
- 【先定一个小目标】Redis 安装成windows服务-开机自启
1.第一步安装成windows服务的,开机自启动 redis-server --service-install redis.windows.conf 2.启动\关闭 redis-server --se ...
- 关于HTML5本地缓存技术LocalStorage 本地存储 和 SessionStorage
如果你想在用户访问的时候记录或者记住他们的行为,你会想到的是什么,cookie 和session.但今天告诉你还有两种或者说是1种吧 那就是html5的 LocalStorage 本地存储和 Sess ...
- Unity3D Editor 扩展
官方教程:链接 EditorLayout API:链接 Handles API:链接 1.首先来个Inspector面板Editor的实现 要实现一个组件在Inspector中的Editor功能,首先 ...
- Java面试常见问题汇总
1 String,StringBuffer与StringBuilder的区别?? String 字符串常量StringBuffer 字符串变量(线程安全)StringBuilder 字符串变量(非 ...