POX 애플리케이션과의 상호 운용성

아티클
05/10/2023

POX("Plain Old XML") 애플리케이션은 SOAP 봉투 내에 포함되지 않은 XML 애플리케이션 데이터만 포함하는 원시 HTTP 메시지를 교환하여 통신합니다. WCF(Windows Communication Foundation)는 POX 메시지를 사용하는 서비스와 클라이언트를 모두 제공할 수 있습니다. 서비스의 경우 WCF를 사용하여 POX 메시지를 보내고 받는 스크립팅 언어 및 웹 브라우저와 같은 클라이언트에 엔드포인트를 노출하는 서비스를 구현할 수 있습니다. 클라이언트의 경우 WCF 프로그래밍 모델을 사용하여 POX 기반 서비스와 통신하는 클라이언트를 구현할 수 있습니다.

참고 항목

이 문서는 원래 .NET Framework 3.0용으로 작성되었습니다. .NET Framework 3.5는 POX 애플리케이션 작업에 대한 지원을 기본적으로 제공합니다. 자세한 내용은 WCF 웹 HTTP 프로그래밍 모델을 참조하세요.

WCF를 사용한 POX 프로그래밍

POX 메시지를 사용하여 HTTP를 통해 통신하는 WCF 서비스는 <customBinding>를 사용합니다.

<customBinding>
   <binding name="poxServerBinding">
       <textMessageEncoding messageVersion="None" />
       <httpTransport />
   </binding>
</customBinding>

이 사용자 지정 바인딩에는 다음과 같은 두 가지 요소가 포함되어 있습니다.

표준 WCF 텍스트 메시지 인코더는 특히 None 값을 사용하도록 구성되어, SOAP 봉투로 래핑되지 않은 XML 메시지 페이로드를 처리할 수 있습니다.

POX 메시지를 사용하여 HTTP를 통해 통신하는 WCF 클라이언트는 유사한 바인딩을 사용합니다(다음 명령 코드 참조).

private static Binding CreatePoxBinding()
{
    TextMessageEncodingBindingElement encoder =
        new TextMessageEncodingBindingElement( MessageVersion.None, Encoding.UTF8 );
    HttpTransportBindingElement transport = new HttpTransportBindingElement();
    transport.ManualAddressing = true;
    return new CustomBinding( new BindingElement[] { encoder, transport } );
}

POX 클라이언트는 메시지를 보내는 대상 URI를 명시적으로 지정해야 하기 때문에 일반적으로 POX 클라이언트는 요소에서 HttpTransportBindingElement 속성을 ManualAddressing로 설정하여 true를 수동 주소 지정 모드로 구성해야 합니다. 이를 통해 메시지 주소를 애플리케이션 코드에 따라 명시적으로 지정할 수 있으며 애플리케이션이 메시지를 다른 HTTP URI로 보낼 때마다 새 ChannelFactory를 만들 필요가 없습니다.

POX 메시지는 중요한 프로토콜 정보를 전달하기 위해 SOAP 헤더를 사용하지 않기 때문에 POX 클라이언트 및 서비스가 메시지를 보내거나 받는 데 사용되는 기본 HTTP 요청 일부를 종종 조작해야 합니다. HTTP 헤더 및 상태 코드와 같이 HTTP 관련 프로토콜 정보는 다음 두 가지 클래스를 통해 WCF 프로그래밍 모델에 표시됩니다.

HttpRequestMessageProperty, 여기에는 HTTP 메서드 및 요청 헤더와 같은 HTTP 요청에 대한 정보가 포함됩니다.
HttpResponseMessageProperty, 여기에는 HTTP 응답 헤더뿐만 아니라 HTTP 상태 코드 및 상태 설명과 같은 HTTP 응답에 대한 정보가 포함됩니다.

다음 코드 예제는 http://localhost:8100/customers로 주소가 지정된 HTTP GET 요청 메시지를 생성하는 방법을 보여 줍니다.

Message request = Message.CreateMessage( MessageVersion.None, String.Empty );
request.Headers.To = "http://localhost:8100/customers";

HttpRequestMessageProperty property = new HttpRequestMessageProperty();
property.Method = "GET";
property.SuppressEntityBody = true;
request.Properties.Add( HttpRequestMessageProperty.Name, property );

먼저 Message를 호출하여 빈 요청 CreateMessage(MessageVersion, String)가 만들어집니다. None 매개 변수는 SOAP 봉투가 필요 없음을 나타내는 데 사용되며 Empty 매개 변수는 작업으로 전달됩니다. 그런 다음 To 헤더를 원하는 URI로 설정하여 요청 메시지의 주소가 지정됩니다. 그런 후 HttpRequestMessageProperty가 만들어지고 Method가 HTTP verb GET 메서드로 설정되며, SuppressEntityBody가 true로 설정되어 나가는 HTTP 요청 메시지의 본문에 보낼 데이터가 없어야 함을 나타냅니다. 마지막으로, HTTP 전송이 요청을 보내는 방법에 영향을 줄 수 있도록 요청 속성이 요청 메시지의 Properties 컬렉션에 추가됩니다. 그런 다음 메시지를 IRequestChannel의 해당 인스턴스를 통해 보낼 준비를 완료합니다.

서비스에 대해 유사한 방법을 사용하여 들어오는 메시지에서 HttpRequestMessageProperty를 추출하고 응답을 생성할 수 있습니다.

POX 애플리케이션과의 상호 운용성

WCF를 사용한 POX 프로그래밍

추가 리소스