注解介绍
注解是java5引进的一种语法,注解与注释有着差不多的作用,只不过注释是给人看的,注解是给java编译器与java虚拟机看的。
使用场景
注解都是配合反射技术去使用的,如果没有了java的反射技术,注解也就失去了它存在的意义。
原生注解
在java中,自带了好几个注解,其中五种注解是给我们用来创建自定义注解时使用的,成为五大元注解。剩下的都是应用级注解,即我们可以注解拿来使用的注解。
1. 三种常见应用级注解
注解名 | 应用场景 | 意义 |
---|---|---|
SuppressWarnings | 除了包与注解之外的场景 | 压制警告 |
Deprecated | 全部 | 将该项标记为过时 |
Override | 重写的方法 | 标记该方法为重写发放 |
测试代码如下
/**
* @Classname Demo1
* @Date 2020/11/21 10:16
* @author hzq
* 测试原生三大注解
*/
package com.hzq.annotation;
import java.util.HashMap;
public class Demo1 {
/**
* 覆盖方法的注解
* 用来标注该方法是从父类或者接口继承来的方法
* 在子类中进行重写
* @return
*/
@Override
public String toString() {
return "Demo1{}";
}
/**
* 用来压制警告
*/
@SuppressWarnings("all")
public void test1(){
HashMap<Object, Object> map = new HashMap<>();
};
/**
* 标记该方法已过时
* 不推荐使用
*/
@Deprecated
public void test2(){
}
public static void main(String[] args) {
Demo1 demo1 = new Demo1();
demo1.test2();
}
}
五种元注解
底层注解是在我们创建自定义注解时所使用的注解
注解名 | 应用场景 | 意义 |
---|---|---|
Target | 注解 | 表示新建注解的应用场景 |
Retention | 注解 | 表示新建注解的生命周期 |
Documented | 注解 | 表示该注解也会被输出到文档中 |
Inherited | 注解 | 表示新建注解会被标注的类的子类所继承 |
Repeatable | 注解 | 表示该注解可以在同一位置多次使用 |
测试代码如下:
/**
* @Classname Demo2
* @Date 2020/11/21 10:41
* @author hzq
*/
package com.hzq.annotation;
import java.lang.annotation.*;
@MyAnnotation("myAnnotation1")
@MyAnnotation("myAnnotation2")
public class Demo2 {
}
/**
* @author admin
*/
//表示新创建的注解可以应用的场景
@Target(ElementType.TYPE)
//表示注解的生命周期(我们自定义注解一般都设为Runtime)
@Retention(RetentionPolicy.RUNTIME)
//表示该注解也会被输出到文档上(需要配合javadoc使用,基本上没啥用)
@Documented
//表示新建的注解,可以被标注的类的子类所继承过去
@Inherited
//表示该注解可以在同一个位置标记多次
@Repeatable(MyAnnotations.class)
@interface MyAnnotation{
String value();
}
/**
* @author admin
*/
@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Inherited
@interface MyAnnotations{
MyAnnotation[] value();
}
注解的语法
- 新建注解时应该使用@interface来创建,注解是一个特殊的接口,它会自动继承Annotation接口。
- 在注解内部可以定义注解的属性,如
String value();
。 - 注解的属性除了String类型外还可以基本数据类型,枚举类型,Classl类型等类型以及他们的数组类型。
- 还可以给属性设置默认值,语法为
String value() default "笑笑";
,这样,当使用注解并且没有给属性赋值时,会有一个默认的值。
示例代码如下:
/**
* @Classname Demo3
* @Date 2020/11/21 11:13
* @author hzq
*/
package com.hzq.annotation;
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;
@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
//创建注解使用@interface
public @interface Demo3 {
String value() default "笑笑";
int age();
String[] names = new String[10];
}