这一节,通过SpringSide来分析XFire的应用。
SpringSide开源项目是国内的开发人员所做的一个以Spring为核心的开源项目,目的是提供一个Pragmatic的企业应用开发基础和最佳实践展示。为使用Spring框架的开发者提供一个非Demo版的复杂、正式而体现最佳使用实践的参照系统。为JavaEEer必须面对的所有问题提供合理的、合乎Pragmatic原则的解决方案。采用Plugins形式组织,使开发者可快速定位所需的参考方案并做加法到自己的系统。
SpringSide中关于Web服务的配置是在
WEB-IBF/classes文件下的applicationContext-webservice.xml中配置的:
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE beans PUBLIC "-//SPRING//DTD BEAN//EN" "http://www.springframework.org/dtd/spring-beans.dtd">
<beans>
<import resource="classpath:org/codehaus/xfire/spring/xfire.xml"/>
<bean class="org.springframework.web.servlet.handler.SimpleUrlHandlerMapping">
<property name="mappings">
<value>/BookService=bookService</value>
</property>
</bean>
<bean id="baseWebService" class="org.codehaus.xfire.spring.remoting.XFireExporter" abstract="true">
<property name="serviceFactory" ref="xfire.serviceFactory"/>
<property name="xfire" ref="xfire"/>
</bean>
<bean id="bookService" parent="baseWebService">
<property name="serviceBean" ref="bookManager"/>
<property name="serviceClass" value="org.springside.bookstore.service.webservice.BookService"/>
</bean>
</beans>
第一步,引入xfire.xml文件
<import resource="classpath:org/codehaus/xfire/spring/xfire.xml"/>。这样,我们就不必在web.xml中配置了,这种语法在Spring参考手册(2.0-M3)3.18节中有介绍,3.19节介绍了在web.xml配置bean定义文件的方法,就是上一节使用的方法。
第二步,处理映射,将/BookService URL和bookService这个bean联系起来。当然,这里bookService又继承了baseWebService,这样做挺巧妙,这样如果有多个Web服务bean,就继承baseWebService就可以了,这种面向对象的概念还是值得我们提倡的,Spring参考手册3.5节介绍了相关的知识。
在bookService的定义中,serviceBean也就是接口实现类为bookManager bean,这个bean实际是在WEB-INF/classes/ applicationContext-manager.xml文件中所定义,类名为org.springside.bookstore.service.logic.BookManager:
package org.springside.bookstore.service.logic;
import … …
public class BookManager extends BaseHibernateDao implements BookService {
private CategoryManager categoryManager;
public void setCategoryManager(CategoryManager categoryManager) {
this.categoryManager = categoryManager;
}
protected Class getEntityClass() {
… …
}
public Book get(Integer id) {
… …
}
public void save(Book book) {
… …
}
public void remove(Integer id) {
… …
}
public List getAllCategorys() {
… …
}
public Category getCategory(Integer id) {
… …
}
public List findBooksByName(String name) {
… …
}
public List getNewBooks() {
… …
}
public List findAllLowStock(Integer stockHint) {
… …
}
public List findBooksByCategory(String category_id) {
… …
}
protected void filterCriteria(Criteria criteria, Map filter) {
… …
}
}
serviceClass也就是接口类为
org.springside.bookstore.service.webservice.BookService:
package org.springside.bookstore.service.webservice;
import java.util.List;
public interface BookService {
List findBooksByName(String name);
List findBooksByCategory(String category);
List getAllCategorys();
}
事实上,SpringSide既是一个Web服务的提供者,又是一个Web服务的消费者。它在WEB-INF/classes/applicationContext-webservice-client.xml文件中定义了消费这个Web服务的bean:
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE beans PUBLIC "-//SPRING//DTD BEAN//EN" "http://www.springframework.org/dtd/spring-beans.dtd">
<beans>
<!-- 一分钟刷新一次sciprt文件-->
<bean class="org.springframework.scripting.support.ScriptFactoryPostProcessor">
<property name="refreshCheckDelay" value="60" />
</bean>
<bean id="BookServiceClient" class="org.springframework.scripting.groovy.GroovyScriptFactory">
<constructor-arg value="classpath:org/springside/bookstore/service/webservice/BookServiceClient.groovy"/>
<property name="serviceUrl" value="http://localhost:8080/springside/service/BookService" />
</bean>
</beans>
这个消费Web服务的bean定义为BookServiceClient,它是采用Groovy脚本语言定义了。在Spring参考手册(2.0-M3)中的第25章专门介绍在Spring中脚本语言的使用,脚本语言支持是Spring 2.0新增的内容,目前可以支持Groovy、BeanShell、Jruby三种脚本语言。
这个BookServiceClient最终是在dwr中使用,可以
plugins\org.springside.ajax.dwr\webapp\WEB-INF\dwr.xml中的定义。
在SpringSide,采用Aegis的binding方式,在
plugins\org.springside.webservice.xfire\src\org\springside\bookstore\service\webservice\BookService.aegis.xml中定义了返回值的类型:
<?xml version="1.0" encoding="UTF-8"?>
<mappings>
<mapping>
<method name="findBooksByName">
<return-type componentType="org.springside.bookstore.domain.Book"/>
</method>
<method name="findBooksByCategory">
<return-type componentType="org.springside.bookstore.domain.Book"/>
</method>
<method name="getAllCategorys">
<return-type componentType="org.springside.bookstore.domain.Category"/>
</method>
</mapping>
</mappings>
XFire在SpringSide中的应用就介绍到这里为止。