XFire 使用入门

阅读更多

 
一.  介绍

XFire是下一代的java SOAP框架。XFire提供了非常方便的API，使用

这些API可以开发面向服务(SOA)的程序。

支持多个重要的Web Service标准，包括SOAP、WSDL、WS-I Basic Profile、WSAddressing

、WS-Security等

• 高性能的SOAP栈

• 可选的绑定(binding)方式，如POJO、XMLBeans，JAXB1.1、JAXB2.0、Castor和JiBX等

• 支持JSR181 API

• 多种传输方式，如HTTP、JMS、XMPP、In－JVM等

• 灵活的接口

• 支持多个容器，如Spring、Pico、Plexus、Loom

• 支持JBI，参看servicemix项目(http://servicemix.org)

• 客户端和服务器代码生成

二．简单例子

A．发布web service

1．新建一个web 工程,加入xfire所依赖的lib,配置web.xml:




    xmlns="http://java.sun.com/xml/ns/j2ee"

    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

    xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee

    http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd">



XFireServlet

XFire Servlet



org.codehaus.xfire.transport.http.XFireConfigurableServlet







XFireServlet

/servlet/XFireServlet/*





XFireServlet

/services/*





在这个web.xml文件中定义了一个 XfireServlet，它负责提供Web Services，并提供每个Web Service的WSDL。通过网址http:////services/XXXXService?WSDL得到这个Web Service的WSDL信息。

2.编写要发布的接口和实现，与普通的POJO没有任何区别。

package cn.cares;



public interface HelloService {

    public String hello(String name);

}

package cn.cares;



public class HelloServiceImpl implements HelloService {



    public String hello(String name) {

       // TODO Auto-generated method stub

       return "HI,"+name!=null? name:"Guest";

    }



}

3.在源文件src目录下新建  META-INF/xfire/services.xml，编译发布时会复制到WEB-INF/classes/META-INF/xfire下.

services.xml: (写法有很多，要多研究下)





 

    HelloService

http://cn.cares/HelloService

cn.cares.HelloService

cn.cares.HelloServiceImpl

 



4.发布到web server 上，访问: http://localhost:8080/web_project_name/services

就可看到所发布的web service, 后面的蓝色的链接，就会得到这个Web Service

的WSDL信息。

B 客户端访问

方法一：

1.如果web service发布成功了，就要看如何使用这web service

根据WSDL生成客户端代码，我们采用eclipse plugin 这样更简单，也可采用ant

具体xfire插件安装： Help ->Software Updates->Find and Install->Search for new features to install->Create New Remote Site,并输入"XFire" 名字和http://dist.codehaus.org/xfire/update/ eclipse 更新站点。



2.File->new ->Other->XFire->Code generation from WSDL document

输入WSDL URL或PATH,以及要生成的客户端代码目录。



3.测试：

import cares.cn.helloservice.HelloServiceClient;

import cares.cn.helloservice.HelloServicePortType;



public class Test {

    public static void main(String[] args) {

       HelloServiceClient client = new HelloServiceClient();

       HelloServicePortType helloService = client.getHelloServiceHttpPort();

//     调用服务

       String result = helloService.hello("Tome");

       System.out.println("结果：" + result);

    }



}

注意： 当运行时可能失败，是因为提示缺少jar包，因此，要将commons-codec-1.3.jar和commons-httpclient-3.0.jar只放到lib中并在工程中引用

如果输出：HI,Tome  说明客户端调用web service 成功。整个过程就完成了。



方法二：

直接动态访问web service，测试代码如下：

import java.net.MalformedURLException;

import java.net.URL;



import org.codehaus.xfire.client.Client;



public class Test2 {

    public static void main(String[] args) throws MalformedURLException,Exception {

       Client client = new Client(

              new URL(

                     "http://localhost:8080/ws/services/HelloService?wsdl"));

       Object[] results = client.invoke("hello", new Object[] { "Tome" });

       //invoke的第一个参数你要调用的方法，第二参数表示调用方法传递的参数

       System.out.println((String) results[0]);

    }

}