详解Java中的注解
在Java中,注解(Annotation)引入始于Java5,用来描述Java代码的元信息,通常情况下注解不会直接影响代码的执行,尽管有些注解可以用来做到影响代码执行。
注解可以做什么
Java中的注解通常扮演以下角色
- 编译器指令
- 构建时指令
- 运行时指令
其中
- Java内置了三种编译器指令,本文后面部分会重点介绍
- Java注解可以应用在构建时,即当你构建你的项目时。构建过程包括生成源码,编译源码,生成xml文件,打包编译的源码和文件到JAR包等。软件的构建通常使用诸如Apache Ant和Maven这种工具自动完成。这些构建工具会依照特定的注解扫描Java代码,然后根据这些注解生成源码或文件。
- 通常情况下,注解并不会出现在编译后的代码中,但是如果想要出现也是可以的。Java支持运行时的注解,使用Java的反射我们可以访问到这些注解,运行时的注解的目的通常是提供给程序和第三方API一些指令。
注解基础
一个简单的Java注解类似与@Entity
。其中@
的意思是告诉编译器这是一个注解。而Entity
则是注解的名字。通常在文件中,写法如下
public @interface Entity { }
|
注解元素
Java注解可以使用元素来进行设置一些值,注解中的元素类似于属性或者参数。定义包含元素的注解示例代码
public @interface Entity { String tableName();}
|
使用包含元素的注解示例代码
@Entity(tableName = "vehicles")
|
上述注解的元素名称为tableName
,设置的值为vehicles
。没有元素的注解不需要使用括号。
如果注解包含多个元素,使用方法如下
@Entity(tableName = "vehicles", primaryKey = "id")
|
如果注解只有一个元素,通常我们的写法是这样的
@InsertNew(value = "yes")
|
但是这种情况下,当且仅当元素名为value,我们也可以简写,即不需要填写元素名value
,效果如下
@InsertNew("yes")
|
注解使用
注解可以用来修饰代码中的这些元素
- 类
- 接口
- 方法
- 方法参数
- 属性
- 局部变量
一个完整的使用示例如下
@Entitypublic class Vehicle {
@Persistent protected
StringvehicleName = null;
@Getter public String getVehicleName() {
return this.vehicleName;
} public void setVehicleName(@OptionalvehicleName) {
this.vehicleName = vehicleName;}
public ListaddVehicleNameToList(List names) {@OptionalList localNames =names; if(localNames == null) {localNames = new ArrayList(); }localNames.add(getVehicleName());return localNames; }
}
内置的Java注解
Java中有三种内置注解,这些注解用来为编译器提供指令。它们是
- @Deprecated
- @Override
- @SuppressWarnings
@Deprecated
- 可以用来标记类,方法,属性。
- 如果上述三种元素不再使用,使用@Deprecated注解
- 如果代码使用了@Deprecated注解的类,方法或属性,编译器会进行警告。
@Deprecated使用很简单,如下为注解一个弃用的类。
@Deprecatedpublic class MyComponent {}
//当我们使用@Deprecated注解后,建议配合使用对应的@deprecated JavaDoc符号,并解释说明为什么这个类,方法或属性被弃用,已经替代方案是什么。
@Deprecated
/** @deprecated This class is full of bugs. Use MyNewComponent instead.*/
public class MyComponent {}
@Override
@Override注解用来修饰对父类进行重写的方法。如果一个并非重写父类的方法使用这个注解,编译器将提示错误。
实际上在子类中重写父类或接口的方法,@Overide并不是必须的。但是还是建议使用这个注解,在某些情况下,假设你修改了父类的方法的名字,那么之前重写的子类方法将不再属于重写,如果没有@Overide,你将不会察觉到这个子类的方法。有了这个注解修饰,编译器则会提示你这些信息。
使用Override注解的例子
public class MySuperClass
{ public void doTheThing() {System.out.println("Do the thing"); }
}
public class MySubClassextends MySuperClass{ @Override public void doTheThing() {System.out.println("Do it differently"); }
}
@SuppressWarnings
- @SuppressWarnings用来抑制编译器生成警告信息。
- 可以修饰的元素为类,方法,方法参数,属性,局部变量
使用场景:当我们一个方法调用了弃用的方法或者进行不安全的类型转换,编译器会生成警告。我们可以为这个方法增加@SuppressWarnings注解,来抑制编译器生成警告。
注意:使用@SuppressWarnings注解,采用就近原则,比如一个方法出现警告,我们尽量使用@SuppressWarnings注解这个方法,而不是注解方法所在的类。虽然两个都能抑制编译器生成警告,但是范围越小越好,因为范围大了,不利于我们发现该类下其他方法的警告信息。
使用示例
@SuppressWarningspublic void methodWithWarning() {}
创建自己的注解
在Java中,我们可以创建自己的注解,注解和类,接口文件一样定义在自己的文件里面。如下
@interface MyAnnotation { String value(); String name(); intage(); String[] newNames();}
上述代码定义了一个叫做MyAnnotation的注解,它有4个元素。再次强调一下,@interface
这个关键字用来告诉java编译器这是一个注解。
仔细一看,你会发现,注解元素的定义很类似于接口的方法。这些元素有类型和名称。这些类型可以是
- 原始数据类型
- String
- Class
- annotation
- 枚举
- 一维数组
如下为应用自定义的注解
@MyAnnotation( value="123", name="Jakob", age=37, newNames={"Jenkov", "Peterson"})public class MyClass {}
注意,我们需要为所有的注解元素设置值,一个都不能少。
注解元素默认值
对于注解中的元素,我们可以为其设置默认值,使用方法为
@interface MyAnnotation { String value() default ""; Stringname(); int age(); String[] newNames();}
上述代码,我们设置了value元素的默认值为空字符串。当我们在使用时,可以不设置value的值,即让value使用空字符串默认值。 使用示例代码
@MyAnnotation( name="Jakob", age=37, newNames={"Jenkov","Peterson"})public class MyClass {}
@Retention
@Retention是用来修饰注解的注解,使用这个注解,我们可以做到
- 控制注解是否写入class文件
- 控制class文件中的注解是否在运行时可见
控制很简单,使用使用以下三种策略之一即可。
- RetentionPolicy.SOURCE 表明注解仅存在源码之中,不存在.class文件,更不能运行时可见。常见的注解为@Override, @SuppressWarnings。
- RetentionPolicy.CLASS 这是默认的注解保留策略。这种策略下,注解将存在与.class文件,但是不能被运行时访问。通常这种注解策略用来处于一些字节码级别的操作。
- RetentionPolicy.RUNTIME 这种策略下可以被运行时访问到。通常情况下,我们都会结合反射来做一些事情。
@Retention的使用示例
import java.lang.annotation.Retention;
importjava.lang.annotation.RetentionPolicy;
@Retention(RetentionPolicy.RUNTIME)
@interfaceMyAnnotation { String value() default "";
}
@Target
使用@Target注解,我们可以设定自定义注解可以修饰哪些java元素。简单示例
import java.lang.annotation.ElementType;
importjava.lang.annotation.Target;
@Target({ElementType.METHOD})public@interface MyAnnotation {
String value();
}
上述的代码说明MyAnnotation注解只能修饰方法。
@Target可以选择的参数值有如下这些
- ElementType.ANNOTATION_TYPE(注:修饰注解)
- ElementType.CONSTRUCTOR
- ElementType.FIELD
- ElementType.LOCAL_VARIABLE
- ElementType.METHOD
- ElementType.PACKAGE
- ElementType.PARAMETER
- ElementType.TYPE(注:任何类型,即上面的的类型都可以修饰)
@Inherited
如果你想让一个类和它的子类都包含某个注解,就可以使用@Inherited来修饰这个注解。
java.lang.annotation.Inherited@Inheritedpublic @interfaceMyAnnotation {}@MyAnnotationpublic class MySuperClass { ... }public class MySubClass extends MySuperClass { ... }
上述代码的大致意思是
- 使用@Inherited修饰注解MyAnnotation
- 使用MyAnnotation注解MySuperClass
- 实现一个类MySubclass继承自MySuperClass
通过以上几步,MySubClass也拥有了MyAnnotation注解。
详解Java中的注解相关推荐
- 【java】详解java中的注解(Annotation)
目录结构: contents structure [+] 什么是注解 为什么要使用注解 基本语法 4种基本元注解 重复注解 使用注解 运行时处理的注解 编译时处理的注解 1.什么是注解 用一个词就可以 ...
- java 死锁 内存消耗_详解Java中synchronized关键字的死锁和内存占用问题
先看一段synchronized 的详解: synchronized 是 java语言的关键字,当它用来修饰一个方法或者一个代码块的时候,能够保证在同一时刻最多只有一个线程执行该段代码. 一.当两个并 ...
- java lock unlock_详解Java中的ReentrantLock锁
ReentrantLock锁 ReentrantLock是Java中常用的锁,属于乐观锁类型,多线程并发情况下.能保证共享数据安全性,线程间有序性 ReentrantLock通过原子操作和阻塞实现锁原 ...
- java comparator相等_详解Java中Comparable和Comparator接口的区别
详解Java中Comparable和Comparator接口的区别 发布于 2020-7-20| 复制链接 摘记: 详解Java中Comparable和Comparator接口的区别本文要来详细分析一 ...
- java object数组转实体类_详解Java中String JSONObject JSONArray List实体类转换
JSON使用阿里的fastJson为依赖包 gradle依赖管理如下: compile group: "com.alibaba", name: "fastjson&quo ...
- java system sleep_详解Java中的sleep()和wait()的区别
详解Java中的sleep()和wait()的区别 对于sleep()方法,我们首先要知道该方法是属于Thread类中的.而wait()方法,则是属于Object类中的. sleep()方法导致了程序 ...
- java switch中if_详解java中if语句和switch的使用
if语句 说起if语句,那么不得不提起三元运算符 a>b?c=0:c=1; 如果a>b结果为true,那么c=0,为false,c=1 那么下面看下if语句 if(a>b)c=0; ...
- java list for循环遍历_详解Java中list,set,map的遍历与增强for循环
详解Java中list,set,map的遍历与增强for循环 Java集合类可分为三大块,分别是从Collection接口延伸出的List.Set和以键值对形式作存储的Map类型集合. 关于增强for ...
- 详解Java中的正则表达式
详解Java中的正则表达式,并列出常用的正则表达式语法和一些常用的场景. 判断一个字符串是否是由数字组成: 当不使用正则表达式的时候的实现代码: public class RegexDemo01 {p ...
最新文章
- 特斯拉FSD车端感知解析
- 算法学习之路|统计同成绩学生
- Cassandra使用 —— 一个气象站的例子
- Java基于Socket文件传输示例
- 51nod 1258 序列求和 V4
- vertical-align属性探究
- 卢伟冰暗示Redmi K30 Pro:亮点多多值得再憋憋
- 一道很有趣的多元函数求极值问题
- 符晓《TMS320F28335DSP原理、开发及应用》2017版
- 分享两种证件照换背景方法,轻松把照片底色变白
- Mac重启Finder的技巧
- (Yuni)Markdown光速入门
- 将一个文件夹中的图片写成视频
- 春节短视频暗战,微视后发制人
- 在家做科研是一种什么样的体验?
- android原生系统开发板,安卓学习必备开发板-Rayeager PX2
- 两条完全相同的数据怎么用sql语句删除一条
- Python中定义函数的关键字是什么?一起来学习下吧
- springboot+shiro自定义拦截器互踢问题
- 新买的iphone如何保证安全
热门文章
- 了解一下ES6: 函数简述深浅拷贝
- 【iOS-cocos2d-X 游戏开发之十三】cocos2dx通过Jni调用Android的Java层代码(下)
- 网站制作之按钮onclick大全
- ubuntu16.04 intel_rapl : no valid rapl domains found in packge0
- 给wxPython事件处理函数传递参数
- 可用性高达99.999%!支付系统高可用架构设计实战
- 秒杀系统必须考虑的 3 个技术问题!
- 大型网站架构演进的五大阶段盘点
- 高可用高并发的 9 种技术架构
- 青少年蓝桥杯_2020_steam考试_初级组_第二题