java注解

1. 什么是注解

Java 注解（Annotation）又称 Java 标注，是 JDK5.0 引入的一种注释机制。Java 语言中的类、方法、变量、参数和包等都可以被标注。和 Javadoc 不同， Java 标注可以通过反射获取标注内容。在编译器生成类文件时，标注可以被嵌 入到字节码中。Java 虚拟机可以保留标注内容，在运行时可以获取到标注内容 。 当然它也支持自定义 Java 标注。

2 .内置的注解

@Override - 检查该方法是否是重写方法。如果发现其父类，或者是引用的接口中并没有

该方法时，会报编译错误。

@Deprecated - 标记过时方法。如果使用该方法，会报编译警告。

@SuppressWarnings - 指示编译器去忽略注解中声明的警告。

作用在其他注解的注解(或者说 元注解)是:

@Retention - 标识这个注解怎么保存，是只在代码中，还是编入 class 文件中，或者是在 运行时可以通过反射访问。

@Documented - 标记这些注解是否包含在用户文档中。

@Target - 标记这个注解应该是哪种 Java 成员。

@Inherited - 标记这个注解是继承于哪个注解类(默认 注解并没有继承于任何子类)

@SafeVarargs - Java 7 开始支持，忽略任何使用参数为泛型变量的方法或构造函数调用产

生的警告。

@FunctionalInterface - Java 8 开始支持，标识一个匿名函数或函数式接口。

@Repeatable - Java 8 开始支持，标识某注解可以在同一个声明上使用多次。

重点

@Target：用于描述注解的使用范围（即：被描述的注解可以用在什么地方.

ElementType.TYPE 可以应用于类的任何元素。

ElementType.CONSTRUCTOR 可以应用于构造函数。

ElementType.FIELD 可以应用于字段或属性。

ElementType.LOCAL_VARIABLE 可以应用于局部变量。

ElementType.METHOD 可以应用于方法级注释。

ElementType.PACKAGE 可以应用于包声明。

ElementType.PARAMETER 可以应用于方法的参数。

@Retention：@Retention 定义了该注解被保留的时间长短：某些注解仅出现在源代码中， 而被编译器丢弃；而另一些却被编译在 class 文件中；编译在 class 文件中的注解可能会被虚拟机忽略，而另一些在 class 被装载时将被读取（请注意并不影响 class 的执行，因为注 解与 class 在使用上是被分离的）。使用这个 meta-Annotation 可以对注解的“生命周期” 限制。作用：表示需要在什么级别保存该注释信息，用于描述注解的生命周期（即：被描述 的注解在什么范围内有效）

取值（RetentionPoicy）有：

1.SOURCE:在源文件中有效（即源文件保留）

2.CLASS:在 class 文件中有效（即 class 保留）

3.RUNTIME:在运行时有效（即运行时保留）

3. 自定义注解

参考代码实例

声明的注解类

package javaAnnotation;import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;@Target(ElementType.FIELD)
@Retention(RetentionPolicy.RUNTIME)
public @interface NotNull {String message() default "";int length() default 0;String lengthmessage() default "";
}

用注解的实体类

package javaAnnotation;public class User {private int num;@NotNull(message="姓名不能为空",length=3,lengthmessage="长度不能小于3")private String name;public String getName() {return name;}public void setName(String name) {this.name = name;}public int getNum() {return num;}public void setNum(int num) {this.num = num;}}

测试及解析注解

package javaAnnotation;import java.lang.reflect.Field;
import java.lang.reflect.Method;public class Test {public static void main(String[] args) throws NoSuchMethodException, SecurityException, Exception {User user = new User();user.setName("ji");Field[] fields = user.getClass().getDeclaredFields();for (Field field : fields) {NotNull notNull = field.getAnnotation(NotNull.class);if (notNull != null) { Method m = user.getClass().getMethod("get" + getMethodName(field.getName()));Object obj=m.invoke(user);if (obj==null) {System.err.println(field.getName() +notNull.message());throw new NullPointerException(notNull.message());}else{if(String.valueOf(obj).length()<(notNull.length())){System.err.println(field.getName() +notNull.lengthmessage());}}}}}/*** 把一个字符串的第一个字母大写*/private static String getMethodName(String fildeName) throws Exception {byte[] items = fildeName.getBytes();items[0] = (byte) ((char) items[0] - 'a' + 'A');return new String(items);}
}

结果：