엔드포인트 만들기 개요

아티클
04/07/2023

WCF(Windows Communication Foundation) 서비스와의 모든 통신은 서비스의 엔드포인트를 통해 이루어집니다. 엔드포인트는 WCF 서비스가 제공하는 기능에 대한 클라이언트 액세스를 제공합니다. 이 단원에서는 엔드포인트의 구조에 대해 설명하고 구성 및 코드에서 엔드포인트를 정의하는 방법을 간략하게 설명합니다.

엔드포인트의 구조

각 엔드포인트에는 엔드포인트를 찾을 위치를 나타내는 주소, 클라이언트가 엔드포인트와 통신할 수 있는 방법을 지정하는 바인딩, 그리고 사용 가능한 메서드를 식별하는 계약이 포함되어 있습니다.

주소. 주소는 엔드포인트를 고유하게 식별하고 잠재 고객에게 서비스가 있는 위치를 알려 줍니다. 주소는 WCF 개체 모델에서 EndpointAddress 주소로 표시되며 URI(Uniform Resource Identifier) 및 ID를 포함하는 주소 속성, 일부 WSDL(웹 서비스 기술 언어) 요소 및 선택적 헤더의 컬렉션을 포함합니다. 선택적 헤더는 엔드포인트를 확인하거나 상호 작용하는 데 필요한 자세한 주소 지정 정보를 추가로 제공합니다. 자세한 내용은 엔드포인트 주소 지정을 참조하세요.
바인딩. 바인딩은 엔드포인트와 통신하는 방법을 지정합니다. 바인딩은 사용할 전송 프로토콜(예: TCP 또는 HTTP), 메시지에 사용할 인코딩(예: 텍스트 또는 이진), 필요한 보안 요구 사항(예: SSL[Secure Sockets Layer] 또는 SOAP 메시지 보안) 등을 포함하여 엔드포인트가 대상과 통신하는 방법을 지정합니다. 자세한 내용은 바인딩을 사용하여 서비스 및 클라이언트 구성을 참조하세요.
서비스 계약. 서비스 계약에서는 엔드포인트가 클라이언트에 노출하는 기능을 간략하게 설명합니다. 계약은 클라이언트가 호출할 수 있는 작업, 작업을 호출하는 데 필요한 입력 매개 변수 또는 데이터의 형식 및 메시지 형식, 클라이언트가 기대할 수 있는 처리 또는 응답 메시지의 종류 등을 지정합니다. 계약의 세 가지 기본 유형은 기본 MEP(메시지 교환 패턴)인 데이터 그램(단방향), 요청/응답 및 이중(양방향)과 일치합니다. 또한 서비스 계약은 액세스할 때 데이터 및 메시지 계약을 사용하여 특정 데이터 형식과 메시지 형식을 요구할 수 있습니다. 서비스 계약을 정의하는 방법에 대한 자세한 내용은 서비스 계약 디자인을 참조하세요. 클라이언트가 이중 MEP의 서비스로부터 메시지를 받으려면 콜백 계약이라는 서비스 정의 계약을 구현해야 합니다. 자세한 내용은 이중 서비스를 참조하세요.

서비스의 엔드포인트를 코드를 사용하여 명령적으로 지정하거나 구성을 통해 선언적으로 지정할 수 있습니다. 엔드포인트를 지정하지 않으면 런타임이 서비스에서 구현되는 각 서비스 계약의 각 기본 주소에 대해 기본 엔드포인트를 하나씩 추가하여 기본 엔드포인트를 제공합니다. 배포된 서비스의 바인딩과 주소는 일반적으로 서비스를 개발할 때 사용되는 바인딩 및 주소와는 다르기 때문에 코드에서 엔드포인트를 정의하는 방식은 대개 실용적이지 않습니다. 일반적으로 코드 대신 구성을 사용하여 서비스 엔드포인트를 정의하는 것이 좋습니다. 바인딩 및 주소 지정 정보를 코드와 구분하면 애플리케이션을 다시 컴파일하여 재배포할 필요 없이 해당 정보를 변경할 수 있습니다.

참고 항목

가장을 수행하는 서비스 엔드포인트를 추가할 때는 AddServiceEndpoint 메서드 또는 GetContract(Type, Type) 메서드 중 하나를 사용하여 계약을 새 ServiceDescription 개체로 적절하게 로드해야 합니다.

코드로 엔드포인트 정의

다음 예제에서는 코드로 엔드포인트를 지정하는 방법을 보여 줍니다.

사용자 이름과 에코를 사용하고 "Hello <name>!" 응답을 반환하는 IEcho 서비스 유형에 대한 계약을 정의합니다.
Echo 계약에 정의된 유형의 IEcho 서비스를 구현합니다.
서비스에 대한 http://localhost:8000/Echo의 엔드포인트 주소를 지정합니다.
Echo 바인딩을 사용하여 WSHttpBinding 서비스를 구성합니다.

namespace Echo
{
   // Define the contract for the IEcho service
   [ServiceContract]
   public interface IEcho
   {
       [OperationContract]
       String Hello(string name)
   }

   // Create an Echo service that implements IEcho contract
   class Echo : IEcho
   {
      public string Hello(string name)
      {
         return "Hello" + name + "!";
      }
      public static void Main ()
      {
          //Specify the base address for Echo service.
          Uri echoUri = new Uri("http://localhost:8000/");

          //Create a ServiceHost for the Echo service.
          ServiceHost serviceHost = new ServiceHost(typeof(Echo),echoUri);

          // Use a predefined WSHttpBinding to configure the service.
          WSHttpBinding binding = new WSHttpBinding();

          // Add the endpoint for this service to the service host.
          serviceHost.AddServiceEndpoint(
             typeof(IEcho),
             binding,
             echoUri
           );

          // Open the service host to run it.
          serviceHost.Open();
     }
  }
}

' Define the contract for the IEcho service
    <ServiceContract()> _
    Public Interface IEcho
        <OperationContract()> _
        Function Hello(ByVal name As String) As String
    End Interface

' Create an Echo service that implements IEcho contract
    Public Class Echo
        Implements IEcho
        Public Function Hello(ByVal name As String) As String _
 Implements ICalculator.Hello
            Dim result As String = "Hello" + name + "!"
            Return result
        End Function

' Specify the base address for Echo service.
Dim echoUri As Uri = New Uri("http://localhost:8000/")

' Create a ServiceHost for the Echo service.
Dim svcHost As ServiceHost = New ServiceHost(GetType(HelloWorld), echoUri)

' Use a predefined WSHttpBinding to configure the service.
Dim binding As New WSHttpBinding()

' Add the endpoint for this service to the service host.
serviceHost.AddServiceEndpoint(GetType(IEcho), binding, echoUri)

' Open the service host to run it.
serviceHost.Open()

참고 항목

서비스 호스트가 기본 주소로 만들어집니다. 나머지 주소는 기본 주소를 기준으로 엔드포인트의 일부로 지정됩니다. 이 주소 분할을 통해 호스트에서 서비스에 대해 여러 엔드포인트를 쉽게 정의할 수 있습니다.

참고 항목

ServiceDescription에서 OnOpening 메서드 이후에는 서비스 애플리케이션의 ServiceHostBase 속성을 수정해서는 안 됩니다. Credentials 및 AddServiceEndpoint에서 ServiceHostBase 속성 및 ServiceHost 메서드와 같은 일부 멤버는 해당 지점을 지나서 수정할 경우 예외를 throw합니다. 다른 멤버에서는 이를 수정할 수 있지만 그 결과는 예측할 수 없습니다.

마찬가지로 클라이언트에서 ServiceEndpoint의 OnOpening을 호출한 이후에는 ChannelFactory 값을 수정해서는 안 됩니다. Credentials 속성은 해당 지점을 지나서 수정할 경우 예외를 throw합니다. 다른 클라이언트 설명 값은 수정해도 오류가 발생하지 않지만 결과가 정의되어 있지 않습니다.

서비스와 클라이언트 모두에 대해 Open을 호출하기 이전에 설명을 수정하는 것이 좋습니다.

구성에서 엔드포인트 정의

애플리케이션을 만들 때 애플리케이션을 배포하는 관리자에게 결정을 넘겨야 할 경우가 있습니다. 예를 들어, 서비스 주소(URI)가 무엇인지 미리 알 수 없는 경우가 있습니다. 주소를 하드 코딩하는 대신 관리자가 서비스를 작성한 후에 이를 수행하도록 하는 것이 좋습니다. 이러한 유연성은 구성을 통해 수행됩니다. 자세한 내용은 서비스 구성을 참조하세요.

참고 항목

/config:filename[,filename] 스위치와 함께 ServiceModel 메타데이터 유틸리티 도구(Svcutil.exe)를 사용하여 구성 파일을 빠르게 생성합니다.

기본 엔드포인트 사용

코드 또는 구성에서 엔드포인트를 지정하지 않으면 런타임이 서비스에서 구현되는 각 서비스 계약의 각 기본 주소에 대해 기본 엔드포인트를 하나씩 추가하여 기본 엔드포인트를 제공합니다. 기본 주소는 코드 또는 구성에서 지정할 수 있으며 기본 엔드포인트는 Open()에서 ServiceHost을 호출하면 추가됩니다. 다음 예제는 이전 단원과 같은 예제이지만 엔드포인트가 지정되지 않았으므로 기본 엔드포인트가 추가됩니다.

namespace Echo
{
   // Define the contract for the IEcho service
   [ServiceContract]
   public interface IEcho
   {
       [OperationContract]
       String Hello(string name)
   }

   // Create an Echo service that implements IEcho contract
   public class Echo : IEcho
   {
      public string Hello(string name)
      {
         return "Hello" + name + "!";
      }
      public static void Main ()
      {
          //Specify the base address for Echo service.
          Uri echoUri = new Uri("http://localhost:8000/");

          //Create a ServiceHost for the Echo service.
          ServiceHost serviceHost = new ServiceHost(typeof(Echo),echoUri);

          // Open the service host to run it. Default endpoints
          // are added when the service is opened.
          serviceHost.Open();
     }
  }
}

' Define the contract for the IEcho service
    <ServiceContract()> _
    Public Interface IEcho
        <OperationContract()> _
        Function Hello(ByVal name As String) As String
    End Interface

' Create an Echo service that implements IEcho contract
    Public Class Echo
        Implements IEcho
        Public Function Hello(ByVal name As String) As String _
 Implements ICalculator.Hello
            Dim result As String = "Hello" + name + "!"
            Return result
        End Function

' Specify the base address for Echo service.
Dim echoUri As Uri = New Uri("http://localhost:8000/")

' Open the service host to run it. Default endpoints
' are added when the service is opened.
serviceHost.Open()

엔드포인트를 명시적으로 제공하는 경우에도 AddDefaultEndpoints을 호출하기 전에 ServiceHost에서 Open를 호출하여 기본 엔드포인트를 추가할 수 있습니다. 기본 엔드포인트에 대한 자세한 내용은 단순화된 구성 및 WCF 서비스의 단순화된 구성을 참조하세요.

참고 항목

서비스 계약 구현

다음을 통해 공유

엔드포인트 만들기 개요

엔드포인트의 구조

코드로 엔드포인트 정의

구성에서 엔드포인트 정의

기본 엔드포인트 사용

참고 항목

추가 리소스