C++与Java通过WebService通信(上)

一、 前言

本篇讲述如果通过C++客户端访问Java服务端发布的SOAP模式的WebService接口。文档中的样例代码拷贝出去即可运行，所有的代码都是本地测试OK的；本文不但解决了接口调用的问题，同时解决了中文乱码的问题。

二、 环境准备

1、 CXF组件：Java端用于发布WebService服务的开源组件，内部自带jetty Web容器。
2、 Gsoap组件：C++端用户访问WebService服务的组件。使用的是gsoap-2.8。这两个组件可以直接google，官网下载。
3、 Eclipse：Java开发IDE。
4、 VS 2010：C++开发IDE。

三、 Java服务端开发

Step1 开发Java服务接口

1、 新建Java项目，导入CXF lib目录下的Jar包。
2、 定义WebService接口。

import javax.jws.WebMethod;
import javax.jws.WebService;

@WebService
public interface WSWebServiceIF {
    @WebMethod
    public String helloWebService();

    @WebMethod
    public String helloWebService2(String param);

}

3、 实现WebService接口

import java.nio.charset.Charset;

public class WSWebService implements WSWebServiceIF {
    @Override
    public String helloWebService() 
    {
        return "Hello WS Webservice!";
    }

    @Override
    public String helloWebService2(String param) 
    {
        System.out.println("接收到输入参数：" + param);
        String str = "1212312abns返回值带中文。";
        return new String(str.getBytes(Charset.forName("UTF-8")));
    }
}

Step2借助CXF发布WebService服务

import org.apache.cxf.jaxrs.JAXRSServerFactoryBean;
import org.apache.cxf.jaxws.JaxWsServerFactoryBean;

public class StartUp {
    public static void main(String[] args) 
    {
        JaxWsServerFactoryBean jwfbean = new JaxWsServerFactoryBean();

        // 将服务发布到本机的10009端口上，服务名是WS。
        jwfbean.setAddress("http://localhost:10009/WS");
        jwfbean.setServiceClass(WSWebServiceIF.class);
        jwfbean.setServiceBean(new WSWebService());
        jwfbean.create();

        // 阻塞线程、等待外部消息请求。
        while(true)
        {
            try {
                Thread.sleep(5000);
            } catch (InterruptedException e) {
                e.printStackTrace();
            }
        }
    }
}

借助CXF，用JAVA语言开发WebService服务是非常简单的。环境配置简单，几句代码就搞定。
注意：localhost在host文件中设置是否正确，如果设置为其它无效IP。会导致服务发布失败。
服务发布成功后可以在浏览器中查看服务的接口文件了（WSDL）。

四、 C++客户端开发

Step1 使用gsoap-2.8\gsoap\bin\win32\wsdl2h.exe生成客户端头文件。

执行该命令行，在wsdl2h.exe同目录下生成hellowebservice.h头文件。生成C++版本，不使用STL的头文件。wsdl2h.exe命令还有很多参数可选，wsdl2h.exe –h显示帮助信息。

Step2 使用gsoap-2.8\gsoap\bin\win32\ soapcpp2.exe生成桩文件。借助这些桩函数，在C++中可以像调用本地函数一样访问远程服务器上的WebService服务。

Soapcpp2.exe还有很多参数可选，输入 soapcpp2.exe –h可查看帮助。执行上述命令后生成的如下文件(将红框内的文件拷贝到VS2010工程中)：

stdsoap.h和stdsoap.cpp文件从gsoap-2.8\gsoap目录下拷贝过来。

Step3 开发客户端调用代码

#include "stdafx.h"
#include "soapH.h"

// 将UTF-8字符传唤为宽字符，用于在控制台显示
wchar_t* MulityByteToWideChar(UINT CodePage, char *str)
{
     DWORD dwNum = MultiByteToWideChar(CodePage, 0, str, -1, 0, 0);
     wchar_t *pwText = new wchar_t[dwNum];
     MultiByteToWideChar(CodePage, 0, str, -1, pwText, dwNum); 
     return pwText;
}

// 将宽字符转换为UTF-8模式。用于传递参数。
char* WideCharToMulityByte(UINT CodePage, wchar_t *str)
{
     int len = WideCharToMultiByte(CodePage, 0, str, -1, 0, 0, 0, 0); 
     char* output = new char[len + 2];
     WideCharToMultiByte(CodePage, 0, str, -1, output, len + 1, 0, 0); 
     return output;
}


int _tmain(int argc, _TCHAR* argv[])
{
    struct soap soapObject;
    soap_init(&soapObject);
    soap_set_mode(&soapObject, SOAP_C_UTFSTRING);

    // 测试代码，路径硬编码。
    const char* server = "http://localhost:10009/WS/WSWebServiceIF?wsdl";

    // 调用无输入参数的接口
    ns1__helloWebServiceResponse rsp;
    ns1__helloWebService ns1;
    soap_call___ns1__helloWebService(&soapObject, server, "", &ns1, rsp);

    // 调用有输入参数、有返回值的接口。样例代码中输入参数是一个字符串、返回值也是
    // 一个字符串。需要传递更多的信息可以加多个参数，也可以传一个json串, 把所需内容都包在里面。
    // 推荐后一种做法。
    ns1__helloWebService2 ns11;
    ns11.arg0 =  WideCharToMulityByte(CP_UTF8, L"12341asasas带中文");
    ns1__helloWebService2Response rsp2;
    soap_call___ns1__helloWebService2(&soapObject, server, "", &ns11, rsp2);

    wchar_t* wcReturn = MulityByteToWideChar(CP_UTF8, rsp2.return_);
    printf("接收到返回值：%s\n", wcReturn);

    soap_end(&soapObject);
    soap_done(&soapObject);

    return 0;
}

五 调试验证

先用Eclipse启动Java服务端，再在VS2010中启动客户端，单步调试。查看接口调用和传参，返回值信息。