Integrando Adobe Flex - FluorineFx - C#.net (Parte 1/2)Categoria: C#.net, Flex, FluorineFx — Vinícius Sandim @ 12:32

[ Assista agora a palestra sobre este post realizada durante a Flex Mania 2009 ]Olá pessoal, hoje estou aqui para falar sobre a integração de três ótimos frameworks para desenvolvimento de aplicativos web atualmente:

Adobe FlexFluorineFxMicrosoft C#.net

IntroduçãoExistem diversas formas de integrar o Flex com nossa camada de dados, neste tutorial usarei a integração via RemoteObject utilizando o framework open source FluorineFx. Este tipo de método é em média 50% mais rápido do que outros métodos, como por exemplo via HTTP service, ou WebService. Veja um teste com outras formas de integração.

RequerimentosMicrosoft Visual Studio 2005 ou WebDeveloperExpress 2005FluorineFxAdobe Flex Builder 3

Vamos láTendo em mente que vc já possua os componentes necessários instalados vamos iniciar o tutorial.

1 - Crie uma pasta em um diretório de sua preferência com o nome de IntegracaoFlex.

2 - Dentro desta pasta, crie duas subpastas com os nomes Interface e Negocio.

3 - Crie um projeto no VisualStudio do tipo ASP.NET WebSite dentro da pasta Negocio:

4 - Exclua a pasta App_Data que foi criada automaticamente pelo template

5 - Renomeie o arquivo Default.aspx, criado automaticamente, para Gateway.aspx. Este servirá como ponte para o acesso dos objetos asp.net.

6 - Adicione uma pasta App_Code. (Botão direito do mouse sobre o projeto, Add ASP.NET Folder… > App_Code)

7 - Crie um arquivo do tipo Web.config. (Botão direito do mouse sobre o projeto, Add New Item… > Web Configuration File)

8 - Deixe o arquivo Web.config da seguinte forma:<?xml version="1.0"?>

<configuration>

<configSections>

<sectionGroup name="fluorinefx">

<section name="settings"

type="FluorineFx.Configuration.XmlConfigurator, FluorineFx"/>

</sectionGroup>

</configSections>

<system.web>

<httpModules>

<add name="FluorineGateway"

type="FluorineFx.FluorineGateway, FluorineFx"/>

</httpModules>

<compilation debug="true" />

</system.web>

</configuration>

Esta é a configuração mínima para que o Fluorine funcione.

9 - Agora crie uma referência do seu projeto ao FluorineFx. (Botão direito do mouse sobre o projeto, Add Reference…) :

Caso vc não tenha alterado a pasta de instalação do fluorine padrão é C:\Arquivos de programas\FluorineFx\Bin\net\2.010 - Crie uma classe chamada Pessoa.cs (Botão direito do mouse sobre a pasta App_Code, Add New Item… > Class):

11 - O seu Solution Explorer deverá ficar assim.

12 - Agora finalmente vamos implementar a classe Pessoa.cs:using System;

using FluorineFx;

using System.Collections.Generic;

namespace IntegracaoFlex

{

/// <summary>

/// Representa uma Pessoa.

/// </summary>

[RemotingService]

public class Pessoa

{

#region Atributos

private int _id_Pessoa;

/// <summary>

/// Id da Pessoa.

/// </summary>

public int Id_Pessoa

{

get { return _id_Pessoa; }

set { _id_Pessoa = value; }

}

private string _nome;

/// <summary>

/// Nome da Pessoa.

/// </summary>

public string Nome

{

get { return _nome; }

set { _nome = value; }

}

private string _telefone;

/// <summary>

/// Telefone da Pessoa.

/// </summary>

public string Telefone

{

get { return _telefone; }

set { _telefone = value; }

}

#endregion

#region Construtores

/// <summary>

/// Construtor padrão da classe.

/// </summary>

public Pessoa()

{

}

/// <summary>

/// Construtor que alimenta todos os atributos da classe.

/// </summary>

/// <param name="id_Pessoa">Id da Pessoa.</param>

/// <param name="nome">Nome da Pessoa.</param>

/// <param name="telefone">Telefone da Pessoa.</param>

public Pessoa(int id_Pessoa, string nome, string telefone)

{

this._id_Pessoa = id_Pessoa;

this._nome = nome;

this._telefone = telefone;

}

#endregion

#region Metodos

/// <summary>

/// Insere um novo cliente no banco de dados.

/// </summary>

/// <returns>Cliente inserido no banco de dados.</returns>

public string Insere(Pessoa _pessoa)

{

string _retorno = "--- Pessoa Inserida ---\n";

_retorno += "Id_Pessoa: " + _pessoa._id_Pessoa.ToString() + "\n";

_retorno += "Nome: " + _pessoa._nome + "\n";

_retorno += "Telefone: " + _pessoa._telefone;

return _retorno;

}

/// <summary>

/// Seleciona uma lista de pessoas no banco de dados.

/// </summary>

/// <returns>Lista de pessoas cadastradas.</returns>

public List<Pessoa> Lista()

{

List<Pessoa> _lista = new List<Pessoa>();

//Adiciona algumas pessoas para exemplificar

_lista.Add(new Pessoa(1, "Vinicius", "(16)3711-1111"));

_lista.Add(new Pessoa(5, "Cristian", "(16)3722-2222"));

_lista.Add(new Pessoa(9, "Juliano", "(16)3733-3333"));

_lista.Add(new Pessoa(15, "Ricardo", "(16)3744-4444"));

_lista.Add(new Pessoa(3, "Euripedes", "(16)3755-5555"));

return _lista;

}

#endregion

}

}

Note a tag [RemotingService] na declaração da classe, esta serve para que o Fluorine saiba que esta classe é remota e será acessada por um método do flex.

Bom pessoal, nesta primeira parte criamos o nosso projeto no Visual Studio o configuramos o Fluorine para que possamos chamar os métodos via flex.

No próximo tutorial iremos fazer o projeto no Flex chamar nossos métodos Insere e Lista do .net.

Agradeço a todos e até a próxima!

Integrando Adobe Flex - FluorineFx - C#.net (Parte 2/2)Categoria: C#.net, Flex, FluorineFx — Vinícius Sandim @ 14:47

[ Assista agora a palestra sobre este post realizada durante a Flex Mania 2009 ]Olá pessoal, hoje finalmente vou postar a segunda parte do artigo, neste post vamos utilizar os nossos métodos Insere e Lista, criados anteriormente no asp.net.

Então vamos lá…1 - Crie um projeto no Flex do tipo Flex Project e nomeie como IntegracaoFlex.

2 - Crie uma pasta chamada mapeamento dentro da pasta src do projeto. (Botão direito do mouse sobre a pasta src New>Folder). O Flex interpreta esta pasta como um package, é um conceito muito parecido com o das Namespaces no Visual Studio. Dentro desta pasta vamos mapear as nossas classes criadas no asp.net, como no nosso exemplo temos uma classe só, a Pessoa, vamos implementa-la.

3 - Crie uma nova classe dentro de nossa pasta/package mapeamento, dê o nome de Pessoa, este nome deve ser idêntico ao da classe criada anteriormente no asp.net. (Botão direito sobre a pasta mapeamento New>ActionScript Class), preencha apenas o campo Name com o valor Pessoa.

4 - Agora vamos implementar apenas os atributos da nossa classe criada no asp.net, portanto deixe a classe pessoa da seguinte maneira:package mapeamento

{

[RemoteClass(alias="IntegracaoFlex.Pessoa")]

public class Pessoa

{

private var _id_Pessoa:int;

public function get Id_Pessoa():int { return this._id_Pessoa; }

public function set Id_Pessoa(valor:int):void { this._id_Pessoa = valor; }

private var _nome:String;

public function get Nome():String { return this._nome; }

public function set Nome(valor:String):void { this._nome = valor; }

private var _telefone:String;

public function get Telefone():String { return this._telefone; }

public function set Telefone(valor:String):void { this._telefone = valor; }

public function Pessoa()

{

}

}

}

Desta forma temos a classe Pessoa com os atibutos Id_Pessoa, Nome e Telefone, note que o conceito para o desenvolvimento dos nossos atributos é muito parecido com a do C#.net, ou seja, temos as palavras reservadas get e set para que o complilador entenda que determinada function é um atributo da classe, e não uma function convencional.

Assim como no nome da classe, o nome dos atributos também devem ser idênticos no C#.net e no ActionScript, inclusive os tipos, para que o fluorine fa’xa a serialização C#.net>ActionScript corretamente. Veja mais na documentação oficial do fluorine a tabela completa de serialização.

5 - Agora vamos realmente fazer o mapeamento dos objetos ActionScript>C#.net, para isso, crie um arquivo XML dentro da pasta src do nosso projeto e dê o nome de services-config.xml (Botão direito do mouse sobre a pasta src New>File). Preencha o campo File name com o valor services-config.xml. Deixe o arquivo da seguinte maneira:<?xml version="1.0" encoding="UTF-8"?>

<services-config>

<services>

<service id="remoting-service"

class="flex.messaging.services.RemotingService"

messageTypes="flex.messaging.messages.RemotingMessage">

<destination id="fluorine">

<channels>

<channel ref="my-amf"/>

</channels>

<properties>

<source>*</source>

</properties>

</destination>

</service>

</services>

<channels>

<channel-definition id="my-amf" class="mx.messaging.channels.AMFChannel">

<endpoint uri="http://localhost:3024/Negocio/Gateway.aspx"

class="flex.messaging.endpoints.AMFEndpoint"/>

</channel-definition>

</channels>

</services-config>

Agora execute o seu website criado no VisualStudio anteriormente, ele deverá exibir a lista de arquivos encontrados, isso acontece por que não temos uma página Default.aspx, clique sobre a página Gateway.aspx no navegador, ele abrirá uma pagina em branco, pois não temos nada de interface na Gateway.aspx, o que precisamos agora é do endereço dessa página, copie na barra de endereços do navegador, deve ser algo parecido com (http://localhost:3024/Negocio/Gateway.aspx), o que vai alterar é apenas o número da porta gerado pelo servidor web do VisualStudio, e coloque o endereço na tag uri do atributo endpoint, para este endereço de sua página Gateway no arquivo XML criado agora.

6 - Agora para finalizarmos o mapeamento, precisamos informar ao compilador do Flex que a configuração de serviços remotos que utilizamos em nosso projeto é o arquivo services-config.xlm, para isso, vá até o Flex Navigator, clique com o botão direito do mouse sobre o projeto IntegracaoFlex>Properties, ele abrirá a janela de propriedades de seu projeto, vá até o menu

FlexCompiler e deixe o campo Additional compiler arguments com o seguinte valor:

-locale en_US -services services-config.xml7 - Pronto, o nosso projeto está configurado e vai enxergar a nossa classe no asp.net, agora vamos testar.

8 - Abra o arquivo principal de nosso projeto, o IntegracaoFlex.mxml e adicione uma tag <mx:Script></mx:Script>.

Dentro da tag importe os seguintes packages:import mx.collections.ArrayCollection;

import mx.rpc.remoting.mxml.RemoteObject;

import mx.rpc.events.ResultEvent;

import mx.rpc.events.FaultEvent;

import mx.controls.Alert;

import mapeamento.Pessoa;

Logo abaixo, crie duas functions:/**

* Prepara um objeto remoto para executar um método no asp.net.

**/

private function preparaRemoteObj(fncFalha:Function, fncOk:Function = null):RemoteObject{

//Instancia um objeto remoto pegando as configurações do nosso arquivo services-config.xml

var remoteObj:RemoteObject = new RemoteObject("fluorine"); //<destination id="fluorine">

remoteObj.source = "IntegracaoFlex.Pessoa"; // Namespace.NomeDaClasse no ASP.net

remoteObj.showBusyCursor = true; // Exibe o relogio no lugar do cursor durante a requisição

//Adiciona o evento falha na lista de eventos do ojeto remoto

remoteObj.addEventListener(FaultEvent.FAULT, fncFalha);

//Verifica se é null porque nem sempre um método vai retornar algum valor.

if (fncOk != null)

//Adiciona a funcao passada como parametro neste método,

//ela é responsável por tratar o retorno do método asp.net

remoteObj.addEventListener(ResultEvent.RESULT, fncOk);

return remoteObj; //retorna o objeto remoto configurado.

}

/**

* Tratamento de erro do método executado no asp.net.

**/

private function rstFalha(evt:FaultEvent):void{

Alert.show("Ocorreu o seguinte erro ao tentar executar o método:\n" +

evt.fault.message, "Erro");

}

A function preparaRemoteObj instancia um objeto do tipo RemoteObject e o configura para executar os métodos do asp.net. (vide comentários)

A function rstFalha trata um possível erro durante a chamada do método asp.net.TESTANDO O MÉTODO INSERE9 - Como vocês devem ter visto, por enquanto não executamos nenhum método do asp.net ainda, vamos fazer isto agora. Primeiramente vamos testar o método Insere criado anteriormente chamando-o em um evento click de um button, portanto adicione 3 componentes Label, 3 componentes TextInput e 1 componente Button. Renomeie os componentes da seguinte forma:

TextInputs: txtId_Pessoa, txtNome, txtTelefone

Button: btnInserir

10 - Agora vamos criar mais duas functions dentro de nossa tag <mx:Script></mx:Script>:/**

* Tratamento do retorno do método Insere executado no asp.net.

**/

private function rstSucessoInsere(evt:ResultEvent):void{

if (evt.result != null){

Alert.show("Método executado com sucesso!\n\n" +

(evt.result as String), "Ok");

}

}

/**

* Evento click do botão Inserir.

**/

private function btnInserir_click(evt:MouseEvent):void{

if (evt.type == MouseEvent.CLICK){

//Configura a Pessoa

var pessoa:Pessoa = new Pessoa;

pessoa.Id_Pessoa = int(txtId_Pessoa.text);

pessoa.Nome = txtNome.text;

pessoa.Telefone = txtTelefone.text;

//Executa o método no asp.net

var remoteObj:RemoteObject = preparaRemoteObj(rstFalha, rstSucessoInsere);

remoteObj.getOperation("Insere").send(pessoa);

}

}

11 - Agora adicione a tag click="btnInserir_click(event);" no button btnInserir, ele ficará da seguinte forma:<mx:Button x="167" y="96"

label="Inserir"

id="btnInserir"

click="btnInserir_click(event);"/>

12 - Para testarmos a aplicação, primeiramente execute o website no visual studio, depois compile o projeto no flex. O navegador será aberto, preencha os campos e clique sobre o botão Inserir. Vocé deverá ver uma mensagem na tela com dos dados do cliente inserido. Caso ocorreu algum erro, verifique se todos os passos foram feitos corretamente.

TESTANDO O MÉTODO LISTA13 - Finalmente vamos testar o nosso método Lista que retorna um List<Pessoa> do asp.net. Para isso adicione 1 componente DataGrid e 1 Componente Button. Renomeie os componentes da seguinte forma:

DataGrid: grdPessoas

Button: btnLista

14 - Edite as colunas do DataGrid deixando-as da seguinte forma:<mx:DataGrid y="42" width="489" right="10" id="grdPessoas" height="200">

<mx:columns>

<mx:DataGridColumn headerText="Id" dataField="Id_Pessoa" width="20"/>

<mx:DataGridColumn headerText="Nome" dataField="Nome" width="40"/>

<mx:DataGridColumn headerText="Telefone" dataField="Telefone" width="40"/>

</mx:columns>

</mx:DataGrid>

Note que o atributo dataField deve ser idêntico ao atributo da classe Pessoa que será retornado.

15 - Agora vamos criar duas functions para a execução do evento, uma é para o click do botao btnLista, e outra para tratar retorno do método: /**

* Tratamento do retorno do método Lista executado no asp.net.

**/

private function rstSucessoLista(evt:ResultEvent):void{

if (evt.result != null){

grdPessoas.dataProvider = (evt.result as ArrayCollection);

}

}

/**

* Evento click do botao Lista

**/

private function btnListar_click(evt:MouseEvent):void{

if (evt.type == MouseEvent.CLICK){

//Executa o método no asp.net

var remoteObj:RemoteObject = preparaRemoteObj(rstFalha, rstSucessoLista);

remoteObj.getOperation("Lista").send();

}

}

16 - Finalmente adicionamos a tag click no botao btnLista assim como foi feito no btnInserir, deixando-o da seguibte forma: <mx:Button y="12" right="10"

label="Listar"

id="btnListar"

click="btnListar_click(event);"/>

17 - Para testar, caso a aplicação web não esteja rodando, execute-a no VisualStudio, depois compile o Flex para roda-la. Clique sobre o botão Listar, note que o grid será populado com os dados que inserimos na lista do asp.net.Bom pessoal, é isso, um tutorial básico para integração do flex com o .net, executando métodos que esperam parâmetros complexos, e retornam lista. Espero ter ajudado, qualquer dúvida é só deixar um comentário. Até a próxima.