如果你已经在使用Java编程，并且也使用了任何像Spring和Hibernate这样的流行框架，那么你应该对注解的使用非常地熟悉。使用一个现有框架工作的时候，通常使用它的注解就够了。但是，你是不是也有时候有要创建属于你自己的注解的需求呢?
不久之前，我找到了一个自己创建一个注解的理由，那是一个涉及验证存储在多种数据库中的常用数据的项目。 场景描述该业务有多种数据库都存储着相同的数据，它们有各自不同的保持数据更新的方法. 该业务曾计划把所有这些数据都整合到一个主数据库中，以减轻涉及到多种数据源所带来的问题的复杂性.
不过在项目开始之前，业务还需要知道数据距离可以同步还有多少差距，并做出任何必要的修正来使其可以进行同步.
第一步需要创建一个展示那些数据多种数据库的通用数据的报表，并对其值进行验证, 对那些不符合条件的记录进行高亮显示.
这里有一个对当时需求的简短摘要:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 | @Target(ElementType.FIELD)@Retention(RetentionPolicy.RUNTIME)public @interface ReconField { /** * Value indicates whether or not the values from the specified sources should be compared or will be used to display values or reference within a rule. * * @return The value if sources should be compared, defaults to true. */ boolean compareSources() default true; /** * Value indicates the format that should be used to display the value in the report. * * @return The format specified, defaulting to native. */ ReconDisplayFormat displayFormat() default ReconDisplayFormat.NATIVE; /** * Value indicates the ID value of the field used for matching source values up to the field. * * @return The ID of the field. */ String id(); /** * Value indicates the label that should be displayed in the report for the field. * * @return The label value specified, defaults to an empty string. */ String label() default ""; /** * Value that indicates the sources that should be compared for differences. * * @return The list of sources for comparison. */ ReconSource[] sourcesToCompare() default {};} |
这是驱动数据比对过程如何运作的主要注解. 它包含的基本要素，可以满足不同数据源间数据进行比较的大部分需求. @ReconField 可以处理除更加复杂的比对之外，我们所期望的大多数需求, 而更加复杂的情况我们将会在稍后有所讨论. 这些要素的大多数在代码清单中一对一的注释中都有介绍, 而需要指出的是，在我们的@ReconField上有几个关键的注解.
@Target – 这个注解可以让你来指定你的注解应该被用在那个java元素上. 可能的目标类型是 ANNOTATION_TYPE, CONSTRUCTOR, FIELD, LOCAL_VARIABLE, METHOD, PACKAGE, PARAMETER 和 TYPE. 在我们的 @ReconField 注解中他被指定到了 FIELD 级别.
@Retention – 它可以让你指定注解在何时生效. 可能的值有 CLASS, RUNTIME 和 SOURCE. 因为我们将会在运行时 RUNTIME 处理这个注解, 所以那就是我们需要设置的值.
