`
liqita
  • 浏览: 290865 次
  • 性别: Icon_minigender_1
  • 来自: 上海
社区版块
存档分类
最新评论

JAVA:注解(一)

阅读更多

JAVA:注解(一)

(2010-06-24 08:52:15)
标签:

杂谈

分类: JAVA方向

Annotation 是 JDK 1.5 增加的语言特性,主要为 Java EE 5 发布作为铺垫的,从 Java EE 5
开始使用了大量的 Annotation。比如:EJB3,JPA,JWS 等等都将复杂的 XML 配置文件作为可
选了,由 Annotation 取而代之。

用注释(Annotation)来标识要作绑定的类和属性等,这可以极大简化了开发的工作量。

Annotation 一般可以取代复杂的配置文件,用于告之容器管理者某个类、方法的行为

Annotation(注释)是JDK5.0及以后版本引入的。它可以用于创建文档,跟踪代码中的依赖性,甚至执行基本编译时检查。注释是以‘@注释名’ 在代码中存在的,根据注释参数的个数,我们可以将注释分为:标记注释、单值注释、完整注释三类。它们都不会直接影响到程序的语义,只是作为注释(标识)存 在,我们可以通过反射机制编程实现对这些元数据的访问。另外,你可以在编译时选择代码里的注释是否只存在于源代码级,或者它也能在class文件中出现。

元数据的作用
如果要对于元数据的作用进行分类,目前还没有明确的定义,不过我们可以根据它所起的作用,大致可分为三类:
编写文档:通过代码里标识的元数据生成文档。
代码分析:通过代码里标识的元数据对代码进行分析。
编译检查:通过代码里标识的元数据让编译器能实现基本的编译检查。

基本内置注释

@Override


Java代码

1. package com.iwtxokhtd.annotation;
2.
7. public class OverrideDemoTest {
8.  
9.     //@Override
10.     public String tostring(){
11.         return "测试注释";
12.     }
13. }

package com.iwtxokhtd.annotation;

public class OverrideDemoTest {

//@Override
public String tostring(){
return "测试注释";
}
}

 

 

 

@Deprecated的作用是对不应该在使用的方法添加注释,当编程人员使用这些方法时,将会在编译时显示提示信息,它与javadoc里的@deprecated标记有相同的功能,准确的说,它还不如javadoc @deprecated,因为它不支持参数,使用@Deprecated的示例代码示例如下:


Java代码

1. package com.iwtxokhtd.annotation;
2.
7. public class DeprecatedDemoTest {
8.      public static void main(String[] args) {
9.         //使用DeprecatedClass里声明被过时的方法
10.          DeprecatedClass.DeprecatedMethod();
11.      }
12. }
13. class DeprecatedClass{
14.     @Deprecated
15.     public static void DeprecatedMethod() {      
16.       }  
17. }

package com.iwtxokhtd.annotation;

public class DeprecatedDemoTest {
public static void main(String[] args) {
//使用DeprecatedClass里声明被过时的方法
DeprecatedClass.DeprecatedMethod();
}
}
class DeprecatedClass{
@Deprecated
public static void DeprecatedMethod() {    
}
}

 

@SuppressWarnings,其参数有:

deprecation,使用了过时的类或方法时的警告

unchecked,执行了未检查的转换时的警告

fallthrough,当 Switch 程序块直接通往下一种情况而没有 Break 时的警告

path,在类路径、源文件路径等中有不存在的路径时的警告

serial,当在可序列化的类上缺少 serialVersionUID 定义时的警告

finally ,任何 finally 子句不能正常完成时的警告

all,关于以上所有情况的警告


Java代码

1. package com.iwtxokhtd.annotation;
2.  
3. import java.util.ArrayList;
4. import java.util.List;
5.  
6. public class SuppressWarningsDemoTest {
7.  
8.     public static List list=new ArrayList();
9.     @SuppressWarnings("unchecked")
10.     public void add(String data){
11.         list.add(data);
12.     }
13. }

package com.iwtxokhtd.annotation;

import java.util.ArrayList;
import java.util.List;

public class SuppressWarningsDemoTest {

public static List list=new ArrayList();
@SuppressWarnings("unchecked")
public void add(String data){
list.add(data);
}
}

 

(2)自定义注释

它类似于新创建一个接口类文件,但为了区分,我们需要将它声明为@interface,如下例:


Java代码

1. public @interface NewAnnotation {
2. }

public @interface NewAnnotation {
}

 

使用自定义的注释类型


Java代码

1. public class AnnotationTest {
2.     @NewAnnotation  
3.     public static void main(String[] args) {
4.     }
5. }  

public class AnnotationTest {
@NewAnnotation
public static void main(String[] args) {
}
}

 

 

为自定义注释添加变量


Java代码

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

public @interface NewAnnotation {
String value();
}

 

 


Java代码

1. public class AnnotationTest {  
2.      @NewAnnotation("main method")  
3.     public static void main(String[] args) {  
4.         saying();  
5.     }  
6.     @NewAnnotation(value = "say method")  
7.      public static void saying() {
8.      }
9. }  

public class AnnotationTest {
@NewAnnotation("main method")
public static void main(String[] args) {
saying();
}
@NewAnnotation(value = "say method")
public static void saying() {
}
}

 

 

 

定义一个枚举类型,然后将参数设置为该枚举类型,并赋予默认值


Java代码

1. public @interface Greeting {    
2. public enum FontColor{
3.        BLUE,RED,GREEN
4.     };
5.     String name();
6.     FontColor fontColor() default FontColor.RED;}   
7. }

public @interface Greeting {  
public enum FontColor{
BLUE,RED,GREEN
};
String name();
FontColor fontColor() default FontColor.RED;}
}

 

 

这里有两种选择,其实变数也就是在赋予默认值的参数上,我们可以选择使用该默认值,也可以重新设置一个值来替换默认值


Java代码

1. @NewAnnonation("main method")
2.     public static void main(String[] args) {
3.             saying();    
4.             sayHelloWithDefaultFontColor();    
5.             sayHelloWithRedFontColor();    
6.  
7.     }
8.     @NewAnnonation("say method")
9.     public static void saying(){
10.          
11.     }
12.     //此时的fontColor为默认的RED
13.     @Greeting(name="defaultfontcolor")
14.     public static void sayHelloWithDefaultFontColor() {    
15.          
16.     }
17.     //现在将fontColor改为BLUE
18.     @Greeting(name="notdefault",fontColor=Greeting.FontColor.BLUE)
19.     public static void sayHelloWithRedFontColor() {    
20.             
21. }

@NewAnnonation("main method")
public static void main(String[] args) {
saying();  
sayHelloWithDefaultFontColor();  
sayHelloWithRedFontColor();  

}
@NewAnnonation("say method")
public static void saying(){

}
//此时的fontColor为默认的RED
@Greeting(name="defaultfontcolor")
public static void sayHelloWithDefaultFontColor() {  

}
//现在将fontColor改为BLUE
@Greeting(name="notdefault",fontColor=Greeting.FontColor.BLUE)
public static void sayHelloWithRedFontColor() {  

}

 

 

(3)注释的高级应用

限制注释的使用范围

用@Target指定ElementType属性


Java代码

1. package java.lang.annotation;    
2. public enum ElementType {    
3.   TYPE,    
4.   // 用于类,接口,枚举但不能是注释
5.   FIELD,    
6.   // 字段上,包括枚举值   
7.   METHOD,    
8.   // 方法,不包括构造方法
9.   PARAMETER,    
10.   // 方法的参数
11.   CONSTRUCTOR,    
12.   //构造方法
13.   LOCAL_VARIABLE,    
14.   // 本地变量或catch语句  
15.   ANNOTATION_TYPE,    
16.   // 注释类型(无数据)   
17.   PACKAGE    
18.   // Java包   
19. }   

package java.lang.annotation;  
public enum ElementType {  
TYPE,  
// 用于类,接口,枚举但不能是注释
FIELD,  
// 字段上,包括枚举值
METHOD,  
// 方法,不包括构造方法
PARAMETER,  
// 方法的参数
CONSTRUCTOR,  
//构造方法
LOCAL_VARIABLE,  
// 本地变量或catch语句
ANNOTATION_TYPE,  
// 注释类型(无数据)
PACKAGE  
// Java包
}

 

注解保持性策略


Java代码

1. //限制注解使用范围
2. @Target({ElementType.METHOD,ElementType.CONSTRUCTOR})
3. public @interface Greeting {
4.  
5.     //使用枚举类型
6.     public enum FontColor{
7.        BLUE,RED,GREEN
8.     };
9.     String name();
10.     FontColor fontColor() default FontColor.RED;
11. }

//限制注解使用范围
@Target({ElementType.METHOD,ElementType.CONSTRUCTOR})
public @interface Greeting {

//使用枚举类型
public enum FontColor{
BLUE,RED,GREEN
};
String name();
FontColor fontColor() default FontColor.RED;
}

 

在Java编译器编译时,它会识别在源代码里添加的注释是否还会保留,这就是RetentionPolicy。下面是Java定义的RetentionPolicy枚举:

编译器的处理有三种策略:

将注释保留在编译后的类文件中,并在第一次加载类时读取它

将注释保留在编译后的类文件中,但是在运行时忽略它

按照规定使用注释,但是并不将它保留到编译后的类文件中

 


Java代码

1. package java.lang.annotation;    
2. public enum RetentionPolicy {    
3.   SOURCE,    
4.   // 此类型会被编译器丢弃   
5.   CLASS,    
6.   // 此类型注释会保留在class文件中,但JVM会忽略它   
7.   RUNTIME    
8.   // 此类型注释会保留在class文件中,JVM会读取它    
9. }   

package java.lang.annotation;  
public enum RetentionPolicy {  
SOURCE,  
// 此类型会被编译器丢弃
CLASS,  
// 此类型注释会保留在class文件中,但JVM会忽略它
RUNTIME  
// 此类型注释会保留在class文件中,JVM会读取它  
}


Java代码

1. //让保持性策略为运行时态,即将注解编码到class文件中,让虚拟机读取
2. @Retention(RetentionPolicy.RUNTIME)
3. public @interface Greeting {
4.  
5.     //使用枚举类型
6.     public enum FontColor{
7.        BLUE,RED,GREEN
8.     };
9.     String name();
10.     FontColor fontColor() default FontColor.RED;
11. }

//让保持性策略为运行时态,即将注解编码到class文件中,让虚拟机读取
@Retention(RetentionPolicy.RUNTIME)
public @interface Greeting {

//使用枚举类型
public enum FontColor{
BLUE,RED,GREEN
};
String name();
FontColor fontColor() default FontColor.RED;
}

 

文档化功能

Java提供的Documented元注释跟Javadoc的作用是差不多的,其实它存在的好处是开发人员可以定制Javadoc不支持的文档属性,并在开发中应用。它的使用跟前两个也是一样的,简单代码示例如下:


Java代码

1. //让它定制文档化功能
2. //使用此注解时必须设置RetentionPolicy为RUNTIME
3. @Documented
4. public @interface Greeting {
5.  
6.     //使用枚举类型
7.     public enum FontColor{
8.        BLUE,RED,GREEN
9.     };
10.     String name();
11.     FontColor fontColor() default FontColor.RED;
12. }

//让它定制文档化功能
//使用此注解时必须设置RetentionPolicy为RUNTIME
@Documented
public @interface Greeting {

//使用枚举类型
public enum FontColor{
BLUE,RED,GREEN
};
String name();
FontColor fontColor() default FontColor.RED;
}

 

标注继承


Java代码

1. //让它允许继承,可作用到子类
2. @Inherited
3. public @interface Greeting {
4.  
5.     //使用枚举类型
6.     public enum FontColor{
7.        BLUE,RED,GREEN
8.     };
9.     String name();
10.     FontColor fontColor() default FontColor.RED;
11. }

//让它允许继承,可作用到子类
@Inherited
public @interface Greeting {

//使用枚举类型
public enum FontColor{
BLUE,RED,GREEN
};
String name();
FontColor fontColor() default FontColor.RED;
}

 

 

(4)读取注解信息

属于重点,在系统中用到注解权限时非常有用,可以精确控制权限的粒度


Java代码

1. package com.iwtxokhtd.annotation;
2. import java.lang.annotation.Annotation;
3. import java.lang.reflect.Method;
4.  
5. //读取注解信息
6. public class ReadAnnotationInfoTest {
7.     public static void main(String[] args)throws Exception {
8.         //测试AnnotationTest类,得到此类的类对象
9.         Class c=Class.forName("com.iwtxokhtd.annotation.AnnotationTest");
10.         //获取该类所有声明的方法
11.         Method []methods=c.getDeclaredMethods();
12.         //声明注解集合
13.         Annotation[] annotations;
14.         //遍历所有的方法得到各方法上面的注解信息
15.         for(Method method:methods){
16.             //获取每个方法上面所声明的所有注解信息
17.             annotations=method.getDeclaredAnnotations();
18.             //再遍历所有的注解,打印其基本信息
19.             for(Annotation an:annotations){
20.             System.out.println("方法名为:"+method.getName()+" 其上面的注解为:"+an.annotationType().getSimpleName());
21.                 Method []meths=an.annotationType().getDeclaredMethods();
22.                 //遍历每个注解的所有变量
23.                 for(Method meth:meths){
24.                     System.out.println("注解的变量名为:"+meth.getName());
25.                 }
26.                  
27.             }
28.         }
29.  
30.     }
31.  
32. }

package com.iwtxokhtd.annotation;
import java.lang.annotation.Annotation;
import java.lang.reflect.Method;

//读取注解信息
public class ReadAnnotationInfoTest {
public static void main(String[] args)throws Exception {
//测试AnnotationTest类,得到此类的类对象
Class c=Class.forName("com.iwtxokhtd.annotation.AnnotationTest");
//获取该类所有声明的方法
Method []methods=c.getDeclaredMethods();
//声明注解集合
Annotation[] annotations;
//遍历所有的方法得到各方法上面的注解信息
for(Method method:methods){
//获取每个方法上面所声明的所有注解信息
annotations=method.getDeclaredAnnotations();
//再遍历所有的注解,打印其基本信息
for(Annotation an:annotations){
System.out.println("方法名为:"+method.getName()+" 其上面的注解为:"+an.annotationType().getSimpleName());
Method []meths=an.annotationType().getDeclaredMethods();
//遍历每个注解的所有变量
for(Method meth:meths){
System.out.println("注解的变量名为:"+meth.getName());
}
}
}
}
}

分享到:
评论

相关推荐

    Java自定义注解实例

    ### 一、Java注解概述 1. **定义**: 注解是一种声明式的编程元素,以`@`符号开头,后面跟着注解的名称。它们可以应用于类、接口、方法、变量等不同级别。 2. **预定义注解**: Java标准库提供了若干预定义注解,如`...

    java 自定义注解验证

    首先,我们需要理解Java注解的基本原理。注解是一种元数据,它提供了一种安全的方法来将信息附加到代码中,而不直接影响代码的执行。Java提供了内置的注解,如`@Override`、`@Deprecated`等,但自定义注解允许我们...

    Java元注解是Java注解的重要特性,下面我就来详解常见的4大Java元注解

    Java 元注解详解 Java 元注解是 Java 注解的重要特性,它们是用于修饰注解的注解。Java 元注解的作用是通过使用 Java 元注解,可以为注解指定:作用范围、生命周期、是否可重复和是否继承等信息,从而提高注解的...

    Java 使用注解拼接SQL语句

    假设我们有一个User DAO,我们可以定义一个方法来获取用户信息,使用自定义注解: ```java public interface UserRepository { @Query("SELECT * FROM users WHERE id = #{id}") User getUserById(int id); }...

    java注解代码java注解代码

    java注解代码java注解代码java注解代码java注解代码java注解代码java注解代码java注解代码java注解代码java注解代码java注解代码java注解代码java注解代码java注解代码java注解代码java注解代码java注解代码java注解...

    Java核心知识体系2:注解机制详解.pdf

    Java注解是编程时的一种元数据机制,引入于JDK1.5,它允许程序员在源代码中的多种元素(如类、方法、变量等)上添加声明性信息。注解的作用主要包括生成文档、编译时检查、编译时或运行时的动态处理。 1. **Java...

    Java自定义注解使用反射获取字段注解

    Java的`Field`类提供了`getAnnotation(Class<A> annotationClass)` 方法,用于获取指定类型的注解: ```java public class AnnotationReflectionDemo { public static void main(String[] args) throws ...

    java注解webservice学习第一篇

    Java注解是Java编程语言中的一个重要特性,它允许在代码中添加元数据,为编译器、解释器或任何其他工具提供额外的信息。在Java Web服务(WebService)开发中,注解的应用极大地简化了服务的创建和配置。本文将深入...

    java注解详解

    ### Java注解详解 #### 一、注解(Annotation)简介 注解是Java语言自JDK 5.0版本引入...以上内容总结了Java注解的基本概念、常见注解、元注解以及注解的定义和使用方式,帮助开发者更好地理解和运用注解这一强大特性。

    Java Annotation注解技术

    Java Annotation注解技术是自Java SE 5.0版本引入的一种元编程机制,它允许程序员在源代码的各个层面(如类、方法、变量等)添加元数据,以供编译器、JVM或第三方工具在编译时或运行时进行处理。Annotation简化了...

    java通用注解API

    通过阅读《Java通用注解和API规范.pdf》这份文档,你可以更深入地理解Java注解的原理、使用方法以及最佳实践,从而在实际开发中更好地利用这一强大的工具。这份文档涵盖了从基础概念到高级特性的全面内容,对于Java...

    java自定义注解接口限流demo

    java自定义注解接口限流demo; java自定义注解接口限流demo; java自定义注解接口限流demo; java自定义注解接口限流demo; java自定义注解接口限流demo; java自定义注解接口限流demo; java自定义注解接口限流demo...

    java自定义注解实践

    Java 自定义注解实践是 Java 语言中的一项重要特性,它可以使开发者自定义注解,以满足不同的需求。在本文中,我们将详细介绍 Java 自定义注解的概念、特点、实现方式及实践应用。 概念 ---- Java 自定义注解是 ...

    java自定义注解和通过反射获取注解

    我们可以通过`getAnnotations()`、`getAnnotation(Class)`等方法来获取注解: ```java public static void main(String[] args) { Method method = MyClass.class.getMethod("myMethod"); MyAnnotation ...

    java注解深入理解

    Java注解是Java编程语言中的一个重要特性,它提供了一种元数据的方式,允许程序员在代码中插入额外的信息,这些信息可以被编译器或者运行时环境用来执行特定的任务。注解在现代Java开发中扮演了不可或缺的角色,尤其...

    android&java的注解详解demo

    在编程世界中,Java注解(Annotation)是一个强大的工具,它允许程序员在代码中嵌入元数据,这些元数据不直接影响程序的运行,但可以被编译器或运行时环境用来进行各种处理。Android开发中,注解同样扮演着重要角色...

    JAVA 注解示例 详解

    本篇文章将深入探讨Java注解的使用及其在实际开发中的应用。 首先,我们了解Java注解的基本结构。一个注解以`@`符号开头,后面跟着注解类型,如`@Override`或`@Deprecated`。注解可以带有参数,参数以键值对的形式...

    Java注解介绍+代码实现

    注解概要介绍.doc文件 :简要介绍了Java注解 Java工程文件夹:里面有一个javaSe工程StudyAnnotation,此工程是自定义注解的完整代码 工程API文件夹:是StudyAnnotation工程的帮助文档,可以不用看

    java和ssh注解

    Java注解是一种元数据,它提供了一种安全的方式向编译器或JVM传递信息。常见的注解如@Override、@Deprecated、@ SuppressWarnings等,它们可以帮助开发者进行类型检查、版本控制和消除警告。自定义注解可以用于更...

Global site tag (gtag.js) - Google Analytics