표준 엔드포인트
엔드포인트는 주소, 바인딩 및 계약을 지정하여 정의됩니다. 이외에도 엔드포인트에 설정할 수 있는 매개 변수에는 동작 구성, 헤더 및 수신 대기 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<TStandardEndpoint,TEndpointConfiguration>에서 각각 클래스를 파생시키고 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<TStandardEndpoint,TEndpointConfiguration>은 표준 엔드포인트에 대한 구성의 <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"/>
</standardEndpointExtensions>
</extensions>
표준 엔드포인트 구성
표준 엔드포인트는 코드나 구성에 추가할 수 있습니다. 코드에 표준 엔드포인트를 추가하려면 다음 예제와 같이 적절한 표준 엔드포인트 형식을 인스턴스화하고 이를 서비스 호스트에 추가합니다.
serviceHost.AddServiceEndpoint(new CustomEndpoint());
구성에서 표준 엔드포인트를 추가하려면 <endpoint> 요소에 <service> 요소를 추가하고 <standardEndpoints> 요소에 필요한 구성 설정을 추가합니다. 다음 예제에서는 .NET Framework 4.6.1과 함께 제공되는 표준 엔드포인트 중 하나인 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.6.1과 함께 제공되는 표준 엔드포인트를 보여 줍니다.
Mex Endpoint 서비스 메타데이터를 노출하기 위해 사용하는 표준 엔드포인트입니다.
AnnouncementEndpoint 서비스에서 알림 메시지를 보내기 위해 사용하는 표준 엔드포인트입니다.
DiscoveryEndpoint 서비스에서 검색 메시지를 보내기 위해 사용하는 표준 엔드포인트입니다.
UdpDiscoveryEndpointUDP 멀티캐스트 바인딩을 통한 검색 작업에 대해 미리 구성된 표준 엔드포인트입니다.
UdpAnnouncementEndpoint 서비스에서 UDP 바인딩을 통해 알림 메시지를 보내기 위해 사용하는 표준 엔드포인트입니다.
DynamicEndpoint 엔드포인트 주소를 동적으로 찾기 위해 런타임에 WS-Discovery를 사용하는 표준 엔드포인트입니다.
ServiceMetadataEndpoint 메타데이터 교환을 위한 표준 엔드포인트입니다.
WebHttpEndpoint 자동으로 WebHttpBehavior 동작을 추가하는 WebHttpBinding 바인딩이 있는 표준 엔드포인트
WebScriptEndpoint 자동으로 WebScriptEnablingBehavior 동작을 추가하는 WebHttpBinding 바인딩이 있는 표준 엔드포인트입니다.
WebServiceEndpoint WebHttpBinding 바인딩이 있는 표준 엔드포인트입니다.
WorkflowControlEndpoint 워크플로 인스턴스에서 제어 작업을 호출하기 위해 사용할 수 있는 표준 엔드포인트입니다.
WorkflowHostingEndpoint 워크플로 생성 및 책갈피 다시 시작을 지원하는 표준 엔드포인트입니다.