一、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客户端的开发。