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的相应目录下面。

1. 如果Web Services的方法的参数是Collections，那就需要建一个Mapping文件，而且Mapping文件的命名为className.aegis.xml，并且与class放在同一个package下。
如：
public interface IConstraceSerice {
   boolean editConstraceInfo(List aList);
}
Mapping文件如下：IConstraceService.aegis.xml
<?xml version="1.0" encoding="utf-8"?>
<mappings>
   <mapping>
      <method name="editConstraceInfo">
          <parameter index="0" componentType="java.lang.String"/>
      </method>
   </mapping>
</mappings>

<parameter index="0" componentType="java.lang.String"/>表示第一个参数，里面实际值的类型,这里实际值的类型是java.lang.String.
如果是一个JavaBean,如com.test.TestBean,那以就要写成<parameter index="0" compentType="com.test.TestBean"/>

2. 如果返回类型是List或Map，并且里面存放的是自定义类的话，则需要增加一个对于服务接口的配置文件。该文件的命名规则是　接口文件名.aegis.xml。例如接口是UserService.java的话，则此配置文件命名为UserService.aegis.xml。注意此配置文件须与接口放在同一目录下面。
<?xml version="1.0" encoding="UTF-8"?> 
 <mappings> 
   <mapping > 
     <method name="getUsers"> 
       <return-type componentType="com.test.domain.User"/> 
     </method> 
   </mapping> 
 </mappings>
getUsers方法返回类型是List，里面装的User对象。对于这种类型的方法，在配置文件中描述了它的返回值类型。

如果返回的类型是Map的话，做法和List一样。但定义的类型，是Map中的Value部分，并且这样的话，Map中Value所存放的对象就必须全部是同一种类啦。

下面给出一个详细的例子：
1）服务接口:
public interface MyService2
{
    boolean getInfo();
    Collection getCollection(); //method 1
    Collection getCollection(int id); //method 2
    Collection getCollection(String id); //method 3
    Collection getCollectionForValues(String id, Collection c); //method 4
    Collection getCollectionForValues(int value, Collection c); //method 5
}
2) Mapping文件内容:
<mappings>
    <mapping>
        <!-- mapping 1 -->
        <method name="getCollection">
            <return-type componentType="java.lang.Double"/>
        </method>
        <!-- mapping 2 -->
        <method name="getCollection">
            <return-type componentType="java.lang.Float"/>
            <parameter index="0" class="int"/>
        </method>
        <!-- mapping 3 -->
        <method name="getCollectionForValues">
            <return-type componentType="java.math.BigDecimal"/>
        </method>
        <!-- mapping 4 -->
        <method name="getCollectionForValues">
            <parameter index="0" class="java.lang.String"/>
            <parameter index="1" componentType="java.util.Date"/>
        </method>
        <!-- mapping 5 -->
        <method name="getCollectionForValues">
            <return-type componentType="java.util.Calendar"/>
            <parameter index="0" class="int"/>
            <parameter index="1" componentType="java.lang.Bit"/>
        </method>
    </mapping>
</mappings>

3. 如果一个方法的返回类型是一个JavaBean,而这个JavaBean当中又存在Collections,那么就需要定义一个与JavaBean相关的Mapping文件,文件名要与JavaBean名相同,如:User.aegis.xmll,并且与JavaBean放在同一个目录.

例子:
1) 服务接口
public interface IYMServiceFacade {
   User getUser();
}

2) JavaBean
public class User {
   private Strirng userName;
   // 这里是一个Collection
   private Set rooms;

   .....
   .....
}

3) Mapping文件(User.aegis.xml)
<?xml version="1.0" encoding="utf-8"?>
<mappings>
    <mapping>
        <property name="rooms" componentType="com.powerunion.ymservice.dto.Room"/>
    </mapping>
</mappings>

介绍:<property name="rooms" componentType="com.powerunion.ymservice.dto.Room"/>
其中的name属性就是JavaBean里面定义的rooms,componentType上面的相同,表示Collections里真正存储的类型.

请注意，此文件一定要放到与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