您的位置:

Java调用WebService接口wsdl详解

一、WebService接口wsdl是什么

WebService接口wsdl(Web Services Description Language)是一种用于描述Web服务的语言,它基于XML语言,描述了如何访问一个Web服务以及Web服务的参数和数据类型等信息。使用wsdl语言可以方便开发人员快速构建Web服务。一个wsdl文件包含了Web服务的全部描述信息,可以视为Web服务的契约,客户端通过wsdl文档描述文件可以了解到WebService所提供的服务内容、调用方式和参数等信息。

二、Java调用WebService接口wsdl的流程

Java调用WebService接口wsdl分为以下几个步骤:

1. 导入WebService接口wsdl文件

2. 创建SOAP请求消息

3. 发送SOAP请求消息

4. 解析SOAP响应消息

三、导入WebService接口wsdl文件

在Java中,我们可以通过JAX-WS工具将wsdl文件导入为一个Java类,用于WebService的调用。导入wsdl文件的方式有两种:

1. 使用wsimport工具命令自动生成Java类

wsimport -p com.example.webservice.client -keep http://localhost:8080/HelloWorld?wsdl 

2. 手工编写Java类

手工编写Java类需要根据wsdl文件中的信息,手动构建WebService客户端。构建客户端的主要步骤是:创建服务(Service)、创建端口(Port)、创建绑定(Binding)、创建QName、创建请求参数等。

四、创建SOAP请求消息

SOAP消息格式分为请求和响应两个部分,通过构造SOAP消息的XML格式提供请求及响应的信息,其中请求XML格式遵照SOAP协议规范,XML必须包含SOAP消息头和SOAP消息体两个部分。SOAP消息体根据webservice服务器端需要调用的接口方法及方法的参数进行组装,SOAP消息头包含一些必须的标记和客户端自定义的标记,用于描述请求及响应的消息属性信息。

// 创建 service 实例
HelloWorldService service = new HelloWorldService();
// 从 service 中获取 port 实例
HelloWorld port = service.getHelloWorldPort();
// 组装请求消息
BindingProvider bp = (BindingProvider) port;
SOAPMessage requestMsg = MessageFactory.newInstance().createMessage();
SOAPPart soapPart = requestMsg.getSOAPPart();
SOAPEnvelope soapEnvelope = soapPart.getEnvelope();
SOAPBody soapBody = soapEnvelope.getBody();
QName bodyName = new QName(service.getNamespaceURI(), "getHelloWorldAsString", "ns1");
SOAPBodyElement bodyElement = soapBody.addBodyElement(bodyName);

五、发送SOAP请求消息

使用JDK提供的HttpURLConnection或Apache提供的HttpClient等HTTP请求工具向webservice服务端发送SOAP消息请求,获取SOAP响应消息,将响应消息转化为Java对象,以供调用者使用。

// 发送请求,并获取响应
URL endpoint = new URL("http://localhost:8080/HelloWorld");
HttpURLConnection conn = (HttpURLConnection) endpoint.openConnection();
ByteArrayOutputStream bout = new ByteArrayOutputStream();
requestMsg.writeTo(bout);
byte[] bytes = bout.toByteArray();
conn.setRequestProperty("Content-Length", String.valueOf(bytes.length));
conn.setRequestProperty("Content-Type", "text/xml;charset=UTF-8");
conn.setRequestProperty("SOAPAction", service.getNamespaceURI() + "getHelloWorldAsString");
conn.setDoOutput(true);
conn.getOutputStream().write(bytes);
ByteArrayInputStream bi = new ByteArrayInputStream(getBytes(conn));
SOAPMessage responseMsg = MessageFactory.newInstance().createMessage(null, bi);
conn.disconnect();

六、解析SOAP响应消息

解析响应SOAP消息的过程就是将一个XML格式的SOAP响应消息转换为Java对象,从中提取需要的业务数据。SOAP响应消息同样包含SOAP消息头和SOAP消息体。

// 解析响应消息
SOAPEnvelope resEnvelope = responseMsg.getSOAPPart().getEnvelope();
SOAPBody resBody = resEnvelope.getBody();
Iterator iterator = resBody.getChildElements(bodyName);
if (iterator.hasNext()) {
    SOAPBodyElement bodyElement = (SOAPBodyElement) iterator.next();
    String retStr = bodyElement.getTextContent();
}

七、总结

以上是Java调用WebService接口wsdl的详细流程,通过了解wsdl文件的定义、创建SOAP请求、发送SOAP请求以及解析SOAP响应等步骤,我们能够更加方便地实现WebService客户端的开发。