对于最新的稳定版本,请使用 Spring Framework 6.2.0spring-doc.cn

使用 创建 AOP 代理ProxyFactoryBean

如果你将 Spring IoC 容器(或 )用于 business 对象(您应该是!),您希望使用 Spring 的 AOP 实现之一。(请记住,工厂 Bean 引入了一个间接层,让 它创建不同类型的对象。ApplicationContextBeanFactoryFactoryBeanspring-doc.cn

Spring AOP 支持还在幕后使用工厂 bean。

在 Spring 中创建 AOP 代理的基本方法是使用 .这提供了对 切入点、任何适用的建议以及它们的顺序。然而,还有更简单的 如果您不需要此类控制,则首选选项。org.springframework.aop.framework.ProxyFactoryBeanspring-doc.cn

基本

与其他 Spring 实现一样,这 引入了一个 间接级别。如果定义一个命名的 , 对象 引用看不到实例本身,而是一个对象 由 .这 方法创建包装目标对象的 AOP 代理。ProxyFactoryBeanFactoryBeanProxyFactoryBeanfoofooProxyFactoryBeangetObject()ProxyFactoryBeanspring-doc.cn

使用 IoC 感知的最重要好处之一 类来创建 AOP 代理,则 advice 和 pointcuts 也可以是 由 IoC 管理。这是一个强大的功能,支持某些难以 实现。例如,通知本身可以引用 application 对象(除了目标,它应该在任何 AOP 中都可用 框架),受益于 Dependency Injection 提供的所有可插拔性。ProxyFactoryBeanspring-doc.cn

JavaBean 属性

与 Spring 提供的大多数实现一样,该类本身就是一个 JavaBean。其属性用于:FactoryBeanProxyFactoryBeanspring-doc.cn

一些关键属性继承自(Spring 中所有 AOP 代理工厂的超类)。这些关键属性包括 以下内容:org.springframework.aop.framework.ProxyConfigspring-doc.cn

  • proxyTargetClass:如果要代理目标类,而不是 Target 类的接口。如果此属性值设置为 ,则 CGLIB 代理 创建(但另请参阅基于 JDK 和 CGLIB 的代理)。truetruespring-doc.cn

  • optimize:控制是否对代理应用主动优化 通过 CGLIB 创建。除非您完全 了解相关的 AOP 代理如何处理优化。这是当前使用的 仅适用于 CGLIB 代理。它对 JDK 动态代理没有影响。spring-doc.cn

  • frozen:如果代理配置为 ,则对配置的更改为 不再允许。这在轻微优化和那些情况下都很有用 当您不希望调用方在创建代理后能够 (通过界面) 操作代理时。此属性的默认值为 ,因此允许进行更改(例如添加其他建议)。frozenAdvisedfalsespring-doc.cn

  • exposeProxy:确定是否应在 中公开当前代理,以便目标可以访问它。如果目标需要获取 代理和属性设置为 ,则目标可以使用该方法。ThreadLocalexposeProxytrueAopContext.currentProxy()spring-doc.cn

特定于 to 的其他属性包括:ProxyFactoryBeanspring-doc.cn

  • proxyInterfaces:接口名称数组。如果未提供,则 CGLIB 使用目标类的代理(但另请参阅基于 JDK 和 CGLIB 的代理)。Stringspring-doc.cn

  • interceptorNames:、interceptor 或其他通知名称的数组 应用。订购很重要,先到先得。也就是说 列表中的第一个拦截器是第一个能够拦截 调用。StringAdvisorspring-doc.cn

    这些名称是当前工厂中的 bean 名称,包括来自祖先的 bean 名称 工厂。你不能在这里提到 bean 引用,因为这样做会导致忽略 advice 的 singleton 设置。ProxyFactoryBeanspring-doc.cn

    您可以在侦听器名称后附加星号 ()。这样做会导致 应用程序名称以星号前部分开头的所有 advisor bean 以应用。您可以在使用 “Global” Advisors 中找到使用此功能的示例。*spring-doc.cn

  • singleton:工厂是否应该返回单个对象,无论如何 通常会调用 Method。多种实施方式 这样的方法。默认值为 .如果你想使用有状态通知 - 对于 例如,对于有状态的混合 — 使用 prototype advice 以及单例值 .getObject()FactoryBeantruefalsespring-doc.cn

基于 JDK 和 CGLIB 的代理

本节是有关如何为特定目标选择创建基于 JDK 的代理或基于 CGLIB 的代理的权威文档 object (要代理的)。ProxyFactoryBeanspring-doc.cn

创建基于 JDK 或 CGLIB 的行为 代理在 Spring 的 1.2.x 和 2.0 版本之间发生了变化。现在 在自动检测接口方面表现出与类的语义相似的语义。ProxyFactoryBeanProxyFactoryBeanTransactionProxyFactoryBean

如果要代理的目标对象的类(以下简称为 目标类)不实现任何接口,则基于 CGLIB 的代理是 创建。这是最简单的方案,因为 JDK 代理是基于接口的,没有 interfaces 意味着 JDK 代理甚至是不可能的。您可以插入目标 bean 并通过设置属性来指定拦截器列表。请注意, 即使 的属性已设置为 ,也会创建基于 CGLIB 的代理。(这样做没有意义,而且是最好的 从 Bean 定义中删除,因为它充其量是多余的,最坏的情况是 令人困惑。interceptorNamesproxyTargetClassProxyFactoryBeanfalsespring-doc.cn

如果目标类实现一个(或多个)接口,则 created 取决于 的配置。ProxyFactoryBeanspring-doc.cn

如果 的属性已设置为 , 将创建基于 CGLIB 的代理。这是有道理的,并且符合 最小惊喜原则。即使 的属性已设置为一个或多个完全限定的接口名称,事实 该属性设置为导致基于 CGLIB 代理生效。proxyTargetClassProxyFactoryBeantrueproxyInterfacesProxyFactoryBeanproxyTargetClasstruespring-doc.cn

如果 的属性已设置为 1 或多个 完全限定的接口名称,则会创建一个基于 JDK 的代理。创建的 proxy 实现 property 中指定的所有接口。如果目标类恰好实现了比 那些在属性中指定的,那都是好的,但是那些 返回的代理不会实现其他接口。proxyInterfacesProxyFactoryBeanproxyInterfacesproxyInterfacesspring-doc.cn

如果 的属性尚未设置,但 Target 类确实实现了一个(或多个)接口,它会自动检测 Target 类实际上确实实现了 实现至少一个接口,并创建基于 JDK 的代理。接口 实际上是 Target 类 实现。实际上,这与提供每个 目标类实现到属性的接口。然而 它明显减少了工作量,并且不易出现印刷错误。proxyInterfacesProxyFactoryBeanProxyFactoryBeanproxyInterfacesspring-doc.cn

代理接口

考虑一个 in action 的简单示例。此示例涉及:ProxyFactoryBeanspring-doc.cn

  • 代理的目标 Bean。这是 示例。personTargetspring-doc.cn

  • An 和 an 用于提供建议。AdvisorInterceptorspring-doc.cn

  • 用于指定目标对象(Bean)的 AOP 代理 Bean 定义, 代理的接口和申请的建议。personTargetspring-doc.cn

下面的清单显示了该示例:spring-doc.cn

<bean id="personTarget" class="com.mycompany.PersonImpl">
	<property name="name" value="Tony"/>
	<property name="age" value="51"/>
</bean>

<bean id="myAdvisor" class="com.mycompany.MyAdvisor">
	<property name="someProperty" value="Custom string property value"/>
</bean>

<bean id="debugInterceptor" class="org.springframework.aop.interceptor.DebugInterceptor">
</bean>

<bean id="person"
	class="org.springframework.aop.framework.ProxyFactoryBean">
	<property name="proxyInterfaces" value="com.mycompany.Person"/>

	<property name="target" ref="personTarget"/>
	<property name="interceptorNames">
		<list>
			<value>myAdvisor</value>
			<value>debugInterceptor</value>
		</list>
	</property>
</bean>

请注意,该属性采用一个列表 ,其中包含 当前工厂中的 interceptor 或 advisor。您可以使用 advisors、interceptor、before、after returning,并抛出 Advice 对象。顾问的排序很重要。interceptorNamesStringspring-doc.cn

您可能想知道为什么该列表不包含 bean 引用。这样做的原因是 如果 的 singleton 属性设置为 ,则它必须能够 返回独立的代理实例。如果任何 advisor 本身就是一个原型,则 需要返回独立实例,因此需要能够获取 工厂中的原型实例。持有参考是不够的。ProxyFactoryBeanfalse

前面显示的 bean 定义可以代替实现,因为 遵循:personPersonspring-doc.cn

Person person = (Person) factory.getBean("person");
val person = factory.getBean("person") as Person;

同一 IoC 上下文中的其他 bean 可以表示对它的强类型依赖关系,如 替换为普通的 Java 对象。以下示例显示了如何执行此操作:spring-doc.cn

<bean id="personUser" class="com.mycompany.PersonUser">
	<property name="person"><ref bean="person"/></property>
</bean>

此示例中的类公开了 .就 值得一提的是,AOP 代理可以透明地代替“真实”人使用 实现。但是,它的类将是动态代理类。这是可能的 将其强制转换为接口(稍后讨论)。PersonUserPersonAdvisedspring-doc.cn

您可以通过使用匿名 内 Bean 的 Bean 中。只是定义不同。这 包含建议只是为了完整性。以下示例演示如何使用 匿名内部 Bean:ProxyFactoryBeanspring-doc.cn

<bean id="myAdvisor" class="com.mycompany.MyAdvisor">
	<property name="someProperty" value="Custom string property value"/>
</bean>

<bean id="debugInterceptor" class="org.springframework.aop.interceptor.DebugInterceptor"/>

<bean id="person" class="org.springframework.aop.framework.ProxyFactoryBean">
	<property name="proxyInterfaces" value="com.mycompany.Person"/>
	<!-- Use inner bean, not local reference to target -->
	<property name="target">
		<bean class="com.mycompany.PersonImpl">
			<property name="name" value="Tony"/>
			<property name="age" value="51"/>
		</bean>
	</property>
	<property name="interceptorNames">
		<list>
			<value>myAdvisor</value>
			<value>debugInterceptor</value>
		</list>
	</property>
</bean>

使用匿名内部 bean 的优点是只有一个 type 为 的对象。如果我们想要,这很有用 防止应用程序上下文的用户获取对 un-advised 的引用 对象或需要避免 Spring IoC 自动装配的任何歧义。还有, 可以说,一个优势在于该定义是自包含的。 但是,有时能够从 Factory 实际上可能是一个优势(例如,在某些测试场景中)。PersonProxyFactoryBeanspring-doc.cn

代理类

如果您需要代理一个类,而不是一个或多个接口,该怎么办?spring-doc.cn

想象一下,在我们前面的示例中,没有接口。我们需要提供建议 一个名为 的类,它没有实现任何业务接口。在这种情况下,您 可以将 Spring 配置为使用 CGLIB 代理而不是动态代理。为此,请将前面显示的 上的属性设置为 。虽然最好 program 添加到接口而不是类,能够通知没有 在处理遗留代码时,实现接口可能很有用。(一般来说,Spring 不是规定性的。虽然它使应用良好实践变得容易,但它避免了强制 特定方法。PersonPersonproxyTargetClassProxyFactoryBeantruespring-doc.cn

如果你愿意,你可以在任何情况下强制使用 CGLIB,即使你有 接口。spring-doc.cn

CGLIB 代理的工作原理是在运行时生成目标类的子类。Spring 配置此生成的子类以将方法调用委托给原始目标。这 subclass 用于实现 Decorator 模式,并在 advice 中编织。spring-doc.cn

CGLIB 代理通常应该对用户透明。但是,存在一些问题 考虑:spring-doc.cn

无需将 CGLIB 添加到您的 Classpath 中。CGLIB 被重新打包并包含在内 在 JAR 中。换句话说,基于 CGLIB 的 AOP 可以“开箱即用”地工作,就像 JDK 动态代理。spring-core

CGLIB 代理和动态代理之间的性能差异很小。 在这种情况下,性能不应该是一个决定性的考虑因素。spring-doc.cn

使用“全球”顾问

通过在拦截器名称后附加星号,所有 bean 名称匹配的 advisor 星号前面的部分将添加到 advisor 链中。这可以派上用场 如果您需要添加一组标准的 “global” 顾问。以下示例定义了 两个 Global Advisors:spring-doc.cn

<bean id="proxy" class="org.springframework.aop.framework.ProxyFactoryBean">
	<property name="target" ref="service"/>
	<property name="interceptorNames">
		<list>
			<value>global*</value>
		</list>
	</property>
</bean>

<bean id="global_debug" class="org.springframework.aop.interceptor.DebugInterceptor"/>
<bean id="global_performance" class="org.springframework.aop.interceptor.PerformanceMonitorInterceptor"/>