java中注解解析

向阳花自开

已于 2024-08-13 13:55:03 修改

阅读量249

点赞数 3

分类专栏： Java学习文章标签： java 开发语言

于 2024-08-12 10:25:42 首次发布

本文链接：https://blog.csdn.net/m0_55477902/article/details/141124686

版权

3 篇文章 0 订阅

订阅专栏

在 Java 中，注解（Annotation） 是一种用来给代码添加元数据的机制。你可以把注解理解为一种特殊的标记或标签，通过这些标记，你可以告诉编译器、工具、或者运行时环境对代码进行一些额外的处理。

想象一下你在图书馆借了一本书，上面贴了一个“新书推荐”的标签。这个标签不会改变书的内容，但它告诉你和其他读者这本书很值得一读。注解在代码中也是类似的作用，它不会直接影响代码的执行，但它可以告诉编译器、开发工具，或者运行时环境如何处理这些代码。

编译时的检查：一些注解可以帮助编译器在编译期间检查代码，比如 @Override 注解，用来标明一个方法是重写父类的方法。如果你不小心拼错了方法名，编译器就会提示错误。
简化代码配置：注解可以用来减少冗长的配置，比如在框架中常用的 @Autowired，它可以自动注入依赖，而不需要手动编写代码来创建对象。
代码生成和处理：一些注解可以用来生成代码，或者在运行时对代码进行处理。比如 JPA 中的 @Entity 注解告诉框架这个类是一个数据库实体类，框架会自动生成数据库表结构等。

注解就像代码中的“提示牌”，让其他人和工具知道该如何处理某些代码部分，而不会改变代码的本质逻辑。
在 Java 中，有很多常用的注解，它们被广泛应用于各种场景，尤其是在日常的开发中和使用各种框架时。以下是一些最常用的注解以及它们的用途：

这些注解是 Java 标准库中提供的，常用于基本的代码检查和文档生成。

@Override：
- 用途：表示一个方法是重写父类方法。它帮助编译器检查你是否正确地重写了方法。
- 示例：
```
@Override
public String toString() {
    return "MyClass";
}
```
@Deprecated：
- 用途：标记某个方法、类或字段已经过时，不建议使用。使用这个注解的代码在编译时会发出警告。
- 示例：
```
@Deprecated
public void oldMethod() {
    // ...
}
```
@SuppressWarnings：
- 用途：告诉编译器忽略特定的警告。常用于压制一些不必要的编译器警告，比如未检查的泛型类型。
- 示例：
```
@SuppressWarnings("unchecked")
public void myMethod() {
    List list = new ArrayList();
}
```

元注解是用来注解其他注解的注解。

@Retention：
- 用途：指定注解的保留策略，即注解在什么阶段保留（源码、字节码、运行时）。
- 示例：
```
@Retention(RetentionPolicy.RUNTIME)
public @interface MyAnnotation {
    // ...
}
```
@Target：
- 用途：指定注解可以应用的目标（类、方法、字段等）。
- 示例：
```
@Target(ElementType.METHOD)
public @interface MyAnnotation {
    // ...
}
```
@Documented：
- 用途：表示注解会被包含在 Javadoc 中。
- 示例：
```
@Documented
public @interface MyAnnotation {
    // ...
}
```
@Inherited：
- 用途：表示一个注解可以被子类继承。
- 示例：
```
@Inherited
public @interface MyAnnotation {
    // ...
}
```

这些注解通常用于编译期注解处理器的开发。

@SafeVarargs：
- 用途：用于静态方法或构造函数中的可变参数，表示对可变参数的使用是安全的。
- 示例：
```
@SafeVarargs
public final void myMethod(List<String>... lists) {
    // ...
}
```
@FunctionalInterface：
- 用途：标记接口为函数式接口（即仅包含一个抽象方法的接口）。
- 示例：
```
@FunctionalInterface
public interface MyFunctionalInterface {
    void execute();
}
```

这些注解通常用于特定框架，如 Spring 或 JPA。

Spring 框架：
- @Autowired：自动注入依赖对象。
- @Component、@Service、@Repository、@Controller：标记为 Spring 容器的组件，用于自动扫描和实例化。
- @RequestMapping：用于映射 HTTP 请求到控制器方法。
JPA（Java Persistence API）：
- @Entity：表示一个类是 JPA 实体。
- @Table：指定数据库表的名称。
- @Id：指定实体的主键。
- @GeneratedValue：指定主键的生成策略。
- @Column：用于指定列的详细信息，比如名称、类型、长度等。

这些注解主要用于单元测试框架，如 JUnit 和 TestNG。

JUnit 4：
- @Test：表示一个方法是测试方法。
- @Before：在每个测试方法前运行。
- @After：在每个测试方法后运行。
- @BeforeClass：在所有测试方法之前运行一次。
- @AfterClass：在所有测试方法之后运行一次。
JUnit 5：
- @Test：表示一个方法是测试方法。
- @BeforeEach：在每个测试方法前运行。
- @AfterEach：在每个测试方法后运行。
- @BeforeAll：在所有测试方法之前运行一次。
- @AfterAll：在所有测试方法之后运行一次。