文档章节

JAVA基础回顾-自定义注解

vzard
 vzard
发布于 2017/07/13 18:30
字数 1079
阅读 1
收藏 0

这篇博客我们来回顾一下Java基础中的注解,主要通过来自定义一套注解来回顾一下这块的知识。

下面先回顾一下基础知识:

四个元注解:

  • @Target
  • @Retention
  • @Documented
  • @Inherited

*具体说明: *

  • @Target @Target说明了Annotation所修饰的对象范围:Annotation可被用于 packages、types(类、接口、枚举、Annotation类型)、类型成员(方法、构造方法、成员变量、枚举值)、方法参数和本地变量(如循环变量、catch参数)。在Annotation类型的声明中使用了target可更加明晰其修饰的目标。

作用:用于描述注解的使用范围(即:被描述的注解可以用在什么地方)

取值(ElementType)有:   1. CONSTRUCTOR:用于描述构造器   2. FIELD:用于描述域   3. LOCAL_VARIABLE:用于描述局部变量   4. METHOD:用于描述方法   5. PACKAGE:用于描述包   6. PARAMETER:用于描述参数   7. TYPE:用于描述类、接口(包括注解类型) 或enum声明     

  • @Retention @Retention定义了该Annotation被保留的时间长短:某些Annotation仅出现在源代码中,而被编译器丢弃;而另一些却被编译在class文件中;编译在class文件中的Annotation可能会被虚拟机忽略,而另一些在class被装载时将被读取(请注意并不影响class的执行,因为Annotation与class在使用上是被分离的)。使用这个meta-Annotation可以对 Annotation的“生命周期”限制。

作用:表示需要在什么级别保存该注释信息,用于描述注解的生命周期(即:被描述的注解在什么范围内有效)

取值(RetentionPoicy)有:   1. SOURCE:在源文件中有效(即源文件保留)   2. CLASS:在class文件中有效(即class保留)   3. RUNTIME:在运行时有效(即运行时保留)

  • @Docmented @Documented用于描述其它类型的annotation应该被作为被标注的程序成员的公共API,因此可以被例如javadoc此类的工具文档化。Documented是一个标记注解,没有成员。

  • Inherited @Inherited 元注解是一个标记注解,@Inherited阐述了某个被标注的类型是被继承的。如果一个使用了@Inherited修饰的annotation类型被用于一个class,则这个annotation将被用于该class的子类。   注意:@Inherited annotation类型是被标注过的class的子类所继承。类并不从它所实现的接口继承annotation,方法并不从它所重载的方法继承annotation。   当@Inherited annotation类型标注的annotation的Retention是RetentionPolicy.RUNTIME,则反射API增强了这种继承性。如果我们使用java.lang.reflect去查询一个@Inherited annotation类型的annotation时,反射代码检查将展开工作:检查class和其父类,直到发现指定的annotation类型被发现,或者到达类继承结构的顶层。

自定义一套注解:

我们的目的是定义一套注解,可以通过注解来配置人的个人信息,包括姓名,性别,年龄。

  • 首先定义@Name,@Gender,@Age三个标签:
package annotation_learn;

import java.lang.annotation.*;

/**
 * 定义@Name注解
 * Created by V-zar on 2017/7/11.
 */


@Target(ElementType.FIELD)
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface Name {
    String value() default "";
}

package annotation_learn;

import java.lang.annotation.*;

/**
 * 定义@Gender注解
 * Created by V-zar on 2017/7/11.
 */


@Target(ElementType.FIELD)
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Inherited
public @interface Gender {

    public enum Sex{MALE,FEMALE};

    Sex value() default Sex.MALE;
}

package annotation_learn;

import java.lang.annotation.*;

/**
 * 定义@Age注解
 * Created by V-zar on 2017/7/11.
 */
@Target(ElementType.FIELD)
@Retention(RetentionPolicy.RUNTIME)
@Documented

public @interface Age {

    int value() default 0;
}

  • 其次定义一个注解处理类,不然注解不会比注释更有用:-)
package annotation_learn;

import java.lang.reflect.Field;

/**
 * 定义注解处理类
 * Created by V-zar on 2017/7/11.
 */
public class PersonInfoUtil {
    public static void getPersonInfo(Class<?> clazz){
        String strPersonName = "姓名:";
        String strPersonSex = "性别:";
        String strPersonAge = "年龄:";

        Field[] fileds = clazz.getDeclaredFields();

        for (Field filed : fileds){
            if(filed.isAnnotationPresent(Name.class)){
                Name name = (Name) filed.getAnnotation(Name.class);
                System.out.println(strPersonName+name.value()+"\n");
            }else if(filed.isAnnotationPresent(Gender.class)){
                Gender sex = (Gender) filed.getAnnotation(Gender.class);
                System.out.println(strPersonSex+sex.value()+"\n");

            }else if(filed.isAnnotationPresent(Age.class)){
                Age age = (Age) filed.getAnnotation(Age.class);
                System.out.println(strPersonAge+age.value()+"\n");
            }


        }



    }


}

  • 定义一个人物类来测试注解:
package annotation_learn;

/**
 * 定义人物类
 * Created by V-zar on 2017/7/11.
 */
public class Person {

    @Name("Jack")
    private String Name;
    @Gender(Gender.Sex.MALE)
    private String Sex;
    @Age(23)
    private int Age;
}

  • 运行测试主函数:
package annotation_learn;

/**
 * 测试用主函数
 * Created by V-zar on 2017/7/11.
 */
public class Runner {
    public static void main(String[] args) {
        PersonInfoUtil.getPersonInfo(Person.class);
    }
}

  • 运行结果:
姓名:Jack

性别:MALE

年龄:23


Process finished with exit code 0

自定义注解成功!

© 著作权归作者所有

vzard
粉丝 0
博文 1
码字总数 1079
作品 0
马鞍山
私信 提问
Spring Boot实战之基础回顾

本文作者: 吴伟祥 本文链接: https://wuweixiang.cn/2018/08/21/Spring-Boot实战之基础回顾/ 版权声明: 本博客所有文章除特别声明外均为原创,采用CC BY-NC-SA 4.0 许可协议。转载请在文章开...

吴伟祥
2018/08/21
70
0
轻量级 Java 框架 - JOxygen

JOxygen 轻量级Java框架 介绍 一个轻量级Java框架 oxygen-core 核心部分 基于cglib的aop实现 提供缓存管理和基于注解的缓存,内置LocalCache和Ehcache实现,可扩展 配置管理,支持${attrs.k...

justlive1
2018/11/13
1K
0
play2.0文档-面向java开发者(6)

Action composition Action组合 This chapter introduces several ways to define generic action functionality. 这章节介绍几个定义通用action功能的方式。 Reminder about actions actio......

老盖
2012/04/12
521
0
justlive1/oxygen

oxygen 轻量级Java框架 介绍 一个轻量级Java框架 oxygen-core 核心部分 基于cglib的aop实现 提供缓存管理和基于注解的缓存,内置LocalCache和Ehcache实现,可扩展 配置管理,支持${attrs.key...

justlive1
2018/10/08
0
0
Java面试无非也就这几个知识点,大家是否都掌握了

Java语言的关键点 掌握静态方法和属性 重视接口 学好集合框架 例外捕捉 多线程需要理解机理(多线程原理和多线程安全) 了解网络编程 不需要精通,掌握以下知识点,面试基本没有问题。 这里没有...

土豆宝
2016/08/22
9.5K
37

没有更多内容

加载失败,请刷新页面

加载更多

自定义ApiBoot Logging链路以及单元ID生成策略

ApiBoot Logging会为每一个请求都对应创建链路编号(TraceID)以及单元编号(SpanID),用于归类每一次请求日志,通过一个链路下日志单元的Parent SpanID可以进行上下级关系的梳理。 前文回顾...

恒宇少年
27分钟前
12
0
浅谈 Application 和 activity

对于 在 Application初始化一些变量,为什么不可以放在activity 或者其他的组件里呢? 这里就根据个人的理解来讲述一下,欢迎补充指正。 首先 activity 是以栈的形式出现,一个app应用会有多...

MrLins
27分钟前
11
0
Allegro的脚本文件内容里都有哪些

小伙伴们在使用Allegro的时候是否经常用到脚本文件夹呢?scr的用法其实可真不简单。。。 首先脚本文件的运行模式就存在很多种,比如不提示错误信息,不弹出确认对画框(这样很有利于我们执行...

demyar
28分钟前
21
0
微信升级外链管理规范,「砍一刀帮我加速」要被禁止了

原创: 蒋鸿昌 首发:「知晓程序」公众号 - 最好的微信新商业媒体 几天前,知名互联网评论人阑夕模仿皮尤研究中心(Pew Research Center)在美国做的互联网通识调查问卷,做了一份中文版问卷...

知晓云
29分钟前
16
0
CentOS 7接投影仪

我将一台安装着CentOS 7图形界面的惠普笔记本电脑当桌面使用。最近,想要连接投影仪时却遇到了问题。笔记本有一个HDMI接口。我买了一个HDMI---->VGA的转接线,连上笔记本电脑后,屏幕一直在闪...

大别阿郎
32分钟前
9
0

没有更多内容

加载失败,请刷新页面

加载更多

返回顶部
顶部