다음을 통해 공유

기본 메시지 계약

기본 메시지 계약 샘플은 사용자 지정 사용자 정의 메시지가 서비스 작업으로 전달되는 서비스를 보여 줍니다. 이 샘플은 계산기 인터페이스를 형식화된 서비스로 구현하는 시작 에 기반합니다. 시작에 사용되는 추가, 빼기, 곱하기 및 나누기를 위한 개별 서비스 작업 대신 이 샘플은 피연산자와 연산자를 모두 포함하는 사용자 지정 메시지를 전달하고 산술 계산의 결과를 반환합니다.

클라이언트는 콘솔 프로그램(.exe)이며 서비스 라이브러리(.dll)는 IIS(인터넷 정보 서비스)에서 호스팅됩니다. 클라이언트 작업은 콘솔 창에 표시됩니다.

비고

이 샘플에 대한 설치 절차 및 빌드 지침은 이 항목의 끝에 있습니다.

서비스에서는 형식 MyMessage의 사용자 지정 메시지를 수락하고 반환하는 단일 서비스 작업이 정의됩니다. 이 샘플에서 요청 및 응답 메시지는 동일한 형식이지만 필요한 경우 메시지 계약이 다를 수 있습니다.

[ServiceContract(Namespace="http://Microsoft.ServiceModel.Samples")]
public interface ICalculator
{
    [OperationContract(Action="http://test/MyMessage_action",
                  ReplyAction="http://test/MyMessage_action")]
    MyMessage Calculate(MyMessage request);
}

사용자 지정 메시지 MyMessage는 MessageContractAttribute, MessageHeaderAttribute, 및 MessageBodyMemberAttribute 특성이 주석으로 추가된 클래스에 정의됩니다. 이 샘플에서는 세 번째 생성자만 사용됩니다. 메시지 계약을 사용하면 SOAP 메시지를 완전히 제어할 수 있습니다. 이 샘플에서 MessageHeaderAttribute 특성은 Operation 을 SOAP 헤더에 넣는 데 사용됩니다. 피연산자 N1, N2, 및 Result는 MessageBodyMemberAttribute 속성이 적용되어 SOAP 본문 내에 나타납니다.

[MessageContract]
public class MyMessage
{
    private string operation;
    private double n1;
    private double n2;
    private double result;

    //Constructor - create an empty message.

    public MyMessage() {}

    //Constructor - create a message and populate its members.

    public MyMessage(double n1, double n2, string operation,
                     double result)
    {
        this.n1 = n1;
        this.n2 = n2;
        this.operation = operation;
        this.result = result;
    }

    //Constructor - create a message from another message.

    public MyMessage(MyMessage message)
    {
        this.n1 = message.n1;
        this.n2 = message.n2;
        this.operation = message.operation;
        this.result = message.result;
    }

    [MessageHeader]
    public string Operation
    {
        get { return operation; }
        set { operation = value; }
    }

    [MessageBodyMember]
    public double N1
    {
        get { return n1; }
        set { n1 = value; }
    }

    [MessageBodyMember]
    public double N2
    {
        get { return n2; }
        set { n2 = value; }
    }

    [MessageBodyMember]
    public double Result
    {
        get { return result; }
        set { result = value; }
    }
}

구현 클래스에는 서비스 작업에 대한 코드가 Calculate 포함되어 있습니다. 클래스는 CalculateService 요청 메시지에서 피연산자와 연산자를 가져오고 다음 샘플 코드와 같이 요청된 계산의 결과를 포함하는 응답 메시지를 만듭니다.

// Service class which implements the service contract.
public class CalculatorService : ICalculator
{
    // Perform a calculation.

    public MyMessage Calculate(MyMessage request)
    {
        MyMessage response = new MyMessage(request);
        switch (request.Operation)
        {
            case "+":
                response.Result = request.N1 + request.N2;
                break;
            case "-":
                response.Result = request.N1 - request.N2;
                break;
            case "*":
                response.Result = request.N1 * request.N2;
                break;
            case "/":
                response.Result = request.N1 / request.N2;
                break;
            default:
                response.Result = 0.0D;
                break;
        }
        return response;
    }
}

클라이언트에 대해 생성된 클라이언트 코드는 ServiceModel 메타데이터 유틸리티 도구(Svcutil.exe) 도구를 사용하여 만들어졌습니다. 이 도구는 필요한 경우 생성된 클라이언트 코드에 메시지 계약 형식을 자동으로 만듭니다. /messageContract 메시지 계약을 강제로 생성하도록 명령 옵션을 지정할 수 있습니다.

svcutil.exe /n:"http://Microsoft.ServiceModel.Samples,Microsoft.ServiceModel.Samples" /o:client\generatedClient.cs http://localhost/servicemodelsamples/service.svc/mex

다음 샘플 코드는 클라이언트가 MyMessage 메시지를 사용하는 방법을 보여 줍니다.

// Create a client with given client endpoint configuration
CalculatorClient client = new CalculatorClient();

// Perform addition using a typed message.

MyMessage request = new MyMessage()
                    {
                        N1 = 100D,
                        N2 = 15.99D,
                        Operation = "+"
                    };
MyMessage response = ((ICalculator)client).Calculate(request);
Console.WriteLine("Add({0},{1}) = {2}", request.N1, request.N2, response.Result);

샘플을 실행하면 계산이 클라이언트 콘솔 창에 표시됩니다. 클라이언트 창에서 Enter 키를 눌러 클라이언트를 종료합니다.

Add(100,15.99) = 115.99
Subtract(145,76.54) = 68.46
Multiply(9,81.25) = 731.25
Divide(22,7) = 3.14285714285714

Press <ENTER> to terminate client.

이 시점에서 사용자 지정 사용자 정의 메시지는 클라이언트와 서비스 작업 간에 전달되었습니다. 메시지 계약은 피연산자와 결과가 메시지 본문에 있고 연산자가 메시지 헤더에 있음을 정의했습니다. 이 메시지 구조를 관찰하도록 메시지 로깅을 구성할 수 있습니다.

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

  1. Windows Communication Foundation 샘플 에 대한One-Time 설정 절차를 수행했는지 확인합니다.

  2. 솔루션의 C# 또는 Visual Basic .NET 버전을 빌드하려면 Windows Communication Foundation 샘플빌드의 지침을 따릅니다.

  3. 단일 또는 컴퓨터 간 구성에서 샘플을 실행하려면 Windows Communication Foundation 샘플실행의 지침을 따릅니다.

  • Last updated on