Java 基础 —

注解（annotation）不是注释（comment）；

注解，是一种元数据（metadata），可为我们在代码中添加信息提供了一种形式化的方法。注解在一定程度上实现了元数据和源代码文件的结合，而不是将元数据保存在外部文档中。

Java SE5 在 java.lang 中定义的三种基本注释：

@Override
@Deprecated
@SuppressWarnings

以及 4 中元注解：

@Target
@Retention
- RetentionPolicy.SOURCE – 在编译阶段丢弃。这些注解在编译结束之后就不再有任何意义，所以它们不会写入字节码。@Override, @SuppressWarnings都属于这类注解。
- RetentionPolicy.CLASS – 在类加载的时候丢弃。在字节码文件的处理中有用。注解默认使用这种方式。
- RetentionPolicy.RUNTIME– 始终不会丢弃，运行期也保留该注解，因此可以使用反射机制读取该注解的信息。我们自定义的注解通常使用这种方式。
@Documented（将此注解包含在 doc 中）
@Inherited（允许子类继承父类中的注解）

1. 定义注解

可以看到，注解的定义看起来很像接口（@interface）的定义。事实上，与其他任何 java 接口一样，注解也会被编译成 .class 文件：

@Target(ElementType.METHOD)     // java.lang.annotation.ElementType/Target
@Retention(RetentionPolicy.RUNTIME) // java.lang.annotation.Retention/RententionPolicy;
public @interface Test {}

定义注解时，会需要一些元注解（meta-annotation），比如上例的 @Target 和 @Retention。

@Target 用来定义你的注解将应用在什么地方
- 一个方法（@Target(ElementType.METHOD)），
- 或是一个域（成员变量，@Target(ELEMENTTYPE.FIELD)）
- ElementType.CONSTRUCTOR
- ElementType.LOCAL_VARIABLE
- ElementType.PACKAGE
- ElementType.TYPE
- ElementType.PARAMETER
@Retention 用来定义该注解在哪一级别可用：
- SOURCE：源代码中；
- CLASS：类文件中；
- RUNTIME：运行时；

在注解上，一般也会包含一些元素以表示某些值。当搜集分析处理注解时，程序或者工具可以利用这些值（没有元素的注解称为标记注解 marker annotation，也即仅起到标记作用，如上例的 @Test）。注解的元素看起来就像接口的方法，唯一的区别你可以为其指定默认值。

2. 注解的应用

如下为一个用来跟踪项目用例的注解。如果一个方法或一组方法实现了某个用例的需求，那么程序员可以为此方法加上注解。项目经理便可通过计算已经实现的用例，以掌握项目的进展。

// UseCase.java
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface UseCase {public int id();public String description() default "no description";
}// PasswordUtils
public class PasswordUtils {@UseCase(id = 47, description = "password must contains at least one numeric")public boolean validatePassword(String password) {return password.matches("\\w*\\d\\w*");}@UseCase(id = 48)public String entryptPassword(String password) {return new StringBuilder(password).reverse().toString();}@UseCase(id = 49, description = "new password can't equal previously used ones")public boolean checkForNewPassword(List<String> prevPasswords, String password) {return prevPasswords.contains(password);}
}

Java 基础 —— 注解相关推荐

Java基础-注解和反射
Java基础-注解和反射前言对于注解,我主要还是在自定义APT还有运行时反射获取类来让自己能够构建出复用性更高的代码逻辑. 知识点1-注解: 注解的应用场景由元注解@Retention来进行指定, ...
Java基础 --- 注解 Annotation
Java基础 --- 注解 Annotation Java注解 Java自带的标准注解自定义注解 Java注解 Java注解它提供了一种安全的类似注释的机制,用来将任何的信息或元数据(metadat ...
夯实 Java 基础 - 注解
夯实 Java 基础 - 注解不知道大家有没有一种感觉,当你想要了解某个知识点的时候,就会发现好多技术类 APP 或者公众号在推一些关于这个知识点的文章.也许这就是大数据的作用,这也说明总有人比你抢 ...
Java基础-注解机制详解
文章目录 1. 注解基础 1.1 Java内置注解 1.1.1 内置注解 - @Override 1.1.2 内置注解 - @Deprecated 1.1.3 内置注解 - @SuppressWarn ...
Java基础——注解
一.概述引自百度百科: 定义:注解(Annotation),也叫元数据.一种代码级别的说明.它是JDK1.5及以后版本引入的一个特性,与类.接口.枚举是在同一个层次.它可以声明在包.类.字段.方法. ...
java基础-注解Annotation原理和用法
转载自 http://www.wolfbe.com/detail/201608/265.html 在很多java代码中都可以看到诸如@Override.@Deprecated.@SuppressWar ...
java基础:注解的定义与使用
java中的注解 1.该如何来理解注解? 乔布斯重新定义了手机,罗太君重新定义了傻逼.自然而然的就给罗太君贴上了傻逼的标签,不熟悉老罗的人,不知道他当教师,办博客,做手机,殊不知老罗还有"理 ...
java基础- 注解和反射
1. 注解(Annotation) 1. 什么是注解 Annotation是从JDK5.0开始引入的新技术. Annotation的作用 : 不是程序本身,可以对程序作出解释.(这一点和注释(comm ...
Java基础--注解
一直都想了解一下注解,下面是自己学到的一点东西. 1.分类内置注解(@Override,@Deprecated,@SuppressWarnings),源码上很清楚的备注了各自的作用. 元注解(@Re ...

Java 基础 —— 注解

1. 定义注解

2. 注解的应用

Java 基础 —— 注解相关推荐

最新文章

热门文章