다음을 통해 공유

표준 끝점

  • 아티클

끝점은 주소, 바인딩 및 계약을 지정하여 정의됩니다. 이외에도 끝점에 설정할 수 있는 매개 변수에는 동작 구성, 헤더 및 수신 대기 URI가 있습니다. 일부 끝점 유형의 경우 이러한 값이 변경되지 않습니다. 예를 들어 메타데이터 교환 끝점은 항상 IMetadataExchange 계약을 사용합니다. WebHttpEndpoint와 같은 다른 끝점에는 항상 지정된 끝점 동작이 필요합니다. 일반적으로 사용되는 끝점 속성을 기본값으로 적용하면 끝점의 유용성이 향상될 수 있습니다. 개발자는 표준 끝점을 사용하여 기본값을 갖거나 하나 이상의 끝점 속성이 변경되지 않는 끝점을 정의할 수 있습니다. 이러한 끝점을 사용하면 정적 상태에 대한 정보를 지정하지 않고도 끝점을 사용할 수 있습니다. 표준 끝점은 인프라 및 응용 프로그램 끝점으로 사용될 수 있습니다.

인프라 끝점

서비스에서는 서비스 작성자가 명시적으로 구현하지 않은 일부 속성이 있는 끝점을 노출할 수 있습니다. 예를 들어 메타데이터 교환 끝점에서 IMetadataExchange 계약을 노출하지만 해당 인프라가 서비스 작성자가 아닌 WCF에 의해 구현됩니다. 이러한 인프라는 하나 이상의 끝점 속성에 대해 기본값을 가지며, 이러한 속성의 일부는 변경할 수 없습니다. 메타데이터 교환 끝점의 Contract 속성은 IMetadataExchange이어야 하는 반면 바인딩과 같은 다른 속성은 개발자가 제공할 수 있습니다. 인프라 끝점은 IsSystemEndpoint 속성을 true로 설정하여 식별됩니다.

응용 프로그램 끝점

응용 프로그램 개발자는 주소, 바인딩 또는 계약에 대해 기본값을 지정하는 고유한 표준 끝점을 정의할 수 있습니다. 표준 끝점은 ServiceEndpoint에서 클래스를 파생시킨 후 적절한 끝점 속성을 설정하여 정의합니다. 속성에 변경 가능한 기본값을 제공할 수 있지만 일부 다른 속성은 변경할 수 없는 정적 값을 갖습니다. 다음 예제에서는 표준 끝점을 구현하는 방법을 보여 줍니다.

public class CustomEndpoint : ServiceEndpoint
    {
        public CustomEndpoint()
            : this(string.Empty)
        {
        }

        public CustomEndpoint(string address)
            : this(address, ContractDescription.GetContract(typeof(ICalculator)))
        {
        }

        // Create the custom endpoint with a fixed binding
        public CustomEndpoint(string address, ContractDescription contract)
            : base(contract)
        {
            this.Binding = new BasicHttpBinding();
            this.IsSystemEndpoint = false;
        }

        // Definition of the additional property of this endpoint
        public bool Property
        {
            get;
            set;
        }
    }

구성 파일에서 사용자가 정의한 사용자 지정 끝점을 사용하려면 StandardEndpointElement와 StandardEndpointCollectionElement에서 각각 클래스를 파생시키고 app.config 또는 machine.config의 확장 섹션에 새 표준 끝점을 등록해야 합니다. 다음 예제와 같이 StandardEndpointElement는 표준 끝점을 구성하기 위한 지원을 제공합니다.

public class CustomEndpointElement : StandardEndpointElement
    {
        // Definition of the additional property for the standard endpoint element
        public bool Property
        {
            get { return (bool)base["property"]; }
            set { base["property"] = value; }
        }

        // The additional property needs to be added to the properties of the standard endpoint element
        protected override ConfigurationPropertyCollection Properties
        {
            get
            {
                ConfigurationPropertyCollection properties = base.Properties;
                properties.Add(new ConfigurationProperty("property", typeof(bool), false, ConfigurationPropertyOptions.None));
                return properties;
            }
        }

        // Return the type of this standard endpoint
        protected override Type EndpointType
        {
            get { return typeof(CustomEndpoint); }
        }

        // Create the custom service endpoint
        protected override ServiceEndpoint CreateServiceEndpoint(ContractDescription contract)
        {
            return new CustomEndpoint();
        }

        // Read the value given to the property in config and save it
        protected override void OnApplyConfiguration(ServiceEndpoint endpoint, ServiceEndpointElement serviceEndpointElement)
        {
            CustomEndpoint customEndpoint = (CustomEndpoint)endpoint;
            customEndpoint.Property = this.Property;
        }

        // Read the value given to the property in config and save it
        protected override void OnApplyConfiguration(ServiceEndpoint endpoint, ChannelEndpointElement channelEndpointElement)
        {
            CustomEndpoint customEndpoint = (CustomEndpoint)endpoint;
            customEndpoint.Property = this.Property;
        }

        // No validation in this sample
        protected override void OnInitializeAndValidate(ServiceEndpointElement serviceEndpointElement)
        {
        }

        // No validation in this sample
        protected override void OnInitializeAndValidate(ChannelEndpointElement channelEndpointElement)
        {
        }
    }

StandardEndpointCollectionElement은 표준 끝점에 대한 구성의 <standardEndpoints> 섹션 아래에 나타나는 컬렉션에 지원 형식을 제공합니다. 다음 예제에서는 이 클래스를 구현하는 방법을 보여 줍니다.

public class CustomEndpointCollectionElement : StandardEndpointCollectionElement<CustomEndpoint, CustomEndpointElement>
    {
         // ...

    }

다음 예제에서는 확장 섹션에 표준 끝점을 등록하는 방법을 보여 줍니다.

<extensions>
      <standardEndpointExtensions>
        <add
          name="customStandardEndpoint"
          type="CustomEndpointCollectionElement, Example.dll,
                Version=1.0.0.0, Culture=neutral, PublicKeyToken=ffffffffffffffff"/>

표준 끝점 구성

표준 끝점은 코드나 구성에 추가할 수 있습니다. 코드에 표준 끝점을 추가하려면 다음 예제와 같이 적절한 표준 끝점 형식을 인스턴스화하고 이를 서비스 호스트에 추가합니다.

serviceHost.AddServiceEndpoint(new CustomEndpoint());

구성에 표준 끝점을 추가하려면 <service> 요소에 <endpoint> 요소를 추가하고 <standardEndpoints> 요소에 필요한 모든 구성 설정을 추가합니다. 다음 예제에서는 .NET Framework 4와 함께 제공되는 표준 끝점 중 하나인 UdpDiscoveryEndpoint를 추가하는 방법을 보여 줍니다.

<services>
  <service>
    <endpoint isSystemEndpoint=”true” kind=”udpDiscoveryEndpoint” />
  </service>
</services>
<standardEndpoints>  
  <udpDiscoveryEndpoint>
     <standardEndpoint multicastAddress="soap.udp://239.255.255.250:3702" /> 
  </udpDiscoveryEndpoint>
</ standardEndpoints >

표준 끝점의 형식은 <endpoint> 요소의 kind 특성을 사용하여 지정됩니다. 끝점은 <standardEndpoints> 요소 내에 구성됩니다. 위의 예제에서는 UdpDiscoveryEndpoint 끝점을 추가하고 구성했습니다. <udpDiscoveryEndpoint> 요소에는 UdpDiscoveryEndpoint의 MulticastAddress 속성을 설정하는 <standardEndpoint>가 포함되어 있습니다.

.NET Framework와 함께 제공되는 표준 끝점

다음 표에서는 .NET Framework 4와 함께 제공되는 표준 끝점을 보여 줍니다.

  • Mex Endpoint
    서비스 메타데이터를 노출하는 데 사용되는 표준 끝점입니다.
  • AnnouncementEndpoint
    서비스에서 알림 메시지를 보내는 데 사용되는 표준 끝점입니다.
  • DiscoveryEndpoint
    서비스에서 검색 메시지를 보내는 데 사용되는 표준 끝점입니다.
  • UdpDiscoveryEndpoint
    UDP 멀티캐스트 바인딩을 통한 검색 작업에 대해 미리 구성된 표준 끝점입니다.
  • UdpAnnouncementEndpoint
    서비스에서 UDP 바인딩을 통해 알림 메시지를 보내는 데 사용되는 표준 끝점입니다.
  • DynamicEndpoint
    런타임에 WS-Discovery를 사용하여 끝점 주소를 동적으로 찾는 표준 끝점입니다.
  • WorkflowControlEndpoint
    워크플로 인스턴스에서 제어 작업을 호출하는 데 사용할 수 있는 표준 끝점입니다.