java学习笔记11--Annotation

Annotation：在JDK1.5之后增加的一个新特性，这种特性被称为元数据特性，在JDK1.5之后称为注释，即：使用注释的方式加入一些程序的信息。

java.lang.annotation Annotation接口是所有的Annotation都必须实现的接口。

系统内建的Annotation

在JDK1.5之后，系统中已经建立了如下的三个内建的Annotation类型，用户直接使用即可。

@Override：覆写的Annotation

@Deprecated：不赞成使用的Annotation

@SuppressWarnings：压制安全警告的Annotation

自定义Annotation

Annotation定义格式：

【public】 @interface Annotation名称{

数据类型变量名称();

}

[java] view plaincopy

public @interface Meaning {
String value();
}

之后就直接可以在程序中使用@Meaning的格式

[java] view plaincopy

@Meaning(value="itmyhome")
class Demo{
}

可以在Annotation中设置一个参数，用来接收变量的内容，如上面的value，使用Annotation的时候也必须给参数赋值如：value="itmyhome"

既然可以设置一个参数，则同时也就可以设置多个参数。

[java] view plaincopy

public @interface Meaning {
String key();
String value();
}

此Annotation在使用的时候需要设置两个参数，一个key一个value

[java] view plaincopy

@Meaning(key="hi",value="itmyhome")
class Demo{
}

也可以设置一个数组进去

[java] view plaincopy

public @interface Meaning {
String[] value();
}

接收的内容要传递数组

[java] view plaincopy

@Meaning(value={"hello","world"})
class Demo{
}

以上所定义的全部的Annotation中有一个特点，所有的参数内容需要在使用注释的时候设置上去，那么也可以为一个参数设置默认的内容，在声明的时候使用default即可。

[java] view plaincopy

public @interface Meaning {
String value() default ""; //默认为空
}

在使用的时候就可以不设置值

[java] view plaincopy

@Meaning
class Demo{
}

在操作中，对于一个Annotation而言有时候会固定期取值范围，只能取固定的几个值，这个时候实际上就需要依靠枚举。

[java] view plaincopy

public enum FormItemType { //定义枚举类型
hidden,text,select,date
}

定义Annotation

[java] view plaincopy

public @interface Meaning {
FormItemType value() ; //设置为枚举类型
}

Annotation的取值只能是枚举类型中的值

[java] view plaincopy

@Meaning(value=FormItemType.date)
class Demo{
}

Retention和RetentionPolicy

在Annotation中，可以使用Retention定义个Annotation的保存范围，此Annotation的定义如下：

[java] view plaincopy

@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.FIELD)
public @interface Meaning {
FormItemType value() ; //设置为枚举类型
}

在以上的Retetion定义中存在了一个RetentionPolicy的变量，此变量用于指定Annotation的保存范围，RetentionPolicy包含三种范围

在三个范围中，最重要的就是RUNTIME范围，因为在执行的时候起作用。

内建Annotation的RetentionPolicy

三个内建的Annotation的定义：

Override定义采用的是@Retention(RetentionPolicy.SOURCE) 只能在源文件中出现

Deprecated定义采用的是@Retention(RetentionPolicy.RUNTIME)，可以在执行时出现

SuppressWarnings定义采用的是@Retention(RetentionPolicy.SOURCE)，只能在源文件中出现

一个Annotation如果要是想让其变得有意义，则必须结合反射机制取得Annotaion中设置的全部内容。

在Class类中存在以下几种与Annotation操作有关的方法

[java] view plaincopy

package com.itmyhome;
import java.lang.annotation.Annotation;
import java.lang.reflect.Method;
class Demo{
@SuppressWarnings("unchecked")
@Deprecated
@Override
public String toString(){
return "hello";
}
}
public class T {
public static void main(String[] args) throws Exception{
Class<?> c = Class.forName("com.itmyhome.Demo");
Method mt = c.getMethod("toString"); //找到toString方法
Annotation an[] = mt.getAnnotations(); //取得全部的Annotation
for(Annotation a:an){
System.out.println(a);
}
}
}

此时已经取得了一个Annota。以上的操作实际上是通过三个系统内建的Annotation完成的，也可以自定义一个Annotation

[java] view plaincopy

@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.METHOD)
public @interface Meaning {
FormItemType value() ; //设置为枚举类型
}

[java] view plaincopy

package com.itmyhome;
import java.lang.reflect.Method;
class Demo{
@Meaning(value=FormItemType.select) //自定义Annotation
@SuppressWarnings("unchecked")
@Deprecated
@Override
public String toString(){
return "hello";
}
}
public class T {
public static void main(String[] args) throws Exception{
Class<?> c = Class.forName("com.itmyhome.Demo");
Method mt = c.getMethod("toString"); //找到toString方法
//指定的注释是否存在于此元素上
if(mt.isAnnotationPresent(Meaning.class)){
Meaning m = mt.getAnnotation(Meaning.class); //得到指定的Annotation
System.out.println(m.value()); //取得Annotation的值
}
}
}

@Target

指示注释类型所适用的程序元素的种类。如果注释类型声明中不存在 Target 元注释，则声明的类型可以用在任一程序元素上。如果存在这样的元注释，则编译器强制实施指定的使用限制，如：@Target(ElementType.ANNOTATION_TYPE)

ElementType的保存范围

java学习笔记11--Annotation相关推荐

Java学习笔记11
Object类是所有类.数组.枚举类的父类,是类层次结构的根类.每个类都使用Object作为超类.所有对象(包括数组)都实现这个类的方法. Object类实现了以下方法: 我们来看看在源码中regi ...
java学习笔记11 （构造方法 this深探）
在开发中,经常需要在创建对象的同事明确对象对的属性值,比如一个person对象创建的时候就应该有name和age 等属性,那么如何做到在创建对象的同时给对象的属性值初始化值呢? 这里介绍构造方法 1 ...
Java学习笔记：2022年1月11日
Java学习笔记:2022年1月11日摘要:这篇笔记主要讲解了一些数据在计算机中的存在方式相关的知识点,并由此延伸出了数据在计算机中的操作以及一些数据结构的知识. 文章目录 Java学习笔记:2 ...
《Java学习笔记(第8版)》学习指导
<Java学习笔记(第8版)>学习指导目录图书简况学习指导第一章 Java平台概论第二章从JDK到IDE 第三章基础语法第四章认识对象第五章对象封装第六章继承与多 ...
Java学习笔记-Day64 Spring 框架（二）
Java学习笔记-Day64 Spring 框架(二) 一.控制反转IOC和依赖注入DI 1.控制反转IOC 2.依赖注入DI 3.Spring IOC容器 3.1.简介 3.2.实现容器 3.2.获 ...
从零写一个具有IOC-AOP-MVC功能的框架---学习笔记---11. MVC功能之http请求处理器的编写---简易框架最后一公里！
从零写一个具有IOC-AOP-MVC功能的框架-学习笔记专栏往期文章链接: IOC功能相关章节: 从零写一个具有IOC-AOP-MVC功能的框架-学习笔记-01.项目初始化从零写一个具有IOC-A ...
java学习笔记13--反射机制与动态代理
本文地址:http://www.cnblogs.com/archimedes/p/java-study-note13.html,转载请注明源地址. Java的反射机制在Java运行时环境中,对于任意 ...
Java学习笔记（十）--控制台输入输出
输入输出一.控制台输入在程序运行中要获取用户的输入数据来控制程序,我们要使用到 java.util 包中的 Scanner 类.当然 Java 中还可以使用其他的输入方式,但这里主要讲解 Scan ...
Hadoop学习笔记—11.MapReduce中的排序和分组
Hadoop学习笔记-11.MapReduce中的排序和分组一.写在之前的 1.1 回顾Map阶段四大步骤首先,我们回顾一下在MapReduce中,排序和分组在哪里被执行: 从上图中可以清楚地看出 ...

java学习笔记11--Annotation

java学习笔记11--Annotation相关推荐

最新文章

热门文章