创建自己的Java批注

如果您一直在用Java编程并且使用诸如Spring和Hibernate之类的任何流行框架,那么您应该对使用注释非常熟悉。 当使用现有框架时,其注释通常就足够了。 但是,您是否发现需要创建自己的注释?

不久之前,我找到了一个理由来为一个项目创建自己的注释,该注释涉及验证存储在多个数据库中的公共数据。

场景

该企业有多个存储相同信息的数据库,并且具有使数据保持最新状态的各种方法。 该企业已经计划了一个将数据整合到主数据库中的项目,以减轻与拥有多个数据源有关的一些问题。

但是,在项目开始之前,业务部门需要了解数据之间的不同步程度,并进行必要的更正以恢复同步。 第一步需要创建一个报告,该报告显示属于多个数据库的公共数据并验证值,并根据定义的对帐规则突出显示所有不匹配的记录。 这是当时需求的简短摘要:

  • 比较多个数据库之间的数据以获取一条公共数据,例如客户,公司或目录信息。
  • 默认情况下,根据值的类型,找到的值应与所有数据库完全匹配。
  • 对于某些字段,我们只希望显示找到的值,而不执行任何数据比较。
  • 对于某些字段,我们只想比较找到的值并在指定的特定数据源上执行数据验证。
  • 对于某些字段,我们可能希望根据记录中其他字段的值进行一些复杂的数据比较。
  • 对于某些字段,我们可能希望将数据格式化为特定格式,例如,金额为$ 000,000.00。
  • 该报告应采用MS Excel格式,每行应包含来自每个来源的字段值。 根据数据验证规则不匹配的任何行应以黄色突出显示。

注解

在研究了需求并提出了一些想法之后,我决定使用批注来驱动数据比较和报告过程的配置。 我们需要一些简单但又高度灵活和可扩展的东西。 这些注释将在字段级别,我喜欢这样的事实,即不会将配置隐藏在类路径上的某个文件中。 相反,您将能够查看与字段相关联的注释,以确切地知道将如何处理它。

用最简单的术语来说,注释不过是标记,即提供信息但对代码本身的操作没有直接影响的元数据。 如果您已经从事Java编程已有一段时间,那么您应该对它们的使用非常熟悉,但是也许您根本不需要创建自己的Java编程。 为此,您需要创建一个使用Java类型@interface的新类型,该类型将包含指定元数据详细信息的元素。

这是该项目的一个示例:

@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处理此批注,因此需要对其进行设置。

此数据验证过程将对每个数据库运行一个查询,然后将结果映射到一个通用数据bean,该bean代表该特定类型的业务记录的所有字段。 此映射数据Bean的每个字段上的注释告诉处理器如何针对该特定字段及其在每个数据库中找到的值执行数据比较。 因此,让我们看一些如何将这些注释用于各种数据比较配置的示例。

要验证该值是否存在并在每个数据源中完全匹配,您只需提供字段ID和应在报告中为该字段显示的标签。

@ReconField(id = CUSTOMER_ID, label = "Customer ID")
private String customerId;

要显示在每个数据源中找到的值,但不进行任何数据比较,则需要指定元素compareSources并将其值设置为false。

@ReconField(id = NAME, label = "NAME", compareSources = false)
private String name;

要验证在特定数据源中找到的值,但不是全部,请使用元素sourcesToCompare 。 使用此选项将显示找到的所有值,但仅对元素中列出的数据源执行任何数据比较。 处理某些数据没有存储在每个数据源中的情况。 ReconSource是一个枚举,其中包含可用于比较的数据源。

@ReconField(id = PRIVATE_PLACEMENT_FLAG, label = "PRIVATE PLACEMENT FLAG", sourcesToCompare ={ ReconSource.LEGACY, ReconSource.PACE })
private String privatePlacementFlag;

既然我们已经满足了基本要求,我们就需要解决运行特定于相关领域的复杂数据比较的功能。 为此,我们将创建第二个注释,以驱动自定义规则的处理。

@Target(ElementType.FIELD)
@Retention(RetentionPolicy.RUNTIME)
public @interface ReconCustomRule {/**
* Value indicates the parameters used to instantiate a custom rule processor, the default value is no parameters.
*
* @return The String[] of parameters to instantiate a custom rule processor.
*/
String[] params() default {};/**
* Value indicates the class of the custom rule processor to be used in comparing the values from each source.
*
* @return The class of the custom rule processor.
*/
Class<?> processor() default DefaultReconRule.class;}

与先前的注释非常相似, @ ReconCustomRule注释中的最大区别是我们指定了一个在执行侦察过程时将执行数据比较的类。 您只能定义将要使用的类,因此您的处理器将必须实例化并初始化您指定的任何类。 在此批注中指定的类将需要实现自定义规则接口,规则处理器将使用该接口执行规则。

现在,让我们看一下此注释的几个示例。

在此示例中,我们使用自定义规则,该规则将检查证券交易所是否不是美国,如果是这种情况,则跳过数据比较。 为此,规则将需要检查同一记录上的“交换国家/地区”字段。

@ReconField(id = STREET_CUSIP, label = "STREET CUSIP", compareSources = false)
@ReconCustomRule(processor = SkipNonUSExchangeComparisonRule.class)
private String streetCusip;

这是一个示例,其中我们为自定义规则指定了一个参数,在这种情况下,这是一个公差值。 对于此特定数据比较,要比较的值相差不能超过1,000。 通过使用参数指定容差量,这使我们可以在具有不同容差量的多个字段上使用相同的自定义规则。 唯一的缺点是这些参数是静态的,由于注释的性质而不能是动态的。

@ReconField(id = USD_MKT_CAP, label = "MARKET CAP USD", displayFormat = ReconDisplayFormat.NUMERIC_WHOLE, sourcesToCompare =
{ ReconSource.LEGACY, ReconSource.PACE, ReconSource.BOB_PRCM })
@ReconCustomRule(processor = ToleranceAmountRule.class, params =	{ "10000" })
private BigDecimal usdMktCap;

如您所见,我们仅使用几个相当简单的注释就为多个数据库的数据验证报告设计了相当多的灵活性。 对于这种特殊情况,注释正在驱动数据比较处理,因此我们实际上是在评估在映射的数据bean上找到的注释,并使用这些注释来指导处理。

结论

关于Java注释,它们的作用以及使用它们的规则,已有许多文章。 我想让本文更多地关注一个示例,说明为什么您可能想要考虑使用它们并直接看到其好处。

请记住,这只是一个起点,一旦您决定创建批注,您仍然需要弄清楚如何处理它们以真正充分利用它们。 在第二部分中,我将向您展示如何使用Java反射来处理这些注释。 在此之前,这里有一些很好的资源,可以了解有关Java注释的更多信息:

  • Java注释教程– http://docs.oracle.com/javase/tutorial/java/annotations/
  • Java注释-http: //tutorials.jenkov.com/java/annotations.html
  • 注释的工作方式– http://java.dzone.com/articles/how-annotations-work-java

翻译自: https://www.javacodegeeks.com/2014/07/creating-your-own-java-annotations.html

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.mzph.cn/news/362973.shtml

如若内容造成侵权/违法违规/事实不符,请联系多彩编程网进行投诉反馈email:809451989@qq.com,一经查实,立即删除!

相关文章

浅谈MAXIMO项目实施(转)

浅谈MAXIMO项目实施工作以来&#xff0c;参与了XX公司的MAXIMO项目实施&#xff0c;妄谈一些工作中的感受和对MAXIMO的理解&#xff0c;欢迎砖头。[b]对MAXIMO的理解[/b]MAXIMO是老外的软件&#xff0c;是J2EE上架起的很成熟的平台级系统&#xff0c;其中融入了老外的管理方式和…

完整机器学习项目的流程

1 抽象成数学问题 明确问题是进行机器学习的第一步。机器学习的训练过程通常都是一件非常耗时的事情&#xff0c;胡乱尝试时间成本是非常高的。 这里的抽象成数学问题&#xff0c;指的明确我们可以获得什么样的数据&#xff0c;抽象出的问题&#xff0c;是一个分类还是回归或者…

使用Stream API的类Java产量

几种编程语言&#xff08;例如Ruby或Python等&#xff09;提供yield命令。 在内存消耗方面&#xff0c;Yield提供了一种有效的方式&#xff0c;可以通过按需生成值来创建一系列值。 有关Python产量的更多信息。 让我们考虑一个需要大量安全随机整数的类或方法。 经典方法是创建…

深入理解DOM节点类型第六篇——特性节点Attribute

前面的话 元素的特性在DOM中以Attr类型表示&#xff0c;从技术角度讲&#xff0c;特性是存在于元素的attributes属性中的节点。尽管特性是节点&#xff0c;但却不是DOM节点树的一部分。本文将详细介绍该部分内容 特征 特性节点的三个node属性————nodeType、nodeName、nodeV…

Vista,Windows7中给IIS7添加PHP支持

截止到发文时&#xff08;2009年9月25日&#xff09;&#xff0c;PHP是最新版本为5.3.0&#xff0c;但是5.3.0在IIS中的运行方式是FastCGI&#xff0c;要在Vista的IIS7上实现这一点我始终没弄成。最后我还是用的老方法&#xff0c;ISAPI&#xff0c;选用了一个5.3以前的版本&am…

python画手绘图

第一步&#xff1a;插入代码 #e17.1HandDrawPic.py from PIL import Image import numpy as np vec_el np.pi/2.2 # 光源的俯视角度&#xff0c;弧度值 vec_az np.pi/4. # 光源的方位角度&#xff0c;弧度值 depth 10. # (0-100) im Image.open(C:\\Users\\Thinkpad\\Deskt…

cf1208G Polygons 欧拉函数

链接 cf 给你两个正整数\(n\)和\(k\)&#xff0c;询问在一个圆上你最少需要几个点构才能造出\(k\)个边数小于等于\(n\)的正多边形 思路 深受迫害&#xff0c;所以写的详细一点&#xff0c;不会请留言。 性质1 考虑加进一个\(x\)边形。那么他的因子\(d\)一定在他之前加进来了. 因…

Java 8:功能性VS传统

业务逻辑是相同的&#xff1a; 给定一个由访问次数/时间组成的String表达式&#xff0c;例如&#xff1a;“ 1 / 24h&#xff0c;1..3 / 3h&#xff0c;5 / *” 然后&#xff0c;结果应为以下字符串列表&#xff1a; “ 1 / 24h”&#xff0c; “ 1 / 3h”&#xff0c;“ 2…

深入学习jQuery选择器系列第六篇——过滤选择器之状态选择器

前面的话 过滤选择器的内容非常多&#xff0c;本文介绍过滤选择器的最后一部分——状态选择器 焦点状态 :focus :focus选择器选择当前获得焦点的元素 <div><button>btn1</button><button>btn2</button><button>btn3</button></d…

aop 幂等验证(二)

1 创建IIdempotent Target({ElementType.PARAMETER, ElementType.METHOD}) Retention(RetentionPolicy.RUNTIME) Documented public interface IIdempotent { } 2 创建aop Component Aspect public class IdempotentAction {public final static String ERROR_REPEATSUBMIT &q…

pursuit of happiness

看的过程中&#xff0c;一直在看时间&#xff0c;只剩30分钟了&#xff0c;20分&#xff0c;15分了&#xff0c;主人公怎么还没发达。 因为那种痛苦&#xff0c;绝望&#xff0c;沮丧&#xff0c;真的可以隔着屏幕传递过来。 你会带着儿子住厕所么&#xff1f; 你会拼了老命赶时…

解读阿里巴巴集团的“大中台、小前台”组织战略

解读阿里巴巴集团的“大中台、小前台”组织战略 https://www.iyiou.com/p/92012.html 亿欧导读 ] 阿里的“中台战略” 不是一个简单的组织变革&#xff0c;还有业务变革、机制变革、技术架构变革的一次全面转型。 【编者按】阿里巴巴“大中台小前台”的中台战略的官方提法源自2…

编译时检查JPA查询

JPA提供了几种查询数据的方法。 可以根据各种标准&#xff08;例如&#xff0c;所使用的语言&#xff08;SQL与JPQL&#xff09;或查询是静态的&#xff08;编译时间&#xff09;还是动态的&#xff08;执行时间&#xff09;&#xff09;对此类替代方案进行分类。 静态查询是使…

深入理解DOM节点关系

前面的话 DOM可以将任何HTML描绘成一个由多层节点构成的结构。节点分为12种不同类型&#xff0c;每种类型分别表示文档中不同的信息及标记。每个节点都拥有各自的特点、数据和方法&#xff0c;也与其他节点存在某种关系。节点之间的关系构成了层次&#xff0c;而所有页面标记则…

Windows服务编写

摘要&#xff1a;几乎所有的操作系统在启动的时候都会启动一些不需要与用户交互的进程&#xff0c;这些进程在Windows中就被称作服务。它由服务程序、服务控制程序&#xff08;&#xff33;&#xff23;&#xff30;&#xff0c;service control program&#xff09;和服务控制…

1031 查验身份证 (15 分)

#include <iostream> #include <string> using namespace std; int main() {int n, i, sum 0, cnt 0; // 这是为零很重要string s;int w[17] { 7,9,10,5,8,4,2,1,6,3,7,9,10,5,8,4,2 };char z[11] { 1, 0, X, 9, 8, 7, 6, 5, 4, 3, 2 };cin >> n;getcha…

分布式锁(基于redis和zookeeper)详解

分布式锁&#xff08;基于redis和zookeeper&#xff09;详解 https://blog.csdn.net/a15835774652/article/details/81775044 为什么写这篇文章&#xff1f; 目前网上大部分的基于zookeeper&#xff0c;和redis的分布式锁的文章都不够全面。要么就是特意避开集群的情况&#xf…

深入理解this机制系列第三篇——箭头函数

前面的话 this机制与函数调用有关&#xff0c;而作用域则与函数定义有关。有没有什么是可以将this机制和作用域联系起来的呢&#xff1f;本文将介绍ES6新增的内容——箭头函数 痛点 对于闭包的痛点在于&#xff0c;闭包的this默认绑定到window对象&#xff0c;但又常常需要访问…

C# CheckedListBox控件的用法

最近用到checklistbox控件&#xff0c;在使用其过程中&#xff0c;花了较多的时间&#xff0c;这里我收集了其相关的代码段&#xff0c;希望对大家有所帮助。1.添加项checkedListBox1.Items.Add("蓝色"); checkedListBox1.Items.Add("红色"); checkedListB…

如何从JSF获取JSON响应?

许多JavaScript小部件都希望使用JSON格式的数据和选项。 如今&#xff0c;选择一个很酷的小部件并将其包装在一个复合组件中确实很容易。 但是第一个问题是如何发送AJAX请求并以正确的JSON格式接收响应。 JSF用户经常会提出这个问题 。 您需要的只是一个XHTML facelet&#xff…