如何从Java类调用SOAP Web服务？

Question

我对webservice世界相对来说是个新手，我的研究似乎让我困惑而不是启发，我的问题是我得到了一个库(jar)，我必须用一些webservice功能来扩展它。

这个库将共享给其他开发人员，在jar中的类中，将有一个调用webservice的方法的类（该方法实质上设置类的属性，执行一些业务逻辑，如将对象存储在db中等，并将对象与这些修改一起发回）。我希望对这个服务的调用尽可能简单，希望尽可能简单，这样使用类的开发人员只需要做。

Car c = new Car("Blue");
c.webmethod();

我一直在研究如何在服务器上使用JAX-WS，但在我看来，我不需要在服务器上创建WSimPort，也不需要在客户端上创建WSimPort，因为我知道这两者都有类，我只需要在服务器和客户端中共享的类之间进行一些交互。您认为如何在类中执行webservice和调用是有意义的？

Answer 1

我理解您的问题归结为如何从Java调用SOAP（JAX-WS）web服务并获取其返回对象。在这种情况下,您有两种可能的方法：

1. 通过wsimport生成Java类并使用它们；或
2. 创建SOAP客户端，该客户端：
   1. 将服务参数序列化为XML；
   2. 通过HTTP操作调用web方法；和
   3. 将返回的XML响应解析回对象。

   
   关于第一种方法（使用WSimPort):

   不过，恐怕在这种情况下，你只能要么：

   • 调整（编辑）wsimport生成的代码，使其使用您的业务类（这很困难，而且不值得这样做--请记住，每次WSDL更改时，您都必须重新生成和重新调整代码）；或
   • 放弃并使用WSimPort生成的类。（在此解决方案中，业务代码可以从另一个体系结构层“使用”生成的类作为服务。）

   关于第二种方法（创建自定义SOAP客户端）：

   null
   • 使用OXM（Object to XML Mapping）框架（如JAXB）将XML序列化/反序列化对象/对象到对象
   • 或者，如果必须，手动创建/解析XML（如果接收的对象与发送的对象只有一点点不同，这可能是最好的解决方案）。

   使用经典的java.net.HTTPURLConnection创建SOAP客户机并不是那么难（但也不是那么简单），您可以在此链接中找到一个非常好的起始代码。

   我建议您使用SAAJ框架：

   SOAP with Attachments API for Java(SAAJ)主要用于直接处理SOAP请求/响应消息，这种消息发生在任何Web服务API的幕后。它允许开发人员直接发送和接收soap消息，而不是使用JAX-WS。

   请参阅下面的工作示例（运行它！）使用SAAJ调用SOAP web服务。它调用此web服务。

   import javax.xml.soap.*;
   
   public class SOAPClientSAAJ {
   
       // SAAJ - SOAP Client Testing
       public static void main(String args[]) {
           /*
               The example below requests from the Web Service at:
                https://www.w3schools.com/xml/tempconvert.asmx?op=CelsiusToFahrenheit
   
   
               To call other WS, change the parameters below, which are:
                - the SOAP Endpoint URL (that is, where the service is responding from)
                - the SOAP Action
   
               Also change the contents of the method createSoapEnvelope() in this class. It constructs
                the inner part of the SOAP envelope that is actually sent.
            */
           String soapEndpointUrl = "https://www.w3schools.com/xml/tempconvert.asmx";
           String soapAction = "https://www.w3schools.com/xml/CelsiusToFahrenheit";
   
           callSoapWebService(soapEndpointUrl, soapAction);
       }
   
       private static void createSoapEnvelope(SOAPMessage soapMessage) throws SOAPException {
           SOAPPart soapPart = soapMessage.getSOAPPart();
   
           String myNamespace = "myNamespace";
           String myNamespaceURI = "https://www.w3schools.com/xml/";
   
           // SOAP Envelope
           SOAPEnvelope envelope = soapPart.getEnvelope();
           envelope.addNamespaceDeclaration(myNamespace, myNamespaceURI);
   
               /*
               Constructed SOAP Request Message:
               <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:myNamespace="https://www.w3schools.com/xml/">
                   <SOAP-ENV:Header/>
                   <SOAP-ENV:Body>
                       <myNamespace:CelsiusToFahrenheit>
                           <myNamespace:Celsius>100</myNamespace:Celsius>
                       </myNamespace:CelsiusToFahrenheit>
                   </SOAP-ENV:Body>
               </SOAP-ENV:Envelope>
               */
   
           // SOAP Body
           SOAPBody soapBody = envelope.getBody();
           SOAPElement soapBodyElem = soapBody.addChildElement("CelsiusToFahrenheit", myNamespace);
           SOAPElement soapBodyElem1 = soapBodyElem.addChildElement("Celsius", myNamespace);
           soapBodyElem1.addTextNode("100");
       }
   
       private static void callSoapWebService(String soapEndpointUrl, String soapAction) {
           try {
               // Create SOAP Connection
               SOAPConnectionFactory soapConnectionFactory = SOAPConnectionFactory.newInstance();
               SOAPConnection soapConnection = soapConnectionFactory.createConnection();
   
               // Send SOAP Message to SOAP Server
               SOAPMessage soapResponse = soapConnection.call(createSOAPRequest(soapAction), soapEndpointUrl);
   
               // Print the SOAP Response
               System.out.println("Response SOAP Message:");
               soapResponse.writeTo(System.out);
               System.out.println();
   
               soapConnection.close();
           } catch (Exception e) {
               System.err.println("\nError occurred while sending SOAP Request to Server!\nMake sure you have the correct endpoint URL and SOAPAction!\n");
               e.printStackTrace();
           }
       }
   
       private static SOAPMessage createSOAPRequest(String soapAction) throws Exception {
           MessageFactory messageFactory = MessageFactory.newInstance();
           SOAPMessage soapMessage = messageFactory.createMessage();
   
           createSoapEnvelope(soapMessage);
   
           MimeHeaders headers = soapMessage.getMimeHeaders();
           headers.addHeader("SOAPAction", soapAction);
   
           soapMessage.saveChanges();
   
           /* Print the request message, just for debugging purposes */
           System.out.println("Request SOAP Message:");
           soapMessage.writeTo(System.out);
           System.out.println("\n");
   
           return soapMessage;
       }
   
   }