Windows Service Host

아티클
09/05/2008

이 샘플에서는 관리되는 Windows 서비스에서 호스팅되는 WCF(Windows Communication Foundation) 서비스를 보여 줍니다. Windows 서비스는 제어판에서 서비스 애플릿을 사용하여 제어하며 시스템을 다시 부팅한 후에 자동으로 시작되도록 구성할 수 있습니다. 이 샘플은 클라이언트 프로그램과 Windows 서비스 프로그램으로 구성됩니다. 서비스는 .exe 프로그램으로 구현되고 자체 호스팅 코드가 포함됩니다. WAS(Windows Process Activation Services) 또는 IIS(인터넷 정보 서비스) 등의 다른 호스팅 환경에서는 직접 호스팅 코드를 작성할 필요가 없습니다.

참고

이 샘플의 설치 절차 및 빌드 지침은 이 항목의 끝부분에 나와 있습니다.

이 서비스를 빌드한 후에는 다른 Windows 서비스와 마찬가지로 Installutil.exe 유틸리티로 설치해야 합니다. 서비스를 변경하려는 경우에는 먼저 installutil /u를 사용하여 제거해야 합니다. 이 샘플에 포함된 Setup.bat 및 Cleanup.bat 파일은 Windows 서비스를 설치 및 시작하기 위한 명령과 Windows 서비스를 종료 및 제거하기 위한 명령입니다. WCF 서비스는 Windows 서비스가 실행 중인 경우에만 클라이언트에 응답할 수 있습니다. 제어판에서 서비스 애플릿을 사용하여 Windows 서비스를 중지하고 클라이언트를 실행하면 클라이언트에서 서비스에 액세스를 시도할 때 EndpointNotFoundException 예외가 발생합니다. Windows 서비스를 다시 시작하고 클라이언트를 다시 실행하면 통신이 성공합니다.

서비스 코드에는 ICalculator 계약을 구현하는 WCF 서비스 구현 클래스인 설치 관리자 클래스와 런타임 호스트 역할을 하는 Windows 서비스 클래스가 포함됩니다. Installer에서 상속되는 설치 관리자 클래스를 사용하면 프로그램을 Installutil.exe 도구를 통해 NT 서비스로 설치할 수 있습니다. 서비스 구현 클래스인 WcfCalculatorService는 기본 서비스 계약을 구현하는 WCF 서비스입니다. 이 WCF 서비스는 WindowsCalculatorService라는 Windows 서비스 클래스 내에서 호스팅됩니다. Windows 서비스로 정규화하기 위해 클래스가 ServiceBase에서 상속되고 OnStart 및 OnStop 메서드를 구현합니다. OnStart에서 ServiceHost 개체가 WcfCalculatorService 형식에 대해 만들어지고 열립니다. OnStop에서 ServiceHost는 ServiceHost 개체의 Close 메서드를 호출하여 닫습니다. 호스트의 기본 주소는 <add> of <baseAddress> 요소를 사용하여 구성됩니다. 해당 요소는 <service>의 자식인 <host>의 자식인 <baseAddresses>의 자식입니다.

정의된 끝점에서는 기본 주소와 wsHttpBinding Element를 사용합니다. 다음 샘플에서는 CalculatorService를 노출시키는 끝점과 기본 주소의 구성을 보여 줍니다.

<services>
  <service name="Microsoft.ServiceModel.Samples.WcfCalculatorService"
           behaviorConfiguration="CalculatorServiceBehavior">
    <host>
      <baseAddresses>
        <add baseAddress="https://localhost:8000/ServiceModelSamples/service"/>
      </baseAddresses>
    </host>
    <!-- This endpoint is exposed at the base address provided by host: https://localhost:8000/ServiceModelSamples/service.  -->
    <endpoint address=""
              binding="wsHttpBinding"
              contract="Microsoft.ServiceModel.Samples.ICalculator" />
    ...
  </service>
</services>

샘플을 실행하면 작업 요청 및 응답이 서비스와 클라이언트 콘솔 창 모두에 표시됩니다. 서비스와 클라이언트를 종료하려면 각 콘솔 창에서 Enter 키를 누릅니다.

샘플을 설치, 빌드 및 실행하려면

Windows Communication Foundation 샘플의 일회 설치 절차를 수행했는지 확인합니다.
C# 또는 Visual Basic .NET 버전의 솔루션을 빌드하려면 Windows Communication Foundation 샘플 빌드의 지침을 따릅니다.
솔루션이 빌드되고 나면 Setup.bat를 실행하여 Installutil.exe 도구로 Windows 서비스를 설치합니다. 서비스가 서비스에 표시됩니다.
단일 컴퓨터 또는 다중 컴퓨터 구성에서 샘플을 실행하려면 Windows Communication Foundation 샘플 실행의 지침을 따릅니다.

다음을 통해 공유

Windows Service Host

샘플을 설치, 빌드 및 실행하려면

추가 리소스