网上关于XFire入门的教程不少,要么是讲得很简单,就像Hello World一样的程序,要么就是通过IDE集成的工具来开发的,这对于不同的人群有诸多不便,关于XFire的一些详细的信息就不再多讲,可以参考官方网站和相关的文档,这里讲一个完整的入门实例。
实例中包括三个情况,我想基本上可以概括所有的需求,或者自己稍加扩展即可。先来看看我们的Interface。 1package test; 2 3import java.util.List; 4 5public 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、实现接口和业务逻辑,代码如下: 1package test; 2 3import java.util.ArrayList; 4import java.util.List; 5 6public 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两个类的代码如下:
package test; 2 3public class User { 4 private String name; 5 6 public String getName() { 7 return name; 8 } 910 public void setName(String name) { 11 this.name = name;12 }13}14
package test; 2 3public class Course { 4 private String name; 5 6 public String getName() { 7 return name; 8 } 910 public void setName(String name) { 11 this.name = name;12 }1314}
3、编写XFire要求的WebSevice定义描述文件,如下:
<?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的相应目录下面。
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" />-----接受的参数类型,index--第几个参数6 <return-type componentType="test.Course" />-----List内对象的完整类名7 </method>8 </mapping>9</mappings>
请注意,此文件一定要放到与IHelloService.java相同的目录下面,否则会出错。
5、在Web.xml中配置XFire需要用到的Servlet,代码如下: <?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>1314 <servlet-mapping>15 <servlet-name>XFireServlet</servlet-name>16 <url-pattern>/servlet/XFireServlet/*</url-pattern>17 </servlet-mapping>1819 <servlet-mapping>20 <servlet-name>XFireServlet</servlet-name>21 <url-pattern>/services/*</url-pattern>22 </servlet-mapping>232425 <welcome-file-list>26 <welcome-file>index.jsp</welcome-file>27 </welcome-file-list>28</web-app>
此时Web Service的服务端就开发完成了。 我们来看看客户端的代码吧,也很简单,如下:
1package test; 2 3import java.net.MalformedURLException; 4import java.util.ArrayList; 5import java.util.List; 6 7import org.codehaus.xfire.XFireFactory; 8import org.codehaus.xfire.client.XFireProxyFactory; 9import org.codehaus.xfire.service.Service;10import org.codehaus.xfire.service.binding.ObjectServiceFactory;1112public class Client { 1314 public static void main(String[] args) { 1516 Service srvcModel = new ObjectServiceFactory()17 .create(IHelloService.class);18 XFireProxyFactory factory = new XFireProxyFactory(XFireFactory19 .newInstance().getXFire());2021 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 }4546 }4748}49
以上代码均无注释,因为都非常简单,呵呵。如有不清楚的地方,请留言!