다음을 통해 공유

디스패처 확장

  • 아티클

서비스 모델 계층은 기본 채널에서 들어오는 메시지를 가져와서 응용 프로그램 코드에서 이를 메서드 호출로 변환하여 결과를 다시 호출자에게 보내는 역할을 합니다. 서비스 모델 확장은 클라이언트 또는 디스패처 기능, 사용자 지정 동작, 메시지 및 매개 변수 가로채기 그리고 다른 확장 기능이 포함된 통신 동작 및 기능 또는 실행을 수정하거나 구현합니다.

이 항목에서는 WCF(Windows Communication Foundation) 서비스 응용 프로그램에서 ClientRuntime 및 ClientOperation 클래스를 사용하여 디스패처의 기본 실행 동작을 수정하는 방법과 메시지, 매개 변수 또는 반환 값을 채널 계층에서 보내거나 검색하기 이전 또는 이후에 이를 가로채거나 수정하는 방법에 대해 설명합니다. 이에 해당하는 클라이언트 런타임 메시지 처리에 대한 자세한 내용은 클라이언트 확장을 참조하십시오. 여러 런타임 사용자 지정 개체 간의 공유 상태에 액세스할 때 IExtensibleObject 형식이 수행하는 역할을 이해하려면 확장 가능한 개체를 참조하십시오.

디스패처

일반적으로 채널 계층으로 불리는 서비스 모델 계층을 통해 개발자의 프로그래밍 모델과 기본 메시지 교환 간의 변환이 수행됩니다. WCF에서 채널 및 끝점 디스패처(각각 ChannelDispatcher 및 EndpointDispatcher)는 새로운 채널을 허용하고 메시지, 작업 디스패치 및 호출을 수신하며 응답 처리를 담당하는 서비스 구성 요소입니다. 디스패처 개체는 수신자 개체이지만, 이중 서비스에서의 콜백 계약 구현에서도 검사, 수정 또는 확장을 위해 디스패처 개체를 노출합니다.

채널 디스패처(및 도우미 IChannelListener)는 기본 채널에서 메시지를 가져와 각 끝점 디스패처에 메시지를 전달합니다. 각 끝점 디스패처에는 작업을 구현하는 메서드를 호출하는 DispatchOperation에 메시지를 라우팅하는 DispatchRuntime이 있습니다. 방식에 따라 다양한 선택적 확장 클래스와 필수 확장 클래스가 호출 및 관련됩니다. 이 항목에서는 이러한 항목들이 연결되는 방법 및 속성을 수정하고 자체 코드를 연결하여 기본 기능을 확장하는 방법에 대해 설명합니다.

디스패처 속성 및 수정된 사용자 지정 개체는 서비스, 끝점, 계약 또는 작업 동작 개체를 사용하여 삽입합니다. 이 항목에서는 동작 사용 방법에 대해서는 설명하지 않습니다. 디스패처 수정을 삽입하는 데 사용하는 형식에 대한 자세한 내용은 방법: 엔터프라이즈에서 끝점 잠그기을 참조하십시오.

다음 그래픽에서는 서비스의 아키텍처 항목에 대해 간략하게 보여 줍니다.

디스패치 런타임 아키텍처

채널 디스패처

ChannelDispatcher 개체는 특정 URI(수신 대기 URI)에서 IChannelListener를 서비스의 인스턴스와 연결하기 위해 만들어집니다. 따라서 각 ServiceHost 개체에는 여러 개의 ChannelDispatcher 개체가 포함될 수 있으며, 각 개체는 단 하나의 수신기와 수신 대기 URI에 연결됩니다. 메시지가 도착하면 ChannelDispatcher는 연관된 각 EndpointDispatcher 개체에 쿼리하여 끝점에서 메시지를 수락할 수 있는지 여부를 확인한 다음 수락할 수 있는 끝점에 메시지를 전달합니다.

채널 세션의 수명과 동작을 제어하는 모든 속성을 사용하여 ChannelDispatcher 개체를 검사하거나 수정할 수 있습니다. 여기에는 사용자 지정 채널 이니셜라이저, 채널 수신기, 호스트, 관련 InstanceContext 등이 포함됩니다.

끝점 디스패처

메시지의 대상 주소가 AddressFilter와 일치하고 메시지 동작이 ContractFilter 속성과 일치하면 EndpointDispatcher 개체는 ChannelDispatcher의 메시지를 처리합니다. 두 EndpointDispatcher 개체가 메시지를 수락할 수 있는 경우 FilterPriority 속성 값에 따라 우선 순위가 높은 끝점이 결정됩니다.

디스패처의 처리를 사용자 지정하는 데 사용할 수 있는 두 개의 기본 서비스 모델 확장 지점(DispatchRuntime 및 DispatchOperation 클래스)을 가져오려면 EndpointDispatcher를 사용합니다. DispatchRuntime 클래스를 사용하면, 계약 범위(즉, 계약의 모든 메시지)에서 디스패처를 가로채고 확장할 수 있습니다. 그리고 DispatchOperation 클래스를 사용하면, 작업 범위(즉, 작업의 모든 메시지)에서 디스패처를 가로채고 확장할 수 있습니다.

시나리오

디스패처를 확장하는 데에는 다음과 같은 여러 가지 이유가 있습니다.

  • 사용자 지정 메시지 유효성 확인. 메시지가 특정 스키마에 유효하도록 지정할 수 있습니다. 이 작업은 메시지 인터셉터 인터페이스를 구현하여 수행할 수 있습니다. 예제를 보려면 Message Inspectors를 참조하십시오.

  • 사용자 지정 메시지 로깅. 끝점을 통해 이동하는 응용 프로그램 메시지의 일부를 검사하고 기록할 수 있습니다. 이 작업도 메시지 인터셉터 인터페이스를 통해 수행할 수 있습니다.

  • 사용자 지정 메시지 변환. 런타임에 메시지에 특정 변환을 적용할 수 있습니다(예: 버전 관리). 이 작업도 메시지 인터셉터 인터페이스를 통해 수행할 수 있습니다.

  • 사용자 지정 데이터 모델. WCF에서 기본적으로 지원되는 데이터 serialization 모델(즉, System.Runtime.Serialization.DataContractSerializer, System.Xml.Serialization.XmlSerializer 및 원시 메시지) 이외의 데이터 serialization 모델을 사용할 수 있습니다. 이 작업은 메시지 포맷터 인터페이스를 구현하여 수행할 수 있습니다. 예제를 보려면 Operation Formatter And Operation Selector를 참조하십시오.

  • 사용자 지정 매개 변수 유효성 검사. XML 형식이 아닌 다른 형식의 매개 변수가 유효하도록 지정할 수 있습니다. 이 작업은 매개 변수 검사자 인터페이스를 사용하여 수행할 수 있습니다. 예제를 보려면 Parameter Filter를 참조하십시오.

  • 사용자 지정 작업 디스패치. 동작 이외의 다른 요소, 예를 들면 본문 요소나 사용자 지정 메시지 속성에 대한 디스패치를 구현할 수 있습니다. 이 작업은 IDispatchOperationSelector 인터페이스를 사용하여 수행할 수 있습니다. 예제를 보려면 Operation Formatter And Operation Selector를 참조하십시오.

  • 개체 풀링. 모든 호출에 새 인스턴스를 할당하는 대신 인스턴스를 풀링할 수 있습니다. 이 작업은 인스턴스 공급자 인터페이스를 사용하여 구현할 수 있습니다. 예제를 보려면 Pooling을 참조하십시오.

  • 인스턴스 대여. .NET Framework Remoting의 대여 패턴과 유사한, 인스턴스 수명에 대한 대여 패턴을 구현할 수 있습니다. 이 작업은 인스턴스 컨텍스트 수명 인터페이스를 사용하여 수행할 수 있습니다.

  • 사용자 지정 오류 처리. 로컬 오류를 처리하는 방법 및 오류에 대해 클라이언트에 다시 통신하는 방법을 제어할 수 있습니다. 이 작업은 IErrorHandler 인터페이스를 사용하여 구현할 수 있습니다.

  • 사용자 지정 권한 부여 동작. 계약 또는 작업 런타임 부분을 확장하고 메시지에 있는 토큰에 따라 보안 검사를 추가하여 사용자 지정 액세스 제어를 구현할 수 있습니다. 이 작업은 메시지 인터셉터 또는 매개 변수 인터셉터 인터페이스를 사용하여 수행할 수 있습니다. 예제를 보려면 Security Extensibility Samples을 참조하십시오.

    경고

    보안 속성을 변경하면 WCF 응용 프로그램의 보안을 잠재적으로 해칠 수 있으므로, 보안과 관련된 수정 작업은 주의해서 수행하고 배포 전에 철저하게 테스트하는 것이 좋습니다.

  • 사용자 지정 WCF 런타임 유효성 검사기. 서비스, 계약 및 바인딩을 검사하는 사용자 지정 유효성 검사기를 설치하여 WCF 응용 프로그램에 대해 엔터프라이즈 수준의 정책을 적용할 수 있습니다. 예제를 보려면 방법: 엔터프라이즈에서 끝점 잠그기를 참조하십시오.

DispatchRuntime 클래스 사용

서비스나 개별 끝점의 기본 동작을 수정하거나 다음 서비스 프로세스(또는 이중 클라이언트의 경우 클라이언트 프로세스) 중 하나 또는 모두에 대해 사용자 지정 수정 작업을 구현하는 개체를 삽입하려면 DispatchRuntime 클래스를 사용합니다.

  • 들어오는 메시지를 개체로 변환하고 이러한 개체를 서비스 개체에 대한 메서드 호출로 해제
  • 서비스 작업 호출에 대한 응답에서 수신한 개체를 아웃바운드 메시지로 변환

DispatchRuntime을 사용하면 메시지가 인식되지 않는 경우에도 특정 계약을 통해 모든 메시지에 대한 채널 또는 끝점 디스패처를 가로채서 확장할 수 있습니다. 계약에 선언된 메시지와 일치하지 않는 메시지가 도착하면 이 메시지는 UnhandledDispatchOperation 속성에 의해 반환된 작업에 디스패치됩니다. 특정 작업에 대한 모든 메시지를 가로채거나 확장하려면 DispatchOperation 클래스를 참조하십시오.

DispatchRuntime 클래스에 의해 노출되는 디스패처 확장성의 네 가지 기본 영역은 다음과 같습니다.

  1. 채널 구성 요소에서는 DispatchRuntime 속성 및 ChannelDispatcher 속성에서 반환하는 연관된 채널 디스패처의 속성을 사용하여 채널 디스패처가 채널을 허용하고 닫는 방법을 사용자 지정합니다. 이 범주에는 ChannelInitializers 및 InputSessionShutdownHandlers 속성이 포함됩니다.
  2. 메시지 구성 요소는 처리되는 각 메시지에 대해 사용자 지정됩니다. 이 범주에는 MessageInspectors, OperationSelector, Operations 및 ErrorHandlers 속성이 포함됩니다.
  3. 인스턴스 구성 요소는 서비스 형식 인스턴스의 생성, 수명 및 삭제를 사용자 지정합니다. 서비스 개체 수명에 대한 자세한 내용은 InstanceContextMode 속성을 참조하십시오. 이 범주에는 InstanceContextInitializers 및 InstanceProvider 속성이 포함됩니다.
  4. 보안 관련 구성 요소에서는 다음과 같은 속성을 사용할 수 있습니다.

일반적으로 사용자 지정 확장 개체는 DispatchRuntime 속성에 할당되거나 서비스 동작(IServiceBehavior를 구현하는 개체), 계약 동작(IContractBehavior를 구현하는 개체) 또는 끝점 동작(IEndpointBehavior를 구현하는 개체)에 의해 컬렉션에 삽입됩니다. 그런 다음 프로그래밍 방식을 사용하거나 사용자 지정 BehaviorExtensionElement 개체를 구현하여 설치 동작 개체를 해당 동작 컬렉션에 추가하므로, 응용 프로그램 구성 파일을 사용하여 동작을 삽입할 수 있습니다.

이중 클라이언트(이중 서비스에서 지정한 콜백 계약을 구현하는 클라이언트)도 CallbackDispatchRuntime 속성을 사용하여 액세스할 수 있는 DispatchRuntime 개체를 가질 수 있습니다.

DispatchOperation 클래스 사용

DispatchOperation 클래스는 하나의 서비스 작업으로만 범위가 제한된 사용자 지정 확장에 대한 삽입 지점 및 런타임 수정 내용에 대한 위치입니다. 계약의 모든 메시지에 대한 서비스 런타임 동작을 수정하려면 DispatchRuntime 클래스를 사용합니다.

사용자 지정 서비스 동작 개체를 사용하여 DispatchOperation 수정 내용을 설치합니다.

특정 서비스 작업을 나타내는 DispatchOperation 개체를 찾으려면 Operations 속성을 사용합니다.

다음 속성에서는 작업 수준에서 런타임 실행을 제어합니다.

참고 항목

작업

방법: 서비스에서 메시지 검사 및 수정
방법: 매개 변수 검사 또는 수정
방법: 엔터프라이즈에서 끝점 잠그기

참조

DispatchRuntime
DispatchOperation