使用cxf构建webservice

一、简介
　　cxf是apache下的一个开源的，功能齐全的WebService框架。是由Celtix和XFire两个开源框架组合而成。cxf可以帮助我们使用前端编程模型构建和开发服务，如JAX- WS和JAZ-RS。这些服务可以使用不同的协议，如SOAP，XML/HTTP,RESTFul HTTP或者CORBA和使用各种的数据传输协议，如HTTP，JMS 和JBI。除此之外cxf还有如下特性：

• 使用简单，可与maven，spring等进行集成。
• 支持Web Service标准，包括soap，WS-I Basic Profile, WSDL, WS-Addressing, WS-Policy, WS-ReliableMessaging, WS-Security, WS-SecurityPolicy, WS-
• SecureConverstation, 和WS-Trust (partial)。
• 对二进制和遗留协议的支持，cxf设计并提供了一个可插拔的架构，不仅支持xml还支持非xml类型的绑定，如json,corba。可使用多种类型格式进行传输。
• 提供了多中工具生成代码，如WSDL to JAVA, WSDL to JavaScript, Java to JavaScript等。

二、使用

　　cxf的下载地址如下：http://cxf.apache.org/download.html 。这里下载的是windows版本apache-cxf-3.0.3.zip。在c盘根目录下解压该文件，解压后文件目录结构如下：

　　

其中bin目录下的是为我们提供的相关转换工具，docs目录下的是相关文档，lib目录下是cxf的jar依赖；license目录下的是许可，samples是为我们提供的例子。

　　新建一个java项目cxf_server，并将lib下的jar文件（不包括endorse，和integration目录）添加到项目的依赖。

　　1、编写MyService接口 代码如下：

package com.cxf.testauto;

import javax.jws.WebService;

@WebService
public interface MyService {

    public String sayHello(String username, String address, String school); 
}

　　2、编写MyService的实现类

package com.cxf.testauto;

public class MyServiceImpl implements MyService {

    @Override
    public String sayHello(String username, String address, String school) {
        System.out.println("sayHello is invoked!");

        String result = "hello: " + username + ", your info is: " + address + ", " + school;

        return result;
    } 
}

　　3、Server 服务的启动类

package com.cxf.testauto;

import org.apache.cxf.interceptor.LoggingInInterceptor;
import org.apache.cxf.interceptor.LoggingOutInterceptor;
import org.apache.cxf.jaxws.JaxWsServerFactoryBean;

public class Server {

    public static void main(String[] args) {
        JaxWsServerFactoryBean factory = new JaxWsServerFactoryBean();
        factory.setAddress("http://localhost:9000/myservice");
        factory.setServiceClass(MyServiceImpl.class);
        factory.getInInterceptors().add(new LoggingInInterceptor());
        factory.getOutInterceptors().add(new LoggingOutInterceptor());
        factory.create();
    }
}

　　主要：如果jdk版本比较低会报java.lang.LinkageError: JAXB 2.0 API jar is being loaded, but this RI (...) needs 2.2 API.类似的错误。此时需要在运行该类的时候指定运行参数，打开Run Configurations窗口，在VM arguments输入如下参数：

-Djava.ext.dirs=C:\apache-cxf-3.0.3\lib\endorsed

　　表示指定jvm运行的时候，加载C:\apache-cxf-3.0.3\lib\endorsed目录下的jar文件。如下图所示

　　

　　点击Apply，运行即可。

　　4、运行Server类

　　启动成功后，我们可以通过浏览器访问wsdl文件，使用http://localhost:9000/myservice?wsdl 地址访问即可。wsdl文件内容如下：

<?xml version='1.0' encoding='UTF-8'?>
<wsdl:definitions xmlns:xsd="http://www.w3.org/2001/XMLSchema"
    xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" xmlns:tns="http://testauto.cxf.com/"
    xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:ns1="http://schemas.xmlsoap.org/soap/http"
    name="MyServiceImplService" targetNamespace="http://testauto.cxf.com/">
    <wsdl:types>
        <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema"
            xmlns:tns="http://testauto.cxf.com/" elementFormDefault="unqualified"
            targetNamespace="http://testauto.cxf.com/" version="1.0">

            <xs:element name="sayHello" type="tns:sayHello" />
            <xs:element name="sayHelloResponse" type="tns:sayHelloResponse" />

            <xs:complexType name="sayHello">
                <xs:sequence>
                    <xs:element minOccurs="0" name="arg0" type="xs:string" />
                    <xs:element minOccurs="0" name="arg1" type="xs:string" />
                    <xs:element minOccurs="0" name="arg2" type="xs:string" />
                </xs:sequence>
            </xs:complexType>

            <xs:complexType name="sayHelloResponse">
                <xs:sequence>
                    <xs:element minOccurs="0" name="return" type="xs:string" />
                </xs:sequence>
            </xs:complexType>

        </xs:schema>
    </wsdl:types>
    
    <wsdl:message name="sayHelloResponse">
        <wsdl:part element="tns:sayHelloResponse" name="parameters">
        </wsdl:part>
    </wsdl:message>
    <wsdl:message name="sayHello">
        <wsdl:part element="tns:sayHello" name="parameters">
        </wsdl:part>
    </wsdl:message>
    
    <wsdl:portType name="MyService">
        <wsdl:operation name="sayHello">
            <wsdl:input message="tns:sayHello" name="sayHello">
            </wsdl:input>
            <wsdl:output message="tns:sayHelloResponse" name="sayHelloResponse">
            </wsdl:output>
        </wsdl:operation>
    </wsdl:portType>
    
    <wsdl:binding name="MyServiceImplServiceSoapBinding" type="tns:MyService">
        <soap:binding style="document"
            transport="http://schemas.xmlsoap.org/soap/http" />
        <wsdl:operation name="sayHello">
            <soap:operation soapAction="" style="document" />
            <wsdl:input name="sayHello">
                <soap:body use="literal" />
            </wsdl:input>
            <wsdl:output name="sayHelloResponse">
                <soap:body use="literal" />
            </wsdl:output>
        </wsdl:operation>
    </wsdl:binding>
    
    <wsdl:service name="MyServiceImplService">
        <wsdl:port binding="tns:MyServiceImplServiceSoapBinding"
            name="MyServiceImplPort">
            <soap:address location="http://localhost:9000/myservice" />
        </wsdl:port>
    </wsdl:service>
</wsdl:definitions>

　　5、通过wsdl文件生成客户端

　　将C:\apache-cxf-3.0.3\bin 添加进系统环境变量path中。

　　cmd进入c盘根目录，运行命令

C:\>wsdl2java -client -encoding utf8 -frontend jaxws21 http://localhost:9000/myservice?wsdl 

　　该命令根据wsdl生产调用的客户端。-client表示生成客户端；-encoding表示生成的java代码的编码格式；frontend表示参照jaxws21标准；ttp://localhost:9000/myservice?wsdl为wsdl的地址，也可以是磁盘上的某一个wsdl文件。

　　执行结果如下：

　　命令执行成功后将会在c盘根目录下生成客户端的调用代码：生成的代码结构如下

　

　　我们主要使用到的就是MyService_MyServiceImplPort_Client.java这个调用类。
　　6、进行调用，新建另一个java工程cxf_client，将生成的客户端代码拷贝到这个工程中。并对MyService_MyServiceImplPort_Client.java类进行修改。
　　MyService_MyServiceImplPort_Client.java修改后的内容如下：

package com.cxf.testauto;

/**
 * Please modify this class to meet your needs
 * This class is not complete
 */

import java.io.File;
import java.net.MalformedURLException;
import java.net.URL;
import javax.xml.namespace.QName;
import javax.jws.WebMethod;
import javax.jws.WebParam;
import javax.jws.WebResult;
import javax.jws.WebService;
import javax.xml.bind.annotation.XmlSeeAlso;
import javax.xml.ws.RequestWrapper;
import javax.xml.ws.ResponseWrapper;

/**
 * This class was generated by Apache CXF 3.0.3
 * 2015-01-13T13:58:38.847+08:00
 * Generated source version: 3.0.3
 * 
 */
public final class MyService_MyServiceImplPort_Client {

    private static final QName SERVICE_NAME = new QName("http://testauto.cxf.com/", "MyServiceImplService");

    private MyService_MyServiceImplPort_Client() {
    }

    public static void main(String args[]) throws java.lang.Exception {
        URL wsdlURL = MyServiceImplService.WSDL_LOCATION;
        if (args.length > 0 && args[0] != null && !"".equals(args[0])) { 
            File wsdlFile = new File(args[0]);
            try {
                if (wsdlFile.exists()) {
                    wsdlURL = wsdlFile.toURI().toURL();
                } else {
                    wsdlURL = new URL(args[0]);
                }
            } catch (MalformedURLException e) {
                e.printStackTrace();
            }
        }
      
        MyServiceImplService ss = new MyServiceImplService(wsdlURL, SERVICE_NAME);
        MyService port = ss.getMyServiceImplPort();  
        
        {
        System.out.println("Invoking sayHello...");
        java.lang.String _sayHello_arg0 = "zhangsan";
        java.lang.String _sayHello_arg1 = "beijing";
        java.lang.String _sayHello_arg2 = "hello world";
        java.lang.String _sayHello__return = port.sayHello(_sayHello_arg0, _sayHello_arg1, _sayHello_arg2);//对webservice 接口进行调用
        System.out.println("sayHello.result=" + _sayHello__return);


        }

        System.exit(0);
    }

}

　　运行该类，完成调用。

　　client端打印的结果如下：

　　server端打印的结果如下：