Question

我知道java中的基本注释，如@Override等。

Annotations are only metadata and they do not contain any business logic.

我正在重复oracle documentation页面的注释，以了解java-8新功能。

例如，您正在编写代码以使用timer service that enables you to run a method at a given time or on a certain schedule, similar to the UNIX cron service。现在，您要设置一个计时器，以便在该月的最后一天以及每周五的晚上11点运行方法doPeriodicCleanup。要将计时器设置为运行，请创建@Schedule注释并将其应用于doPeriodicCleanup方法两次。

@Schedule(dayOfMonth="last")
@Schedule(dayOfWeek="Fri", hour="23")
public void doPeriodicCleanup() { ... }

声明可重复的注释类型

注释类型必须使用@Repeatable元注释进行标记。以下示例定义自定义@Schedule可重复注释类型：

import java.lang.annotation.Repeatable;

@Repeatable(Schedules.class)
public @interface Schedule {
  String dayOfMonth() default "first";
  String dayOfWeek() default "Mon";
  int hour() default 12;
}

声明包含注释类型

包含注释类型必须具有带数组类型的value元素。数组类型的组件类型必须是可重复的注释类型。包含注释类型的计划的声明如下：

public @interface Schedules {
    Schedule[] value();
}

我不明白@Schedules注释的使用和使用。它现在如何适用于以下方法？。

public void doPeriodicCleanup() { ... }

提前致谢。

Answer 1

在Java 8之前，给定的注释只能在方法（或类或字段等）上设置一次。因此，如果您希望能够在单个方法上设置两个不同的计划，则必须定义一个“包装”注释，例如Schedules，其中包含Schedule个注释数组。

开发人员因此必须做这样的事情：

@Schedules(value = {
    @Schedule(dayOfMonth="last"),
    @Schedule(dayOfWeek="Fri", hour="23")
})

这不是非常易读，并且除了包含多个Schedule注释之外，Schedules注释没有任何其他用途。

为了减少样板，但保持注释API相同，现在允许使用

简单地注释方法

@Schedule(dayOfMonth="last"),
@Schedule(dayOfWeek="Fri", hour="23")

通过将Schedule声明为可重复并指定其“包装”注释。但它只是语法糖，导致与前面的代码相同：在运行时，该方法被视为使用包含两个Schedule的单个Schedules注释进行注释。编译器将第二段代码转换为第一段代码。

java-8可重复的自定义注释

1 个答案: