XFire快速上手

[b]下载XFrie[/b]
首先，去[url]http://xfire.codehaus.org[/url]下载最新版本的XFire

[b]搭建webservice工程环境[/b]
在eclipse里创建一个叫webservice的java工程，然后依次添加src-service、src-conf、src-test和src-util这几个Source Folder以及web这个Folder
目录结构及文件如下:
[code]
webservice
src-service
cn.hidetoishandsome.xfire.model
Book.java
cn.hidetoishandsome.xfire.service
BookService.java
cn.hidetoishandsome.xfire.service.impl
BookServiceImpl.java
src-conf
META-INF
xfire
services.xml
src-test
cn.hidetoishandsome.xfire.test
BookServiceTest.java
src-util
cn.hidetoishandsome.xfire.util
XfireClientFactory.java
web
WEB-INF
lib
web.xml
index.html
[/code]
然后将解压后的xfire的lib目录下所有jar包和xfire-all-1.*.jar复制到WEB-INF/lib目录
web.xml内容如下:
[code]
<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://java.sun.com/xml/ns/j2ee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="2.4"
xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd">

<servlet>
<servlet-name>xfire</servlet-name>
<servlet-class>org.codehaus.xfire.transport.http.XFireConfigurableServlet</servlet-class>
</servlet>

<servlet-mapping>
<servlet-name>xfire</servlet-name>
<url-pattern>/services/*</url-pattern>
</servlet-mapping>

</web-app>
[/code]

[b]写一个BookService[/b]
我们将创建一个从ISBM号得到Book的Title的简单查询Web服务
首先创建Book.java
[code]
package cn.hidetoishandsome.xfire.model;

public class Book {

private String title;

private String isbn;

public String getIsbn() {
return isbn;
}

public void setIsbn(String isbn) {
this.isbn = isbn;
}

public String getTitle() {
return title;
}

public void setTitle(String title) {
this.title = title;
}

}
[/code]
然后写一个BookService接口BookService.java
[code]
package cn.hidetoishandsome.xfire.service;

import cn.hidetoishandsome.xfire.model.Book;

public interface BookService {
Book findBookByISBN(String isbn);
}
[/code]
然后是BookService的实现BookServiceImpl.java
[code]
package cn.hidetoishandsome.xfire.service.impl;

import cn.hidetoishandsome.xfire.model.Book;
import cn.hidetoishandsome.xfire.service.BookService;

public class BookServiceImpl implements BookService {

private Book book;

public BookServiceImpl() {
book = new Book();
book.setTitle("XFire Quick Start");
book.setIsbn("123456");
}

public Book findBookByISBN(String isbn) {
if (isbn.equals(book.getIsbn()))
return book;
throw new RuntimeException("Can't find book");
}

}
[/code]

[b]在services.xml中配置要发布的服务[/b]
在src-conf的META-INF/xfire目录创建services.xml
[code]
<beans xmlns="http://xfire.codehaus.org/config/1.0">
<service>
<name>BookService</name>
<namespace>http://localhost:8080/xfire/services/BookService</namespace>
<serviceClass>cn.hidetoishandsome.xfire.service.BookService</serviceClass>
<implementationClass>cn.hidetoishandsome.xfire.service.impl.BookServiceImpl</implementationClass>
</service>
</beans>
[/code]
其中name标签决定了我们创建的该服务的WSDL的URL为http://xx.xx.xx/xx/xx/BookService?wsdl

[b]在Tomcat中发布[/b]
可以简单的修改Tomcat的server.xml来发布该Web服务，在<Host>标签中添加以下内容:
[code]
Context path="/webservice" docBase="D:\project\webservice\web" reloadable="true"/>
[/code]
现在打开浏览器访问[url]http://localhost:8080/webservice/services/BookService?wsdl[/url]来看看生成的WSDL文档

[b]客户端调用测试[/b]
我们将使用一个XfireClientFactory.java工具类来帮我们调用该Web服务:
[code]
package cn.hidetoishandsome.xfire.util;

import java.net.MalformedURLException;

import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;
import org.codehaus.xfire.client.XFireProxyFactory;
import org.codehaus.xfire.service.Service;
import org.codehaus.xfire.service.binding.ObjectServiceFactory;
import org.springframework.util.Assert;

public class XfireClientFactory {
private static XFireProxyFactory serviceFactory = new XFireProxyFactory();

private static final Log log = LogFactory.getLog(XfireClientFactory.class);

private XfireClientFactory() {
}

public static <T> T getClient(String serviceURL, Class<T> serviceClass) {
Assert.notNull(serviceURL);
Assert.notNull(serviceClass);
Service serviceModel = new ObjectServiceFactory().create(serviceClass);
try {
return (T) serviceFactory.create(serviceModel, serviceURL);
} catch (MalformedURLException e) {
log.error(e.getMessage(), e);
return null;
}
}

}
[/code]
然后编写一个BookServiceTest.java来调用我们刚才发布的Web服务:
[code]
package cn.hidetoishandsome.xfire.test;

import cn.hidetoishandsome.xfire.service.BookService;
import cn.hidetoishandsome.xfire.util.XfireClientFactory;

public class BookServieTest {

public static void main(String[] args) {
String serviceURL = "http://localhost:8080/webservice/services/BookService";
try {
BookService service = XfireClientFactory.getClient(serviceURL, BookService.class);
System.out.println("Book with ISBN '123456': 《" + service.findBookByISBN("123456").getTitle() + "》");
} catch (Exception e) {
e.printStackTrace();
}

}
}
[/code]
服务调用成功，Console打印内容如下:
[code]
Book with ISBN '123456': 《XFire Quick Start》
[/code]