내보내기(0) 인쇄
모두 확장

2단계:서비스 버스에서 사용할 REST 기반 WCF 서비스 계약 정의

업데이트 날짜: 2014년 6월

이 항목에서는 기본적인 Service Bus용 REST 스타일 서비스를 만드는 데 필요한 네 가지 작업 중 두 번째 작업을 설명합니다.네 가지 작업 모두에 대한 개요는 Service Bus REST 자습서를 참조하십시오.

다른 Service Bus 서비스와 마찬가지로 REST 스타일 서비스를 만들 때도 계약을 정의해야 합니다.이 계약에서 호스트가 지원하는 작업이 지정됩니다.서비스 작업은 웹 서비스 메서드로 생각할 수 있습니다.C++, C# 또는 Visual Basic 인터페이스를 정의하여 계약을 만듭니다.인터페이스의 각 메서드는 특정 서비스 작업에 해당합니다.각 인터페이스에는 ServiceContractAttribute 특성을 적용해야 하며, 각 작업에는 OperationContractAttribute 특성을 적용해야 합니다.ServiceContractAttribute를 포함하는 인터페이스의 메서드에 OperationContractAttribute가 없는 경우 해당 메서드는 표시되지 않습니다.이러한 작업에 사용되는 코드는 절차 다음에 이어지는 예제에서 제공됩니다.

기본 Service Bus 계약과 REST 스타일 계약의 기본적인 차이점은 OperationContractAttribute:WebGetAttribute에 속성이 추가된다는 것입니다. 이 속성을 통해 인터페이스의 메서드를 인터페이스 반대쪽의 메서드에 매핑할 수 있습니다.여기서는 WebGetAttribute를 사용하여 메서드를 HTTP GET에 연결합니다.그러면 Service Bus에서 인터페이스로 보내는 명령을 정확하게 검색하고 해석할 수 있습니다.

예상 소요 시간:10분.

  1. 시작 메뉴에서 Visual Studio를 마우스 오른쪽 단추로 클릭하고 관리자 권한으로 실행을 선택하여 프로그램을 관리자 권한으로 엽니다.

  2. 새 콘솔 응용 프로그램 프로젝트를 만듭니다.파일 메뉴를 클릭하고 새로 만들기, 프로젝트를 선택합니다.새 프로젝트 대화 상자에서 Visual C#을 선택합니다. Visual C#이 표시되지 않으면 다른 언어 아래를 확인합니다. 그런 다음 콘솔 응용 프로그램 템플릿을 선택하고 이름을 ImageListener로 지정합니다.기본 위치를 사용합니다.확인을 클릭하여 프로젝트를 만듭니다.

  3. C# 프로젝트의 경우 Visual Studio에서는 Program.cs라는 파일을 만듭니다.이 클래스는 Main()이라는 빈 메서드를 포함합니다. 콘솔 응용 프로그램 프로젝트를 올바르게 빌드하려면 이 메서드가 필요합니다.따라서 이 메서드는 프로젝트 내에 그대로 두어도 안전합니다.

  4. System.ServiceModel.dll에 대한 참조를 프로젝트에 추가합니다.

    1. 솔루션 탐색기에서 프로젝트 폴더 아래의 참조 폴더를 마우스 오른쪽 단추로 클릭한 다음 참조 추가를 클릭합니다.

    2. 참조 추가 대화 상자에서 .NET 탭을 선택한 후 아래로 스크롤하여 System.ServiceModel이 표시되면 선택합니다.그런 다음 확인을 클릭합니다.

    note참고
    Csc.exe와 같은 명령줄 컴파일러를 사용할 때는 어셈블리 경로도 제공해야 합니다.예를 들어 을 실행하는 컴퓨터의 기본 경로는Windows\Microsoft.NET\Framework\v3.0\Windows Communication Foundation입니다.

  5. 이전 단계를 반복하여 System.ServiceModel.Web.dll 어셈블리에 대한 참조를 추가합니다.

  6. System.ServiceModel, System.ServiceModel.Channels, System.ServiceModel.WebSystem.IO 네임스페이스에 대한 using 문을 추가합니다.

    using System.ServiceModel;
    using System.ServiceModel.Channels;
    using System.ServiceModel.Web;
    using System.IO;
    
    

    System.ServiceModel은 WCF(Windows Communication Foundation)의 기본 기능에 프로그래밍 방식으로 액세스할 수 있도록 하는 네임스페이스입니다. Service Bus에서는 WCF의 개체와 특성을 많이 사용하여 서비스 계약을 정의합니다.대부분의 Service Bus 응용 프로그램에서 이 네임스페이스를 사용하게 됩니다.마찬가지로 System.ServiceModel.Channels를 사용하면 채널을 정의할 수 있습니다. 채널은 Service Bus 및 클라이언트 웹 브라우저와 통신하는 데 사용되는 개체입니다.마지막으로, System.ServiceModel.Web은 웹 기반 응용 프로그램을 만들 수 있도록 하는 형식을 포함합니다.

  7. 프로그램의 네임스페이스 이름을 Visual Studio 기본값에서 Microsoft.ServiceBus.Samples로 바꿉니다.

    namespace Microsoft.ServiceBus.Samples
    {
    ...
    
    
  8. 네임스페이스 선언 바로 뒤에 IImageContract라는 새 인터페이스를 정의하고, 네임스페이스 값을 http://samples.microsoft.com/ServiceModel/Relay/로 지정하여 ServiceContractAttribute 특성을 인터페이스에 적용합니다.이 네임스페이스의 값은 코드 범위 전체에서 사용하는 네임스페이스와 다릅니다.여기서 네임스페이스 값은 이 계약의 고유 식별자로 사용되며 버전 정보를 포함해야 합니다.자세한 내용은 TechNet의, 서비스 버전 관리를 참조하십시오.네임스페이스를 명시적으로 지정하면 기본 네임스페이스 값이 계약 이름에 추가되지 않습니다.

    [ServiceContract(Name = "ImageContract", Namespace = "http://samples.microsoft.com/ServiceModel/Relay/RESTTutorial1")]
    public interface IImageContract
    {
    }
    
    
  9. IImageContract 인터페이스 내에서 IImageContract 계약이 인터페이스에 표시하는 단일 작업에 대한 메서드를 선언하고 공용 Service Bus 계약의 일부분으로 표시할 메서드에 대해 OperationContractAttribute 특성을 적용합니다.

    public interface IImageContract
    {
        [OperationContract]
        Stream GetImage();
    }
    
  10. OperationContract 특성 옆에 WebGet 특성을 적용합니다.

    
    public interface IImageContract
    {
        [OperationContract, WebGet]
        Stream GetImage();
    }
    

    이렇게 하면 Service Bus가 HTTP GET 요청을 GetImage로 라우팅하고 GetImage의 반환 값을 HTTP GETRESPONSE 회신으로 변환합니다.이 자습서 뒷부분에서 웹 브라우저를 사용하여 이 메서드에 액세스한 다음 브라우저에 이미지를 표시할 것입니다.

  11. IImageContract 정의 바로 아래에 IImageContractIClientChannel 인터페이스에서 모두 상속하는 채널을 선언합니다.

    [ServiceContract(Name = "IImageContract", Namespace = "http://samples.microsoft.com/ServiceModel/Relay/")]
    public interface IImageContract
    {
        [OperationContract, WebGet]
        Stream GetImage();
    }
    
    public interface IImageChannel : IImageContract, IClientChannel { }
    

    채널은 서비스와 클라이언트가 서로 정보를 전달하는 데 사용하는 WCF 개체입니다.나중에 호스트 응용 프로그램에 채널을 생성하면 Service Bus가 이 채널을 사용하여 브라우저에서 GetImage 구현으로 HTTP GET 요청을 전달합니다. 또한 Service Bus는 이 채널을 사용하여 GetImage 반환 값을 가져와 클라이언트 브라우저용 HTTP GETRESPONSE로 변환합니다.

  12. 빌드 메뉴에서 솔루션 빌드를 클릭하여 작업이 정확한지 확인합니다.

예제

다음 코드 예제에는 Service Bus 계약을 정의하는 기본 인터페이스가 나와 있습니다.

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.ServiceModel;
using System.ServiceModel.Channels;
using System.ServiceModel.Web;
using System.IO;

namespace Microsoft.ServiceBus.Samples
{

    [ServiceContract(Name = "IImageContract", Namespace = "http://samples.microsoft.com/ServiceModel/Relay/")]
    public interface IImageContract
    {
        [OperationContract, WebGet]
        Stream GetImage();
    }

    public interface IImageChannel : IImageContract, IClientChannel { }

    class Program
    {
        static void Main(string[] args)
        {
        }
    }
}

이제 인터페이스가 생성되었으므로 3단계: Service Bus를 사용하도록 REST 기반 WCF 서비스 계약 구현를 계속 진행하여 인터페이스를 구현합니다.

참고 항목

표시:
© 2014 Microsoft