서비스 런타임 동작 지정

아티클
04/08/2023

서비스 계약을 디자인(Designing Service Contracts) 서비스 계약을 구현(Implementing Service Contracts)했으면 서비스 런타임의 작업 동작을 구성할 수 있습니다. 이 항목에서는 시스템 제공 서비스와 작업 동작에 대해 설명하고, 새 동작을 만들기 위해 추가 정보를 찾을 수 있는 위치에 대해 설명합니다. 일부 동작은 특성으로 적용되지만 대부분은 애플리케이션 구성 파일을 사용하여 적용되거나 프로그래밍 방식으로 적용됩니다. 서비스 애플리케이션을 구성하는 방법에 대한 자세한 내용은 서비스 구성을 참조하세요.

개요

계약은 해당 형식의 서비스 입력, 출력, 데이터 형식 및 기능을 정의합니다. 서비스 계약을 구현하면 주소에서 바인딩으로 구성된 경우 구현한 계약을 이행하는 클래스가 만들어집니다. 클라이언트에서는 계약, 바인딩 및 주소 정보를 모두 알고 있습니다. 이러한 정보가 없으면 클라이언트는 서비스를 사용할 수 없습니다.

그러나 스레딩 문제 또는 인스턴스 관리와 같은 특정 작업은 클라이언트에 불분명합니다. 서비스 계약을 구현한 경우에는 동작을 사용하여 여러 개의 작업 특징을 구성할 수 있습니다. 동작은 런타임 속성을 설정하거나 런타임에 사용자 지정 형식을 삽입하여 WCF(Windows Communication Foundation) 런타임을 수정하는 개체입니다. 사용자 정의 동작을 생성하여 런타임을 수정하는 방법에 대한 자세한 내용은 ServiceHost 및 서비스 모델 레이어 확장을 참조하세요.

System.ServiceModel.ServiceBehaviorAttribute 및 System.ServiceModel.OperationBehaviorAttribute 특성은 가장 널리 쓰이는 유용한 동작이며, 가장 일반적으로 요청되는 작업 기능을 노출합니다. 이들은 특성이기 때문에 서비스 또는 작업 구현에 적용합니다. System.ServiceModel.Description.ServiceMetadataBehavior 또는 System.ServiceModel.Description.ServiceDebugBehavior등의 다른 동작은 프로그래밍 방식으로 사용될 수 있긴 하지만 일반적으로 애플리케이션 구성 파일을 사용하여 적용됩니다.

이 항목에서는 ServiceBehaviorAttribute 및 OperationBehaviorAttribute 특성에 대해 간략하게 설명하고, 동작이 작동할 수 있는 여러 범위에 대해 설명하고, WCF 개발자에게 유용할 수 있는 여러 범위의 다양한 시스템 제공 동작에 대해 짧게 설명합니다.

ServiceBehaviorAttribute 및 OperationBehaviorAttribute

가장 중요한 동작은 다음을 제어할 때 사용할 수 있는 ServiceBehaviorAttribute 및 OperationBehaviorAttribute 특성입니다.

인스턴스 수명
동시성 및 동기화 지원
구성 동작
트랜잭션 동작
Serialization 동작
메타데이터 변환
세션 수명
주소 필터링 및 헤더 처리
가장
이러한 특성을 사용하려면 서비스 또는 작업 구현에 해당 범주에 적합한 특성을 표시하고 속성을 설정합니다. 예를 들어 다음 코드 예제에서는 이 작업 호출자가 가장을 지원하기 위해 OperationBehaviorAttribute.Impersonation 속성을 사용하는 작업 구현을 보여 줍니다.

using System;
using System.Collections.Generic;
using System.ServiceModel;
using System.Threading;

namespace Microsoft.WCF.Documentation
{
  [ServiceContract(
    Name="SampleHello",
    Namespace="http://microsoft.wcf.documentation"
  )]
  public interface IHello
  {
    [OperationContract]
    string Hello(string greeting);
  }

  public class HelloService : IHello
  {

    public HelloService()
    {
      Console.WriteLine("Service object created: " + this.GetHashCode().ToString());
    }

    ~HelloService()
    {
      Console.WriteLine("Service object destroyed: " + this.GetHashCode().ToString());
    }

    [OperationBehavior(Impersonation=ImpersonationOption.Required)]
    public string Hello(string greeting)
    {
      Console.WriteLine("Called by: " + Thread.CurrentPrincipal.Identity.Name);
      Console.WriteLine("IsAuthenticated: " + Thread.CurrentPrincipal.Identity.IsAuthenticated.ToString());
      Console.WriteLine("AuthenticationType: " + Thread.CurrentPrincipal.Identity.AuthenticationType.ToString());

      Console.WriteLine("Caller sent: " + greeting);
      Console.WriteLine("Sending back: Hi, " + Thread.CurrentPrincipal.Identity.Name);
      return "Hi, " + Thread.CurrentPrincipal.Identity.Name;
    }
  }
}

Imports System.ServiceModel
Imports System.Threading

Namespace Microsoft.WCF.Documentation
    <ServiceContract(Name:="SampleHello", Namespace:="http://microsoft.wcf.documentation")> _
    Public Interface IHello
        <OperationContract> _
        Function Hello(ByVal greeting As String) As String
    End Interface

    Public Class HelloService
        Implements IHello

        Public Sub New()
            Console.WriteLine("Service object created: " & Me.GetHashCode().ToString())
        End Sub

        Protected Overrides Sub Finalize()
            Console.WriteLine("Service object destroyed: " & Me.GetHashCode().ToString())
        End Sub

        <OperationBehavior(Impersonation:=ImpersonationOption.Required)> _
        Public Function Hello(ByVal greeting As String) As String Implements IHello.Hello
            Console.WriteLine("Called by: " & Thread.CurrentPrincipal.Identity.Name)
            Console.WriteLine("IsAuthenticated: " & Thread.CurrentPrincipal.Identity.IsAuthenticated.ToString())
            Console.WriteLine("AuthenticationType: " & Thread.CurrentPrincipal.Identity.AuthenticationType.ToString())

            Console.WriteLine("Caller sent: " & greeting)
            Console.WriteLine("Sending back: Hi, " & Thread.CurrentPrincipal.Identity.Name)
            Return "Hi, " & Thread.CurrentPrincipal.Identity.Name
        End Function
    End Class
End Namespace

대부분의 속성에 바인딩의 추가 지원이 필요합니다. 예를 들어 클라이언트의 트랜잭션이 필요한 작업은 이동한 트랜잭션을 지원하는 바인딩을 사용하도록 구성해야 합니다.

잘 알려진 singleton 서비스

ServiceBehaviorAttribute 및 OperationBehaviorAttribute 특성을 사용하여 InstanceContext 와 작업을 구현하는 서비스 개체의 특정 수명을 제어할 수 있습니다.

예를 들어 ServiceBehaviorAttribute.InstanceContextMode 속성은 InstanceContext 가 해제되는 빈도를 제어하고, OperationBehaviorAttribute.ReleaseInstanceMode 및 ServiceBehaviorAttribute.ReleaseServiceInstanceOnTransactionComplete 속성은 서비스 개체가 해제되는 시점을 제어합니다.

그러나 서비스 개체를 직접 만들고, 해당 개체를 사용하여 서비스 호스트를 만들 수도 있습니다. 이렇게 하려면 ServiceBehaviorAttribute.InstanceContextMode 속성도 Single 로 설정해야 하며, 그렇지 않으면 서비스 호스트를 열 때 예외가 throw됩니다.

ServiceHost(Object, Uri[]) 생성자를 사용하여 이러한 서비스를 만듭니다. singleton 서비스에서 사용할 특정 개체 인스턴스를 제공하려면 사용자 지정 System.ServiceModel.Dispatcher.IInstanceContextInitializer 를 구현하는 대신 제공합니다. 예를 들어, 매개 변수가 없는 public 생성자를 구현하지 않는 경우와 같이 서비스 구현 형식을 생성하기 어려운 경우 이 오버로드를 사용할 수 있습니다.

이 생성자에 개체가 제공되면 WCF(Windows Communication Foundation) 인스턴스 동작과 관련된 일부 기능이 다르게 작동합니다. 예를 들어 잘 알려진 개체 인스턴스를 제공하는 경우 InstanceContext.ReleaseServiceInstance 호출은 아무런 효과가 없습니다. 마찬가지로 다른 인스턴스 해제 메커니즘도 무시됩니다. ServiceHost 클래스는 항상 모든 작업에 대해 OperationBehaviorAttribute.ReleaseInstanceMode 속성이 ReleaseInstanceMode.None 으로 설정된 것처럼 동작합니다.

기타 서비스, 엔드포인트, 계약 및 작업 동작

ServiceBehaviorAttribute 특성과 같은 서비스 동작은 전체 서비스에서 작동합니다. 예를 들어 ServiceBehaviorAttribute.ConcurrencyMode 속성을 ConcurrencyMode.Multiple 로 설정하는 경우 해당 서비스의 각 작업 내에서 스레드 동기화 문제를 직접 처리해야 합니다. 엔드포인트 동작은 엔드포인트에서 작동합니다. 대부분의 시스템 제공 엔드포인트 동작은 클라이언트 기능에 대한 것입니다. 계약 동작은 계약 수준에서 작동하고 작업 동작은 작업 배달을 수정합니다.

이러한 동작은 대부분 특성에서 구현되므로 ServiceBehaviorAttribute 및 OperationBehaviorAttribute 특성을 사용할 때 이러한 동작을 사용합니다. 이렇게 하려면 적합한 서비스 클래스 또는 작업 구현에 해당 동작을 적용하면 됩니다. ServiceMetadataBehavior 또는 ServiceDebugBehavior 개체 등의 다른 동작은 프로그래밍 방식으로 사용될 수 있긴 하지만 일반적으로 애플리케이션 구성 파일을 사용하여 적용됩니다.

예를 들어 메타데이터 게시는 ServiceMetadataBehavior 개체를 사용하여 구성됩니다. 다음 애플리케이션 구성 파일은 가장 일반적인 사용 방법을 보여 줍니다.

<configuration>
  <system.serviceModel>
    <services>
      <service 
        name="Microsoft.WCF.Documentation.SampleService"
        behaviorConfiguration="metadataSupport"
      >
        <host>
          <baseAddresses>
            <add baseAddress="http://localhost:8080/SampleService" />
          </baseAddresses>
        </host>
        <endpoint
          address=""
          binding="wsHttpBinding"
          contract="Microsoft.WCF.Documentation.ISampleService"
        />
        <!-- Adds a WS-MetadataExchange endpoint at -->
        <!-- "http://localhost:8080/SampleService/mex" -->
        <endpoint
           address="mex"
           binding="mexHttpBinding"
           contract="IMetadataExchange"
        />
      </service>
    </services>
    <behaviors>
      <serviceBehaviors>
      <behavior name="metadataSupport">
        <!-- Enables the IMetadataExchange endpoint in services that -->
        <!-- use "metadataSupport" in their behaviorConfiguration attribute. -->
        <!-- In addition, the httpGetEnabled and httpGetUrl attributes publish -->
        <!-- Service metadata for retrieval by HTTP/GET at the address -->
        <!-- "http://localhost:8080/SampleService?wsdl" -->
        <serviceMetadata httpGetEnabled="true" httpGetUrl=""/>
      </behavior>
    </serviceBehaviors>
  </behaviors>
  </system.serviceModel>
</configuration>

다음 단원에서는 서비스 또는 클라이언트의 런타임 배달을 수정할 때 사용할 수 있는 여러 개의 가장 유용한 시스템 제공 동작에 대해 설명합니다. 참조 항목을 참조하여 각 동작의 사용 방법을 결정합니다.

서비스 동작

다음 동작은 서비스에서 작동합니다.

AspNetCompatibilityRequirementsAttribute. 해당 서비스를 ASP.NET 호환 모드로 실행할 수 있는지 여부를 나타내기 위해 WCF 서비스에 적용됩니다.
ServiceAuthorizationBehavior. 서비스가 클라이언트 클레임에 권한을 부여하는 방식을 제어합니다.
ServiceCredentials. 이 클래스는 서비스 자격 증명을 구성합니다. 이 클래스를 사용하여 서비스에 대한 자격 증명(예: X.509 인증서)을 지정합니다.
ServiceDebugBehavior. WCF 서비스에 대한 디버깅 및 도움말 정보 기능을 사용합니다.
ServiceMetadataBehavior. 서비스 메타데이터 및 관련 정보의 게시를 제어합니다.
ServiceSecurityAuditBehavior. 보안 이벤트의 감사 동작을 지정합니다.
ServiceThrottlingBehavior. 서비스 성능을 조정할 수 있는 런타임 처리량 설정을 구성합니다.

엔드포인트 동작

다음 동작은 엔드포인트에서 작동합니다. 이러한 동작은 대부분 클라이언트 애플리케이션에서 사용됩니다.

CallbackBehaviorAttribute. 이중 클라이언트 애플리케이션에서 콜백 서비스 구현을 구성합니다.
CallbackDebugBehavior. WCF 콜백 개체에 대해 서비스 디버깅을 사용하도록 설정합니다.
ClientCredentials. 사용자가 클라이언트와 서비스 자격 증명 및 클라이언트에서 사용할 서비스 자격 증명 인증 설정을 구성할 수 있습니다.
ClientViaBehavior. 전송 채널을 만들어야 하는 URI(Uniform Resource Identifier)를 지정하기 위해 클라이언트에서 사용합니다.
MustUnderstandBehavior. MustUnderstand 처리를 사용하지 않도록 WCF에 지시합니다.
SynchronousReceiveBehavior. 런타임에 채널에 대한 동기 수신 프로세스를 사용하도록 지시합니다.
TransactedBatchingBehavior. 트랜잭션 수신을 지원하는 전송에 대해 받기 작업을 최적화합니다.

계약 동작

DeliveryRequirementsAttribute. 바인딩이 서비스 또는 클라이언트 구현에 제공해야 하는 기능 요구 사항을 지정합니다.

작업 동작

다음 작업 동작은 작업에 대한 serialization 및 트랜잭션 제어를 지정합니다.

DataContractSerializerOperationBehavior. System.Runtime.Serialization.DataContractSerializer의 런타임 동작을 나타냅니다.
XmlSerializerOperationBehavior. XmlSerializer 의 런타임 동작을 제어하고 해당 동작을 작업과 연결합니다.
TransactionFlowAttribute. 서비스 작업에서 트랜잭션 헤더를 허용하는 수준을 지정합니다.