WSDL을 사용하여 지정된 표준 SOAP 메시지 형식

이 항목은 레거시 기술과 관련된 것입니다. 이제 XML Web services와 XML Web services 클라이언트는 다음을 사용하여 만들어야 합니다. Windows Communication Foundation.

웹 서비스를 정의하는 XML 문서에 대한 스키마를 정의하는 산업 표준 WSDL(웹 서비스 기술 언어)은 두 가지 주요 SOAP 형식 옵션을 제공합니다. 두 옵션은 모두 기본 WSDL 네임스페이스(https://schemas.xmlsoap.org/wsdl/)가 아니라 https://schemas.xmlsoap.org/wsdl/soap/ 네임스페이스의 XML 요소에서 지정됩니다. 이 보조 네임스페이스는 웹 서비스를 SOAP 프로토콜에 커밋합니다.

SOAP 형식 옵션

두 가지 형식 옵션은 다음과 같습니다.

  • Style: SOAP 메시지에서 Body 요소의 자식 요소 및 손자 요소(해당하는 경우)에 대한 옵션입니다. 이 옵션은 binding WSDL 요소(일반적) 또는 operation 요소의 style 특성으로 지정됩니다.

  • Use: 한 수준 아래에 표시되는 웹 서비스 메서드 매개 변수 또는 반환 값에 대한 옵션입니다. 이 옵션은 body 요소의 use 특성으로 지정됩니다.

SOAP 사양에 대한 자세한 내용은 W3C 웹 사이트(http://www.w3.org/TR/SOAP)를 참조하십시오. WSDL 사양에 대한 자세한 내용은 W3C 웹 사이트(http://www.w3.org/TR/wsdl)에서도 참조할 수 있습니다.

허용되는 Style 특성 값

WSDL에서는 전체 SOAP 본문 형식을 제어하는 style 특성에 대해 다음 두 가지 값을 사용할 수 있습니다.

  • RPC: 매개 변수 또는 반환 값은 해당 부모가 SOAP Body 요소인 부모 요소에 자동으로 배치되며, 네임스페이스 한정자 없이 표시됩니다. 이 스키마는 SOAP 1.1 사양의 7절에 설명되어 있습니다. style="rpc"로 지정됩니다.

    SOAP 요청의 경우 SOAP Body 아래에 있는 요소의 이름은 웹 서비스 메서드에 해당하는 WSDL operation 요소에 따라 지정됩니다. 해당 요소 내의 각 요소는 매개 변수를 나타내며 해당 매개 변수에 따라 이름이 지정됩니다.

    SOAP 응답의 경우 SOAP Body 아래에 있는 요소의 이름은 작업 이름에 Response를 추가하여 지정됩니다. 반환 값을 나타내는 하위 요소의 이름은 작업 이름에 Return 접두사를 붙여 지정합니다.

  • Document: SOAP Body 요소의 콘텐츠는 WSDL에서 XML 스키마 정의에 정의된 XML 요소로 지정됩니다. XML 스키마는 WSDL 문서에 지정되거나 WSDL 문서로 가져옵니다. WSDL은 매개 변수와 반환 값을 감지하지 못하고 XML 문서만 처리합니다. 매개 변수와 반환 값이 XML 스키마 요소 및 형식으로 변환되는 방법은 개발자나 웹 서비스 인프라에서 처리합니다. style="document"로 지정됩니다.

    최상위 XML 요소는 message 요소에 정의된 part 요소인 메시지 부분으로 정의되며 XSD 요소 선언을 가리킵니다. 일반적으로 WSDL에서 다중 요소를 금지하지 않더라도 이 메시지 부분은 하나만 존재하므로 SOAP Body 콘텐츠가 실제 XML 문서가 됩니다.

WSDL에서는 매개 변수 및 반환 값 형식을 제어하는 use 특성에 대해 다음 두 가지 값을 사용할 수 있습니다.

  • Encoded: SOAP 1.1 사양의 5절에 설명된 스키마에 따라 데이터 형식이 지정됩니다. SOAP 인코딩에서는 XML 문서와 XML 문서가 나타내는 데이터 간의 바인딩에 XML 스키마의 하위 집합을 사용합니다. 또한 한 문서에서 여러 번 나타나는 요소에 대한 참조를 사용합니다. use="encoded"로 지정됩니다.

  • Literal: WSDL 문서에 지정되거나 WSDL 문서로 가져온 XML 스키마 정의에 따라 데이터 형식이 문자 그대로 지정됩니다. use="literal"로 지정됩니다.

참고 항목

기타 리소스

SOAP 메시지 서식 사용자 지정