SpringSide团队日志

springside快一岁啦，新的博客已搬到 http://blog.springside.org.cn  ，本博客暂停更新。

谢谢scud 飞云小侠这一年来提供的博客平台服务：）

     Spring 2.0  的重头戏之一就是AspectJ 式 AOP 配置。 但是一定要通过对比，才能看到2.0式的AOP配置是如何跳出一片新天空的。

1. 对比

先看1.0的标准事务配置:

<bean id="baseTxService" class="org.springframework.transaction.interceptor.TransactionProxyFactoryBean"           abstract="true">         <property name="transactionManager" ref="transactionManager"/>         <property name="proxyTargetClass" value="true"/>         <property name="transactionAttributes">             <props>                 <prop key="get*">PROPAGATION_REQUIRED,readOnly</prop>                 <prop key="find*">PROPAGATION_REQUIRED,readOnly</prop>                 <prop key="save*">PROPAGATION_REQUIRED</prop>                 <prop key="remove*">PROPAGATION_REQUIRED</prop>             </props>         </property>         <property name="preInterceptors">             <list>                 <ref bean="methodSecurityInterceptor"/>             </list>         </property>  </bean>  <bean id="bookManager" parent="baseTxService">         <property name="target">             <bean class="org.springside.bookstore.admin.manager.BookManager"/>         </property>  </bean>

再看2.0的新配置：

<aop:config proxy-target-class="true">     <aop:advisor pointcut="execution(* *..*Manager.*(..))" advice-ref="txAdvice"/>     <aop:advisor pointcut="execution(* *..*Manager.save(..))" advice-ref="fooAdvice"/> </aop:config><tx:advice id="txAdvice" transaction-manager="transactionManager">     <tx:attributes>         <tx:method name="save*"/>         <tx:method name="remove*"/>         <tx:method name="*" read-only="true"/>    </tx:attributes> </tx:advice>  <bean id="bookManager" class="org.springside.bookstore.commons.service.BookManager"/>

2.进步

1. AOP的配置方式也AOP了。
      对比1.0的配置文件，因为下面2提到的限制，事关安全acegi methodSecurityInterceptor 拦截器要配置在关于事务的TransactionProxyFactoryBean的preInterceptors属性里，这样子就一点不AOP了。

      而2.0使用ponintcut expression，很AOP的配置一切Aspect。
 
2. 1.0时，一个已经AOP过的object不能再次被AOP。
   在Spring 1.0的文档里Rod说，比如<bean id="bookManager" parent="baseTxService">已经进行了一次AOP，如果想在这个Bean上再配一层AOP，比如要对方法执行结果缓存，无论以1.0 还是2.0的方式定义，cglib方式是会报错的，而基于接口的方式，结果不确定。
 
3. BookManager能直接定义自己，而不是像1.0那样作匿名内部target。

3. 语法

Spring参考文档 7.3 chema-based AOP support 提供了aspect,advisor,advide三种组装方法的解释，其中aspect是aspectJ原装，但稍复杂，

这里唯一有点难懂的是pointcut里的语法，其实也很好学，Spring参考文档7.2.3.4里有完整说明 ，其实一排子过去是

execution(modifiers-pattern? ret-type-pattern declaring-type-pattern? name-pattern(param-pattern) throws-pattern?)

其中带问号的modifiers-pattern?(public/protected) 和 declaring-type-pattern? throws-pattern? 可以不填

可见execution(* *..BookManager.save(..))

• 第一颗* 代表ret-type-pattern 返回值可任意，
• *..BookManager 代表任意Pacakge里的BookManager类。
  如果写成com.xyz.service.* 则代表com.xyz.service下的任意类
  com.xyz.service..* com.xyz.service则代表com.xyz.service及其子package下的任意类
• save代表save方法，也可以写save* 代表saveBook()等方法
• (..) 匹配0个参数或者多个参数的，任意类型
  (x,..) 第一个参数的类型必须是X 
  (x,,,s,..) 匹配至少4个参数，第一个参数必须是x类型，第二个和第三个参数可以任意，第四个必须是s类型。

推荐 The Elements of Ant Style ，写Ant 脚本的best practice总结。

http://wiki.apache.org/ant/TheElementsOfAntStyle

 有空要根据着来修改ss2的ant 脚本。 不过ant 脚本已花费太多时间了，短时间内不再动它。

  @Override 一方面提醒用户这是个重载函数，另一方面保证了父类作任何改动时，子类如果没有跟着变化，就会编译不过。虽然有点占地方，但用处的确很大，不会哪天子类被人卖了都不知道。

  所以我甚至设置了让IDEA6检查所有重载函数必须加上@Override标识。

  @SuppressWarnings("unchecked")

    这个用法可以减少JDK5.0的集合操作引入范型后无处不在的warning。因为有些非JDK5.0的开源库如hibernate, 函数返回的一定是List，而不会是List<User>，这时候IDE就会爆出很多warning。用SuppressWarning可以取消掉它。

  @Deprecated
   以前写在JavaDoc里，现在单提了出来，注释已废弃的函数。用户使用该函数的话，编译时会得到提示，说你用了废柴API.

    折腾了快一年，又经过很臭美的倒数后，spring 2.0终于发布了。但对它的进度其实严重不满的，尤其看看它的jira里还有那么多没做完的事情。

    SS2.0国庆期间更新如下：

1. 从项目中吸取的两个改进

    一是构件库放弃单一的SSH Mainstream架构，而改为Struts/Strut2, Hibernate/Ibatis/Hibernate JPA可自由组合。 二是Helloworld里放弃了模块化架构，完全平面化适应小项目。

 2. Struts的更新：

     （详见wiki中的pramatic struts一节）

     1. 改用lazyValidatorForm, 适合POJO的所有属性并不都在Form里的情况。 并升级到commons-beanutils-1.7.1 Snapshot 。

     2. Struts-Config.xml 中使用通配符简化配置。

     3. 开始编写CRUD的StrutsEntityAction。

  3. Spring 2的更新:

      配置文件改用2.0的DTD 文件，不是很喜欢用schema xsd文件，一大堆太长了。

      <!DOCTYPE beans PUBLIC "-//SPRING//DTD BEAN 2.0//EN" "http://www.springframework.org/dtd/spring-beans-2.0.dtd">

 还有好些小的bugfix......

在dfdfswsw的努力下，Simon同志的指导下，springside的第一个plugin终于诞生了。

第一个plugin的功能是新建项目，实际调用的是ant脚本。

同时，在曹晓刚同志的试用后，QuickStart的效果做了修改，终于达到和我最喜欢的pentaho一样的效果。

    最近的项目准备用Selenium作一部分的Regression Test。在SpringSide里参考了一下，又下了个Selenium IDE玩玩，觉得还蛮容易上手，基本上不需要手动写测试代码。
    但实操起来时面对各种复杂的页面情况遇到不少麻烦。感觉Selenium 的offical documentation写的比较high level, 最后找了个though works的ppt，算得上比较全面易懂。匆匆翻译了一下，供后来者参考。

1.QuickStart 完美版

    之前QuickStart启动Tomcat是以后台方式启动的, 用户看不到tomcat的窗口,也不能以普通方式关闭Tomcat   (为了Tomcat启动后不把ant进程杜塞,用了spawn=true参数)

    现在在ant 里使用了并行容器, 没有了这个问题.

2.Selenium 完美版

    之前Tomcat 与 Selenium Server同样是后台摸黑启动的,现在都改为明版.

    原来用firefox作测试浏览器,考虑到firefox的普及率,SS2.0 换回IE当默认测试服务器.

    代码简化, 下面是一段Helloworld 增加用户的测试,非常清晰,完全可以省略controller测试.

        String userName = "TestUser";
        user.open("/helloworld");
        user.click("adduser");
        user.waitForPageToLoad("5000");
        user.type("user.name",userName);
        user.click("save");
        user.waitForPageToLoad("5000");
        assertTrue( user.isTextPresent(userName));

3. 构件安装完美版

前两天的构件安装只负责拷贝jar 和 template文件
今天增加了web.xml ,struts-config.xml 这类文件的自动合并功能.
另外在web/ec 里演示了构件自定义安装脚本,把/meta/taglibs.jsp 的内容append 到主应用的taglibs 里.

 备忘录:

selenium 的浏览器设定 ,*firefox, 会在系统的PATH 里找*firefox.exe文件

selenium  使用IE时, proxy机制较特殊,好像需要改注册表,而且与E家宽这种同样以proxy机制提供宽带服务的供应商冲突,需要断网才能正确运行.

SpringSide 2.0的文档及下载见：

http://wiki.javascud.org/display/springs/Home

吸取SS1.0的经验，这次三军未动，文档先行。

漫漫长途第一步，完成了Spring+Hibernate+Struts的User管理helloworld搭建，更重要是做了一个新建项目，安装构件的Ant Script框架出来，将extremecomponents, hsqldb,quartz,sitemesh等都切分为构件。用户可以用ant命令新建基础项目，并把其他的构件装入项目。

另外，每一个细微的地方都作了优化，如hsqldb的使用，log的优化,i18n文件的放置等等等等....对比之下觉得SS1.0太多不完美的地方了，强烈建议大家转为关注SpringSide2.0。

SpringSide1.0范围内最后一个跑马圈地，开疆拓土的版本。详情见[Release Notes]

1. spring的配置文件可以大量配置<beans default-lazy-init="true">来加快单元测试的速度。

    不过注意那些PostFactoryBean 如PropertyPlaceholderConfigurer是不能lazy-init的，否则一不小心吃个大闷亏，还有那些springmvc-servlet.xml 似乎也不能lazy init.

2. 使用PropertyOverrideConfigurer来特别配置单元测试时的JDBC URL

    PropertyOverrideConfigurer的详细情况见参考手册的3.7.2.2

<bean id="testPropertyConfigurer" class="org.springframework.beans.factory.config.PropertyOverrideConfigurer">
        <property name="location" value="classpath:context/test/test.properties"/>
        <property name="ignoreInvalidKeys" value="true"/>
     </bean> 

test.properties文件如下

dataSource.url=jdbc:hsqldb:res:default-db 

如此配置之下，applicationContext中dataSource bean的url 就会被透明的修改成嵌入式数据的模式。

find(String hql);
find(String hql,Object arg);
find(String hql,Object[] arg); 

可精简为一个

find(String hql,Object... args); 

用户用如下四种方式调用该接口都是合法的

find(hql);
find(hql,arg0);
find(hql,arg0,arg1);
find(hql,new Object[]{arg0,arg1}); 

唯一一个限制就是，可变参数必须在参数列表的最右。

比如tomcat启动时会有一段warning, 比如IE的bug，比如中文问题需要自己写convertUtil, 这些问题都不存在了。

 但是，他的推技术仍然不够成熟，在IE中的表现未如人意。

XFire1.2RC比较吸引人的特性有GZip压缩。

david.turing演示的加入验证的流程 

1.在webservice-server.xml 中，使用bookService的inHanders属性加入验证用户名密码的Hanlder。

<bean id="bookWebService" parent="baseWebService">
        <property name="serviceBean" ref="bookManager"/>
        <property name="serviceClass" value="org.springside.bookstore.plugins.xfire.service.BookService"/>
        <property name="inHandlers" ref="authenticationHandler"/>
</bean> 

2.实现服务端验证用户名密码的authentcationHandler, 见/springside-bookstore/src/.../plugins/xfire/auth目录。

3.在客户端加入负责输入用户名和密码的ClientAuthHandler，见/springside-bookstore/src/.../plugins/xfire/service/client.groovy

return new XFireProxyFactory().create(new ObjectServiceFactory().create(BookService.class),serviceUrl) 

修改为

Service serviceModel = new ObjectServiceFactory().create(BookService.class);
     BookService bookService = (BookService) new XFireProxyFactory().create(serviceModel,serviceUrl);
     Client client = ((XFireProxy) Proxy.getInvocationHandler(bookService)).getClient();
     client.addOutHandler(new ClientAuthHandler());
     return bookService; 

4.实现负责将用户名和密码加入请求的clientAuthHandler.java。

5.在测试用例中加入用户名和密码，见/springside-bookstore/test/unit/.../plugins/xfire/xxx.FindBookByName.xml,header部分增加了

<env:Header>
        <AuthenticationToken xmlns="http://service.xfire.plugins.bookstore.springside.org">
            <Username>admin</Username>
            <Password>admin</Password>
        </AuthenticationToken>
    </env:Header>