集成演练路线图 (P23)

1. 项目基础：……
   
2. Servlet ：……
   
3. Spring Web MVC ：……
   
4. Struts Web MVC ：……
   
5. Spring AOP ：
   
   • 样例 - 公共日志记录层：
     
     1. 环境准备：
        修改 pom.xml ，添加需要的库 (并由 Eclipse 的 Maven 插件自动下载、导入) ：
        

        <project ……>
        	……
        	<dependencies>
        		……
        		<!-- [Spring 3] AOP. -->
        		<dependency>
        			<groupId>org.aspectj</groupId>
        			<artifactId>aspectjweaver</artifactId>
        			<version>1.8.8</version>
        		</dependency>
        	</dependencies>
        </project>
        

        
        说明 / 注意事项：
        
        • 目前通过 Maven 引入的库有：
          antlr-2.7.6.jar
          aopalliance-1.0.jar
          aspectjweaver-1.8.8.jar
          commons-codec-1.10.0.jar
          commons-codec-1.10.jar
          commons-collections-3.1.jar
          commons-dbcp-1.4.jar
          commons-fileupload-1.2.1.jar
          commons-io-1.3.2.jar
          commons-lang-2.1.jar
          commons-logging-1.1.3.jar
          commons-pool-1.5.4.jar
          dom4j-1.6.1.jar
          freemarker-2.3.15.jar
          hamcrest-core-1.3.jar
          hibernate-commons-annotations-3.2.0.Final.jar
          hibernate-core-3.6.8.Final.jar
          hibernate-jpa-2.0-api-1.0.1.Final.jar
          javassist-3.11.0.GA.jar
          jta-1.1.jar
          junit-4.12.jar
          mybatis-3.2.8.jar
          mybatis-spring-1.2.2.jar
          ognl-2.7.3.jar
          ojdbc5-11.2.0.4.jar
          slf4j-api-1.6.1.jar
          spring-aop-3.2.8.RELEASE.jar
          spring-beans-3.2.8.RELEASE.jar
          spring-context-3.2.8.RELEASE.jar
          spring-core-3.2.8.RELEASE.jar
          spring-expression-3.2.8.RELEASE.jar
          spring-hibernate-1.2.8.jar
          spring-jdbc-3.2.8.RELEASE.jar
          spring-orm-1.2.8.jar
          spring-test-2.5.6.jar
          spring-tx-3.2.8.RELEASE.jar
          spring-web-3.2.8.RELEASE.jar
          spring-webmvc-3.2.8.RELEASE.jar
          struts2-core-2.1.8.jar
          struts2-spring-plugin-2.1.8.jar
          xwork-core-2.1.6.jar
          ……
          
     2. 样例编写：
        
        1. 编写切面日志记录器类 tfw.integration_demo._06_spring_aop.aspect.AspectDemoLogger ：
           

           ……
           public class AspectDemoLogger
           {
           
           	……
           	public void logBeforeTarget(JoinPoint jp)
           	{
           		……
           	}
           
           	……
           	public Object logAroundTargetProceed(ProceedingJoinPoint pjp)
           			throws Throwable
           	{
           		Object oTarget = pjp.getTarget();
           		String strTextDesc = getTextDesc(pjp);
           		System.out.println(TextToolE.concat("[",
           				DateToolE.simpleFormat(new Date(), "yyyy-MM-yy HH:mm:ss.SSS"),
           				"] -- Start target ", oTarget, strTextDesc, "."));
           
           		Object oRtn = pjp.proceed(pjp.getArgs());
           		System.out.println(TextToolE.concat("[",
           				DateToolE.simpleFormat(new Date(), "yyyy-MM-yy HH:mm:ss.SSS"),
           				"] -- After target ", oTarget, strTextDesc, " return."));
           		return oRtn;
           	}
           
           	……
           	public void logAfterTargetReturn(JoinPoint jp)
           	{
           		……
           	}
           
           	……
           	public void logAfterTargetThrow(JoinPoint jp, Throwable t) throws Throwable
           	{
           		Object oTarget = jp.getTarget();
           		System.out.println(TextToolE.concat("[",
           				DateToolE.simpleFormat(new Date(), "yyyy-MM-yy HH:mm:ss.SSS"),
           				"] After target ", oTarget, getTextDesc(jp), " throws ", t));
           		throw t;
           	}
           
           	……
           	private String getTextDesc(JoinPoint jp)
           	{
           		// String strMainDesc = jp.getSignature().toString();
           		String strMainDesc = jp.getSignature().getName();
           		Object[] o1dArgs = jp.getArgs();
           		String strTextDesc = TextToolE.concat(strMainDesc, "(",
           				ArrayToolE.arrayForConsole(o1dArgs), ")");
           		return strTextDesc;
           	}
           
           }
           

           
           
        2. 编写 ApplicationContext 分项配置文件 src/main/resources/tfw/integration_demo/_04_spring_web_mvc/sub_files/07_spring_aop.xml ，注册此切面日志记录器对象：
           

           <?xml version="1.0" encoding="UTF-8"?>
           <beans ……>
           	<bean id="aop.aspect.aspectLogger"
           			class="tfw.integration_demo._06_spring_aop.aspect.AspectDemoLogger"/>
           </beans>
           

           
           
        3. 修改 ApplicationContext 主配置文件 src/main/resources/tfw/integration_demo/_04_spring_web_mvc/applicationContext.xml ，添加上述分项：
           

           <?xml version="1.0" encoding="UTF-8"?>
           <beans ……>
           	……
           	<import resource="sub_files/06_spring_4_struts.xml"/>
           	<import resource="sub_files/07_spring_aop.xml"/>
           </beans>
           

           
           
        4. 编写测试用例 tfw.integration_demo._06_spring_aop.AspectLoggerTestCase ，检查 ApplicationContext 配置的正确性：
           

           ……
           public class AspectLoggerTestCase
           {
           
           	private String strClasspathConfFile =
           			"tfw/integration_demo/_04_spring_web_mvc/applicationContext.xml";
           
           	@Test
           	public void testObjects() throws IOException
           	{
           		System.out.println(
           				"Spring Configuration File:\n\t" + strClasspathConfFile);
           
           		AbstractApplicationContext actxt =
           				new ClassPathXmlApplicationContext(strClasspathConfFile);
           		System.out.println("Application Context:\n\t" + actxt);
           
           		AspectDemoLogger logAspect = actxt.getBean("aop.aspect.aspectLogger",
           				AspectDemoLogger.class);
           		System.out.println("LogAspect:\n\t" + logAspect);
           
           		actxt.close();
           		System.out.println("Application Context Closed:\n\t" + actxt);
           	}
           
           }
           

           
           
        5. 修改 ApplicationContext 分项配置文件 src/main/resources/tfw/integration_demo/_04_spring_web_mvc/sub_files/07_spring_aop.xml ，添加切面配置，切点指定为各“用户管理”样例的 DAO ：
           

           <?xml version="1.0" encoding="UTF-8"?>
           <beans ……>
           	<bean id="aop.aspect.aspectLogger"
           			……/>
           
           	<aop:config>
           		<aop:aspect id="aop.aspect.logAspect" ref="aop.aspect.aspectLogger">
           			<aop:pointcut id="pointcut_01"
           					expression="execution(* tfw.integration_demo._04_spring_web_mvc._02_crud._01_basic_jdbc_crud.dao.I_UserDAO.*(..))"/>
           			<aop:before pointcut-ref="pointcut_01" method="logBeforeTarget"/>
           			<aop:around pointcut-ref="pointcut_01"
           					method="logAroundTargetProceed"/>
           			<aop:after pointcut-ref="pointcut_01" method="logAfterTargetReturn"/>
           			<aop:after-throwing pointcut-ref="pointcut_01"
           					method="logAfterTargetThrow" throwing="t"/>
           		</aop:aspect>
           	</aop:config>
           </beans>
           

           
           说明 / 注意事项：
           
           • “method="logAfterTargetThrow" throwing="t"”：
             AOP 配置中调用了 logAfterTargetThrow(JoinPoint jp, Throwable t) 方法，配置中“throwing”属性的值必须和方法声明的变量名一致。
             
        6. 运行任何一个“用户管理”样例的 DAO 测试用例，确认配置的正确性。
           
        7. 运行任何一个“用户管理”样例，并在用 MyBatis 自动生成 DAO 的“用户管理”中人为制造异常，检查切面在各种情况下的输出。
           
        8. 修改 ApplicationContext 分项配置文件 src/main/resources/tfw/integration_demo/_04_spring_web_mvc/sub_files/07_spring_aop.xml ，添加添加更多切点并继续测试：
           

           <?xml version="1.0" encoding="UTF-8"?>
           <beans ……>
           	<bean id="aop.aspect.aspectLogger"
           			……/>
           
           	<aop:config>
           		<aop:aspect id="aop.aspect.logAspect" ref="aop.aspect.aspectLogger">
           			<aop:pointcut id="pointcut_01"
           					expression="execution(* tfw.integration_demo.._0*_DataSourceConfig*.*(..))
           							or execution(* tfw.integration_demo.._01_UserMgr*.*(..))
           							or execution(* tfw.integration_demo._04_spring_web_mvc._02_crud._01_basic_jdbc_crud.dao.I_UserDAO.*(..))"/>
           			<aop:before pointcut-ref="pointcut_01" method="logBeforeTarget"/>
           			……
           		</aop:aspect>
           	</aop:config>
           </beans>
           

           
           说明 / 注意事项：
           
           1. “..”用于表示任意数量的包层级、或任意数量、任意名称的方法参数。
              
           2. “?”通配符不被支持，只支持“*”。