Partilhar via

Como: Criar um contrato de solicitação-resposta

  • Artigo

Um contrato solicitação-resposta especifica um método que retorna uma resposta. A resposta deve ser enviada e correlacionada com o pedido nos termos do presente contrato. Mesmo se o método não retorna nenhuma resposta (void em C# ou um Sub em Visual Basic), a infraestrutura cria e envia uma mensagem vazia para o chamador. Para evitar o envio de uma mensagem de resposta vazia, use um contrato unidirecional para a operação.

Para criar um contrato solicitação-resposta

  1. Crie uma interface na linguagem de programação de sua escolha.

  2. Aplique o ServiceContractAttribute atributo à interface.

  3. Aplique o OperationContractAttribute atributo a cada método que os clientes podem invocar.

  4. Opcional. Defina o IsOneWay valor da propriedade como true para impedir o envio de uma mensagem de resposta vazia. Por padrão, todas as operações são contratos de solicitação-resposta.

Exemplo

O exemplo a seguir define um contrato para um serviço de calculadora que fornece Add e Subtract métodos. O Multiply método não faz parte do contrato porque não é marcado pela OperationContractAttribute classe e, portanto, não é acessível aos clientes.

using System.ServiceModel;

[ServiceContract]
public interface ICalculator
{
    [OperationContract]
    // It would be equivalent to write explicitly:
    // [OperationContract(IsOneWay=false)]
    int Add(int a, int b);

    [OperationContract]
    int Subtract(int a, int b);

    int Multiply(int a, int b)
}

  • Para obter mais informações sobre como especificar contratos de operação, consulte a OperationContractAttribute classe e a IsOneWay propriedade.

  • A aplicação dos ServiceContractAttribute atributos e OperationContractAttribute causa a geração automática de definições de contrato de serviço em um documento WSDL (Web Services Description Language) depois que o serviço é implantado. O documento é baixado anexando ?wsdl ao endereço base HTTP do serviço. Por exemplo, http://microsoft/CalculatorService?wsdl

Consulte também