2024年最新32、学习 Java 中的注解（参照官方教程）_@unused 注解(1)，2024年最新985研究生入职电网6个月

既有适合小白学习的零基础资料，也有适合3年以上经验的小伙伴深入学习提升的进阶课程，涵盖了95%以上大数据知识点，真正体系化！

由于文件比较多，这里只是将部分目录截图出来，全套包含大厂面经、学习笔记、源码讲义、实战项目、大纲路线、讲解视频，并且后续会持续更新

需要这份系统化资料的朋友，可以戳这里获取

📖 The at sign character (@) indicates to the compiler that what follows is an annotation. In the following example, the annotation’s name is Override:
📝 @ 符号用于告诉编译器 @ 符号后面的内容是一个注解。在下面的例子中，注解的名字是：Override

class Dog extends Animal {
    @Override
    public void test() {
        super.test();
    }
}

---

📖 The annotation can include elements, which can be named or unnamed, and there are values for those elements:
📝 注解可以包含元素。元素可以有名字，也可以没有名字。元素如下所示：

@Author(
        name = "庆医",
        date = "2022/5/20"
)
class CommonClass { 
    
}

🌼 上面代码中的 name 和 date 是注解的元素
🌼【庆医】和【2022/5/20】是元素的值

@SuppressWarnings(value = "unused")
class Whatever {
    private String s;
}

🌼 上面代码中的 @ 告诉编译器 @ 符号后面的是注解
🌼 SuppressWarnings 是注解名
🌼 value 是 SuppressWarnings 注解的元素
🌼【unused】是 value 元素的值

---

📖 If there is just one element named value, then the name can be omitted.
📝 如果注解中只写了一个元素，并且元素的名字是 value，那么元素名可以省略掉（如下所示）

//@SuppressWarnings(value = "unused")
@SuppressWarnings("unused")
class Whatever {
    private String s;
}

---

📖 If the annotation has no elements, then the parentheses（圆括号） can be omitted.
📝 如果注解中没有元素，那么注解的圆括号可以省略掉（如下所示）

class Dog extends Animal {
    @Override // Override 注解没有元素, 圆括号可以省略
    public void test() {
        super.test();
    }
}

---

📖 It is also possible to use multiple annotations on the same declaration.
📝 也可以在同一个声明上使用多个注解

class Dog extends Animal {

    @Override
    @SuppressWarnings("unused")
    public void test() {
        int a = 66;
        super.test();
    }

}

---

📖 The annotation type can be one of the types that are defined in the java.lang or java.lang.annotation packages of the Java SE API. It is also possible to define your own annotation type.
📝 注解类型可能存在于 Java 标准版的 java.lang 包或java.lang.annotation 包中。您也可以定义自己的注解类型。

(2) 注解可以使用在哪儿

📖 Annotations can be applied to declarations: declarations of classes, fields, methods, and other program elements. When used on a declaration, each annotation often appears, by convention, on its own line.
📝 注解可以运用于声明：类声明、字段声明、方法声明和其他程序元素的声明。当多个注解使用在同一个声明的时候，每一个注解独占一行。

三、创建注解类型

📖 Many annotations replace comments in code.
📝 很多注解取代了代码中的注释

---

📖 The annotation type definition looks similar to an interface definition where the keyword interface is preceded by the at sign (@).
📝 定义注解类型就像定义一个接口一样。只是接口的关键字（interface）前面增加了 @ 符号【@ 符号是注解类型的标志】

📖 Annotation types are a form of interface.【注解类型是接口的一种形式】

📖 The body of the annotation definition contains annotation type element declarations, which look a lot like methods. Note that they can define optional default values.
📝 注解定义的主体中包含注解类型元素的定义，注解类型元素的定义看起有点像方法（定义注解类型元素的时候可以提供可选的默认值）

创建注解类型示例：

/\*\*
 \* @author 庆医
 \* @describe 创建一个注解类型,
 \* 花括号中可定义注解的元素（且元素可以有可选的默认值）
 \*/
@Documented // 使 DescribeInfo 注解能够在 javadoc 文档中出现
public @interface DescribeInfo {
    /\*
 元素的类型是：String
 元素名是：author
 \*/
    String author(); // 作者

    String date(); // 创建时间

    /\*
 元素的类型是：int
 元素名是：currentRevision
 该元素的默认值是：1
 \*/
    int currentRevision() default 1; // 当前版本

    String lastModifiedDate() default ""; // 最后一次修改的时间

    String lastModifiedBy() default ""; // 最后一次是被誰修改的

    String[] reviewers(); // 审核者（可以写数组）
}

🌼 元素的定义和方法有点像，一种语法而已，记住就好。

使用自定义注解：

@DescribeInfo(
        author = "庆医",
        date = "2022/2/2",
        currentRevision = 3,
        lastModifiedDate = "2022/3/3",
        lastModifiedBy = "庆医儿子",
        reviewers = {"Tom", "Eric"}
)
public class MainTest {
}

---

📖 To make the information in @DescribeInfo appear in Javadoc-generated documentation, you must annotate the @DescribeInfo definition with the @Documented annotation.

📝 为了能够在 javadoc 文档中显示@DescribeInfo自定义注解的信息，您必须在定义该注解的时候标注@Documented注解。

四、注解介绍

📄 注解（Annotation）也被称为元数据（Metadata），用于解释包、类、方法、属性、构造器、局部变量等数据的信息

📄 和注释一样，注解不影响程序的逻辑。当注解可以被编译或运行（相当于嵌入在代码中的补充信息）

📄 在 JavaSE 中，注解的作用非常简单（例如：标记过时的功能、忽略警告等）

📄 在 JavaEE 中，注解非常非常得重要。在 JavaEE 中，注解占据重要地位（可用于配置应用程序的任何切面，代替 Java EE 旧版中所遗留的繁冗代码和 XML 配置等）

📄 软件工具可以通过处理注解信息生成 Java 代码、生成 XML 文件

五、jdk 中的常见注解

jdk 中的预定义注解（jdk 中自带的注解）详细介绍

📄 使用注解必须要加上 @ 符号，它是注解的标志

📗 @Override：只能应用于方法，表示该方法是重写父类的方法
📗 @Deprecated：用于表示某个程序元素（类或方法）已过时
📗 @SuppressWarnings：抑制编译器的警告
📗 @FunctionalInterface：标志该接口是函数式接口（若接口使用了 @FunctionalInterface 注解，并且该接口中存在多个抽象方法：会报错）

网上学习资料一大堆，但如果学到的知识不成体系，遇到问题时只是浅尝辄止，不再深入研究，那么很难做到真正的技术提升。

需要这份系统化资料的朋友，可以戳这里获取

一个人可以走的很快，但一群人才能走的更远！不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人，都欢迎加入我们的的圈子（技术交流、学习资源、职场吐槽、大厂内推、面试辅导），让我们一起学习成长！

ie-1715646602700)]
[外链图片转存中…(img-cNBk7xhK-1715646602700)]

网上学习资料一大堆，但如果学到的知识不成体系，遇到问题时只是浅尝辄止，不再深入研究，那么很难做到真正的技术提升。

需要这份系统化资料的朋友，可以戳这里获取

一个人可以走的很快，但一群人才能走的更远！不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人，都欢迎加入我们的的圈子（技术交流、学习资源、职场吐槽、大厂内推、面试辅导），让我们一起学习成长！