JavaWeb——2.注解

这篇文章我们来讲一下Java中的注解

其实这部分内容算是Javaweb的补充内容,其中还包括Junit测试和反射的相关内容。 Junit测试是一个比较简单的内容,这里就不写了;而反射的相关内容可以看java基础专栏,那里面有详细的叙述。

目录

1.注解概述

2.jdk里面已经定义的注解

2.1 @Override注解

2.2 @Deprecated注解

2.3 @SuppressWarnings(参数)

3.自定义注解

4.在程序中解析注解

5.具体案例

扫描二维码关注公众号,回复: 15708323 查看本文章

1.注解概述

首先,我们来对注解进行一个全面的认识

注解概念:用来说明程序的,是给计算机看的

格式:@+注解名称

解释:我们知道java里面有注释,注释的概念是:用文字描述程序,给程序员看的;我们类比注释,就给出了注解的概念。唯一不同的是注解是给计算机看的

注解的分类:

  1. 编译检查:通过代码里面标识的注解,让编译器可以实现基本的编译检查,例@Override
  2. 编写文档:通过代码里面标识的注解,来生成文档(生成doc文档,也就是api文档,生成类的文档的命令:javadoc 类名)
  3. 代码分析:通过代码里标识的注解,对代码进行分析(使用反射)

说明:编译检查,很简单,就是程序在编译的时候对代码进行检查,看看它是否符合语法格式,典型的就是对方法的重写时用的注解@Override;编写文档,也很容易理解,就是我们给程序加上注解,然后如果我们要生成api文档,那么就会生成加了注解的部分;代码分析这里先不阐述

关于注解我们要学习的内容:

  1. jdk里面定义的注解
  2. 自定义注解
  3. 在程序中使用(解析)注解

2.jdk里面已经定义的注解

首先,我们先来了解一下jdk里面已经定义了的注解。主要了解以下三个:

  1. @Override 检测被标记的方法是否是基础父类(接口)的
  2. @Deprecated 该注解标识的内容表示已过时
  3. @SuppressWarnings(参数) 用来压制警告的,其中的参数一般传递all,表示压制所有警告

2.1 @Override注解

这个注解就不过多赘述了,我们已经用了很多次了

直接看一下代码吧

很简单,不多讲

2.2 @Deprecated注解

这个注解是用来表示标识的内容已经过时了

注意:是可以用,但是已经过时了。就比如一个程序有了一个新功能,旧的功能过时了,所以我们要对旧的功能进行表示,但是因为还有人会用旧的功能,所以旧的功能还是可以用的

看下代码:

第16行的注解表示方法show1()过时了,所以在第28行输入的时候,idea显示的show1()上面划了条横线,但是注意,show1()方法还是可以用的

2.3 @SuppressWarnings(参数)

@SuppressWarnings(参数)注解是用来压制警告的

具体的看一下代码:

这些标黄的位置就是警告,不是错误,不影响程序运行

然后我们加上注解看一下:

 如图所示,警告就没有了

里面的参数我们一般传入的是all,表示压制所有的警告

对于这个注解,我们一般是直接标识在类上的,这样就可以压制整个类的警告了

 如图所示,我们这整个类都没有警告了

3.自定义注解

下面,我们来尝试一下自定义注解

我们来看一下java中注解的格式:

它大体上是分两部分组成的。第一部分:元注解,就是49和50两行;第二部分:注解定义,就是第51行

所以注解格式如下:

元注解
public @interface MyAnno {

}

我们仿照它也来定义一个注解:

 

 这里再说明一点内容,我们定义了一个注解,然后进行编译,然后在用javap命令反编译,就能看到注解的本质

注解的本质:注解本质上是一个接口,该接口默认继承Annotation接口

接口反编译出来的内容:public interface MyAnno extends java.lang.annotation.Annotation{}

所以说,注解本质上是一个接口,接口里面能写的内容(常量、抽象方法)注解里面都可以写

但是有所要求:

  1. 属性的返回值类型,只能包括:基本数据类型、String、枚举、注解、以上类型的数组,只能包括这五大类
  2. 定义了属性,在使用时要给属性赋值,赋值格式为 属性名=值;还可以使用default关键字给属性赋默认值
  3. 如果只有一个属性需要赋值,并且属性名为value,那么可以直接写值,不用写value

下面来看一个自定义的注解:

这是自定义的注解,里面写了内容

下面看一下这个注解的使用:

 很简单key-value的形式

下面再来讲一下元注解:

元注解:用于描述注解的注解,是jdk已经定义好的
需要掌握的元注解:

  1. @Target:用于描述注解能够作用的位置,三个取值:TYPE:只作用于类上;METHOD:只作用于方法上;FIELD:只作用与成员变量上
  2. @Retention:描述注解被保留的阶段 @Retention(RetentionPolicy.RUNTIME),表示当前被描述的注解会保留到class字节码文件中,并被jvm读取到;我们自己写的注解一般是选RUNTIME
  3. @Document:描述注解是否被抽取到api文档中
  4. @Inherited:描述被该注解描述的注解注释的类的子类会自动继承这个注解

下面来看一下具体的实例:

 我们写自定义的注解时,一般只用前两个注解,后面两个一般不用

注解的定义就是这么多的内容

4.在程序中解析注解

下面我们通过具体的实例来看下注解的在程序中的解析

如图所示,这是我们自定义的一个注解

 这个是我们在程序中使用我们自定义的注解

 这个就是运行的结果

我们在程序中解析注解,实质上就是在程序中获取注解里面的内容,它包含以下三部分:

  1. 获取注解定义的位置的字节码文件
  2. 获取指定的注解
  3. 调用注解中的抽象方法来获取配置的属性值

 这在上面的程序中也是对应上的,运行方法啥的运用的是反射的技术

5.具体案例

情景:你写了一个计算器,能够进行四则运行,现在要求你写一个测试框架,来测试你的计算器是否可以正确运算,如果有错,请返回文件指出错误

代码如下:

 这是计算器类

这是我们写的注解

 这是我们的测试框架

这是运行结果

最后,我们小结一下

我们以后是要会使用注解,而不是自定义注解来使用。注解给谁用?注解给计算机用,给解析程序用(这个解析程序就是类似于我们的TestCheck类),注解是给这二者用的。并且注解不是我们程序的一部分,可以将注解理解为一个标签,它不是程序的一部分。 

猜你喜欢

转载自blog.csdn.net/m0_52096593/article/details/131463446
2.
今日推荐