【官方】Java官方笔记10注解

image1

注解

注解的作用：

  • Information for the compiler — Annotations can be used by the compiler to detect errors or suppress warnings.

  • Compile-time and deployment-time processing — Software tools can process annotation information to generate code, XML files, and so forth.

  • Runtime processing — Some annotations are available to be examined at runtime.

注解格式，使用@：

@Entity

带key-value：

@Author(
   name = "Benjamin Franklin",
   date = "3/27/2003"
)
class MyClass { ... }

只有1个key时可以省略key：

@SuppressWarnings(value = "unchecked")
void myMethod() { ... }

@SuppressWarnings("unchecked")
void myMethod() { ... }

同时使用多个注解：

@Author(name = "Jane Doe")
@EBook
class MyClass { ... }

The annotation type can be one of the types that are defined in the `java.lang <https://docs.oracle.com/en/java/javase/20/docs/api/java.base/java/lang/package-summary.html>`__ or `java.lang.annotation <https://docs.oracle.com/en/java/javase/20/docs/api/java.base/java/lang/annotation/package-summary.html>`__ packages of the Java SE API.

哪里能用注解

① Annotations can be applied to declarations: declarations of classes, fields, methods, and other program elements.

② Java SE 8，annotations can also be applied to the use of types：

  • Class instance creation expression:

    new @Interned MyObject();

  • Type cast:

    myString = (@NonNull String) str;

  • implements clause:

    class UnmodifiableList<T> implements
  @Readonly List<@Readonly T> { ... }

  • Thrown exception declaration:

    void monitorTemperature() throws
  @Critical TemperatureException { ... }

自定义注解

使用@interface：

@interface ClassPreamble {
   String author();
   String date();
   int currentRevision() default 1;
   String lastModified() default "N/A";
   String lastModifiedBy() default "N/A";
   // Note use of array
   String[] reviewers();
}

注解其实也是一种接口，只是要使用@来声明。

使用：

@ClassPreamble (
   author = "John Doe",
   date = "3/17/2002",
   currentRevision = 6,
   lastModified = "4/12/2004",
   lastModifiedBy = "Jane Doe",
   // Note array notation
   reviewers = {"Alice", "Bob", "Cindy"}
)
public class Generation3List extends Generation2List {

// class code goes here

}

Java预置注解

@Deprecated

// Javadoc comment follows
/**
 * @deprecated
 * explanation of why it was deprecated
 */
@Deprecated
static void deprecatedMethod() { }

@Override

// mark method as a superclass method
// that has been overridden
@Override
int overriddenMethod() { }

@SuppressWarnings

// use a deprecated method and tell
// compiler not to generate a warning
@SuppressWarnings("deprecation")
void useDeprecatedMethod() {
    // deprecation warning
    // - suppressed
    objectOne.deprecatedMethod();
}

@SafeVarargs

@FunctionalInterface

注解上的注解：Annotations that apply to other annotations are called meta-annotations. There are several meta-annotation types defined in `java.lang.annotation <https://docs.oracle.com/en/java/javase/20/docs/api/java.base/java/lang/annotation/package-summary.html>`__.

@Retention

@Documented

@Target

@Inherited

@Repeatable

重复注解也是允许的：

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

重复注解的定义要用到@Repeatable：

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

并且，The containing annotation type must have a value element with an array type：

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

the containing annotation type is @Schedules, so repeating @Schedule annotations is stored in an @Schedules annotation.

Schedule[] value()是一个没有参数、返回类型为Schedule[]的方法的声明，它是一个抽象方法。事实上，这个方法声明是用来定义注解的属性的，与普通方法不同的是，它没有方法体，只有方法声明，而方法的具体实现则由使用该注解的代码来完成。在使用该注解时，也可以通过指定该属性的值来进行赋值操作，例如：

@Schedules({
        @Schedule(dayOfMonth="last"),
        @Schedule(dayOfWeek="Fri", hour="23")
})
public class MyScheduledTask {
    // ...
}

在上述代码中，我们使用了@Schedules注解，并且指定了它的value属性，也就是给Schedule[] value()方法赋上相应的值。注意到，该属性的值是一个注解数组，因此需要使用大括号{}将多个注解组合起来。

参考资料：

Annotations https://dev.java/learn/annotations/