通过IDE开发基于web的XFire(WebService)

请下载两个工具包供环境使用 。

1、xfire-distribution-1.2.6.zip,主要包含XFire依赖的部分jar包，下载地址为http://repository.codehaus.org/org/codehaus/xfire/xfire-distribution/1.2.6/xfire-distribution-1.2.6.zip；

2、xalan-j_2_7_1-bin.zip ，主要包含了处理XML的工具，其下载地址为http://apache.mirror.phpchina.com/xml/xalan-j/xalan-j_2_7_1-bin.zip


一.配置IDE环境与XFire的开发

1、新建一个Java工程，取名为XFireDemo，将xfire-distribution-1.2.6.zip中的xfire-all-1.2.6.jar和lib下面的所有包，还有 xalan-j_2_7_1-bin.zip中的 xalan.jar导入到IDE的类路径中（当然，可以为上述jar包创建一个用户类库）

2、如图1，在XFireDemo的src下新建包，java文件，文件夹，以及xml文件，其中，之所以将META-INF建立在src下，是为了将IDE编译后输出目录下的所有文件夹部署到Tomcat中。





3、所有代码：

Book.java 是数据的封装类



Book.java 源代码：

view plaincopy to clipboardprint?
package stoneyang.bean;

public class Book {

private String name;

private String author;

private String year;

private String price;

public String getName() {

return name;

}

public void setName(String name) {

this.name = name;

}

public String getAuthor() {

return author;

}

public void setAuthor(String author) {

this.author = author;

}

public String getYear() {

return year;

}

public void setYear(String year) {

this.year = year;

}

public String getPrice() {

return price;

}

public void setPrice(String price) {

this.price = price;

}

public Book() {

super();

}

public Book(String name, String author, String year, String price) {

super();

this.name = name;

this.author = author;

this.year = year;

this.price = price;

}

public Book(String name) {

super();

this.name = name;

}

public Book(String name, String year) {

super();

this.name = name;

this.year = year;

}

public String toString(){

StringBuilder builder = new StringBuilder();

if( name != null && !"".equals(name.trim())){

builder.append( " 名称： "+name );

}

if( author != null && !"".equals(author.trim())){

builder.append( " 作者： "+author );

}

if( year != null && !"".equals(year.trim())){

builder.append( " 年份： "+year );

}

if( price != null && !"".equals(price.trim())){

builder.append( " 价格： "+price );

}

return builder.toString();

}

}
package stoneyang.bean;

public class Book {

private String name;

private String author;

private String year;

private String price;

public String getName() {

return name;

}

public void setName(String name) {

this.name = name;

}

public String getAuthor() {

return author;

}

public void setAuthor(String author) {

this.author = author;

}

public String getYear() {

return year;

}

public void setYear(String year) {

this.year = year;

}

public String getPrice() {

return price;

}

public void setPrice(String price) {

this.price = price;

}

public Book() {

super();

}

public Book(String name, String author, String year, String price) {

super();

this.name = name;

this.author = author;

this.year = year;

this.price = price;

}

public Book(String name) {

super();

this.name = name;

}

public Book(String name, String year) {

super();

this.name = name;

this.year = year;

}

public String toString(){

StringBuilder builder = new StringBuilder();

if( name != null && !"".equals(name.trim())){

builder.append( " 名称： "+name );

}

if( author != null && !"".equals(author.trim())){

builder.append( " 作者： "+author );

}

if( year != null && !"".equals(year.trim())){

builder.append( " 年份： "+year );

}

if( price != null && !"".equals(price.trim())){

builder.append( " 价格： "+price );

}

return builder.toString();

}

}





BusinessI.java 提供给webservice的接口，这里的返回值之所以用到泛型，是为了避免手动配置 stoneyang.businessI 包下BusinessI.aegis.xml的文件（BusinessI.java与BusinessI.aegis.xml同包，而且文件名的第一个“.”前的名称必须一样），而导致出错，此例子因用的是泛型，固无需配置。



BusinessI.java 源代码：

view plaincopy to clipboardprint?
package stoneyang.businessI;

import java.util.List;

import stoneyang.bean.Book;



public interface BusinessI {

public Book getBookByName(String name);

public List<Book> getBooksByNames(String[] bookNames);

public List<Book> getBooksWithSpecialYear(Book book);

}
package stoneyang.businessI;

import java.util.List;

import stoneyang.bean.Book;



public interface BusinessI {

public Book getBookByName(String name);

public List<Book> getBooksByNames(String[] bookNames);

public List<Book> getBooksWithSpecialYear(Book book);

}



若使用泛型，可跳过“====”之间的部分

=======================================================================

若不用泛型，则需要加BusinessI.aegis.xml文件,下面代码可以看出，"getBooksByNames"的方法的参数是字符串数组，但componentType="java.lang.String"，返回的是集合，但componentType="stoneyang.bean.Book"，可以看出，componentType会自动将参数（无论是集合还是数组或者是自定义类型）都会取一个尝试转换成配置的类型，而不是将String[],List来强转成componentType指定的类型；下面代码不能够写成两个map，每个map有一个method，那么程序会报错。



BusinessI.aegis.xml（若不用泛型，则必须添加此xml和BusinessI.java放在一个包下）

view plaincopy to clipboardprint?
<?xml version="1.0" encoding="UTF-8"?>
<mappings>
<mapping>
<method name="getBooksByNames">
<parameter index="0" componentType="java.lang.String" />
<return-type componentType="stoneyang.bean.Book" />
</method>
<method name="getBooksWithSpecialYear">
<parameter index="0" componentType="stoneyang.bean.Book" />
<return-type componentType="stoneyang.bean.Book" />
</method>
</mapping>
</mappings>
<?xml version="1.0" encoding="UTF-8"?>
<mappings>
<mapping>
<method name="getBooksByNames">
<parameter index="0" componentType="java.lang.String" />
<return-type componentType="stoneyang.bean.Book" />
</method>
<method name="getBooksWithSpecialYear">
<parameter index="0" componentType="stoneyang.bean.Book" />
<return-type componentType="stoneyang.bean.Book" />
</method>
</mapping>
</mappings>



================================================================================



BusinessImpl.java 提供给webservice的接口的实现



BusinessImpl.java源代码：



view plaincopy to clipboardprint?
package stoneyang.businessIpml;

import java.util.ArrayList;

import java.util.List;

import stoneyang.bean.Book;

import stoneyang.businessI.BusinessI;

public class BusinessImpl implements BusinessI{



//通过书名得到一本书来模拟数据库操作

public Book getBookByName(String name) {

return new Book(name);

}

//根据已知的书名数组，得到书实例的集合来模拟数据库操作

public List<Book> getBooksByNames(String[] bookNames) {

List<Book> books = new ArrayList<Book>();

for( String bookName : bookNames ){

books.add(new Book( bookName ));

}

return books;

}

//得到同年出版的其他书籍来模拟数据库操作

public List<Book> getBooksWithSpecialYear(Book book) {

List<Book> books = new ArrayList<Book>();

books.add(new Book(book.getName()+"翻印版",book.getYear()));

books.add(new Book(book.getName()+"影音版",book.getYear()));

return books;

}

}
package stoneyang.businessIpml;

import java.util.ArrayList;

import java.util.List;

import stoneyang.bean.Book;

import stoneyang.businessI.BusinessI;

public class BusinessImpl implements BusinessI{



//通过书名得到一本书来模拟数据库操作

public Book getBookByName(String name) {

return new Book(name);

}

//根据已知的书名数组，得到书实例的集合来模拟数据库操作

public List<Book> getBooksByNames(String[] bookNames) {

List<Book> books = new ArrayList<Book>();

for( String bookName : bookNames ){

books.add(new Book( bookName ));

}

return books;

}

//得到同年出版的其他书籍来模拟数据库操作

public List<Book> getBooksWithSpecialYear(Book book) {

List<Book> books = new ArrayList<Book>();

books.add(new Book(book.getName()+"翻印版",book.getYear()));

books.add(new Book(book.getName()+"影音版",book.getYear()));

return books;

}

}








Test.java 是远程调用的客户端，这里

（1） 通过远程调用得到一个book的实例，并在本地设置实例的年份；

（2） 通过远程调用，传入书名的数组，返回书实例的集合；（和（1）没有关系）

（3） 设置（1）的book实例再次进行远程调用得到同年份的book的集合；



Test.java源代码：

view plaincopy to clipboardprint?
package stoneyang.test;

import java.net.MalformedURLException;

import java.util.List;

import org.codehaus.xfire.XFireFactory;

import org.codehaus.xfire.client.XFireProxyFactory;

import org.codehaus.xfire.service.Service;

import org.codehaus.xfire.service.binding.ObjectServiceFactory;



import stoneyang.bean.Book;

import stoneyang.businessI.BusinessI;

public class Test {

public static void main(String args[]){

//通过接口类创建Service对象

Service srvcModel = new ObjectServiceFactory().create(BusinessI.class);

//通过XFire的工厂类创建工厂对象

XFireProxyFactory factory = new XFireProxyFactory(XFireFactory.newInstance().getXFire());

//访问的地址

String url="http://localhost:38088/xfireDemo/services/business";

//异常处理

try{

//创建服务对象

BusinessI srvc = (BusinessI) factory.create(srvcModel, url);

//调用服务中的方法，并显示其结果

Book book = srvc.getBookByName("《小红帽》");

book.setYear("1986年");

List<Book> books1 = srvc.getBooksByNames(new String[]{"《社会心理学》","《心理学与生活》"});

List<Book> books2 = srvc.getBooksWithSpecialYear(book);



System.out.println(book);

for( Book b: books1 ){

System.out.println( b );

}

for( Book b: books2 ){

System.out.println( b );

}

} catch (MalformedURLException e) {

e.printStackTrace();

}

}

}
package stoneyang.test;

import java.net.MalformedURLException;

import java.util.List;

import org.codehaus.xfire.XFireFactory;

import org.codehaus.xfire.client.XFireProxyFactory;

import org.codehaus.xfire.service.Service;

import org.codehaus.xfire.service.binding.ObjectServiceFactory;



import stoneyang.bean.Book;

import stoneyang.businessI.BusinessI;

public class Test {

public static void main(String args[]){

//通过接口类创建Service对象

Service srvcModel = new ObjectServiceFactory().create(BusinessI.class);

//通过XFire的工厂类创建工厂对象

XFireProxyFactory factory = new XFireProxyFactory(XFireFactory.newInstance().getXFire());

//访问的地址

String url="http://localhost:38088/xfireDemo/services/business";

//异常处理

try{

//创建服务对象

BusinessI srvc = (BusinessI) factory.create(srvcModel, url);

//调用服务中的方法，并显示其结果

Book book = srvc.getBookByName("《小红帽》");

book.setYear("1986年");

List<Book> books1 = srvc.getBooksByNames(new String[]{"《社会心理学》","《心理学与生活》"});

List<Book> books2 = srvc.getBooksWithSpecialYear(book);



System.out.println(book);

for( Book b: books1 ){

System.out.println( b );

}

for( Book b: books2 ){

System.out.println( b );

}

} catch (MalformedURLException e) {

e.printStackTrace();

}

}

}





services.xml 是给Tomcat部署使用的，暴露接口做为webservice的服务

services.xml:

view plaincopy to clipboardprint?
<?xml version="1.0" encoding="UTF-8"?>

<beans xmlns="http://xfire.codehaus.org/config/1.0">

<service>

<name>business</name>

<serviceClass>stoneyang.businessI.BusinessI</serviceClass>

<implementationClass>stoneyang.businessIpml.BusinessImpl</implementationClass>

<use>literal</use>

<scope>application</scope>

</service>

</beans>
<?xml version="1.0" encoding="UTF-8"?>

<beans xmlns="http://xfire.codehaus.org/config/1.0">

<service>

<name>business</name>

<serviceClass>stoneyang.businessI.BusinessI</serviceClass>

<implementationClass>stoneyang.businessIpml.BusinessImpl</implementationClass>

<use>literal</use>

<scope>application</scope>

</service>

</beans>



二. 配置Tomcat

1、在Tomcat下新建应用为 xfireDemo，如图2，创建目录后，添加相关的文件：





WEB-INF：创建web.xml



web.xml:

view plaincopy to clipboardprint?
<?xml version="1.0" encoding="ISO-8859-1"?>

<!-- START SNIPPET: webxml -->

<!DOCTYPE web-app

PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"

"http://java.sun.com/dtd/web-app_2_3.dtd">



<web-app>



<servlet>

<servlet-name>XFireServlet</servlet-name>

<display-name>XFire Servlet</display-name>

<servlet-class>

org.codehaus.xfire.transport.http.XFireConfigurableServlet

</servlet-class>

</servlet>



<servlet-mapping>

<servlet-name>XFireServlet</servlet-name>

<url-pattern>/servlet/XFireServlet/*</url-pattern>

</servlet-mapping>



<servlet-mapping>

<servlet-name>XFireServlet</servlet-name>

<url-pattern>/services/*</url-pattern>

</servlet-mapping>

</web-app>

<!-- END SNIPPET: webxml -->
<?xml version="1.0" encoding="ISO-8859-1"?>

<!-- START SNIPPET: webxml -->

<!DOCTYPE web-app

PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"

"http://java.sun.com/dtd/web-app_2_3.dtd">



<web-app>



<servlet>

<servlet-name>XFireServlet</servlet-name>

<display-name>XFire Servlet</display-name>

<servlet-class>

org.codehaus.xfire.transport.http.XFireConfigurableServlet

</servlet-class>

</servlet>



<servlet-mapping>

<servlet-name>XFireServlet</servlet-name>

<url-pattern>/servlet/XFireServlet/*</url-pattern>

</servlet-mapping>



<servlet-mapping>

<servlet-name>XFireServlet</servlet-name>

<url-pattern>/services/*</url-pattern>

</servlet-mapping>

</web-app>

<!-- END SNIPPET: webxml -->



WEB-INF/ classes:将IDE编译后输出目录下的所有文件夹拷贝到此处；

WEB-INF/lib:将之前配置IDE的所有jar包宝贝到此处；



部署后的文件目录：







三. 验证部署是否成功

开启Tomcat后，输入网址http://localhost:38088/xfireDemo/services/business?wsdl 后，若看到类似xml格式的内容，如下图，则部署成功；







四．远程调用



运行 stoneyang.test.Test.java 后得到结果：



名称： 《小红帽》 年份： 1986年

名称： 《社会心理学》

名称： 《心理学与生活》

名称： 《小红帽》翻印版 年份： 1986年

名称： 《小红帽》影音版 年份： 1986年







希望看到的朋友，哪点看不明白或者有错误敬请指出，谢谢。



发表于 @ 2009年02月24日　13:15:00 | 评论( 9 ) | 编辑| 举报| 收藏

旧一篇:WebSphere 6.1 安装部署 Liferay4.2.2 的应用 | 新一篇:使用Xfire从WSDL生成客户端（详）enxiuwang 发表于2009年3月7日 10:37:10 IP:举报
这样做有一个问题，客户端与服务器端用的是一个Book类，然而服务器端与客户端可能不是一个机器，并且服务器端可以用的是.net公布的服务,这样怎么办？stoneyang2005 发表于2009年3月7日 10:52:07 IP:举报
你看一下这个“http://blog.youkuaiyun.com/stoneyang2005/archive/2009/02/26/3939117.aspx”
这篇文章写的是从 wsdl 转化出客户端，它自动生成服务端的代码，和这篇文章中的代码截然不同，转化的客户端就是通过wsdl中反射出来的对象，那么，服务器端和客户端不是一台机器也无所谓的，至于.net发布的wsdl我想应该也可以使用的，毕竟，webservice是跨平台的不是？那么wsdl一定是有规范的，只要有规范，就可以用生成后的代码来调用的。zhlclient 发表于2009年3月11日 9:07:58 IP:举报
MyEclipe集成了Xfire，我用它建立了webservices工程，但只能返回基本类型。我自己定义了一个Product类，wdsl中的类型定义如下：
<xsd:complexType name="Product" />
- <xsd:element name="getProductsResponse">
- <xsd:complexType>
- <xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="1" name="out" nillable="true" type="tns:ArrayOfProduct" />
</xsd:sequence>
</xsd:complexType>
</xsd:element>
没有具体的类属性描述啊！

本文来自优快云博客，转载请标明出处：http://blog.youkuaiyun.com/stoneyang2005/archive/2009/02/24/3931841.aspx