EasyAOP

English

EasyAOP是什么

• EasyAOP是基于ASM实现切面通用能力的工具。EasyAOP提供的通用切面能力，可以使用配置文件(yaml)方式来配置使用。
• EasyAOP使用不需要开发者了解或理解学习底层的晦涩难懂的切面专业知识，也不需要用相关的切面开发经验。仅根据自己的需求，进行简单配置就能完成相关的切面功能或者能力。
• EasyAOP提供Android gradle Plugin方式，方便Android开发者进行接入使用。

为什么要做EasyAOP

1. 我们发现切面需求开发中，使用到的切面通用功能或者能力是有限的，也满足二八原则，既80%的需求只使用到了20%的切面通用功能（能力）
2. 底层的切面知识晦涩难懂，因相关的库更贴近字节码，所以开发者掌握起来难度较大。且切面类的需求较少，投入产出比很差。
3. 开源的切面工具，没有一款既简单好用又稳定可靠的。

EasyAOP支持的能力

EasyAOP应用示例

说明：下文中在切面示例中提到的“原代码”，是指切面修改之前的代码，在项目中可能是多种形式存在，如AAR、JAR包中的二进制class文件，源码中的java文件等。

方法调用切面代理（替换）能力

例如原代码如下：

我们要对com.tea.Waiter.class 中的 drink和tea方法调用做代理，替换成我们自己com.test.WaiterProxy.class 中的drinkBeer和specialTea。

在Android上接入EasyAOP的gradle plugin后仅需要在配置文件中添加如下配置即可：

编译完成，所有关于com.tea.Waiter.class 中的 drink和tea方法调用都会替换成com.test.WaiterProxy.class 中的drinkBeer和specialTea的调用。

说明：以上大家注意到，我们方法切面代理能力是支持对象方法和静态方法的代理的。

对于静态方法代理来说，提供代理方法和原方法的方法入参是一样的（顺序、类型一样），无需做任何调整。

而对于对象方法代理来说，需要注意的是代理方法第一个参数必须是该被代理方法的对象，其他参数依次对照即可，这样做的原因是：很多情况下，代理方法是需要拿到原方法的对象的，需要能够提供进行调用原始方法的能力。

方法体置空能力

还是以“服务员煮茶”为例，假如在煮茶流程中有一道错误的流程导致冲泡出来的茶品质很差，要把错误流程去掉。

例如，原代码中：

要把com.tea.Water.class 中 这个waitingErrorTime 错误流程方法干掉，接入EasyAOP plugin后配置文件写法如下：

这样就会把com.tea.Water.class 中 waitingErrorTime方法体内容置空，对于有返回值的方法，方法体置空后默认会返回，返回值类型的默认值，当然返回值也允许用户通过配置设置。

指定方法体，进入、退出插入指定代码

例如原方法 makeTea 如下：

如果需要在此方法体开始前插入代码，例如插入方法如下：

配置为： 当然方法体尾部插入部分的配置示例也在上面中有提到，使用上也是一样的。

其他能力部分

其他能力部分，后续版本陆续支持了，会在对应的使用文档中再做更新。这里就不做介绍了。

常见切面工具与EasyAOP的对比

切面工具框架，现在常用的是ASM和AspectJ，这些框架都是学习、接入使用难度较大，偏全面、底层的框架。EasyAOP底层调用和封装的是ASM的能力，它提供了面向业务需求的通用能力，仅通过简单配置就能调用。下面是EasyAOP和常见切面工具在7个纬度方面的对比：

从对比上，明显可以看出EasyAOP继承了ASM好的方面，优化改进了接入使用复杂度，让使用方简单接入，无需了解切面知识就能够快速的进行切面功能需求开发。

在上面“为什么要做EasyAOP”中也提到了，80%的切面类需求仅仅使用到20%的切面能力，所以我们EasyAOP框架 的切面方向是提供面向业务的通用切面能力，而不是全面的、底层的切面能力。

EasyAOP 相关问题

使用EasyAOP之前，请先根据需要阅读相关文档：

1. 接入指南
2. 示例Sample 参考 EasyAOP/sample
3. 常见问题
4. 日志说明
5. 也可在Issues上寻找和提问问题。
6. show me the code 最直接的方式就是看源码了

开发者

• @wswenyue
• @stven0king

欢迎共建

欢迎同志共建EasyAOP. EasyAOP Contributing Guide.

致谢

• ASM Library

许可协议

EasyAOP 项目基于BSD协议开源.