要创建注释，请使用@interface关键字：

public@interfaceMyAnnotation{}

但是，这还不够，因为不能在任何地方设置这样的注释。 注释需要另外两条信息：

稍后我们将详细介绍。 到目前为止，我们首先需要了解注释的工作方式。 当类从其父类继承代码时，将注解为 。

@Target(ElementType.ANNOTATION_TYPE) (1)
@interfaceFoo{}@Target(ElementType.ANNOTATION_TYPE) (1)
@interfaceBar{}@Foo
@Bar
@interfaceBaz{} (2)

这是@Target和@Retention的源代码：

@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.ANNOTATION_TYPE)
public@interfaceTarget{ (1)ElementType[]value();
}@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.ANNOTATION_TYPE)
public@interfaceRetention{ (2)RetentionPolicyvalue();
}

下面的类图中对此进行了总结：

注释可以定义参数 。 使用注释时，可以使用参数添加某些级别的配置。 参数接受类型和可选的默认值 。 如果在定义注释时未设置该值，则必须在使用它时使用。

参数类型限于以下几种：

@Target(ElementType.CLASS)
@interfaceFoo{intbar();Class<?extendsCollection>baz()defaultList.class;String[]qux();
}@Foo(bar=1,qux={"a","b","c"})
classMyClass{}

如果只有一个参数并将其命名为value ，则在设置时可以省略其名称：

@Target(ElementType.CLASS)
@interfaceFoo{intvalue();
}@Foo(1)
classMyClass{}

自创建以来，Java就允许反射 ：反射是在运行时获取有关代码信息的能力。 这是一个示例：

varsession=request.getHttpSession();
varobject=session.getAttribute("objet"); (1)
varclazz=object.getClass(); (2)
varmethods=clazz.getMethods(); (3)
for(varmethod:methods){if(method.getParameterCount()==0){ (4)method.invoke(foo); (5)}
}

通过注释，反射API得到了相关的改进：

通过注释，框架开始在不同的用例中使用它们。 其中，配置是最常用的配置之一：例如， Spring框架代替了XML（或者更精确地说，除了XML之外），还添加了基于注释的配置选项。

长期以来，用户和提供者都对运行时反射对批注的访问感到满意。 因为它主要集中在配置上，所以反射在启动时发生。 在受限的环境中，这对应用程序来说负担太重：此类环境最著名的示例是Android平台。 人们可能希望在那里拥有最快的启动时间，而启动时间反射方法会使速度变慢。

解决该问题的另一种方法是在编译时处理注释 。 为此，必须将编译器配置为使用特定的注释处理器 。 它们的输出可能不同：简单的文件，生成的代码等。这种方法的权衡之处在于， 每次编译都会对性能造成影响，但不会影响启动时间。

使用此方法生成代码的最早框架之一是Dagger ：它是Android的DI框架。 它不是基于运行时的，而是基于编译时的。 长期以来，编译时代码生成仅限于Android生态系统。

但是，最近，诸如Quarkus和Micronaut之类的后端框架也采用了这种方法。 目的是通过编译时代码生成来代替运行时自省，以减少应用程序启动时间。 此外，将生成的字节码提前编译为本机代码还可以进一步减少启动时间以及内存消耗。

注释处理器的世界非常庞大：本节只是一个很小的介绍，因此如果需要，可以继续进行。

处理器只是需要在编译时注册的特定类。 有几种注册方法。 使用Maven，只需配置编译器插件即可：

处理器本身需要实现Processor ，但是抽象类AbstractProcessor实现其大多数方法，但可以进行process ：实际上，从AbstractProcessor继承就足够了。 这是API的简化图：

让我们创建一个非常简单的处理器。 它只应列出带有特定注释的类。 现实世界中的注释处理器可能会做一些有用的事情， 例如生成代码，但是这种额外的逻辑远远超出了本文的范围。

@SupportedAnnotationTypes("ch.frankel.blog.*") (1)
@SupportedSourceVersion(SourceVersion.RELEASE_8)
publicclassSampleProcessorextendsAbstractProcessor{@Overridepublicbooleanprocess(Set<?extendsTypeElement>annotations, (2)RoundEnvironmentenv){annotations.forEach(annotation->{ (3)Set<?extendsElement>elements=env.getElementsAnnotatedWith(annotation); (4)elements.stream().filter(TypeElement.class::isInstance) (5).map(TypeElement.class::cast) (6).map(TypeElement::getQualifiedName) (7).map(name->"Class "+name+" is annotated with "+annotation.getQualifiedName()).forEach(System.out::println);});returntrue;}
}

无论在运行时还是在编译时使用，注释都非常强大。 另一方面，最大的问题是它们似乎像魔术一样工作：没有简单的方法来知道哪个使用反射的类或注释处理器正在使用它们。 每个人都可以根据自己的情况决定自己的优点是否超过缺点。 在没有任何深思熟虑的情况下使用它们会对代码产生极大的损害....由于意识形态错位而导致丢弃它们与破坏代码一样严重。

我希望这篇文章对注释的工作方式有所启发，以便大家自己决定。