IntroductionInterceptor

對於之前介紹過的 Before Advice 、 After Advice 、 Around Advice 、 Throw Advice ，從使用者的角度來看，它們「影響了目標物件上某些方法的行為」，例如讓某些方法看來似乎增加了一些記錄的動作。

Introduction是個特別的Advice，從使用者的角度來看，它「影響了目標物件的行為定義，直接增加了目標物件的職責（具體來說就是增加了可 操作的方法）」，例如讓某個已定義好的物件，在不修改該物件之類別檔案的情況下，卻可以增加一些額外的操作方法到物件之上。

就Java程式語言類別設計的觀點來說，動態為物件增加可操作的方法顯得不可思議，事實上在Spring AOP中，您可以透過實作org.springframework.aop.IntroductionInterceptor來實現Introduction。

IntroductionInterceptor繼承了MethodInterceptor與DynamicIntroductionAdvice介面， 其中implementsInterface()方法（繼承自DynamicIntroductionAdvice）如果返回true的話，表示目前的 IntroductionInterceptor實作了給定的介面（也就是要額外增加行為的介面），此時您要使用invoke()呼叫介面上的方法，讓目 標物件執行額外的行為，您不可能使用MethodInvocation的proceed()方法，因為您要執行的是物件上原來沒有的行為，呼叫 proceed()方法沒有意義。

從文字上來理解Introduction會比較抽象，舉個實際的例子來說，假設您的系統中已經有以下的類別：

• ISome.java

package onlyfun.caterpillar;

public interface ISome {
    public void doSome();
}

• Some.java

package onlyfun.caterpillar;

public class Some implements ISome { 
    public void doSome() {
        System.out.println("原來物件的職責。。。");
    }
}

您希望在不修改原始檔案的情況下，為Some類別增加一些可操作的方法，也許您甚至連原始碼檔案都沒有，只有.class檔案，您唯一知道的也許是他們的API說明，在不對它們作出修改的情況下，您希望Some類別可以增加doOther()方法。

在Spring中，您可以藉由實作IntroductionInterceptor介面來完成上面的任務，首先您為doOther()方法建立介面：

• IOther.java

package onlyfun.caterpillar; 

public interface IOther {  
    public void doOther();
}

接著定義一個OtherIntroduction類別實作IntroductionInterceptor介面，並在實作IntroductionInterceptor介面的同時，也實作IOther介面，例如：

• OtherIntroduction.java

package onlyfun.caterpillar;

import org.aopalliance.intercept.MethodInvocation;
import org.springframework.aop.IntroductionInterceptor;

public class OtherIntroduction 
              implements IntroductionInterceptor, IOther {   
    // 是否實作自IOther介面
    public boolean implementsInterface(Class clazz) {
        return clazz.isAssignableFrom(IOther.class);
    }
    
    public Object invoke(MethodInvocation methodInvocation) 
                                      throws Throwable {
        // 如果呼叫的方法來自IOther介面的定義
        if(implementsInterface(
            methodInvocation.getMethod().getDeclaringClass())) {
            // 呼叫執行額外加入（mixin）的行為
            return methodInvocation.getMethod().
                    invoke(this, methodInvocation.getArguments());
        }
        else {
            return methodInvocation.proceed();
        }
    }
    
    public void doOther() {
        System.out.println("增加的職責。。。");
    }
}

接著您要在Bean定義檔中將Introduction縫合至Some物件之上，使用org.springframework.aop.support.DefaultIntroductionAdvisor就可以了，例如：

• beans-config.xml

<?xml version="1.0" encoding="UTF-8"?> 
<!DOCTYPE beans PUBLIC "-//SPRING/DTD BEAN/EN" 
  "http://www.springframework.org/dtd/spring-beans.dtd"> 

<beans> 
    <bean id="some" 
          class="onlyfun.caterpillar.Some"/> 

    <bean id="otherIntroduction" 
          class="onlyfun.caterpillar.OtherIntroduction"/> 
          
    <bean id="otherAdvisor" 
          class="org.springframework.aop.support.DefaultIntroductionAdvisor"> 
          <constructor-arg index="0">
              <ref bean="otherIntroduction"/>
          </constructor-arg>  
          <constructor-arg index="1">
              <value>onlyfun.caterpillar.IOther</value>
          </constructor-arg>  
    </bean>
   
    <bean id="proxyFactoryBean" 
          class="org.springframework.aop.framework.ProxyFactoryBean"> 
        <property name="proxyInterfaces"> 
            <value>onlyfun.caterpillar.ISome</value> 
        </property> 
        <property name="target"> 
            <ref bean="some"/> 
        </property> 
        <property name="interceptorNames"> 
            <list> 
                <value>otherAdvisor</value> 
            </list> 
        </property> 
    </bean> 
</beans>

DefaultIntroductionAdvisor在建構時，需要給它IntroductionInterceptor的實例，以及所要代理額外行為的介面，現在，來撰寫一個簡單的程式測試，從這個程式當中，您可以更進一步了解何謂為物件額外增加行為：

• SpringAOPDemo.java

package onlyfun.caterpillar;

import org.springframework.context.ApplicationContext;
import org.springframework.context.
              support.FileSystemXmlApplicationContext;

public class SpringAOPDemo {
    public static void main(String[] args) {
        ApplicationContext context = 
            new FileSystemXmlApplicationContext(
                    "beans-config.xml"); 
    
        ISome some = 
            (ISome) context.getBean("proxyFactoryBean"); 
    
        some.doSome();
    
        // 看來好像some物件動態增加了職責
        ((IOther) some).doOther();
    }
} 

對於some所參考的物件來說，它原先並不會有doOther()方法可供操作，然而透過Spring AOP的Introduction機制，現在some所參考的物件多了doOther()方法可以操作。