建立代理,而不是框架

自从引入Java注释以来,它已成为大型应用程序框架API的组成部分。 此类API的良好示例是Spring或Hibernate的示例,其中添加了几行注释代码可实现非常复杂的程序逻辑。 尽管人们可以争论这些特定API的缺点,但大多数开发人员都会同意,正确使用这种形式的声明性编程非常有表现力。 但是,只有极少数的开发人员选择为其自己的框架或应用程序中间件实现基于注释的API,主要是因为它们难以实现。 在下一篇文章中,我想说服您,相比之下,此类API的实现非常简单,并且使用正确的工具不需要任何有关Java内在函数的专门知识。

实施基于注释的API时,一个非常明显的问题是,正在执行的Java运行时未处理注释。 结果,不可能为给定的用户注释分配特定的含义。 例如,考虑我们想要定义一个@Log批注,该批注我们希望提供它用于简单地记录每次被注释方法的调用:

class Service {@Logvoid doSomething() { // do something ...}
}

由于@Log注释@Log@Log就无法执行程序逻辑,因此,注释的用户可以执行所请求的日志记录。 显然,这使注释几乎无用,因为我们无法调用doSomething方法,并且期望在日志中观察到相应的语句。 到目前为止,注释仅充当标记,而没有贡献任何程序逻辑。

缩小差距

为了克服这种明显的局限性,许多注释驱动的框架将子类与方法重写结合使用以实现与特定注释关联的逻辑。 这通常称为子类检测。 对于建议的@Log注释,子类检测将导致创建一个类似于以下LoggingService

class LoggingService extends Service {@Overridevoid doSomething() { Logger.log("doSomething() was called");super.doSomething();}
}

当然,上述类通常不需要显式实现。 相反,这是一种流行的方法,仅在运行时使用诸如cglib或Javassist之类的代码生成库来生成此类。 这两个库均提供用于创建程序增强子类的简单API。 作为将类的创建延迟到运行时的一个很好的副作用,建议的日志记录框架无需任何特殊的准备就可以使用,并且始终与用户代码保持同步。 如果以更明确的方式创建类(例如通过在构建过程中编写Java源文件)来创建类,情况就不会如此。

但是,它可扩展吗?

然而,该解决方案带来了另一个缺点。 通过将注释的逻辑放入生成的子类中,必须不再通过其构造函数实例化示例Service类。 否则,仍然不会记录对带注释的方法的调用:显然,调用构造函数不会创建所需子类的实例。 更糟的是,当使用建议的运行时生成方法时,由于Java编译器不知道运行时生成的类,因此LoggingService无法直接实例化。

因此,诸如Spring或Hibernate之类的框架使用对象工厂,并且不允许直接实例化被视为其框架逻辑一部分的对象。 使用Spring,由于所有Spring对象都是已经由框架首先创建的托管Bean,因此自然可以通过工厂创建对象。 同样,大多数Hibernate实体是作为查询结果创建的,因此不会显式实例化。 但是,例如在保存尚未在数据库中表示的实体实例时,Hibernate的用户需要用存储后从Hibernate返回的实例替换最近保存的实例。 通过查看有关Hibernate的问题,忽略这种替代已经构成了一个常见的初学者错误。 除此之外,由于有了这些工厂,子类​​检测对于框架用户来说几乎是透明的,因为Java的类型系统暗示子类可以替代其任何超类。 因此, LoggingService的实例可以在用户期望用户定义的Service类的实例的任何地方使用。

不幸的是,事实证明,这种批准的实例工厂方法很难实现建议的@Log注释,因为这将需要对可能被注释的类的每个单个实例使用工厂。 显然,这将增加大量的样板代码。 通过不将日志记录指令硬编码到方法中,我们甚至有可能创建比我们避免的样板更多的样板。 同样,意外使用构造函数会给Java程序带来一些细微的错误,因为此类实例上的注释将不再像我们期望的那样被对待。 另一个问题是,工厂不容易构成。 如果我们想向已经是Hibernate bean的类添加@Log注释怎么办? 这听起来很琐碎,但需要大量配置才能合并两个框架的工厂。 最后,最终的工厂膨胀的代码看起来不会太漂亮,以致于无法使用该框架进行迁移。 这是使用Java代理进行检测的地方。 这种低估的检测形式为讨论的子类检测提供了很好的选择。

一个简单的代理

Java代理由一个简单的jar文件表示。 与普通Java程序类似,Java代理将某些类定义为入口点。 然后,期望此类定义一个静态方法,该方法在调用实际Java程序的main方法之前将被调用:

class MyAgent {public static void premain(String args, Instrumentation inst) {// implement agent here ...}
}

处理Java代理时,最有趣的部分是premain方法的第二个参数,它表示Instrumentation接口的实例。 通过定义ClassFileTransformer此接口提供了一种挂接到Java的类加载过程的方法。 使用此类转换器,我们可以在首次使用Java程序之前对其进行增强。

乍一看,使用此API听起来可能很直接,但它却带来了新的挑战。 通过更改已编译的Java类(表示为Java字节码)来执行类文件转换。 实际上,Java虚拟机不知道编程语言是什么Java。 相反,它仅处理此字节码。 还要感谢字节码抽象,JVM能够轻松运行其他语言,例如Scala或Groovy。 结果,注册的类文件转换器仅提供将给定的字节(代码)数组转换为另一个数组的功能。

尽管诸如ASM或BCEL之类的库提供了用于处理已编译Java类的简单API,但只有很少的开发人员具有处理原始字节码的经验。 更糟糕的是,正确执行字节码操作通常很麻烦,并且即使虚拟机因抛出令人讨厌且不可恢复的VerifierError而弥补了很小的错误。 幸运的是,有更好,更轻松的方式来处理字节码。

我编写和维护的Byte Buddy库提供了一个简单的API,用于处理已编译的Java类和创建Java代理。 在某些方面,Byte Buddy是类似于cglib和Javassist的代码生成库。 但是,除了那些库以外,Byte Buddy还提供了一个统一的API,用于实现子类和重新定义现有的类。 但是,对于本文,我们只希望研究使用Java代理重新定义类。 好奇的读者可以参考Byte Buddy的网页,该网页提供了有关其完整功能集的详细教程 。

使用Byte Buddy作为简单代理

字节伙伴提供的一种定义工具的方法是使用依赖项注入。 这样做,一个拦截器类(由任何普通的旧Java对象表示)都可以通过其参数的注释简单地请求任何所需的信息。 例如,通过在“ Method类型的参数上使用Byte Buddy的@Origin批注,Byte Buddy可以@Origin出拦截器想知道要拦截的方法。 这样,我们可以定义一个通用拦截器,该拦截器始终知道要拦截的方法:

class LogInterceptor {static void log(@Origin Method method) {Logger.log(method + " was called");} 
}

当然,Byte Buddy附带了更多注释。

但是,此拦截器如何表示我们打算用于拟议的日志记录框架的逻辑? 到目前为止,我们仅定义了一个记录方法调用的拦截器。 我们错过的是该方法的原始代码的后续调用。 幸运的是,Byte Buddy的乐器是可组合的。 首先,我们为最近定义的LogInterceptor定义一个MethodDelegation ,默认情况下,该方法在每次调用方法时都会调用拦截器的静态方法。 从此开始,我们可以随后以SuperMethodCall表示的原始方法代码的后续调用来组成委托:

MethodDelegation.to(LogInterceptor.class).andThen(SuperMethodCall.INSTANCE)

最后,我们需要告知Byte Buddy有关指定工具要拦截的方法的信息。 如前所述,我们希望该工具适用于任何使用@Log注释的方法。 在字节伙伴中,可以使用类似于Java 8谓词的ElementMatcher来标识方法的这种属性。 在静态实用程序类ElementMatchers ,我们已经可以找到一个合适的匹配器,用于标识带有给定注释的方法: ElementMatchers.isAnnotatedWith(Log.class)

有了这些,我们现在可以定义一个实现建议的日志记录框架的代理。 对于Java代理,Byte Buddy提供了一个实用程序API,该API建立在我们刚刚讨论的类修改API的基础上。 与后一种API相似,它被设计为特定领域的语言,因此仅通过查看实现即可轻松理解其含义。 如我们所见,定义这样的代理仅需要几行代码:

class LogAgent {public static void premain(String args, Instrumentation inst) {new AgentBuilder.Default().rebase(ElementMatchers.any()).transform( builder -> return builder.method(ElementMatchers.isAnnotatedWith(Log.class)).intercept(MethodDelegation.to(LogInterceptor.class).andThen(SuperMethodCall.INSTANCE)) ).installOn(inst);}
}

请注意,这种最小的Java代理不会干扰应用程序的其余部分,因为任何执行代码都会观察所检测的Java类,就像将日志记录语句硬编码到任何带注释的方法中一样。

那现实生活呢?

当然,提出的基于代理的记录器是一个简单的例子。 通常情况下,提供类似功能的广泛框架非常有用,例如Spring或Dropwizard。 但是,对于如何解决编程问题,人们通常也对此类框架持意见。 对于大量的软件应用程序,这可能不是问题。 但是,有时这些意见会阻碍更大的发展。 然后,围绕框架关于如何做事情的假设进行工作,不仅会导致一些问题,而且还会导致抽象的泄漏,并可能导致软件维护成本激增。 尤其是当应用程序随时间增长和变化并且其需求与基础框架所提供的需求有所不同时,尤其如此。

相反,当以图片混合的方式组成更专业的框架或库时,一个简单地用另一个替换了有问题的组件。 如果这两种方法都不起作用,甚至可以实施自定义解决方案,而不会干扰应用程序的其余部分。 据我们了解,这似乎很难在JVM上实现,这主要是Java严格的类型系统的结果。 但是,使用Java代理很有可能克服这些类型限制。

我的观点是,我认为至少所有跨领域的问题都应该由代理驱动的专用库来解决,而不是由整体框架的内置模块来解决。 我真的希望更多的应用程序会考虑这种方法。 在最琐碎的情况下,使用代理在感兴趣的方法上注册侦听器并将其从那里获取就足够了。 这种组成代码模块的间接方法避免了我在遇到的大部分Java应用程序中观察到的强大凝聚力。 作为一个很好的副作用,它也使测试非常容易。 与运行测试类似,在启动应用程序时不添加代理,可以有针对性地禁用某些应用程序功能,例如日志记录。 所有这些都无需更改代码行,也不会使应用程序崩溃,因为JVM只是忽略了它在运行时无法解析的注释。 安全性,日志记录,缓存,有许多原因需要以建议的方式处理这些主题,甚至更多。 因此,有时创建代理而不是框架。

翻译自: https://www.javacodegeeks.com/2015/01/make-agents-not-frameworks.html

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

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

相关文章

HttpServletRequest.getContextPath()取得的路径

如果项目名称为test,你在浏览器中输入请求路径:http://localhost:8080/test/pc/list.jsp 执行下面向行代码后打印出如下结果: 1、 System.out.println(request.getContextPath()); 打印结果:/test 2、System.out.println(request.getSer…

合理的嵌入式开发学习路线

最近网上好多新手问我,怎么样学习嵌入式开发?其实这个问题很复杂,因为嵌入式开发是个非常复杂的领域,既有深度,也有广度,是个软硬结合的领域。。。我研究的时间也不长,不过以后可能会研究RTOS这…

重点保护

在“ Java的一些句子 ”一文中,我写道: “受保护的方法和字段可以在同一包中的类中使用(到目前为止与私有包相同),此外,还可以从其他类中使用受保护的方法和字段,这些类扩展了包含受保护的字段或…

机打发票打印管理

最近公司也从手写发票换成了机打发票,便应财务的要求做了这么一个简单的发票管理及打印系统,程序并不复杂。 使用C#(2.0) Access(97-2003版)/WinForm形式 系统菜单中有企业基本信息设置,见图4…

程序员需要了解的一点组织行为学知识

程序员由于天天和逻辑打交道,所以在世故的人眼里往往显得过于简单。 近来看组织行为学,发现其中一节列了很多特别的技能。 考虑到也许他们对程序员群体很有启示意义,就追加了一点说明,把它放在博客里。 相信这对想成为管理者的程序…

序列化的概念

讨论了为什么Optional不可序列化以及如何处理(即将推出)之后,让我们仔细看看序列化。 总览 这篇文章介绍了序列化的一些关键概念。 它尝试精简地执行此操作,而不会涉及太多细节,包括将建议降至最低。 它没有叙述&…

正则表达式总结及一些有用的例子

背景 正则表达式的用处十分广泛:字符串处理、输入验证等,特别是在爬取网页中对网页内容的清洗更需要正则。 正则表达式 基本所有的语言都支持正则表达式,或者内置或者引入。正则的语法很多,但每种语言对正则支持的程度都不同&…

对PostgreSQL SPI例子的学习

[作者:技术者高健博客园 mail: luckyjackgaogmail.com ] http://www.postgresql.org/docs/9.1/static/spi-examples.html SPI 的例子里面没有说,是如何编译和部署的,我这里补充下: 编译与部署: [rootlocalhost soft]#…

Java飞行记录器(JFR)

JFR是Java分析器,它使您可以研究代码的运行时特征。 通常,您将使用探查器来确定代码的哪些部分导致大量内存分配或导致消耗过多的CPU。 有很多产品在那里。 过去,我使用过YourKit,OptimizeIt,JProfiler,Ne…

图像识别SLIC、Haralick texture features(自备)

SLIC 简单线性迭代聚类(SLIC ),它采用k-means聚类方法来有效地生成超像素。 SLIC超像素分割详解(一)(二)(三)_超像素分割 样本-CSDN博客 超像素分割 & SLIC算法 & 使用示例_slic分割算法matlab-C…

DOM

1 标签操作 直接查找 documeny.getElementById() 间接查找 文件内容: 1.innterText只有文本 2.innerHTML所有内容 3.value input便签 value 获取当前标签中的值 select标签 value 获取当前选中的value selectedIndex 设定当前选中的value textarea标签…

在Java中给出的时间

tl; dr,您可以使用标签来阐明给定的测试时间样式。 什么时候给出? 给定的时间,然后是一种指定系统行为的常用样式,其中您的测试分为三个部分。 给定的部分列出了测试的前提条件,即在开始之前假设世界所处的任何状态。…

Vue.js环境搭建

简述小弟刚刚开始写博客,学习VueJs也不久,开这个博客,只是为了多多学习和记录自己的 学习之旅,可能很多地方都很浅薄,还望各位海涵和多多拍砖。 学习Vue也有两个多月了,接触它是在一个很偶然的机会。当初是…

【Python】Python中对目录路径的要求

Python中使用的目录路径一定不能以"\"结尾,否则会报未知符号错误 另外Python中的编码不支持VisBuild的output窗口,在python开头处定义了UTF-8输出,然后在下面调用了某个字符串的decode(UTF8),始终会在VisBuild的output里…

我如何想成为Java

我喜欢Java。 我喜欢用Java编程。 但是在使用Python一段时间后,我希望对其进行一些更改。 它几乎纯粹是语法上的,因此可能有更好的JVM语言,但是我并不真正感兴趣,因为我仍然需要使用普通的Java来工作。 我意识到这些更改将不会实施…

9.1定时器 小时分秒

功能:用切换图片0-9效果显示当前系统时间 属性:img的src 1.用到 new Date() getHours(),getMinutes(),getSeconds() getFullyear(),getMouth() 1月数需要加1,getDay()星期为0,1,2,3,4,5&am…

浏览器中的JavaFX

浏览器中的JavaFX屏幕截图 最近,Carl Dea和我启动了一个新项目,将JavaFX 8引入浏览器。 今天,我想介绍我们创建的前两个概念验证,以查看该想法是否完全可行。 对于不耐烦的人,这里是到PoC的链接。 但请注意&#xff0…

如何用代码对repeating section控件新增Item(InfoPath)

在做项目的时候,有一个场景,当用户切换不同选项时(radio button),repeating section会随着切换而变换两种状态1:删除所有item. 2.新增而且只新增一个item. 对于删除比较容易,但对于从没有任何一个item状态下&#xff0…

MDB!= JMS,反之亦然

基本 消息驱动Bean(又称为MDB)只是另一个EJB,如无状态,有状态或单例。 使用MessageDriven批注指定。 MDB用于异步消息处理 它们与无状态EJB 相似 ,因为它们都是由EJB容器池化的 但是,它们与无状态EJB不同…

4.1邮箱的全选,全不选,反选

事件&#xff1a;onclick 属性&#xff1a;checked 对于分清getElementsByTagName(元素名)里的元素名&#xff0c; 可以先提取其外面一层的元素&#xff0c;再在此基础上用getElementsByTagName(元素名) 用到for语句&#xff0c;if语句&#xff0c;length <!DOCTYPE ht…