XFire完整入门教程

XFire完整入门教程

本Blog所有内容不得随意转载，版权属于作者所有。如需转载请与作者联系（ fastzch@163.com ）。
未经许可的转载，本人保留一切法律权益。
一直以来，发现有某些人完全不尊重我的劳动成果，随意转载，提醒一下那些人小心哪天惹上官司。

网上关于XFire入门的教程不少，要么是讲得很简单，就像Hello World一样的程序，要么就是通过IDE集成的工具来开发的，这对于不同的人群有诸多不便，关于XFire的一些详细的信息就不再多讲，可以参考官方网站和相关的文档，这里讲一个完整的入门实例。

实例中包括三个情况，我想基本上可以概括所有的需求，或者自己稍加扩展即可。先来看看我们的Interface。

 1 package  test;
 2
 3 import  java.util.List;
 4
 5 public   interface  IHelloService  {
 6      public  String sayHello(String ttt);
 7     
 8      public  Course choose(User u);
 9     
10      public  List  test(List t);
11 }

这其中包含了简单对象的传递，对象的传递，List的传递。

具体的开发步骤如下：
1、定义Web Service的接口，代码见上面的接口定义。

2、实现接口和业务逻辑，代码如下：

 1 package  test;
 2
 3 import  java.util.ArrayList;
 4 import  java.util.List;
 5
 6 public   class  HelloServiceImpl  implements  IHelloService  {
 7
 8    public String sayHello(String ttt) {
 9        return "Hello, "+ttt;
10    }
11    
12    public Course choose(User u){
13        System.out.println(u.getName());
14        Course c=new Course();
15        c.setName("Eee");
16        return c; 
17        
18    }
19    
20    public List  test(List t){
21        for (int i = 0; i < t.size(); i++) {
22            System.out.println((String) t.get(i));
23        }
24        List  al=new ArrayList();
25        Course c=new Course();
26        c.setName("EeeDDDDDD");
27        al.add(c);
28        return al;
29        
30    }
31}

用到的User和Course两个类的代码如下：

 1 package  test;
 2
 3 public   class  User  {
 4    private String name;
 5
 6    public String getName() {
 7        return name;
 8    }
 9
10    public void setName(String name) {
11        this.name = name;
12    }
13}
14

 1 package  test;
 2
 3 public   class  Course   {
 4    private String name;
 5
 6    public String getName() {
 7        return name;
 8    }
 9
10    public void setName(String name) {
11        this.name = name;
12    }
13
14}

3、编写XFire要求的WebSevice定义描述文件，如下：

 1 <? xml version="1.0" encoding="UTF-8" ?>
 2 < beans  xmlns ="http://xfire.codehaus.org/config/1.0" >
 3
 4      < service >
 5          < name > HelloService </ name >
 6          < namespace > http://test/HelloService </ namespace >
 7          < serviceClass > test.IHelloService </ serviceClass >
 8          < implementationClass > test.HelloServiceImpl </ implementationClass >
 9      </ service >
10     
11 </ beans >

此文件放在src/META-INF/xfire/services.xml，编译时会自动编译到classes的相应目录下面。

最近有些朋友因使用Spring2.0以上版本时，会发生如下异常：

ERROR  -  Error initializing XFireServlet.
org.springframework.beans.factory.BeanDefinitionStoreException: Unrecognized xbean element mapping: beans in namespace http: // xfire.codehaus.org/config/1.0

当出现如下异常时，请将此文件用如下内容替换：

 1 <? xml version="1.0" encoding="UTF-8" ?>
 2 < beans >
 3      < service  xmlns ="http://xfire.codehaus.org/config/1.0"
 4         xmlns:s ="http://www.springframework.org/schema/beans"
 5         xmlns:xsi ="http://www.w3.org/2001/XMLSchema-instance"
 6         xsi:schemaLocation ="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-2.5.xsd" >
 7          < name > HelloService </ name >
 8          < namespace > http://test/HelloService </ namespace >
 9          < serviceClass > test.IHelloService </ serviceClass >
10          < implementationClass > test.HelloServiceImpl </ implementationClass >
11      </ service >
12 </ beans >
13

4、因为我们用到了List等集合类型，所以需要定义Mapping关系，文件名为：src/test/IHelloService.aegis.xml，代码如下：

1 <? xml version="1.0" encoding="UTF-8" ?>
2 < mappings >
3      < mapping >
4          < method  name ="test" >
5              < parameter  index ="0"  componentType ="java.lang.String"   />
6              < return-type  componentType ="test.Course"   />
7          </ method >
8      </ mapping >
9 </ mappings >

请注意，此文件一定要放到与IHelloService.java相同的目录下面，否则会出错。

5、在Web.xml中配置XFire需要用到的Servlet，代码如下：

 1 <? xml version="1.0" encoding="UTF-8" ?>
 2 < web-app  version ="2.4"  xmlns ="http://java.sun.com/xml/ns/j2ee"
 3     xmlns:xsi ="http://www.w3.org/2001/XMLSchema-instance"
 4     xsi:schemaLocation ="http://java.sun.com/xml/ns/j2ee 
 5     http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd" >
 6
 7      < servlet >
 8          < servlet-name > XFireServlet </ servlet-name >
 9          < servlet-class >
10             org.codehaus.xfire.transport.http.XFireConfigurableServlet
11          </ servlet-class >
12      </ servlet >
13
14      < servlet-mapping >
15          < servlet-name > XFireServlet </ servlet-name >
16          < url-pattern > /servlet/XFireServlet/* </ url-pattern >
17      </ servlet-mapping >
18
19      < servlet-mapping >
20          < servlet-name > XFireServlet </ servlet-name >
21          < url-pattern > /services/* </ url-pattern >
22      </ servlet-mapping >
23
24
25      < welcome-file-list >
26          < welcome-file > index.jsp </ welcome-file >
27      </ welcome-file-list >
28 </ web-app >

此时Web Service的服务端就开发完成了。
我们来看看客户端的代码吧，也很简单，如下：

 1 package  test;
 2
 3 import  java.net.MalformedURLException;
 4 import  java.util.ArrayList;
 5 import  java.util.List;
 6
 7 import  org.codehaus.xfire.XFireFactory;
 8 import  org.codehaus.xfire.client.XFireProxyFactory;
 9 import  org.codehaus.xfire.service.Service;
10 import  org.codehaus.xfire.service.binding.ObjectServiceFactory;
11
12 public   class  Client  {
13
14    public static void main(String[] args) {
15
16        Service srvcModel = new ObjectServiceFactory()
17                .create(IHelloService.class);
18        XFireProxyFactory factory = new XFireProxyFactory(XFireFactory
19                .newInstance().getXFire());
20
21        String helloWorldURL = "http://localhost:8080/xfiretest/services/HelloService";
22        try {
23            IHelloService srvc = (IHelloService) factory.create(srvcModel,
24                    helloWorldURL);
25            System.out.println(srvc.sayHello("Robin"));
26            
27            User u=new User();
28            u.setName("RRRRR");
29            Course c=srvc.choose(u);
30            System.out.println(c.getName());
31            
32            List  al=new ArrayList();
33            al.add("1212");
34            al.add("2222");
35            List t=srvc.test(al);
36            for (int i = 0; i < t.size(); i++) {
37                Course co=(Course)t.get(i);
38                System.out.println(co.getName());
39            }
40            
41            
42        } catch (MalformedURLException e) {
43            e.printStackTrace();
44        }
45
46    }
47
48}
49

以上代码均无注释，因为都非常简单，呵呵。如有不清楚的地方，请留言！


关于使用XFire开发Web Service客户端的方法，可以参考我的另一篇文章《 使用XFire开发Web Service客户端完整入门教程》。