文档章节

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

没有更多内容

加载失败,请刷新页面

加载更多

下一页

人生苦短:Python里的17个“超赞操作

人生苦短,我选Python”。那么,你真的掌握了Python吗? 1. 交换变量 有时候,当我们要交换两个变量的值时,一种常规的方法是创建一个临时变量,然后用它来进行交换。比如: # 输入 a = 5 b ...

糖宝lsh
39分钟前
4
0
咕泡-spring中常用设计模式概述

设计模式就是经验之谈,供后人借鉴,解决一些具有代表性的问题 设计模式来源于生活,反过来帮助我们更好生活 设计模式提升代码的可读性、可扩展性、维护成本、复杂业务问题 千万不要死记硬背...

职业搬砖20年
今天
2
0
day59-20180817-流利阅读笔记-待学习

假·照骗,真·社交焦虑 雪梨 2018-08-17 1.今日导读 发朋友圈之前,不少人为了展现更美好的生活状态会对照片加以“微调”,或是加个滤镜显得逼格更高,或是磨个皮瘦个脸拉个大长腿。现在,国...

aibinxiao
今天
19
0
OSChina 周五乱弹 —— 姑娘在这个节日里表白你接受么?

Osc乱弹歌单(2018)请戳(这里) 【今日歌曲】 @Sharon啊:完全被这个小姐姐圈粉了,学两首她的歌去哈哈 分享王贰浪的单曲《往后余生(翻自 马良)》 《往后余生(翻自 马良)》- 王贰浪 手...

小小编辑
今天
949
16
为什么HashMap要自己实现writeObject和readObject方法?

为什么HashMap要自己实现writeObject和readObject方法? 如果你有仔细阅读过HashMap的源码,那么你一定注意过一个问题:HashMap中有两个私有方法。 private void writeObject(java.io.Objec...

DemonsI
今天
0
0

没有更多内容

加载失败,请刷新页面

加载更多

下一页

返回顶部
顶部