Headers vs. Properties

Quando escrevemos serviços WCF tanto do lado do cliente quanto do lado serviço, temos a disposição uma classe chamada OperationContext que, como o próprio nome diz, fornece acesso ao contexto da requisição atual através de uma propriedade estática chamada Current.

A partir desta propriedade podemos manipular a coleção de headers e properties (IncomingMessageHeaders, IncomingMessageProperties, OutgoingMessageHeaders e OutgoingMessageProperties) de entrada e saída. Cada uma dessas coleções tem finalidades diferentes. Os headers existentes em uma mensagem estão associados com o corpo da mesma e influenciarão no processamento dela, já que podem armazenar informações de correlação, transações, segurança, mensagens confiáveis, etc., tudo de acordo com as especificações WS-*, ou seja, esses headers são utilizados pela própria infraestrutura do WCF e ultrapassam possíveis intermediários, chegando até o seu destino final.

Já as properties são utilizadas “localmente”, não ultrapassando esses intermediários. O próprio WCF já utiliza isso em alguns casos como, por exemplo, nos protocolos existentes e suportados por ele. Caso o transporte seja realizado através do protocolo HTTP, os detalhes específicos da requisição/protocolo (HTTP Headers) são armazenados na coleção de properties, “fora” da mensagem. Se efetuarmos o tracing, podemos ver o seguinte resultado:

<MessageLogTraceRecord>
  <HttpRequest>
    <Method>POST</Method>
    <QueryString></QueryString>
    <WebHeaders>
      <AlgumaChave>AlgumValor</AlgumaChave>
      <SOAPAction>http://www.projetando.net/IUsuario/Adicionar</SOAPAction&gt;
      <Connection>Keep-Alive</Connection>
      <Content-Length>411</Content-Length>
      <Content-Type>text/xml; charset=utf-8</Content-Type>
      <Expect>100-continue</Expect>
      <Host>projetando.net</Host>
    </WebHeaders>
  </HttpRequest>
  <s:Envelope>
    <s:Header>
      <ActivityId>6269eb97-955f-4e4c-8477-e6379127de2f</ActivityId>
      <To>http://www.projetando.net/usuarios</To&gt;
      <Action>http://www.projetando.net/IUsuario/Adicionar</Action&gt;
    </s:Header>

    <s:Body>
      <Adicionar xmlns=”http://www.projetando.net“>
        <nome>Israel</nome>
        <email>israel@projetando.net</email>
      </Adicionar>
    </s:Body>
  </s:Envelope>
</MessageLogTraceRecord>

O que temos em vermelho são as properties relacionadas ao protocolo HTTP, mais precisamente aos HTTP Headers. Note que o elemento em negrito trata-se de um valor customizado que foi adicionado a esta coleção. O conteúdo em azul são os headers referentes a mensagem.