通过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 源代码：

    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 源代码：

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放在一个包下）

<?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源代码：

 

 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源代码：

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:

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

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

 

 

     

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