XFire完整入门教程
网上关于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
}
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}
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
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}
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 >
<? 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
<? 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 >
<? 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 >
<? 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.XFireConfigurableServlet11
</ 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
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(XFireFactory19
.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
以上代码均无注释，因为都非常简单，呵呵。如有不清楚的地方，请留言！