자습서: Windows Communication Foundation 클라이언트 만들기

이 자습서에서는 기본 WCF(Windows Communication Foundation) 애플리케이션을 만드는 데 필요한 다섯 가지 작업 중 네 번째 작업에 대해 설명합니다. 자습서에 대한 개요는 자습서: Windows Communication Foundation 애플리케이션 시작를 참조하세요.

WCF 애플리케이션을 만들기 위한 다음 작업은 WCF 서비스에서 메타데이터를 검색하여 클라이언트를 만드는 것입니다. Visual Studio를 사용하여 서비스의 MEX 엔드포인트에서 메타데이터를 가져오는 서비스 참조를 추가합니다. 그런 다음, Visual Studio는 선택한 언어로 클라이언트 프록시에 대한 관리형 소스 코드 파일을 생성합니다. 또한 클라이언트 구성 파일(App.config)을 만듭니다. 이 파일을 사용하면 클라이언트 애플리케이션이 엔드포인트에서 서비스에 연결할 수 있습니다.

클라이언트 애플리케이션은 생성된 프록시 클래스를 사용하여 서비스와 통신합니다. 이 절차는 자습서: 클라이언트 사용에서 설명합니다.

이 자습서에서는 다음을 하는 방법을 알아볼 수 있습니다.

Windows Communication Foundation 클라이언트 만들기

1. 다음과 같이 Visual Studio에서 콘솔 앱 프로젝트를 만듭니다.

   1. 파일 메뉴에서 열기>프로젝트/솔루션을 선택하고 이전에 만든 GettingStarted 솔루션(GettingStarted.sln)으로 이동합니다. 열기를 선택합니다.

   2. 보기 메뉴에서 솔루션 탐색기를 선택합니다.

   3. 솔루션 탐색기 창에서 GettingStarted 솔루션(최상위 노드)을 선택한 다음, 바로 가기 메뉴에서 추가>새 프로젝트를 선택합니다.

   4. 새 프로젝트 창 왼쪽에 있는 Visual C# 또는 Visual Basic 아래에서 Windows 데스크톱 범주를 선택합니다.

   5. 콘솔 앱(.NET Framework) 템플릿을 선택하고 이름으로 GettingStartedClient를 입력합니다. 확인을 선택합니다.

2. GettingStartedClient 프로젝트의 참조를 System.ServiceModel 어셈블리에 추가합니다.

   1. 솔루션 탐색기 창에서 GettingStartedClient 프로젝트 아래의 참조 폴더를 선택한 다음, 바로 가기 메뉴에서 참조 추가를 선택합니다.

   2. 참조 추가 창의 창 왼쪽에 있는 어셈블리 아래에서 프레임워크를 선택합니다.

   3. System.ServiceModel을 찾아서 선택한 다음, 확인을 선택합니다.

   4. 파일>모두 저장을 선택하여 솔루션을 저장합니다.

3. 그런 다음, 계산기 서비스에 대한 서비스 참조를 추가합니다.

   1. 솔루션 탐색기 창에서 GettingStartedClient 프로젝트 아래의 참조 폴더를 선택한 다음, 바로 가기 메뉴에서 서비스 참조 추가를 선택합니다.

   2. 서비스 참조 추가 창에서 검색을 선택합니다.

      CalculatorService 서비스가 시작되고 Visual Studio의 서비스 상자에 해당 서비스가 표시됩니다.

   3. CalculatorService를 선택하여 확장하고 서비스에서 구현한 서비스 계약을 표시합니다. 기본 네임스페이스를 그대로 두고 확인을 선택합니다.

      Visual Studio는 GettingStartedClient 프로젝트의 연결된 서비스 폴더 아래에 새 항목을 추가합니다.

ServiceModel Metadata 유틸리티 도구

다음 예제에서는 선택적으로 ServiceModel Metadata 유틸리티 도구(Svcutil.exe)를 사용하여 프록시 클래스 파일을 생성하는 방법을 보여 줍니다. 이 도구는 프록시 클래스 파일과 App.config 파일을 생성합니다. 다음 예제에서는 C# 및 Visual Basic에서 각각 프록시를 생성하는 방법을 보여 줍니다.

svcutil.exe /language:cs /out:generatedProxy.cs /config:app.config http://localhost:8000/GettingStarted/CalculatorService

svcutil.exe /language:vb /out:generatedProxy.vb /config:app.config http://localhost:8000/GettingStarted/CalculatorService

클라이언트 구성 파일

클라이언트를 만든 후 Visual Studio는 App.config 구성 파일을 다음 예제와 유사하게 GettingStartedClient 프로젝트에 만듭니다.

    <?xml version="1.0" encoding="utf-8" ?>
    <configuration>
        <startup>
            <!-- specifies the version of WCF to use-->
            <supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.6.1" />
        </startup>
        <system.serviceModel>
            <bindings>
                <!-- Uses wsHttpBinding-->
                <wsHttpBinding>
                    <binding name="WSHttpBinding_ICalculator" />
                </wsHttpBinding>
            </bindings>
            <client>
                <!-- specifies the endpoint to use when calling the service -->
                <endpoint address="http://localhost:8000/GettingStarted/CalculatorService"
                    binding="wsHttpBinding" bindingConfiguration="WSHttpBinding_ICalculator"
                    contract="ServiceReference1.ICalculator" name="WSHttpBinding_ICalculator">
                    <identity>
                        <dns value="localhost" />
                    </identity>
                </endpoint>
            </client>
        </system.serviceModel>
    </configuration>

<system.serviceModel> 섹션에서 <endpoint> 요소를 확인합니다. <endpoint> 요소는 다음과 같이 클라이언트가 서비스에 액세스하는 데 사용하는 엔드포인트를 정의합니다.

• 주소: http://localhost:8000/GettingStarted/CalculatorService. 엔드포인트의 주소입니다.
• 서비스 계약: ServiceReference1.ICalculator. 서비스 계약은 WCF 클라이언트와 서비스 간의 통신을 처리합니다. Visual Studio는 서비스 참조 추가 함수를 사용할 때 이 계약을 생성했습니다. 실질적으로 GettingStartedLib 프로젝트에 정의된 계약의 사본입니다.
• 바인딩: WSHttpBinding. 바인딩은 HTTP를 전송, 상호 운용 가능한 보안 및 기타 구성 세부 사항으로 지정합니다.

다음 단계

이 자습서에서는 다음 작업 방법을 알아보았습니다.

생성된 클라이언트를 사용하는 방법을 알아보려면 다음 자습서를 계속 진행하세요.