如何使用 Java 中的 SAAJ 创建一个可用的 SOAP 客户端？

工作 SOAP 客户端示例

简介

SOAP 是一种广泛使用的协议，用于通过 Web 交换基于 XML 的消息。实现 SOAP 客户端可能是一项具有挑战性的任务，特别是对于初学者而言。本文旨在利用 SAAJ（适用于 Java 的带有附件 API 的 SOAP）框架提供一个简单而实用的 Java SOAP 客户端工作示例。

SAAJ：适用于 Java 的带有附件 API 的 SOAP

SAAJ 是 Java 中用于直接处理 SOAP 消息的框架。它使开发人员能够在不使用 JAX-WS 的情况下创建和解析 SOAP 消息。 SAAJ 提供了用于处理 SOAP 消息的简化界面，使其成为创建 SOAP 客户端的理想选择。

工作 SOAP 客户端示例

以下代码片段展示了一个工作使用 SAAJ 的 SOAP 客户端示例。此客户端调用 Web 服务来检索有关特定城市的信息：

import javax.xml.soap.*;

public class SOAPClientSAAJ {

    // SAAJ - SOAP Client Testing
    public static void main(String args[]) {
        // SOAP Endpoint URL and SOAP Action
        String soapEndpointUrl = "http://www.webservicex.net/uszip.asmx";
        String soapAction = "http://www.webserviceX.NET/GetInfoByCity";

        callSoapWebService(soapEndpointUrl, soapAction);
    }

    private static void createSoapEnvelope(SOAPMessage soapMessage) throws SOAPException {
        // Create SOAP Envelope and Namespace
        SOAPPart soapPart = soapMessage.getSOAPPart();
        String myNamespace = "myNamespace";
        String myNamespaceURI = "http://www.webserviceX.NET";
        
        SOAPEnvelope envelope = soapPart.getEnvelope();
        envelope.addNamespaceDeclaration(myNamespace, myNamespaceURI);
        
        // Create SOAP Body and Request Content
        SOAPBody soapBody = envelope.getBody();
        SOAPElement soapBodyElem = soapBody.addChildElement("GetInfoByCity", myNamespace);
        SOAPElement soapBodyElem1 = soapBodyElem.addChildElement("USCity", myNamespace);
        soapBodyElem1.addTextNode("New York");
    }

    private static void callSoapWebService(String soapEndpointUrl, String soapAction) {
        try {
            // Create SOAP Connection and Message
            SOAPConnectionFactory soapConnectionFactory = SOAPConnectionFactory.newInstance();
            SOAPConnection soapConnection = soapConnectionFactory.createConnection();
            SOAPMessage soapMessage = createSOAPRequest(soapAction);

            // Send SOAP Message and Receive Response
            SOAPMessage soapResponse = soapConnection.call(soapMessage, soapEndpointUrl);
            soapResponse.writeTo(System.out);

            soapConnection.close();
        } catch (Exception e) {
            System.err.println("Error sending SOAP Request!");
            e.printStackTrace();
        }
    }

    private static SOAPMessage createSOAPRequest(String soapAction) throws Exception {
        // Create SOAP Message and Add Headers
        MessageFactory messageFactory = MessageFactory.newInstance();
        SOAPMessage soapMessage = messageFactory.createMessage();
        createSoapEnvelope(soapMessage);

        MimeHeaders headers = soapMessage.getMimeHeaders();
        headers.addHeader("SOAPAction", soapAction);

        soapMessage.saveChanges();
        
        return soapMessage;
    }

}

运行示例

要执行此示例，您需要安装 Java在您的系统上。将代码片段保存为扩展名为 .java 的文件，使用 javac 编译它，然后使用 java 运行它。该代码将调用 Web 服务来检索有关城市“纽约”的信息，响应结果将打印在控制台上。

附加说明

• 此示例使用简单的 Web 服务进行演示；您可以修改它以调用其他 SOAP Web 服务。
• SAAJ 已从 Java 11 中删除，因此如果使用较新版本的 Java，您可能需要使用替代框架或库。

通过遵循此示例并了解使用 SAAJ 构造和处理 SOAP 消息的概念，您可以自信地为自己的应用程序构建 SOAP 客户端。

以上是如何使用 Java 中的 SAAJ 创建一个可用的 SOAP 客户端？的详细内容。更多信息请关注PHP中文网其他相关文章！