文档章节

JAVA1.5新特性--注解Annotation

i
 iteryder
发布于 2015/10/17 14:28
字数 2168
阅读 12
收藏 0

主键分类:

1.   内键注解(基本注解),定义于java.lang包下。

*限定重写父类的方法@Override

*表示已过时:@Deprecated

*抑制编译器警告:@S uppressWarnings

2.   元注解,定义于java.lang.annotation包下。

*@Retention

*@Target

*@Documented

*@Inherited

3.   自定义注解

*使用@interface自定义注解

 

@Override指定方法重写,强制一个子类重写父类的方法。

只能修饰方法,不能修饰类和成员变量。

错误提示1

        The method getObjectInfo() of type Apple must override or implement a suppertype method

        该方法getObjectInfo()类型的苹果必须重写或实现suppertype方法。

        

@Deprecated用于表示某个程序元素(类、方法、成员变量等)已过时。

文档注释中的@deprecated将在后续版本中改进放弃使用。

        

        

当调用Apple类的getObjectInfo方法时,编译器将会给出警告。

 

@SunppressWarnigs指示被注解表示的程序元素及其子元素取消显示指定的编译器警告。

会一直作用于该成程序元素的所有子元素。

@SuppressWarnings("unchecked")

关键字用途

Deprecation使用了不赞成使用的类或方法时的警告 

unchecked 执行了未检查的转换时的警告,例如当使用集合时没有用泛型 (Generics) 来指定集合保存的类型。 

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

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

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

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

Unused有程序元素未被使用

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

===============元注解

@Target

1、用于指定被修饰的注解能用于修饰哪些程序元素

2@Target注解类型有唯一的value作为成员变量,value的类型为java.lang.annotation.ElementType类型

                            ElementType.ANNOTATION_TYPE 注解声明

                            ElementType.CONSTRUCTOR     构造方法声明

                            ElementType.FIELD                   成员变量声明

                            ElementType.LOCAL_VARIABLE  局部变量声明

                            ElementType.METHOD                   方法声明

                            ElementType.PACKAGE                 包声明

                            ElementType.PARAMETER       参数声明

                            ElementType.TYPE                         类、接口(包括注解类型)或枚举类声明

@Retention

1、用于指定被修饰的注解可以保留多长时间。描述了被其修饰的注解是否被编译器丢弃或者保存在class文件中,如果保存在class文件中,是否在class文件被加载时被虚拟机所读取。

2、默认情况下,注解被保存在class文件中,但在运行时并不能被反射访问。

3@Retention包含一个java.lang.annotation.RetentionPolicy的枚举类型的value成员变量,使用@Retention时必须为该value成员变量指定值,通过指定@Retentionvalue值,就可以指定被修饰的注解可以保留多长时间。

RetentionPolicy.CLASS   (默认值)  编译器将把注解记录在class文件中,当运行java程序时,java虚拟机不再保留注解。程序无法通过反射获取该注解。


RetentionPolicy.RUNTIME 编译器将把注解记录在class文件中,当允许java程序时,java虚拟机也会保留注解,程序可以通过反射获取该注解。


RetentionPolicy.SOURCE编译器直接丢弃被修饰的注解。

示例:

       指定了@Retention在运行时,可以通过反射访问。

        从这个例子中我们可以看到,@Retention修饰了自己的注解类型定义

        



@Documented

1、用于指定被修饰的注解将被javadoc工具提取成文档,

2、如果定义注解时使用了@Documented修饰,则所有使用该注解的程序元素的API文档中豆浆包含该注解说明;

3、@Documented注解类型中没有成员变量。


                    

示例:

         

        

        @SuppressWarnings的部分API文档举例;图中被红框框起来的白色字体部分即是@SuppressWarnings中包含的@Target@Retention,而之所以在这里显示@Target@Retention,就是因为这两个注解是被@Documented注解所修饰的。        

  

 

@Inherited

1、用于指定被修饰的注解将具有继承性

2、如果某个类使用了定义时被@Inherited修饰的注解,则其子类会自动具有这个注解。

3、被@Inherited注解修饰的注解是被标注过的类的子类所继承。类并不从它所实现的接口继承该类型的注解,方法也不能从它所重载的方法中继承这种注解。

4、当被@Inherited修饰的注解的Retention是RetentionPolicy.RUNTIME时,反射API会增强这种继承性。因为如果我们使用java.lang.reflect去查下一个Inherited类型的注解时,反射将展开代码检查工作:检查类及其父类知道泛型指定的注解被发现,或者到达类继承结构的顶层。

 

===============自定义注解

注解类型与接口的差异:

注解类型使用关键字@interface,这个关键字隐含了一个基本的信息,即继
承了:
java.lang.annotation.Annotation接口。

public @interface Inherited{}

注解类型的方法定义是独特的、受限制的,不同于普通接口中的方法定义,注解类型的方法必须声明为无参数、无异常抛出的。注解类型中的方法即为主角类型的成员变量。

String[] value;

方法名就是成员变量名:value

方法返回值即为成员变量的类型:String[]        

方法的后面可以使用default关键字和一个默认数值来声明成员变量的默认值,而空不能作为默认值。 这与我们在非注解类的接口中定义方法有很大的不同。


注解类型与接口的像是之处:

·         都可以定义接口常量、静态成员类型(如枚举类型定义)。注解类型也可以像接口一样被实现或继承。


注解类型是一种接口,但它又不同于接口,如何自定义注解类型

1、使用@interface关键字;

2、使用注解时类似与public、final这样的修饰符。

3、可用于修饰类、接口、方法、成员变量等程序元素。


使用注解时的规范:

1、把注解放在所有修饰符之前;

2、把注解单独放在一行;


      注解也可以带成员变量:

注解的成员变量在注解类型的定义中以无参数方法的形式来声明,其方法名和返回值分别定义了该成员变量的名字和类型。

示例:(value变量单个值

public @interface AnnotationTest{

//定义一个成员变量value

//注解类型中的成员变量以方法的形式定义

String value();//--变量名为value,类型为String

}

示例:(value变量多个值

 public @interface AnnotationTest{

//定义多个成员变量value

//注解类型中的成员变量以方法的形式定义

String[] value();//--变量名为value,类型为String

}

示例:(多个成员变量

public @interface AnnotationTest{

//定义两个成员变量value

//注解类型中的成员变量以方法的形式定义

String name();//--变量名为value,类型为String

int age();

}

使用定义了成员变量的注解时要为成员变量赋值:

示例:

Public class MyAnnotation{

//使用带成员变量的注解时,需要为成员变量赋值

@AnnotationTest(name="jack",age=20)

Public void getObjectInfo(){

……

}

}

使用default关键字为注解类型的成员变量指定初始值:

示例:

Public @interface AnnotationTest{

//定义两个成员变量name和age

//用default关键字为两个成员变量赋初始值

String name() default "jack";

int age() default 20;

}

如果注解类型的成员变量被指定了初始值,则在使用该注解时不对成员变量赋值也可以:

示例:

Public class MyAnnotation{

//使用带有初始值的成员变量的注解时,可以不为成员变量赋值

@AnnotationTest

Public void getObjectInfo(){
.…..

}

}

===============自定义注解分类

根据注解类型是否包含成员变量,可以注解分为两类:

*标记注解

·         没有定义成员变量的注解类型被称为标记注解,这种注解仅使用自身的存在与否,来为我们提供信息。

示例:

@Override---内建注解

@Document---元注解

*元数据注解

·         包含成员变量的注解,因为他们可以接受更多的元数据,所以被称为元数据注解。

示例:

@SuppressWarnings---内建注解

@Target---元注解

 










© 著作权归作者所有

共有 人打赏支持
i
粉丝 0
博文 1
码字总数 2168
作品 0
海淀
程序员
私信 提问
详解java1.5新添特性------注解

详解java1.5新添特性------注解 在求职面试过程中,被问到是否自己用过java注解以及自己实现过一个注解,当时就懵逼了,what's the f**k! 未来的开发模式都是基于注解的,JPA是基于注解的,S...

banyoukang
2016/03/29
38
0
java基础强化——注解原理解析和应用实战(简单ORM功能实现)

1.什么是注解 注解是java1.5引入的新特性,它是嵌入代码中的元数据信息,元数据是解释数据的数据。通俗的说,注解是解释代码的代码。这个定义强调了三点, 1.注解是代码 这意味着注解可以被程序...

takumiCX
07/23
0
0
Java注解教程及自定义注解

Java注解提供了关于代码的一些信息,但并不直接作用于它所注解的代码内容。在这个教程当中,我们将学习Java的注解,如何定制注解,注解的使用以及如何通过反射解析注解。 Java1.5引入了注解,...

天蚕宝衣
2016/02/29
21
0
深入理解注解(Annotation)

在现在的开发中,注解越来越多地应用到了开发中,无论是Servlet3.0新特性,还是SSH中的全注解,都给开发带来了极大的便利, 直观. 因此需要对注解有深入的理解. 一. 自定义注解 自定义注解的目...

长平狐
2012/09/03
111
0
Java 注解深入理解

内容概要 Annotation的概念 Annotation的作用 Annotation的分类 系统内置注解 元注解 自定义注解 解析注解信息 JDK8注解新特性 附:项目源码地址 一、Annotation的概念 Annotation(注解)是插...

GarfieldEr007
01/07
0
0

没有更多内容

加载失败,请刷新页面

加载更多

腾讯与Github的魔幻会面背后的故事…

10月22日,腾讯开源管理办公室有幸邀请到Github新晋CEO Nat Friedman,前来鹅厂参观交流。目前腾讯已经有近70个项目在Github上开源,共获得17w stars,世界排名11位。Github是腾讯开源的主阵...

腾讯开源
19分钟前
0
0
单例模式

单例模式(Singleton pattern)属于创建型设计模式。 保证一个类仅有一个实例,并提供一个访问它的全局访问点。 通常我们可以让一个全局变量使得一个对象被访问,但它不能防止你实例化多个对...

NinjaFrog
24分钟前
0
0
TypeScript基础入门之装饰器(三)

转载 TypeScript基础入门之装饰器(三) 继续上篇文章[TypeScript基础入门之装饰器(二)] 访问器装饰器 Accessor Decorator在访问器声明之前声明。 访问器装饰器应用于访问器的属性描述符,可用...

durban
41分钟前
2
0
spring5调研学习(转载)

Spring框架的新功能 这一章主要提供Spring框架新的功能和变更。 升级到新版本的框架可以参考。Spring git。 内容列表 Spring 5.x框架新的功能 Spring 4.x框架新的功能 Spring 3.x框架新的功能...

小海bug
52分钟前
2
0
为何Spring框架能这么流行?

想要学习更多关于Spring框架在Java开发者中如此流行?看这篇文章可以学到更多! Spring框架特性 Spring是用于应用开发中的一款强大,轻量级框架。更广泛地说,你可以认为Spring框架是一个定义...

java知识分子
54分钟前
2
0

没有更多内容

加载失败,请刷新页面

加载更多

返回顶部
顶部