java基础之注解示例详解

java基础之注解示例详解 目录 定义 作用 注解与注释的区别 JDK内置的标准注解 自定义注解 @Target 属性 定义 注解也叫原数据,它是JDK1.5及之后版本引入的一个特性,它可以声明在类.方法.变量等前面,用来对这些元素进行说明. 作用 生成文档:通过代码

目录
  • 定义
  • 作用
  • 注解与注释的区别
  • JDK内置的标准注解
  • 自定义注解
  • @Target
  • 属性

定义

注解也叫原数据,它是JDK1.5及之后版本引入的一个特性,它可以声明在类、方法、变量等前面,用来对这些元素进行说明。

作用

生成文档:通过代码里标识的注解生成doc文档【生成doc文档】

代码分析:通过代码里标识的注解对代码进行分析【反射】

编译检查:通过代码里标识的注解让编译器能够实现基本的编译检查【Override】

注解与注释的区别

注解是给编译器看的,注释是给程序员看的。

JDK内置的标准注解

@Override

表示该方法是覆盖父类的,如果某个方法父类中并没有,且该方法使用了@Override,则会报错

@Deprecated

表示该方法已经过时,但还是可以用

@SuppressWarnings

压制警告

一般用在类的前面,传递参数"all",表示压制该类的所有警告

这是父类代码


public class Fu {
    public void eat(){
        System.out.println("Fu 吃......");
    }
}

这是子类代码


@SuppressWarnings("all")//压制该类下的所有警告
public class Zi extends Fu{

    @Override			//表示该方法是重写父类的
    public void eat(){
        System.out.println("Zi eat......");
    }
    @Deprecated			//表示该方法已经过时
    public void work(){				

    }
}

下面是主类

自定义注解

格式:

​ 元注解

​ public @interface 注解名称{

​ 属性列表

​ }

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

public interface 注解名称extends java.lang.annotation.Annotation {}

元注解

注解的注解就是元注解

下面是@Override注解的源码,我们可以看到在@Override的前面还有一些注解,下面我们来介绍一下这些注解

我们需要掌握5种元注解:

@Target

指明了注解可以在哪里使用

参数ElementType取值

​ TYPE:指明注解可以使用在类上

​ METHOD:指明注解可以使用在方法上

​ FIELD:指明注解可以使用在成员变量上


@Target({ElementType.TYPE, ElementType.FIELD, ElementType.METHOD})	//当{}里面的内容只有一个时,{}可以省略
public @interface PersonWrite {
        int age();
        String name() default "22";
}

@Retention()

指明注解被保留的阶段:

注解保留到源代码阶段


@Retention(RetentionPolicy.SOURCE)   

注解保留到编译阶段


@Retention(RetentionPolicy.CLASS)

注解1保留到运行阶段


@Retention(RetentionPolicy.RUNTIME)

@Documented

标识注解被抽取到doc文档中

@Inherited

标识注解被子类继承

属性

注解中的属性其实是抽象方法

属性的返回类型只能是下面几种类型:

基本数据类型

String

枚举

注解

以上类型的数组

如果注解里面定义了属性(接口),在使用时要给属性赋值

如果定义属性时使用default给属性赋值,则在使用注解时可以不给该属性赋值(当然也可以重新赋值)如果注解只有一个,且注解的名称是value,则使用时传参直接写参数即可,不用写属性名数组赋值时,使用{}包裹,如果数组中只有一个值,则{}可以省略

下面是自定义的注解:


@Target({ElementType.TYPE, ElementType.FIELD, ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
public @interface PersonWrite {
        int age();
        String name() default "李四";
}

下面是该注解的使用:


package Java高级特性.注解;

@PersonWrite(age = 222)
public class Main {

    public static void main(String[] args) {
        Zi zi = new Zi();
        zi.work();
    }
}

到此这篇关于java基础之注解示例详解的文章就介绍到这了,更多相关java注解内容请搜索我们以前的文章或继续浏览下面的相关文章希望大家以后多多支持我们!

本文标题为:java基础之注解示例详解

基础教程推荐