단일 ListenUri의 여러 엔드포인트

아티클
04/08/2023

MultipleEndpointsSingleUri 샘플에서는 단일 ListenUri에서 여러 엔드포인트를 호스팅하는 서비스를 보여 줍니다. 이 샘플은 계산기 서비스를 구현하는 시작을 기반으로 합니다.

참고 항목

이 샘플의 설치 절차 및 빌드 지침은 이 항목의 끝부분에 나와 있습니다.

여러 엔드포인트 샘플에 나온 것처럼 서비스는 각각 다른 주소뿐만 아니라 다른 바인딩을 가질 수도 있는 여러 엔드포인트를 호스팅할 수 있습니다. 이 샘플에서는 동일한 주소에서 여러 엔드포인트를 호스팅할 수 있다는 것을 보여 줍니다. 또한 이 샘플에서는 서비스 엔드포인트가 가지는 두 종류의 주소인 EndpointAddress 및 ListenUri 간의 차이점을 보여 줍니다.

EndpointAddress는 서비스의 논리 주소입니다. SOAP 메시지의 주소가 이 주소로 지정됩니다. ListenUri는 서비스의 실제 주소입니다. 서비스 엔드포인트가 현재 컴퓨터에서 메시지를 실제로 수신 대기하는 포트 및 주소 정보가 이 주소에 포함됩니다. 대부분의 경우 이러한 주소는 다를 필요가 없습니다. ListenUri가 명시적으로 지정되지 않은 경우 엔드포인트의 EndpointAddress의 URI가 기본값으로 사용됩니다. 라우터를 구성하는 경우와 같은 일부 상황에서는 여러 다른 서비스로 주소가 지정된 메시지를 수락할 수 있도록 이러한 주소를 구별하는 것이 유용합니다.

서비스

이 샘플의 서비스에는 두 개의 계약인 ICalculator 및 IEcho가 있습니다. 다음 코드에 표시된 것처럼 일반적인 IMetadataExchange 엔드포인트 외에도 세 개의 애플리케이션 엔드포인트가 있습니다.

<endpoint address="urn:Stuff"
        binding="wsHttpBinding"
        contract="Microsoft.ServiceModel.Samples.ICalculator"
        listenUri="http://localhost/servicemodelsamples/service.svc" />
<endpoint address="urn:Stuff"
        binding="wsHttpBinding"
        contract="Microsoft.ServiceModel.Samples.IEcho"
        listenUri="http://localhost/servicemodelsamples/service.svc" />
<endpoint address="urn:OtherEcho"
        binding="wsHttpBinding"
        contract="Microsoft.ServiceModel.Samples.IEcho"
        listenUri="http://localhost/servicemodelsamples/service.svc" />

세 개의 엔드포인트는 모두 동일한 ListenUri에서 호스팅되고 동일한 binding을 사용합니다. 동일한 ListenUri에 있는 엔드포인트는 컴퓨터의 해당 실제 주소에서 메시지를 수신 대기하는 단일 채널 스택을 공유하므로 동일한 바인딩을 가져야 합니다. 각 엔드포인트의 address는 URN입니다. 일반적으로 주소가 실제 위치를 나타내지만 이 샘플에 나온 것처럼 실제로 이 주소는 일치 및 필터링 목적에 사용되므로 모든 종류의 URI가 될 수 있습니다.

세 개의 엔드포인트가 모두 동일한 ListenUri를 공유하므로 메시지가 여기에 도착하면 WCF(Windows Communication Foundation)는 메시지의 대상이 되는 엔드포인트를 결정해야 합니다. 각 엔드포인트에는 주소 필터와 계약 필터의 두 부분으로 구성된 메시지 필터가 있습니다. 주소 필터는 SOAP 메시지의 To를 서비스 엔드포인트의 주소에 일치시킵니다. 예를 들어, To "Urn:OtherEcho"에 주소 지정된 메시지만 이 서비스의 세 번째 엔드포인트의 후보가 됩니다. 계약 필터는 특정 계약의 작업과 연관된 작업을 일치시킵니다. 예를 들면 IEcho의 작업을 가진 메시지입니다. 이 서비스의 두 번째 및 세 번째 엔드포인트가 Echo 계약을 호스팅하기 때문에 IEcho는 이러한 두 엔드포인트 모두의 계약 필터를 일치시킵니다.

따라서 주소 필터와 계약 필터를 조합하면 이 서비스의 ListenUri에 도착하는 각 메시지를 올바른 엔드포인트에 라우트할 수 있습니다. 세 번째 엔드포인트는 다른 엔드포인트에서 다른 주소로 보내진 메시지를 수락하기 때문에 다른 두 개와 구별됩니다. 첫 번째 및 두 번째 엔드포인트는 해당 계약(들어오는 메시지의 작업)에 기초하여 서로 구별됩니다.

클라이언트

서버의 엔드포인트가 두 개의 다른 주소를 가진 것처럼 클라이언트 엔드포인트도 두 개의 주소를 가집니다. 서버 및 클라이언트 모두에서 논리 주소를 EndpointAddress라고 합니다. 그러나 서버에서 물리 주소를 ListenUri라고 하는 것과 달리 클라이언트에서는 물리 주소를 Via라고 합니다.

서버에서와 같이 기본적으로 이러한 두 주소는 동일합니다. 엔드포인트 주소와 다른 클라이언트의 Via를 지정하려면 ClientViaBehavior를 사용합니다.

Uri via = new Uri("http://localhost/ServiceModelSamples/service.svc");
CalculatorClient calcClient = new CalculatorClient();
calcClient.ChannelFactory.Endpoint.Behaviors.Add(
        new ClientViaBehavior(via));

일반적인 경우와 같이 주소는 Svcutil.exe에 의해 생성된 클라이언트 구성 파일에서 제공됩니다. 서비스의 Via에 해당하는 ListenUri는 서비스의 메타데이터에 나타나지 않으므로 이 정보는 서비스의 메타데이터 주소와 같이 out-of-band로 클라이언트에 전달되어야 합니다.

이 샘플에서 클라이언트는 서버의 세 개 엔드포인트가 모두 동일한 Via를 가진 경우에도 이러한 엔드포인트와 통신하고 구별할 수 있다는 것을 보여 주기 위해 각 엔드포인트에 메시지를 보냅니다.

샘플을 설치, 빌드 및 실행하려면

Windows Communication Foundation 샘플의 일회 설치 절차를 수행했는지 확인합니다.
C# 또는 Visual Basic .NET 버전의 솔루션을 빌드하려면 Building the Windows Communication Foundation Samples의 지침을 따릅니다.
단일 컴퓨터 또는 다중 컴퓨터 구성에서 샘플을 실행하려면 Windows Communication Foundation 샘플 실행의 지침을 따릅니다.

참고 항목

다중 컴퓨터 구성의 경우 Client.cs 파일의 localhost를 서비스 컴퓨터의 이름으로 대체해야 합니다.

다음을 통해 공유

단일 ListenUri의 여러 엔드포인트

서비스

클라이언트

샘플을 설치, 빌드 및 실행하려면

추가 리소스