Java 클래스에서 SOAP 웹 서비스 호출을 수행하는 방법은 무엇입니까?


116

나는 웹 서비스 세계에 상대적으로 새롭고 내 연구는 나를 깨우는 것보다 더 혼란스러워하는 것 같습니다. 내 문제는 웹 서비스 기능으로 확장 해야하는 라이브러리 (jar)를 받았다는 것입니다.

이 라이브러리는 다른 개발자와 공유되며 jar의 클래스 중에는 웹 서비스를 호출하는 메서드가있는 클래스가 있습니다 (기본적으로 클래스의 속성을 설정하고, 객체를 db에 저장하는 것과 같은 일부 비즈니스 로직을 수행합니다. 등을 수정하여 개체를 다시 보냅니다). 이 서비스에 대한 호출을 가능한 한 간단하게 만들고 싶습니다. 클래스를 사용하는 개발자 만 수행하면됩니다.

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

나는 서버에서 사용하기 위해 JAX-WS를 연구했지만 wsimport서버 나 wsimport클라이언트에서 둘 다 클래스가 있다는 것을 알고 있기 때문에 클래스 간 상호 작용이 필요하다는 것을 알기 때문에 서버 나 클라이언트 에서 만들 필요가 없다고 생각합니다. 서버와 클라이언트 모두에서 공유됩니다. 클래스에서 웹 서비스와 호출을 수행하는 것이 어떻게 합리적이라고 생각하십니까?


귀하의 질문은 약간 명확하지 않습니다. 생성하려는 메소드는 (1) 웹 서비스에서 객체를 가져옵니다. (2) 물체를 조금 다루십시오. (3) 웹 서비스에 다시 게시합니다. 그게 다야?
acdcjunior 2013-04-11

아니요, 개체는 클라이언트에서 생성되고 호출에서 ws로 전송되고 ws는 변수 (예 : currentTime)를 설정하고이를 db에 저장하는 것과 같은 비즈니스 로직을 수행 한 다음 개체를 전송합니다. 이제 currentTime이 설정된 클라이언트로 돌아갑니다. 내 자신을 좀 더 잘 설명했으면 좋겠다. 감사합니다.
jpz 2013

답변:


273

귀하의 문제는 Java에서 SOAP (JAX-WS) 웹 서비스를 호출하고 반환하는 객체를 얻는 방법으로 귀결된다는 것을 이해합니다 . 이 경우 두 가지 가능한 접근 방식이 있습니다.

  1. 다음을 통해 Java 클래스 생성 wsimport이를 하고 사용하십시오. 또는
  2. 다음과 같은 SOAP 클라이언트를 만듭니다.
    1. 서비스의 매개 변수를 XML로 직렬화합니다.
    2. HTTP 조작을 통해 웹 메서드를 호출합니다. 과
    3. 반환되는 XML 응답을 다시 객체로 구문 분석합니다.


첫 번째 접근 방법 (사용 wsimport) :

귀하는 이미 서비스 (엔터티 또는 기타) 비즈니스 클래스를 보유하고 있습니다. wsimport 에서 완전히 새로운 클래스 집합 (이미 가지고있는 클래스의 중복)을 생성 .

하지만이 시나리오에서는 다음 중 하나만 수행 할 수 있습니다.

  • wsimport생성 된 코드를 수정 (편집) 하여 비즈니스 클래스를 (이것은 어렵고 가치가 없습니다. WSDL이 변경 될 때마다 코드를 재생성하고 다시 수정해야합니다.) 또는
  • wsimport생성 된 클래스를 포기하고 사용하십시오 . (이 솔루션에서 비즈니스 코드는 생성 된 클래스를 다른 아키텍처 계층의 서비스로 "사용"할 수 있습니다.

두 번째 접근 방식 (사용자 지정 SOAP 클라이언트 생성) :

두 번째 접근 방식을 구현하려면 다음을 수행해야합니다.

  1. 전화 걸기 :
    • SAAJ (SOAP with Attachments API for Java) 프레임 워크 (아래 참조, Java SE 1.6 이상과 함께 제공됨)를 사용하여 호출합니다. 또는
    • 당신은 또한 그것을 통해 할 수 있습니다 java.net.HttpUrlconnection(그리고 약간의 java.io처리).
  2. 객체를 XML로 또는 XML에서 되돌립니다.
    • JAXB와 같은 OXM (Object to XML Mapping) 프레임 워크를 사용하여 객체에서 XML을 직렬화 / 역 직렬화합니다.
    • 또는 필요한 경우 XML을 수동으로 생성 / 파싱합니다 (수신 된 객체가 전송 된 객체와 약간만 다를 경우 최상의 솔루션이 될 수 있음).

클래식을 사용하여 SOAP 클라이언트를 만드는 java.net.HttpUrlConnection것은 그리 어렵지 않습니다 (하지만 그렇게 간단하지는 않습니다). 이 링크 에서 아주 좋은 시작 코드를 찾을 수 있습니다 .

SAAJ 프레임 워크를 사용하는 것이 좋습니다.

SAAJ (SOAP with Attachments API for Java) 는 주로 웹 서비스 API의 뒤에서 발생하는 SOAP 요청 / 응답 메시지를 직접 처리하는 데 사용됩니다. 개발자가 JAX-WS를 사용하는 대신 SOAP 메시지를 직접 보내고받을 수 있습니다.

SAAJ를 사용하는 SOAP 웹 서비스 호출의 작동 예제 (실행!)는 아래를 참조하십시오. 이 웹 서비스를 호출 합니다 .

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/에서 시작할 수 있습니다 .


위에서 언급 한 방법을 사용하여 비누 버전을 어떻게 설정합니까?
Redone

나는 당신의 방법을 사용할 수 있었고 URI를 사용할 때 작동했지만 내 자신의 SOAP 요청에 대해 예상대로 값이 표시되지 않는 응답을 얻습니다 <xsd:element name="Incident_Number" type="xsd:string"/>. 보시다시피 요소가 닫히고 WS에서 정보가 생성되지 않습니다.
Martin Erlic 2016

GetInfoByCity것입니다 503Service Unavailable그것은 seeems. :(
Brad Turek

@BradTurek D * mn! 나는 단지 그것을 대체했다. 알려 줘서 고마워! 나는 다른 것을 찾아 조금 후에 그것을 바꿀 것입니다.
acdcjunior

1
통행인에게 : 위 코드 (예 : SOAP 웹 서비스 엔드 포인트)가 작동을 멈추거나 오류 (예 : 500, 503 등)를 제공하기 시작하면 문제를 해결할 수 있도록 알려주세요.
acdcjunior

3

또는 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 를 살펴볼 수 있습니다.


1
내 응용 프로그램에 30 개 이상의 wsdl이 있습니다. 단 1 개의 wsdl (5 soapActions 포함)에 대한 리소스를 준비하는 동안 Eclipse IDE가 중단되고 약 100MB 이상의 클래스 / 객체가 생성되었습니다.
Manmohan_singh

-1

비누 메시지를 생성하는 훨씬 더 간단한 대안을 찾았습니다. 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);
      }
당사 사이트를 사용함과 동시에 당사의 쿠키 정책개인정보 보호정책을 읽고 이해하였음을 인정하는 것으로 간주합니다.
Licensed under cc by-sa 3.0 with attribution required.