为增强依赖注入功能,Guice支持方法拦截器。通过这个特性可以让方法在每次执行前调用一个匹配的方法。这适用于横切性关注点(切面),例如事务控制,权限与日志记录等。因为拦截器将一个问题分割成切面而不是对象;所以拦截器使用又被称为面向切面编程(AOP)。
大多数开发者不会直接编写方法拦截器,但是可能在一些类库中见到,需要进方法进行选择,创建一个拦截器并将它配置在
Module
中。
Matcher
是一个简单接口,接收或者拒绝一个值。在Guice AOP中,我们需要两种
Matcher
,一是定义哪些类需要进行拦截;二是这些类的哪些方法需要进行拦截。为简化
Matcher
的创建,Guice使了工厂类(
Matchers
)来满足常见操作。
在需要拦截的方法被执行前,方法拦截器(
MethodInterceptors
)先被执行。拦截器可以检查该调用,包括方法本身,方法参数等。拦截器可以执行行横切性逻辑并且可以委托于底层方法。最后检查返回值,或者直接抛出异常。因为拦截器可能应用于非常多的方法并且被执行多次,所以其实现应该是高效的,非侵入式的。
例如:我们要实现在周末禁止方法调用,步骤如下:
-
编写一注解
@Retention(RetentionPolicy.RUNTIME) @Target(ElementType.METHOD)//标注于方法上@interface NotOnWeekends {}
-
将注解标注于要拦截的方法上
public class RealBillingService implements BillingService {@NotOnWeekendspublic Receipt chargeOrder(PizzaOrder order, CreditCard creditCard) {...}}
-
定义一个
org.aopalliance.intercept.MethodInterceptor
接口实现类,如果要执行底层方法,则执行
invocation.proceed()
方法(这一点与Spring中是一致的)
public class WeekendBlocker implements MethodInterceptor {public Object invoke(MethodInvocation invocation) throws Throwable {Calendar today = new GregorianCalendar();if (today.getDisplayName(DAY_OF_WEEK, LONG, ENGLISH).startsWith(\"S\")) {throw new IllegalStateException(invocation.getMethod().getName() + \" not allowed on weekends!\");}return invocation.proceed();}}
-
将拦截器配置于
Module
中,还需要定义哪些类哪些方法要被拦截。在如下例子中所有有都将会拦截,但是方法要有
@NotOnWeekends
注解才会被拦截
public class NotOnWeekendsModule extends AbstractModule {protected void configure() {bindInterceptor(Matchers.any(), Matchers.annotatedWith(NotOnWeekends.class),new WeekendBlocker());}}
在Guice AOP中,方法的拦截是在运行时动态生成字节码来实现的,Guice动态地创建被拦截类的一个子类,覆盖掉被拦截的方法并应用上拦截器。这其实就是动态代理模式的应用了。类中方法要能被拦截有如下限制:
- 类必须是
public
或者
package-private
- 类不能是
final
类,因为是
final
类就不能创建其子类
- 方法必须是
public
或
package-private
或
proctected
- 方法不能是
final
的,因为是
final
方法就无法被覆盖
- 只有Guice通过
@Inject
注解或者无参构造方法创建的实例的方法才能被拦截
对拦截器进行注入:
如果需要对拦截器注入依赖的话,需要使用
requestInject
方法:
public class NotOnWeekendsModule extends AbstractModule {protected void configure() {WeekendBlocker weekendBlocker = new WeekendBlocker();requestInjection(weekendBlocker);bindInterceptor(Matchers.any(), Matchers.annotatedWith(NotOnWeekends.class),weekendBlocker);}}
还有一个方法是使用
Provider
,然后将
Provider
作为拦截器构造方法参数传入,而且
Provider
中的依赖会自动注入:
public class NotOnWeekendsModule extends AbstractModule {protected void configure() {bindInterceptor(any(),annotatedWith(NotOnWeekends.class),new WeekendBlocker(getProvider(Calendar.class)));}}
在使用拦截器的时候,如果拦截器调用了一个被该拦截器拦截的方法就进入死循环,其结果当然就是
StackOverflowExeption
。
——————————– END ——————————-
及时获取更多精彩文章,请关注公众号《Java精讲》。