java 多重注解_Java注解-元数据、注解分类、内置注解和自定义注解
大家好,我是乐字节的小乐,上次说过了Java多态的6大特性|乐字节,接下来我们来看看Java编程里的注解。
Java注解有以下几个知识点:元数据
注解的分类
内置注解
自定义注解
注解处理器
Servlet3.0
本文先介绍前面4个知识点:元数据、注解的分类、内置注解、自定义注解。
一、注解简介
注解是Java 1.5引入的,目前已被广泛应用于各种Java框架,如Hibernate,Jersey,
Spring。注解相当于是一种嵌入在程序中的元数据,可以使用注解解析工具或编译器对
其进行解析,也可以指定注解在编译期或运行期有效。
在注解诞生之前,程序的元数据存在的形式仅限于java注释或javadoc,但注解可以提
供更多功能,它不仅包含元数据,还能作用于运行期,注解解析器能够使用注解决定处
理流程。
Annotation(注解)就是Java提供了一种元程序中的元素关联任何信息和任何元数据
(metadata)的途径和方法。Annotation是一个接口,程序可以通过反射来获取指定
程序元素的Annotation对象,然后通过Annotation对象来获取注解里面的元数据。
注解API非常强大,被广泛应用于各种Java框架,如Spring,Hibernate,JUnit。
二、 元数据metadata
元数据从metadata一词译来,就是“关于数据的数据”的意思,即描述数据的结构信息。元数据的功能作用有很多,比如:你可能用过Javadoc的注释自动生成文档。这就是元数据功能的一种。总的来说,元数据可以用来创建文档,跟踪代码的依赖性,执行编译时格式检查,代替已有的配置文件。
在Java中元数据以标签的形式存在于Java代码中,元数据标签的存在并不影响程序代码的编译和执行,被用来生成其它的文件或只在运行时知道被运行代码的描述信息。
其作用如下:
①生成文档:这是最常见的,也是java 最早提供的注解。常用的有@param @return 等;
② 跟踪代码依赖性,实现替代配置文件功能。常见的是spring 2.5 开始的基于注解配置。作用就是减少配置。现在的框架基本都使用了这种配置来减少配置文件的数量。;
③在编译时进行格式检查。如@override 放在方法前,如果你这个方法并不是覆盖了超类方法,则编译时就能检查出。
三、 注解的分类
根据注解参数的个数:
1)、标记注解:一个没有成员定义的Annotation类型被称为标记注解。
2)、单值注解:只有一个值
3)、完整注解:拥有多个值
根据注解使用方法和用途:
1)、JDK内置系统注解
2)、元注解
3)、自定义注解
四、 内置注解
JavaSE中内置三个标准注解,定义在java.lang中:
@Override
限定重写父类方法,若想要重写父类的一个方法时,需要使用该注解告知编译器我们正在重写一个方法。如此一来,当父类的方法被删除或修改了,编译器会提示错误信息;或者该方法不是重写也会提示错误。
public interface Car {
void run();
}
class QQ implements Car{
@Override
public void run() {}
}
class Bmw implements Car{
@Override
void run() {}
}复制代码
QQ 类编译不会有任何问题,Bmw类在编译的时候会提示相应的错误。父类中省略了public abstract修饰符。@Override注解只能用于方法,不能用于其他程序元素。
@Deprecated
标记已过时,当我们想要让编译器知道一个方法已经被弃用(deprecate)时,应该使用这个注解。Java推荐在javadoc中提供信息,告知用户为什么这个方法被弃用了,以及替代方法是什么;
/**
* Deprecated -->该方法过时(有更好的解决方案)
* @author Administrator
*/
public class TestDeprecated {
@Deprecated
public int test(){
System.out.println("TestDeprecated.test()");
return 0;
}
public void test(int a){
System.out.println("TestDeprecated.test(int)");
}
}复制代码
3. @SuppressWarnings
抑制编译器警告,该注解仅仅告知编译器,忽略它们产生了特殊警告。如:在java泛型中使用原始类型。其保持性策略(retention policy)是SOURCE,在编译器中将被丢弃。
/**
* SuppressWarnings 压制警告
* @author Administrator
*/
public class TestSuppressWarnings {
public static void main(String[] args) {
@SuppressWarnings("unused")
List list =new ArrayList();
}
@SuppressWarnings("rawtypes") //没有定义范型
public static List test(){
return new ArrayList();
}
}复制代码
五、 自定义注解
1、简单入门
@interface:用来声明一个注解。注解类里的每一个方法实际上是声明了一个配置参数。方法的名称就是参数的名称,返回值类型就是参数的类型。可以通过default来声明参数的默认值。
@interface Simple{
//这里定义了一个空的注解,它能干什么呢?我也不知道,但他能用。后面有补充
}复制代码
2、元注解
元注解的作用就是负责注解其他注解。Java5.0定义了4个标准的meta-annotation类型,它们被用来提供对其它 annotation类型作说明。Java5.0定义的元注解有四个,
这些类型和它们所支持的类在java.lang.annotation包中可以找到。
@Target
用于描述注解的使用范围(即:被描述的注解可以用在什么地方)。表示支持注解的程序元素的种类,一些可能的值有TYPE, METHOD, CONSTRUCTOR, FIELD等等。如果Target元注解不存在,那么该注解就可以使用在任何程序元素之上。
取值(ElementType)有:
1.CONSTRUCTOR:用于描述构造器
2.FIELD:用于描述域
3.LOCAL_VARIABLE:用于描述局部变量
4.METHOD:用于描述方法
5.PACKAGE:用于描述包
6.PARAMETER:用于描述参数
7.TYPE:用于描述类、接口(包括注解类型) 或enum声明
此时在空注解中加入@Target元注解如:
//此注解只能用在方法上
@Target(ElementType.METHOD)
@interface TestMethod {}复制代码
@Retention
表示需要在什么级别保存该注释信息,用于描述注解的生命周期(即:被描述的注解在什么范围内有效)表示注解类型保留时间的长短。
取值(RetentionPoicy)有:
1.SOURCE:在源文件中有效(即源文件保留)
2.CLASS:在class文件中有效(即class保留)
3.RUNTIME:在运行时有效(即运行时保留)
此时在上述注解中加入@Retention元注解如:
// 此注解可以用于注解类、接口(包括注解类型) 或enum声明
@Target(ElementType.TYPE)
//该注解运行时有效。注解处理器可以通过反射,获取到该注解的属性值,从而去做一些运行时的逻辑处理
@Retention(RetentionPolicy.RUNTIME)
@interface TestRn{
}复制代码
@Documented
表示使用该注解的元素应被javadoc或类似工具文档化,它应用于类型声明,类型声明的注解会影响客户端对注解元素的使用。如果一个类型声明添加了Documented注解,那么它的注解会成为被注解元素的公共API的一部分,@Documented是一个标记注解。
//可以被例如javadoc此类的工具文档化
@Documented
@interface TestDoc{
}复制代码
@Inherited
表示一个注解类型会被自动继承,如果用户在类声明的时候查询注解类型,同时类声明中也没有这个类型的注解,那么注解类型会自动查询该类的父类,这个过程将会不停地重复,直到该类型的注解被找到为止,或是到达类结构的顶层(Object)。
//被子类继承的注解
@Inherited
@interface TestInheri{}复制代码
3、深入自定义注解
使用@interface自定义注解时,自动继承了java.lang.annotation.Annotation接口,由编译程序自动完成其他细节。在定义注解时,不能继承其他的注解或接口。
⑴定义注解格式:
@interface用来声明一个注解,其中的每一个方法实际上是声明了一个配置参数。方法的名称就是参数的名称,返回值类型就是参数的类型(返回值类型只能是基本类型、Class、String、enum)。可以通过default来声明参数的默认值。
public @interface 注解名{定义体s}
⑵注解参数(即方法)
注解里面的每一个方法实际上就是声明了一个配置参数,其规则如下:
①修饰符
只能用public或默认(default)这两个访问权修饰 ,默认为default
②类型
注解参数只支持以下数据类型:
基本数据类型(int,float,boolean,byte,double,char,long,short);
String类型;
Class类型;
enum类型;
Annotation类型;
以上所有类型的数组
③命名
对取名没有要求,如果只有一个参数成员,最好把参数名称设为"value",后加小括号。
④参数
注解中的方法不能存在参数
⑤默认值
可以包含默认值,使用default来声明默认值。
⑶实例如下
/*
* 码农定义注解
*/
@Target(ElementType.FIELD)
@Retention(RetentionPolicy.RUNTIME)
@Documented
@interface Programmer{
String value() default "马云";
}
/**
* 码农类型注解
* @author peida
*/
@Target(ElementType.FIELD)
@Retention(RetentionPolicy.RUNTIME)
@Documented
@interface ProgrammerType {
/**
* 类型枚举 程序猿 射鸡师
*/
public enum CoderType{MONKEYS,LION,CHOOK};
/**
* 颜色属性
*/
CoderType type() default CoderType.MONKEYS;
}
/**
* 码农制造厂
* @author Administrator
*/
@Target(ElementType.FIELD)
@Retention(RetentionPolicy.RUNTIME)
@Documented
@interface ProgrammerProductor {
/**
* 厂家编号
* @return
*/
public int id() default -1;
/**
* 厂家名称
* @return
*/
public String name() default "shsxt";
/**
* 厂家地址
* @return
*/
public String address() default "上海";
}
/**
* 注解使用
*/
class Coder{
@Programmer("老裴")
private String coderName;
@ProgrammerType(type=CoderType.MONKEYS)
private String coderType;
@ProgrammerProductor(id=1,name="程序猿乐园",address="荣乐东路")
private String coderProductor;
public String getCoderName() {
return coderName;
}
public void setCoderName(String coderName) {
this.coderName = coderName;
}
public String getCoderType() {
return coderType;
}
public void setCoderType(String coderType) {
this.coderType = coderType;
}
public String getCoderProductor() {
return coderProductor;
}
public void setCoderProductor(String coderProductor) {
this.coderProductor = coderProductor;
}
}
乐字节原创,转载请注明出处复制代码
java 多重注解_Java注解-元数据、注解分类、内置注解和自定义注解相关推荐
- java音频库_Java是否为音频_synthesis_内置了库?
小编典典 使用(Andrew)的方法,下面是一个示例,该示例具有相同的调节范围. import javax.sound.sampled.AudioFormat; import javax.sound. ...
- 模拟hibernate的注解来创建数据表,内置注解
目录 导读 注解释义 注解定义 内置三大注解 override注解 Deprecated注解 SuppressWarnings注解 元注解 SOURCE和RUNTIME的区别 SOURCE RUNTI ...
- 实现基于注解(Annotation)的数据库框架(三)自定义注解(Annotation)
#前言# 之前已经简单介绍了系统的内置注解,我们已经对注解有了一个初步的印象,接下来就来看看如何自定义注解. 此文章仍然转载自上一篇的作者,因为他写的实在是太好了,非常适合刚接触注解的朋友去看,原文的 ...
- java web 锁_Java中锁的分类
1.内部锁 就是对象本身,每个Java对象都可以隐式地扮演一个用于同步的锁的角色:这些内置的锁被称 为内部锁(intrinsic locks)或监视器锁(monitorlocks).执行线程进入syn ...
- java sql server 存储过程_修改SQL SERVER内置存储过程
SQLSERVER估计是为了安装或者其它方面,它内置了一批危险的存储过程.能读到注册表信息,能写入注数据库 SQLSERVER估计是为了安装或者其它方面,它内置了一批危险的存储过程.能读到注册表信息, ...
- Java虚拟机学习总结(3)——JDK内置工具(jps、jstack、jmap、jstat)使用详解
一.JDK内置工具 - javap 1. 介绍 java 反编译工具,主要用于根据Java字节码文件反汇编为Java源代码文件. 2.命令 javap <options> <clas ...
- java流控_t-io小教程:tio-http内置的流控功能
从事互联网应用平台的开发,安全一直是个工作量很大的领域,而流控则属于安全的一部分,为此tio-http特意内置了流控功能,我们来看看tio-http流控的使用步骤 1.实现SessionRateLim ...
- java a201游戏_OPPO A201固件再升级 内置官方QQ2010
PPO A201手机正在进行全新的功能升级服务! 首家实现内置C版2010QQ,将会有更多新的体验.立刻带上您的OPPO A201手机到附近的OPPO服务中心,即可进行免费软件升级! PPO A201 ...
- 第二版:JAVA对象对比VO对象找出差异值结合swagger-ApiModel无需自定义注解
创建历史记录表存全量 变更前后数据 CREATE TABLE `ltx_change_info` (`ID` varchar(60) NOT NULL COMMENT '主键',`CHANGE_MSG ...
- java类索引_java中索引的分类,图片详解
java的学习是一个漫长而又循环往复不断上升的过程,今天我们再来看一下java索引的分类,并且通过详细的图片解析. 首先,java中的索引主要分为聚簇索引和非聚簇索引. 其中InnoDB主键使用的是聚 ...
最新文章
- kvm虚拟机命令梳理
- 现代密码学5.4--对哈希函数的攻击
- php MySQL快速入门_PHP 连接 MySQL
- docker启动sqlserver_ASP.NET Core容器化技术Docker零基础从入门到实战演练
- Github 大牛封装 Python 代码,实现自动发送邮件只需三行代码
- 定值保险计算举例_保险公司的“开门红”又要来了!理财险真的值得买吗?
- python 定义变量_python-003-变量
- Objective--C Practice and source code
- 中国装配式模块化建筑(PPVC)行业发展趋势前瞻与十四五战略规划研究报告2022年版
- 面试题——关于文本加密
- 上海浦东生育津贴领取记录
- 非此即彼的逻辑错误_Argument常见逻辑错误及描述 【出国英语】
- 绝缘栅型n沟道场管_N沟道增强型绝缘栅场效应管的工作原理
- oracle ebs和java_Oracle EBS Form Builder使用Java beans创建窗体
- %3c php 连接数据库,深究.htaccess的原理,和用户利用其恶意篡改服务器配值导致的深层安全问题...
- Frida hook零基础教程
- 【CISSP备考】考前情报收集
- 《赢在中国蓝天碧水间》观后感
- Amazon EC2创建快照计划任务
- 服务器特征码修改,如果硬件的信息没变,怎么确保软件特征码不会错误更改?...
热门文章
- 确认! Python再次夺冠,老码农:崩溃!
- 11月4日,上海开源基础设施峰会,不见不散!
- java实验册_Java实验报告册Java实验报告册.doc
- cad多个窗口并排显示_你早该这么做!并排查看Excel工作表其实一个小动作就搞定!...
- html伸缩布局,CSS3 伸缩布局(一)
- mysql驱动profilesql_java连接mysql的驱动配置问题
- nexus3下载地址
- Linux Shell脚本_设置时区并同步时间
- MyBatisPlus_更新篇_入门试炼_03
- 郫都区计算机学校,成都郫县好升学的计算机学校有哪些