如何做到从Java类中的SOAP Web服务调用?(How to do a SOAP Web Ser

2019-08-21 15:22发布

我是相对较新的Web服务的世界,我的研究似乎已经让我感到困惑多开导我,我的问题是,我得到了一个库(JAR),我有一些Web服务功能扩展。

该库将共享给其他开发,并在罐中的类之间的将是具有调用web服务(其基本上设置类的属性,做了一些业务逻辑,像存储在DB中的对象的方法的类,等,并发送回与这些修改对象)。 我想,这样使用类唯一需要做的开发,使调用该服务尽可能地简单,希望简单。

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

我一直在研究JAX-WS服务器上使用,但在我看来,我并不需要创建一个wsimport服务器也不是wsimport在客户端上,因为我知道,无论有课,我只是需要一些互动在服务器和客户端两者共享类之间。 您如何看待情理之中的事了互联网服务和班里的电话吗?

Answer 1:

我明白你的问题归结为如何从Java调用一个SOAP(JAX-WS)Web服务并获取其返回的对象 。 在这种情况下,你有两种可能的方法:

  1. 通过生成Java类wsimport并使用它们; 要么
  2. 创建SOAP客户端:
    1. 序列化服务的参数,以XML;
    2. 调用通过HTTP操纵web方法; 和
    3. 解析XML返回响应回到对象。


关于第一种方法(使用wsimport ):

我看你已经有服务(实体或其他)的业务类,它是在一个事实wsimport产生了一整套新的类(在某种程度上你已经有了类的副本)。

我很害怕,但是,在这种情况下,你只能之一:

  • 适应(编辑) wsimport生成的代码,以使它使用您的业务类(这是困难的,有点不值得的-记住每次的WSDL的变化,你就必须再生和重新适应的代码); 要么
  • 放弃和使用wsimport生成的类。 (在此解决方案,业务代码可以“用”生成的类从另一个架构层的服务。)

关于第二个方法(创建自定义的SOAP客户端):

为了实现第二种方法,你必须:

  1. 拨打电话:
    • 使用SAAJ(SOAP与Java的附件API)框架(见下文,它与Java SE 1.6或以上的运)打的电话; 要么
    • 你也可以做到这一点通过java.net.HttpUrlconnection (和一些java.io处理)。
  2. 转动物体进入和背部的XML:
    • 从/使用OXM(对象到XML映射)框架如JAXB序列化/反序列化XML成对象
    • 或者,如果您必须手动创建/解析XML(这可能是最好的解决办法,如果接收到的对象仅是从发送一个有点differente)。

创建使用经典的SOAP客户端java.net.HttpUrlConnection并不难(但不是简单其一),你可以在找到这个环节非常好的起点代码。

我建议你用SAAJ框架:

用于Java(SAAJ)附件的SOAP API主要用于直接与发生在幕后的任何Web服务API SOAP请求/响应消息处理。 它允许开发者直接发送和接收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;
    }

}

关于使用JAXB用于串行/解串,这是很容易找到相关信息。 你可以从这里开始: http://www.mkyong.com/java/jaxb-hello-world-example/ 。



Answer 2:

或者只是使用的Apache CXF的WSDL2Java的生成,您可以使用对象。

它包含在二进制包,你可以从他们的网站下载。 你可以简单地运行如下命令:

$ ./wsdl2java -p com.mynamespace.for.the.api.objects -autoNameResolution http://www.someurl.com/DefaultWebService?wsdl

它使用WSDL生成对象,你可以使用这样的(对象名称也从WSDL抓起,让你的将是不同的一点):

DefaultWebService defaultWebService = new DefaultWebService();
String res = defaultWebService.getDefaultWebServiceHttpSoap11Endpoint().login("webservice","dadsadasdasd");
System.out.println(res);

甚至有一个Maven插件,其生成源: https://cxf.apache.org/docs/maven-cxf-codegen-plugin-wsdl-to-java.html

注:如果您使用生成和CXF IDEA的来源,你可能想看看这个: https://stackoverflow.com/a/46812593/840315



Answer 3:

我发现了一个更简单的替代的方式来生成SOAP消息。 给定一个Person对象:

import com.fasterxml.jackson.annotation.JsonInclude;

@JsonInclude(JsonInclude.Include.NON_NULL)
public class Person {
  private String name;
  private int age;
  private String address; //setter and getters below
}

下面是一个简单的SOAP消息生成器:

import com.fasterxml.jackson.databind.DeserializationFeature;
import com.fasterxml.jackson.databind.ObjectMapper;
import com.fasterxml.jackson.databind.SerializationFeature;
import com.fasterxml.jackson.datatype.jsr310.JavaTimeModule;
import lombok.extern.slf4j.Slf4j;
import org.apache.commons.lang3.StringUtils;
import com.fasterxml.jackson.dataformat.xml.XmlMapper;

@Slf4j
public class SoapGenerator {

  protected static final ObjectMapper XML_MAPPER = new XmlMapper()
      .enable(DeserializationFeature.READ_UNKNOWN_ENUM_VALUES_AS_NULL)
      .configure(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES, false)
      .configure(SerializationFeature.WRITE_DATES_AS_TIMESTAMPS, false)
      .registerModule(new JavaTimeModule());

  private static final String SOAP_BODY_OPEN = "<soap:Body>";
  private static final String SOAP_BODY_CLOSE = "</soap:Body>";
  private static final String SOAP_ENVELOPE_OPEN = "<soap:Envelope xmlns:soap=\"http://schemas.xmlsoap.org/soap/envelope/\">";
  private static final String SOAP_ENVELOPE_CLOSE = "</soap:Envelope>";

  public static String soapWrap(String xml) {
    return SOAP_ENVELOPE_OPEN + SOAP_BODY_OPEN + xml + SOAP_BODY_CLOSE + SOAP_ENVELOPE_CLOSE;
  }

  public static String soapUnwrap(String xml) {
    return StringUtils.substringBetween(xml, SOAP_BODY_OPEN, SOAP_BODY_CLOSE);
  }
}

您可以使用:

 public static void main(String[] args) throws Exception{
        Person p = new Person();
        p.setName("Test");
        p.setAge(12);

        String xml = SoapGenerator.soapWrap(XML_MAPPER.writeValueAsString(p));
        log.info("Generated String");
        log.info(xml);
      }


文章来源: How to do a SOAP Web Service call from Java class?