XFire快速上手

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

搭建webservice工程环境
在eclipse里创建一个叫webservice的java工程，然后依次添加src-service、src-conf、src-test和src-util这几个Source Folder以及web这个Folder
目录结构及文件如下:

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

然后将解压后的xfire的lib目录下所有jar包和xfire-all-1.*.jar复制到WEB-INF/lib目录
web.xml内容如下:

<?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>

写一个BookService
我们将创建一个从ISBM号得到Book的Title的简单查询Web服务
首先创建Book.java

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;
	}

}

然后写一个BookService接口BookService.java

package cn.hidetoishandsome.xfire.service;

import cn.hidetoishandsome.xfire.model.Book;

public interface BookService {
	Book findBookByISBN(String isbn);
}

然后是BookService的实现BookServiceImpl.java

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");
	}

}

在services.xml中配置要发布的服务
在src-conf的META-INF/xfire目录创建services.xml

<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>

其中name标签决定了我们创建的该服务的WSDL的URL为http://xx.xx.xx/xx/xx/BookService?wsdl

在Tomcat中发布
可以简单的修改Tomcat的server.xml来发布该Web服务，在<Host>标签中添加以下内容:

Context path="/webservice" docBase="D:\project\webservice\web" reloadable="true"/>

现在打开浏览器访问http://localhost:8080/webservice/services/BookService?wsdl来看看生成的WSDL文档

客户端调用测试
我们将使用一个XfireClientFactory.java工具类来帮我们调用该Web服务:

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;
		}
	}

}

然后编写一个BookServiceTest.java来调用我们刚才发布的Web服务:

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();
		}

	}
}

服务调用成功，Console打印内容如下:

Book with ISBN '123456': 《XFire Quick Start》

评论

3 楼 hua758209 2011-07-29  

这些讲的都是在同一个工程下实现的，有没有跨工程的例子啊

2 楼 hideto 2008-06-18  

客户端接口SDK得提供给客户端应用的
serviceURL指定远程URL即可

PS: 很久没碰这个东西了

1 楼 xuewei 2008-06-18  

你这里能够调是因为你在同一个 应用下.可以引进来BookService,如果你不是在同一个应用下呢?
BookService service = XfireClientFactory.getClient(serviceURL, BookService.class);  

可以加你MSN或是QQ聊下这个吗?
MSN:[e-mail]
QQ :280256825