CXF是什么
Apache CXF 是一个开源的、全功能的WebService框架,它提供了一套工具和API来帮助开发和构建WebService,像 JAX-WS 和 JAX-RS。它也支持许多WebService标准,例如:
和许多其他的特性。[更多的请参考 http://en.wikipedia.org/wiki/Apache_CXF]
![]() |
demo.wsdl 是本文中使用的示例wsdl文件. |
使用CXF调用WebService
每个WebService服务都需要提供一套用于外部调用的接口,也需要提供对应于这些接口调用的输入输出数据格式。用于规范这些接口和消息格式定义的标准就是 WSDL 。在本节里,将讨论如何使用CXF 来开发一个基于某个WSDL的WebService客户端。 (这里假设使用的传输协议为 HTTP,更多的可以参考本博客里的关于CXF的介绍的文章).
本质上,每个基于 HTTP 的WebService服务都等价于一个接收 HTTP-POST 请求的HTTP服务,为了调用这个服务,用户只需要知道如何构造一个期望的HTTP POST请求格式,例如:
POST http://localhost:8040/services/WebService HTTP/1.1 Accept-Encoding: gzip,deflate Content-Type: text/xml;charset=UTF-8 SOAPAction: "http://www.talend.org/service/WebServiceOperation1" Content-Length: 307 Host: localhost:8040 Connection: Keep-Alive <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://www.talend.org/service/"> <soapenv:Header/> <soapenv:Body> <ser:WebServiceOperationRequest1> <in>Hello</in> </ser:WebServiceOperationRequest1> </soapenv:Body> </soapenv:Envelope>可以使用Java HTTP API 发送以上请求:
//request content String content = "<soapenv:Envelope" + " xmlns:soapenv=\"http://schemas.xmlsoap.org/soap/envelope/\"" + " xmlns:ser=\"http://www.talend.org/service/\">" + "<soapenv:Body><ser:WebServiceOperationRequest1><in>Hello</in>" + "</ser:WebServiceOperationRequest1></soapenv:Body>" + "</soapenv:Envelope>"; //service url URL url = new URL("http://localhost:8040/services/WebService"); HttpURLConnection connection = (HttpURLConnection) url.openConnection(); //set soapaction connection.addRequestProperty("SOAPAction", "http://www.talend.org/service/WebServiceOperation1"); connection.setDoOutput(true); connection.setDoInput(true); //send out request OutputStream os = connection.getOutputStream(); os.write(content.getBytes()); os.flush(); //read response and print out InputStream is = connection.getInputStream(); int available = is.available(); byte[] response = new byte[available]; is.read(response); System.out.println(new String(response)); os.close(); is.close();
从以上代码里可以看出,为了使得调用成功,我们需要关心从请求信息到连接信息的几乎每个细节。因此这里,我们将介绍如果使用CXF 来简化请求,从而让用户可以只关注业务逻辑部分,再底层细节由CXF 处理。
CXF 提供了好几种调用WebService的方法,详细的可以参考本博客里的相关文章。这里就介绍两种:Provider-Dispatch 和 JAX-WS
Provider-Dispatch
Provider-Dispatch 是一种类似于 Java HTTP 的方式,好处就是灵活、方便、强大,缺点就是和Java HTTP 一样,用户需要知道如何构建一个合格的消息。更多的可以看 http://liugang594.iteye.com/blog/1964510 。
JAX-WS
JAX-WS 是 Java API for XML Web Services 的简称,它是用于创建WebService的Java API,它定义了一个用于Java-WSDL映射的标准,例如WSDL接口如何绑定到Java方法,以及SOAP消息如何匹配到方法的参数等。
为了简化 WSDL 和 Java的映射, CXF 提供了一些工具和API用于Java和WSDL之间的转换,这里只展示如何从WSDL转成Java.
WSDL2Java 命令行
CXF 提供了一个 wsdl2java 命令行工具用于从 WSDL 转换到 Java,有很多可用的选项,以下列出了主要的几个选项:[更多的可以访问 https://cxf.apache.org/docs/wsdl-to-java.html ]:
|
Interpretation |
|
Specifies zero, or more, package names to use for the generated code. Optionally specifies the WSDL namespace to package name mapping. |
|
Specifies the directory into which the generated code files are written. |
wsdlurl |