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

  1. public @interface Meaning {
  2. String value();
  3. }

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

[java] view plaincopy

  1. @Meaning(value="itmyhome")
  2. class Demo{
  3. }

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

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

[java] view plaincopy

  1. public @interface Meaning {
  2. String key();
  3. String value();
  4. }

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

[java] view plaincopy

  1. @Meaning(key="hi",value="itmyhome")
  2. class Demo{
  3. }

也可以设置一个数组进去

[java] view plaincopy

  1. public @interface Meaning {
  2. String[] value();
  3. }

接收的内容要传递数组

[java] view plaincopy

  1. @Meaning(value={"hello","world"})
  2. class Demo{
  3. }

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

[java] view plaincopy

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

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

[java] view plaincopy

  1. @Meaning
  2. class Demo{
  3. }

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

[java] view plaincopy

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

定义Annotation

[java] view plaincopy

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

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

[java] view plaincopy

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

Retention和RetentionPolicy

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

[java] view plaincopy

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

在以上的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

  1. package com.itmyhome;
  2. import java.lang.annotation.Annotation;
  3. import java.lang.reflect.Method;
  4. class Demo{
  5. @SuppressWarnings("unchecked")
  6. @Deprecated
  7. @Override
  8. public String toString(){
  9. return "hello";
  10. }
  11. }
  12. public class T {
  13. public static void main(String[] args) throws Exception{
  14. Class<?> c = Class.forName("com.itmyhome.Demo");
  15. Method mt = c.getMethod("toString");   //找到toString方法
  16. Annotation an[] = mt.getAnnotations(); //取得全部的Annotation
  17. for(Annotation a:an){
  18. System.out.println(a);
  19. }
  20. }
  21. }

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

[java] view plaincopy

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

[java] view plaincopy

  1. package com.itmyhome;
  2. import java.lang.reflect.Method;
  3. class Demo{
  4. @Meaning(value=FormItemType.select)  //自定义Annotation
  5. @SuppressWarnings("unchecked")
  6. @Deprecated
  7. @Override
  8. public String toString(){
  9. return "hello";
  10. }
  11. }
  12. public class T {
  13. public static void main(String[] args) throws Exception{
  14. Class<?> c = Class.forName("com.itmyhome.Demo");
  15. Method mt = c.getMethod("toString");   //找到toString方法
  16. //指定的注释是否存在于此元素上
  17. if(mt.isAnnotationPresent(Meaning.class)){
  18. Meaning m = mt.getAnnotation(Meaning.class);  //得到指定的Annotation
  19. System.out.println(m.value());                //取得Annotation的值
  20. }
  21. }
  22. }

@Target

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

ElementType的保存范围

时间: 2024-10-24 22:23:31

java学习笔记11--Annotation的相关文章

Java学习笔记 11/15:一个简单的JAVA例子

首先来看一个简单的 Java 程序. 来看下面这个程序,试试看是否看得出它是在做哪些事情! 范例:TestJava.java // TestJava.java,java 的简单范例 public class TestJava { public static void main(String args[]) { int num ; // 声明一个整型变量 num num = 3 ; // 将整型变量赋值为 3 // 输出字符串,这里用"+" 号连接变量 System.out.printl

Java学习笔记11

Object类是所有类.数组.枚举类的父类,是类层次结构的根类.每个类都使用Object作为超类.所有对象(包括 数组)都实现这个类的方法. Object类实现了以下方法: 我们来看看在源码中registerNatives()方法: private static native void registerNatives(); static { registerNatives(); } 从上面的代码中看到Object类定义了一个静态初始化块,我们知道当创建Java对象时,系统总是先调用静态初始化块

java学习笔记(11) —— Struts2与Spring的整合

1.右键 项目名称 —— MyEclipse —— Add Spring Capabilities 2.选取 Copy checked Library contents to project folder 3.建立IService 与 Service [Spring 同样是面向接口编程,因此需要引入IService] public interface ILoginService { public boolean isLogin(String username,String password);

我的java学习笔记(11)关于装箱、参数可变方法和枚举类型

1.所有的基本类型都有一个与之对应的类,通常这些类称之为包装器. 2.对象包装器类是不可变的,即一旦构造了包装器,就不允许更改包装在其中的值.对象包装器还是final,因此不能定义它们的子类. 3.假设定义一个整型数组列表,而尖括号中的类型参数不允许是基本类型,即不允许ArrayList<int>,这里可以使用Integer对象包装器类. Array<Integer> l = new ArrayList<>(); 4.装箱和拆箱是编译器认可的,而不是虚拟机.编译器在生成

Java学习笔记-11.运行期间类型鉴定

1.Class对象的getClasses()方法获取的是该类中所有的公共的内部类,以及从父类,父接口继承来的内部类.getinterfaces()方法返回类继承的所有接口. import javax.print.attribute.standard.PrinterInfo; interface HasBatteries{} interface Waterproof{} interface ShootsThings{} class Toy{ Toy(){} Toy(int i){} } class

java学习笔记3——java关键字

java学习笔记3——java关键字 虽然老师说不用刻意的去记忆,但是我还是在网上找到了非常详细的注解,再次收藏 关键字的类型表: 各个关键字的详细注解和实例,按首字母排序: 1.abstract abstract 关键字可以修改类或方法. abstract 类可以扩展(增加子类),但不能直接实例化. abstract 方法不在声明它的类中实现,但必须在某个子类中重写. -示例- public abstract class MyClass{ } public abstract String my

【Java学习笔记之二十六】深入理解Java匿名内部类

在[Java学习笔记之二十五]初步认知Java内部类中对匿名内部类做了一个简单的介绍,但是内部类还存在很多其他细节问题,所以就衍生出这篇博客.在这篇博客中你可以了解到匿名内部类的使用.匿名内部类要注意的事项.如何初始化匿名内部类.匿名内部类使用的形参为何要为final. 一.使用匿名内部类内部类 匿名内部类由于没有名字,所以它的创建方式有点儿奇怪.创建格式如下: new 父类构造器(参数列表)|实现接口() { //匿名内部类的类体部分 } 在这里我们看到使用匿名内部类我们必须要继承一个父类或者

Java学习笔记之继承

一.继承的基础 在Java术语中,被继承的类叫超类(superclass),继承超类的类叫子类(subclass). 举例说明: 1 class Box 2 { 3 public double width; 4 public double height; 5 public double depth; 6 7 //重载构造方法 8 public Box(Box ob) 9 { 10 width = ob.width; 11 height = ob.height; 12 depth = ob.dep

Java学习笔记之接口

一.接口的概念与定义 首先考虑一个简单的接口的定义: public interface Output { int MAX_LINE = 40; void out(); void getData(String msg); } 定义接口使用关键字interface 修饰符interface前面的public可以省略,如果省略,则采用默认访问控制,即只有在相同包结构的代码才可以访问此接口 接口不可以有构造方法(区别于类中的构造方法) 接口里面的所有成员,包括常量.方法等都是public访问权限,所以在

mybatis学习笔记(11)-多对多查询

mybatis学习笔记(11)-多对多查询 mybatis学习笔记11-多对多查询 示例 多对多查询总结 resultMap总结 本文实现多对多查询,查询用户及用户购买商品信息. 示例 查询主表是:用户表 关联表:由于用户和商品没有直接关联,通过订单和订单明细进行关联,所以关联表:orders.orderdetail.items sql SELECT orders.*, user.username, user.sex, user.address, orderdetail.id orderdeta