Pretendo ensinar, em uma série de posts e screencasts, como utilizar o BlazeDS para construir aplicações Flex utilizando a maioria dos serviços disponibilizados pelo BlazeDS, incluindo desde a utilização de mensageira básica a utilização de filas JMS, conhecimentos básicos de serialização e como modifica-la, configurações dos serviços e como customizar Channels e Adapters para resolver os problemas de serialização de Enumse também para resolver o famoso LazyInitializeException quando trabalhamos com Flex, Java e Hibernate.

Sobre o BlazeDS

O BlazeDS é uma aplicação Java opensource mantida pela Adobe, sob licensa GNU Lesser General Public License, Version 3 (LGPL v3), que fornece um conjunto de serviços, todos sobre o protocolo HTTP(Hyper Text Transfer Protocol), para permitir uma aplicação Flex fazer chamadas a serviços remotos Java, retornando os dados tanto de forma assíncrona como em tempo real.

Por utilizar o formato de dados binário chamado AMF(Action Message Format) para a serialiazação e deserialização de dados, a comunicação entre uma aplicação Flex e o servidor Web se torna muito otimizada. Existem estudos feitos comparando as diversas tecnologias, como o Jamesward, mostrando o potencial do AMF.

Outra grande vantagem quando usamos o BlazeDS é a facilidade de ter classe Java automaticamente convertida para uma classe ActionScript e vice-versa.

O BlazeDS pode ser baixado do site da Adobe em dois formatos:

1. Turnkey – Versão que já vem com exemplos e servidor tomcat pré configurado
2. Binary – Versão com os binários

Você pode optar também por fazer o download do código fonte. A documentação também está disponível neste link.

Entendendo os arquivos de configuração do BlazeDS
A estrutura de arquivos do BlazeDS é bem simples, quando descompactamos o blazeds.war, presente na versão binária, podemos ver a seguinte estrutura:



Devemos nos atentar a duas pastas. A pasta lib, que contém todos os jars necessários, e a pasta flex, que contém todos os arquivos de configuração do BlazeDS. Vamos ver o que cada arquivo significa:

1. services-config.xml: É neste arquivo que estão as principais configurações do BlazeDS como segurança, logging, serviços disponíveis (Canais), fábricas para a integração com Frameworks Java como Spring e EJB3 e as referências para os outros três arquivos de configuração.
2. remoting-config.xml: É nesse arquivo que iremos configurar os serviços Java para serem "consumidos" pela aplicação Flex. Sempre quando configuramos este arquivo, iremos trabalhar com o componente Flex chamado RemoteObject.
3. message-config.xml: Aqui é configurado tudo o que for relacionado com mensageria, sempre necessário quando trabalhamos com os componentes Flex Consumer e Producer. Um exemplo da utilização desta tecnologia seria fazer um bate bapo, ou até mesmo aplicações colaborativas, onde é desejável a iteração simultânea de diversos usuários.
4. proxy-config.xml: Além da possibilidade de utilizarmos o componente RemoteObject, o Flex disponibiliza mais duas formas de integração: O HTTPService e o WebService. Porém, por questões de segurança, os serviços só podem ser chamados quando os mesmos estão no mesmo domínio que a aplicação, ou que exista uma configuração específica que permita um cliente Flex fazer a consulta (esta configuração é feita por um arquivo chamado crossdomain.xml e está sempre no servidor onde está o serviço chamado). Caso uma das duas condições acima não seja satisfeita, deveremos utilizar o BlazeDS como proxy , e é ai que configuração deste arquivo se torna necessário.

Criando o seu primeiro projeto com o BlazeDS

Para criar o projeto iremos precisar de:

1. Eclipse Galileo JEE
2. FlashBuilder Plugin
3. BlazeDS 4 Binary
4. Tomcat 6

Feito os downloads e a instalação do Eclipse e FlashBuilder, vamos iniciar o FlashBuilder para criar o projeto.
Antes de criar o projeto, vamos configurar o Tomcat:

1. Nas preferências do Eclipse, vá em Server — Runtime Environments e clique em Add…
   
2. Na pasta Apache selecione Apache Tomcat v6.0 e clique em Next
   
3. Selecione a pasta onde você descompactou o Tomcat e clique em Finish
   

Feito a configuração do Tomcat, vamos criar o projeto:

1. Vá em File – New – Flex Project
2. Preencha os dados do primeiro passo como na imagem abaixo e clique em Next
   
3. Neste passo vamos configurar os dados do servidor. Deixe tudo configurado como na imagem e clique em Next
   
   Para selecionar o “Target Runtime”, clique em New e depois escolha o Apache Tomcat 6, como na imagem abaixo.
   
4. No último passo não será necessário mudar nada, clique em Finish
   

Agora vamos criar a classe Java que terá o serviço para retornar a string “HelloBlazeDS”

1. Crie uma classe Java br.com..service.RemotingService
   
2. Crie o serviço:
   [cc_actionscript]
   package br.com..service;
   public class RemotingService {

   public String sayHello() {
   return “HelloBlazeDS”;
   }

   }
   [/cc_actionscript]

Agora vamos configurar o BlazeDS para disponibilizar o serviço que acabamos de criar.

1. Abra o arquivo remoting-config.xml que está na pasta WebContent/WEB-INF/flex
2. Para que seja possível chamar os métodos da classe Java, precisamos configurar um destination. Isso é necessário para cada classe Java.
   O arquivo fica assim:
   [cc_actionscript]
   
   
   
   
   
   
   
   
   br.com..service.RemotingService
   
   [/cc_actionscript]

Vamos colocar na aplicação a chamada para o servidor.

1. A primeira coisa que precisamos fazer é configurar o RemoteObject. Fazer isso é muito simples:
   [cc_actionscript]
   
   
   
   [/cc_actionscript]
   
   Alguns detalhes:
   
   * Perceba que a propriedade destination aponta para o destination que configuramos no arquivo remoting-config.xml
   
   * Precisamos declarar um id para poder referenciar o RemoteObject
   
   * Adicionamos um ResultHandler para tratar o resultdo do serviço
   
   * Adicionamos um FaultHandler para tratar a falha do serviço
2. Os Handlers ficam assim:
   [cc_actionscript]
   
   
   [/cc_actionscript]
   
   Alguns detalhes:
   
   * A propriedade result do evento ResultEvent vai conter o resultado do serviço. No nosso caso o serviço retorna uma String “HelloBlazeDS”
   
   * A propriedade fault do evento FaultEvent contém os detalhes do erro.
3. A última coisa é chamar o serviço. Vamos fazer isso no evento creationComplete, como segue:
   [cc_actionscript]
   protected function application1_creationCompleteHandler(event:FlexEvent):void
   {
   services.sayHello();
   }
   [/cc_actionscript]
4. A aplicação inteira fica assim:
   [cc_actionscript]
   
   
   
   
   
   
   
   
   [/cc_actionscript]

Agora só falta fazer o deploy da aplicação e subir o servidor.

1. Vá em Window – Show View – Other. Na janela que abrir, digite Servers e clique OK
   
2. Na view Servers, clique com o botão direito em Tomcat v6.0 e selecione Add and Remove…
3. Selecione a aplicação HelloBlazeDS e clique em Add e depois Finish
   
4. Na view Servers, clique com o botão direito em Tomcat v6.0 e clique em Run

Agora é só executar a aplicação e ver o resultado:

Isso é tudo, guarde esse projeto configurado para ser usado nos próximos posts.