Disponibilizar Serviços WCF em JSON

Vimos, no artigo anterior, como expor os dados da nossa base de dados (BD) como coleções de instâncias através do protocolo OData, recorrendo a um projeto WCF Service Application e ao Entity Framework.

O OData baseia-se em protocolos standard para oferecer serviços de dados interoperáveis com aplicações que não usam a framework .Net. Como é baseado em URIs standard para aceder aos dados, podemos aceder e alterar dados usando a semantica REST (Representational State Transfer), como sejam os verbos GET, PUT, POST e DELETE. Isto possibilita a utilização destes serviços a partir de qualquer cliente que possa aceder a dados transmitidos sobre protocolo HTTP standard.

Um serviço OData pode representar dados no formato Atom, JSON (JavaScript Object Notation) e XML, sendo que Atom é o formato por omissão.
O formato dos dados é especificado no header do pedido HTTP.

É bastante fácil acrescentar serviços customizados a serviços de dados WCF, através de Service Operations.
Service Operations são métodos disponibilizados num servidor e que podem ser acedidos por URIs da mesma forma que os recursos de dados vistos anteriormente.
Service Operations podem também usar expressões de query para filtrar, ordenar e paginar os dados resultado da invocação de uma operação.

Vamos, neste artigo, ver como podemos disponibilizar Service Operations, em formato OData, SOAP e JSON.

Criar Modelo de dados EntityFramework e Serviços WCF a partir da Base de Dados

Neste artigo vamos ver como, tendo uma base de dados (BD) previamente criada, podemos obter o modelo de dados para o EntityFramework e um conjunto de serviços de dados WCF (Windows Communication Foundation) o qual pode depois ser usado por uma aplicação Web ou para obter dados da BD via OData.

O nosso exemplo, para uma aplicação de aluguer de automóveis, vai utilizar uma BD SQL Server com o seguinte esquema relacional:

Vamos, então, começar por criar um novo projeto, no Visual Studio 2012, de tipo WCF Service Application (damos-lhe o nome WcfRentACarService):

Começar a usar o .Net Entity Framework - 3

Este artigo ilustra a utilização do ADO.Net Entity Framework na criação, actualização e eliminação de registos de dados.

Este artigo vem na sequência de:

     - Começar a usar o .Net Entity Framework – 1, e

     - Começar a usar o .Net Entity Framework – 2, 

onde vimos como criar um modelo de dados (ADO.Net Entity Data Model) a partir de uma base de dados já existente, e como usar esse modelo, num pequeno exemplo ilustrativo, para consulta da base de dados e preenchimento de uma comboBox.

Pegando no mesmo exemplo, acrescentámos à Form1 mais uma label, para visualizar o ID de cada registo, e uma caixa de texto, para podermos alterar o nome do país ou criar um novo país.

Foram também acrescentados botões para Criar Novo, Alterar e Apagar um país da tabela, e um botão Cancelar, que fecha a janela da aplicação.

Para começar, acrescentámos no handler que trata da selecção de uma nova linha da comboBox o código necessário para preencher a label (label1) com o ID do país, e a caixa de texto (paisTextBox) com o nome do país. Isto permite ao utilizador editar o nome actual de um país, para o poder alterar, ou inserir um novo nome, para criar um novo país na tabela.

        private void paisesBox1_SelectedIndexChanged(object sender, EventArgs e)

        {

            label1.Text = paisesBox1.SelectedValue.ToString();

            //paisTextBox.Text = paisesBox1.SelectedText;

            paisAtual = (Pais)paisesBox1.SelectedItem;

            paisTextBox.Text = paisAtual.nome;

        }

Começar a usar o .Net Entity Framework - 2

Depois de criado o projeto Windows Forms Application, e gerado o modelo de dados a partir da base de dados, vamos ver como podemos aceder à base de dados através do modelo, usando um pequeno exemplo ilustrativo.

No form Form1 criado automaticamente ao criar o projecto Windows Forms Application, vamos criar uma comboBox, arrastando a partir da toolbox. 

No separador de propriedades (Properties) mudemos-lhe o nome para viaturasBox1.

Começar a usar o .Net Entity Framework - 1

Este artigo ilustra a criação de um modelo Entity Framework e a sua utilização num pequeno programa em C# para ambiente Windows (Windows Forms Application).

Para implementar este exemplo é necessário ter o Visual Studio 2010 instalado (com o 2008 também deve funcionar), assim como a framework .Net 3.5 SP1 ou superior.

Para além disso, é necessário aceder a um serviço de base de dados, pelo que, como primeira abordagem, se aconselha a usar o Microsoft SQL Server 2008.

(Este exemplo foi atualizado para o .Net Framework 4.5, e utilizando o VS 2013)

1. O primeiro passo consiste em criar um novo projecto do tipo Windows Forms Application.

ADO.Net Entity Framework

O Entity Framework é um conjunto de tecnologias do ADO.NET que suportam o desenvolvimento de software orientado aos dados (data-oriented).

Tipicamente, hoje em dia, os programadores de aplicações orientadas aos dados efectuam a modelação das entidades e relacionamentos numa forma orientada por objectos, e depois têm que lidar com o formato em que têm que colocar essas entidades num motor de base de dados. Os dados podem ser fisicamente distribuídos por diversos sistemas de armazenamento e, mesmo as aplicações que trabalham com apenas um sistema de base de dados, têm que fazer compromissos entre o formato lógico dos dados modelados, presente no modelo, e o formato físico, fácil de manter e orientado a um acesso eficiente.

O Entity Framework permite aos programadores trabalharem com os dados no formato de objectos específicos do domínio, conforme modelado no modelo abstracto de dados, sem se preocuparem com as tabelas da base de dados onde os mesmos estão armazenados.

Com o Entity Framework, os programadores podem trabalhar a um nível de abstracção mais elevado do que quando têm que lidar directamente com os dados, e podem criar e manter aplicações orientadas aos dados com menos código do que em aplicações tradicionais.

Como o Entity Framework é um componente da .NET Framework, as aplicações que usam o Entity Framework podem correr em qualquer computador em que está instalada a framework .Net, acima da versão 3.5 SP1.

No próximo artigo veremos um pequeno exemplo de como usar o ADO.Net Entity Framework.


Outros artigos relacionados:
    - Começar a usar o .Net Entity Framework - 1
    - Começar a usar o .Net Entity Framework - 2