Microsoft MVP성태의 닷넷 이야기
.NET Framework: 74.1. WCF와 WSE 3.0의 활용 [링크 복사], [링크+제목 복사],
조회: 28892
글쓴 사람
정성태 (techsharer at outlook.com)
홈페이지
첨부 파일
부모글 보이기/감추기
(연관된 글이 2개 있습니다.)
1. WCF와 WSE 3.0의 활용


시나리오를 하나 예로 들어볼까요?

ASP.NET처럼 요청/응답 형의 서버 프로그램이 아니라, NT 서비스(데몬) 성격의 프로그램을 만들어야 되는 상황을 가정해 봅시다. 이때, 여러분들은 해당 NT 서비스 내부에서 행해지는 기능들 또는 직접적인 데이터들에 대해 외부 EXE 프로그램에 노출시켜 주고 싶습니다.
이제 한번 생각해 볼까요?... 이때 여러분들은 어떤 식으로 Application 구조를 잡으시겠습니까?

아마도 WSE 3.0과 WCF를 모르시는 분들은 대개 다음과 같은 식으로 응용 프로그램 구조를 잡으실 것 같습니다.

[그림 1: IIS 서비스를 경유하여 웹 서비스 제공]
IIS 서비스를 경유하여 웹 서비스 제공

물론, NT 서비스 측에서 바로 서버 소켓을 대기시켜 놓고 클라이언트 응용 프로그램에서 접근하게 하는 것도 방법일 테고요. 그런 경우는 특별하게 속도를 염두에 두지 않고는 요즘같은 Enterprise App 세계에서는 효율적이지 않기 때문에 고려 대상에서 제외가 되지요.



상황이 바뀌어서, 여러분들이 만약 WSE 3.0 또는 WCF를 아는 분들이라면, 다음과 같은 응용 프로그램 구조도 가능하다는 것을 알 수 있습니다.

[그림 2: 스스로 웹 서비스 제공]
스스로 웹 서비스 제공

즉, WCF와 WSE 3.0의 경우에는 웹 서비스 기능을 직접 호스팅 할 수 있는 구조를 갖게 됩니다. WSE 3.0은 이미 정식 버전이 나온 상태이고 향후의 WCF와도 호환을 보장한다고 하니 WCF를 기다릴 수 없는 분들은 WSE 3.0을 사용하는 것도 좋은 선택일 수 있습니다. (하지만, .NET 3.0 RC2가 나온 데다 10월 25일에 Vista RTM 버전이 나온다고 하니, .NET 3.0 정식 버전도 그 안에 마무리 되지 않을까 예상해 봅니다.)



기왕에 정리하는 것이니, 코드가 없으면 심심하겠지요! ^^
간단하게, WCF와 WSE 3.0의 Console 버전에서 웹 서비스를 호스팅하고 사용하는 방법에 대해 정리해 보도록 하겠습니다.

#. WSE 3.0 콘솔 서비스와 클라이언트 제작

[WSE 3.0 서비스 제작]
1. WSE 3.0 SDK를 아래의 링크에서 다운로드 받아 설치합니다.
Web Services Enhancements (WSE) 3.0 for Microsoft .NET
; http://www.microsoft.com/downloads/details.aspx?familyid=018a09fd-3a74-43c5-8ec1-8d789091255d&displaylang=en

2. VS.NET 2005를 실행시키고 새로운 프로젝트를 생성합니다. 여기서는 "WSE30Console"이라는 콘솔 유형의 프로젝트를 생성한 것으로 예를 들겠습니다. 비록, 예제는 콘솔 응용 프로그램이지만 동일한 방식으로 NT Service나 WinForm 응용 프로그램에 코드를 적용할 수 있습니다.

3. 솔루션 탐색기 창에서 해당 "WSE30Console" 프로젝트 노드를 오른쪽 마우스 버튼으로 클릭하면 "WSE Settings 3.0..."이라는 메뉴가 나오고 선택하면 다음과 같은 설정창이 뜹니다.

WSE 3.0 설정 대화창

4. 3번 단계를 거치면, 필요한 네임스페이스와 app.config이 정의되게 됩니다. 별다른 WSE 특징을 사용하지 않는다면 "Microsoft.Web.Services3.dll"을 참조 추가하는 것으로도 충분합니다. 이 외에, "System.Web.Services.dll"을 참조 추가해줍니다.

5. "Program.cs" 파일에 다음과 같이 using 문을 추가합니다.

using Microsoft.Web.Services3.Messaging;
using Microsoft.Web.Services3.Addressing;
using System.Web.Services;
using System.Web.Services.Protocols;
using System.Xml;
using System.Xml.Serialization;

6. "Program.cs"에 다음과 같이 간단한 웹 서비스 클래스를 추가합니다.

  [WebService(Namespace = "http://test.com")]
  [WebServiceBinding(ConformsTo = WsiProfiles.BasicProfile1_1)]
  public class HelloService : System.Web.Services.WebService
  {
    public HelloService()
    {
    }

    [WebMethod]
    public string HelloWorld()
    {
      return "Hello World";
    }
  }

7. 마지막으로, 6번 과정에서 정의된 서비스를 호스팅하는 코드를 Main에 작성합니다. 기본적으로 아래와 같이 경로에 포트를 명시하지 않으면 8081 포트에서 대기를 하게 됩니다. 이때, SoapReceivers.Add의 인자로 HTTP 주소 방식을 사용할 수 없습니다. 왜냐하면, WSE 3.0은 HTTP.sys와의 직접적인 통합을 제공하지 않기 때문입니다.

    static void Main(string[] args)
    {
      Uri listenAddress = new Uri("soap.tcp://localhost/HelloService");
      SoapReceivers.Add(new EndpointReference(listenAddress),
        typeof(HelloService));

      Console.WriteLine("Press any key to exit...");
      Console.ReadLine();
    }

여기까지, 여러분들은 WSE 3.0을 이용해서 웹 서비스를 Console 응용 프로그램에서 호스팅하는 서버를 만든 것입니다. 이제 이렇게 Console 안에서 정의된 서비스를 이용하는 클라이언트 프로그램을 제작해 보도록 하겠습니다.





[WSE 3.0 클라이언트 제작]

1. 클라이언트용 콘솔 프로젝트를 새로 생성합니다. 여기서는 프로젝트 명을 "WSE30Consumer"라고 예를 들겠습니다.

2. 웹 서비스를 사용하는 것이니, 당연히 WSDL을 구할 수 있다면 좋겠지만, 지금 설명하는 방식은 SOAP 프로토콜을 사용한 TCP 통신을 구현한 것이기 때문에, 일반적인 wsdl.exe로는 코드 생성을 할 수 없고 반드시 WSE 3.0에서 제공되는 wsewsdl3.exe라는 툴을 사용해서 소스 생성을 해야 합니다. 다음은 그 예입니다.

C:\Program Files\Microsoft WSE\v3.0\Tools>WseWsdl3.exe /type:webClient soap.tcp://localhost/HelloService
Web Services Enhancements 3.0 for Microsoft .NET.
 Copyright (c) Microsoft Corporation.

Microsoft (R) Web Services Description Language Utility
[Microsoft (R) .NET Framework, Version 2.0.50727.42]
Copyright (C) Microsoft Corporation. All rights reserved.
Writing file 'C:\Program Files\Microsoft WSE\v3.0\Tools\HelloService.cs'.


3. 생성된 helloService.cs 파일을 WSE30Consumer 프로젝트에 포함시키고, 다음의 3가지 DLL을 참조 추가합니다.

  • Microsoft.Web.Services3
  • System.Web.Services
  • System.Web

4. Program.cs 파일에 테스트를 위한 코드를 다음과 같이 작성합니다.

    static void Main(string[] args)
    {
      HelloService service = new HelloService();
      Console.WriteLine("Connect to " + service.Url);
      Console.WriteLine(service.HelloWorld());
    }

5. 마지막으로 컴파일 시킨 다음, 서버 및 클라이언트를 실행시키면 정상적으로 동작하는 것을 확인할 수 있습니다.



2. WCF 콘솔 서비스와 클라이언트 제작

WSE 3.0은 정식 버전이 나와 있는 상태이기 때문에 현재 사용하는 것에 무리는 없지만, 역시나 그 보다 더 나은 환경이 WCF에서 제공되기 때문에 .NET 3.0 런타임 및 RC2라는 부담이 없다면 고려해 보는 것도 좋을 것 같습니다.

[WCF 콘솔 서비스 제작]

1. WCF 서버 응용 프로그램을 제작하기 위해서는 최소한 .NET 3.0 Runtime이 설치되어져 있어야 합니다. 다음의 토픽을 참고해서 다운로드 받으십시오.

Vista 5728 관련 .NET 3.0 다운로드 (2006-10-17)
; http://www.microsoft.com/downloads/details.aspx?FamilyId=C6636E90-26E6-44E0-8780-5D3CCD3D94ED&displaylang=en

2. 서비스를 호스팅해주는 Console 프로젝트를 생성합니다. 여기서는 "WcfConsole"이라고 짓겠습니다.

3. "System.ServiceModel" 어셈블리를 참조 추가합니다.

4. "Program.cs" 파일에 "using System.ServiceModel;" 문을 추가합니다.

5. 아래와 같이 "Program.cs" 파일에 WCF 서비스 클래스를 추가합니다.

  [ServiceContract(Namespace = "http://www.wcftest.com/")]
  public interface IHelloWorld
  {
    [OperationContract]
    string HelloWorld();
  }

  [ServiceBehavior]
  public class CHelloWorld : IHelloWorld
  {
    public string HelloWorld()
    {
      return "Hello World";
    }
  }
  

6. Main 함수에 WCF 호스팅 코드를 추가합니다.

    static void Main(string[] args)
    {
      using (ServiceHost serviceHost = new ServiceHost(typeof(CHelloWorld)))
      {
        serviceHost.Open();
        Console.ReadLine();
        serviceHost.Close();
      }
    }

7. 마지막으로, "Application Configuration File", 즉 "app.config" 파일을 추가하고 다음의 내용을 추가하고 빌드합니다.

<?xml version="1.0" encoding="utf-8" ?>
<configuration>

  <system.serviceModel>
    
    <services>
      <service 
         name="WcfConsole.IHelloWorld"
         behaviorConfiguration="HelloWorldBehavior">
        <host>
          <baseAddresses>
            <add baseAddress="http://localhost:9091/HelloService"/>
          </baseAddresses>
        </host>
        <endpoint address=""
           binding="basicHttpBinding"
           contract="WcfConsole.IHelloWorld" />

        <endpoint address="mex"
                 binding="mexHttpBinding"
                 contract="IMetadataExchange" />
      </service>
    </services>

    <behaviors>
      <serviceBehaviors>
        <behavior name="HelloWorldBehavior">
          <serviceMetadata httpGetEnabled="True"/>
        </behavior>
      </serviceBehaviors>
    </behaviors>
    
  </system.serviceModel>

</configuration>





[WCF 클라이언트 제작]

1. WCF 클라이언트를 위해 이번에도 Console 프로젝트를 하나 추가합니다. 여기서는 "WcfConsumer"라고 이름 짓겠습니다.

2. 여기서부터 WCF와 WSE 3.0의 차이가 발생하게 됩니다. WSE 3.0에서는 Console에서 호스팅하는 경우 직접적으로 wsdl.exe와 같은 코드 생성 툴로는 소스 생성을 할 수 없었습니다. 하지만, WCF에서는 자체적으로 WSDL까지도 제공해주기 때문에 wsdl.exe뿐만 아니라 VS.NET 통합환경에서의 "웹 참조"까지도 가능합니다.

위의 "WcfConsole" 프로젝트의 App.Config에서 "IHelloWorld" 서비스에 대한 서비스 노출을 "http://localhost:9091/HelloService"에서 한다고 설정을 했으니, "웹 참조 주소" 창에는 당연히 그 주소를 넣으면 웹 참조를 통한 소스 생성이 가능합니다.

WSE 3.0 설정 대화창

3. "웹 참조"를 했으므로, 소스가 자동으로 생성되어지고 "Program.cs"에 다음과 같이 코드를 추가하면 됩니다.

    static void Main(string[] args)
    {
      MyService.CHelloWorld svc = new WcfConsumer.MyService.CHelloWorld();
      Console.WriteLine(svc.HelloWorld());
    }



첨부된 압축 파일을 해제하면 다음과 같은 예제 프로젝트들이 들어 있습니다.

WSE 3.0 설정 대화창





[이 토픽에 대해서 여러분들과 의견을 공유하고 싶습니다. 틀리거나 미흡한 부분 또는 의문 사항이 있으시면 언제든 댓글 남겨주십시오.]

[연관 글]






[최초 등록일: ]
[최종 수정일: 6/22/2021]

Creative Commons License
이 저작물은 크리에이티브 커먼즈 코리아 저작자표시-비영리-변경금지 2.0 대한민국 라이센스에 따라 이용하실 수 있습니다.
by SeongTae Jeong, mailto:techsharer at outlook.com

비밀번호

댓글 작성자
 



2006-11-07 06시48분
[정준명] 오, 다이어그램 직접 그리신건가요? 너무나 미려한데요 ^^;
[guest]
2006-11-07 09시00분
설마 제가 이런 그림을... ^^; Visual Studio Team System에서 제공되는 배포 다이어그램에서 제공되는 다이어그램들입니다. 그냥 이런 식으로 표현할 때 쓰는 것도 좋겠다는 생각이 들어서 적용해 보았습니다. ^^
kevin25
2007-03-21 11시49분
[초보] [WebServiceBinding(ConformsTo = WsiProfiles.BasicProfile1_1)] 가 무슨 의미인지 아시는지요... 무조건 쓰는건지... 이게 무엇을 하는 역할인지 알려주실 수 있으신지요..^^ 좋은 하루 되세요.
[guest]
2007-03-22 12시16분
딱히 적절한 표현을 찾기 위해 웹 검색을 해보니, "WS-I Basic Profile은 웹 서비스가 서로 호환되도록 하는 권장 사항이 들어 있는 사양입니다."라는 표현이 가장 쉬운 듯하군요. ^^ 만약 이를 벗어나게 되면 다른 플랫폼(대표적인 예를 들어 "자바")과의 상호 웹 서비스 호출에 대한 보장을 할 수 없습니다.

[참조] https://docs.microsoft.com/en-us/previous-versions/ms181876(v=vs.80)
kevin25

... 106  107  [108]  109  110  111  112  113  114  115  116  117  118  119  120  ...
NoWriterDateCnt.TitleFile(s)
11225정성태6/19/201715723오류 유형: 400. Outlook - The required file ExSec32.dll cannot be found in your path. Install Microsoft Outlook again.
11224정성태6/13/201718211.NET Framework: 661. Json.NET의 DeserializeObject 수행 시 속성 이름을 동적으로 바꾸는 방법파일 다운로드1
11223정성태6/12/201716841개발 환경 구성: 318. WCF Service Application과 WCFTestClient.exe
11222정성태6/10/201720574오류 유형: 399. WCF - A property with the name 'UriTemplateMatchResults' already exists.파일 다운로드1
11221정성태6/10/201717562오류 유형: 398. Fakes - Assembly 'Jennifer5.Fakes' with identity '[...].Fakes, [...]' uses '[...]' which has a higher version than referenced assembly '[...]' with identity '[...]'
11220정성태6/10/201722921.NET Framework: 660. Shallow Copy와 Deep Copy [1]파일 다운로드2
11219정성태6/7/201718247.NET Framework: 659. 닷넷 - TypeForwardedFrom / TypeForwardedTo 특성의 사용법
11218정성태6/1/201721074개발 환경 구성: 317. Hyper-V 내의 VM에서 다시 Hyper-V를 설치: Nested Virtualization
11217정성태6/1/201716947오류 유형: 397. initerrlog: Could not open error log file 'C:\...\MSSQL12.MSSQLSERVER\MSSQL\Log\ERRORLOG'
11216정성태6/1/201719061오류 유형: 396. Activation context generation failed
11215정성태6/1/201720018오류 유형: 395. 관리 콘솔을 실행하면 "This app has been blocked for your protection" 오류 발생 [1]
11214정성태6/1/201717710오류 유형: 394. MSDTC 서비스 시작 시 -1073737712(0xC0001010) 오류와 함께 종료되는 문제 [1]
11213정성태5/26/201722520오류 유형: 393. TFS - The underlying connection was closed: Could not establish trust relationship for the SSL/TLS secure channel.
11212정성태5/26/201721844오류 유형: 392. Windows Server 2016에 KB4019472 업데이트가 실패하는 경우
11211정성태5/26/201720867오류 유형: 391. BeginInvoke에 전달한 람다 함수에 CS1660 에러가 발생하는 경우
11210정성태5/25/201721321기타: 65. ActiveX 없는 전자 메일에 사용된 "개인정보 보호를 위해 암호화된 보안메일"의 암호화 방법
11209정성태5/25/201768270Windows: 143. Windows 10의 Recovery 파티션을 삭제 및 새로 생성하는 방법 [16]
11208정성태5/25/201727993오류 유형: 390. diskpart의 set id 명령어에서 "The specified type is not in the correct format." 오류 발생
11207정성태5/24/201728325Windows: 142. Windows 10의 복구 콘솔로 부팅하는 방법
11206정성태5/24/201721601오류 유형: 389. DISM.exe - The specified image in the specified wim is already mounted for read/write access.
11205정성태5/24/201721280.NET Framework: 658. C#의 tail call 구현은? [1]
11204정성태5/22/201730819개발 환경 구성: 316. 간단하게 살펴보는 Docker for Windows [7]
11203정성태5/19/201718746오류 유형: 388. docker - Host does not exist: "default"
11202정성태5/19/201719812오류 유형: 387. WPF - There is no registered CultureInfo with the IetfLanguageTag 'ug'.
11201정성태5/16/201722588오류 유형: 386. WPF - .NET 3.5 이하에서 TextBox에 한글 입력 시 TextChanged 이벤트의 비정상 종료 문제 [1]파일 다운로드1
11200정성태5/16/201719393오류 유형: 385. WPF - 폰트가 없어 System.IO.FileNotFoundException 예외가 발생하는 경우
... 106  107  [108]  109  110  111  112  113  114  115  116  117  118  119  120  ...