Tag Archives: Best Practice

Passar VO(Value Objects) com recurso a uma Class Event

Posted on 03. Abr, 2009 by João Gonçalves.

1

Durante as minhas aulas de Actionscript em ambiente de FLASH, por norma verifico que os formandos têm alguma dificuldade em utilizar algumas das “best practices” mais comuns nomeadamente em relação á criação de Eventos personalizados, no entanto, e assim que conseguem ultrapassar essa barreira, a primeira questão que me colocam é sempre a mesma:

“então e se eu quiser enviar dados pelo meu Event Object, por forma a ……”

Eis que surge então a necessidade de passar o conceito de VO (Value Object) e criação de Classes de Eventos personalizadas.

Como tive hoje que criar alguns ficheiros para exemplificação do Conceito de Classe de Evento Personalizada para envio de dados de uma instância para outra, resolvi partilhar convosco neste Blog os mesmos Ficheiros na esperança que venha ainda a ser útil para alguns dos meus leitores, ou ainda servir de ponto de consulta e esclarecimento de dúvidas para aqueles que durante as aulas não perceberam o conceito. Sendo Assim vamos começar por analisar o pequeno problema que se coloca, e que servirá de “Case Study” para a criação de uma Class de Evento personalizada e do conceito de VO.

PROBLEMA:

  • Temos um form onde a pessoa regista o seu nome, idade e situação laboral, e ao clicar num botão registar, pretende-se acrescentar a uma lista (Texto) os dados da pessoa.

RESOLUÇÃO:

  1. Criar uma Class PessoaVO, que irá servir para armazenar os dados da pessoa que forem inseridos no Form
  2. Criar uma Class PessoaEvent, que será uma subclass da Class Event, e que servirá para enviar um “Event Object” que incluirá uma instância da Class PessoaVO, com os dados anteriormente adquiridos no Form.
  3. A Aplicação principal estará á “escuta” da ocorrência do Evento PessoaEvent, e quando este for detectado, receberá pelo “Event Object” uma instância de PessoaVO com os dados da pessoa.
  4. A Aplicação após receber os dados da pessoa insere e actualiza a TextArea com os registos das pessoas.

Mãos á obra, vamos começar por criar um ficheiro em FLASH, com um form com duas instâncias de TextInputs, para o nome e idade, uma instância de CheckBox para o estado laboral e um botão de registo, ao lado criar uma Textarea para ir acrescentando os Registos, ou seja, qualquer coisa deste género(desculpem mas a designer estava de folga, lol):registo2Passo seguinte vamos criar a Class PessoaVO, que será uma classe Value Object, e por esse motivo terá somente propriedades, propriedades estas que servirão para guardar os dados do form de registo: 

 ActionScript |  copy code |? 
01
 
02
package {
03
 
04
     public class PessoaVO  {
05
 
06
        public var nome:String;
07
        public var idade:int;
08
        public var empregado:Boolean;
09
 
10
     }
11
 
12
}
13
 Depois de criar a Class responsável pelo armazenamento e transporte dos dados do formulário vamos criar a Class PessoaEvent, que irá ser uma SubClass da Class Event:


 ActionScript |  copy code |? 
01
 
02
package {
03
      import flash.events.Event;
04
      import PessoaVO;
05
 
06
      public class PessoaEvent extends Event {
07
 
08
           public static const PESSOA:String = "pessoa";		
09
           public var dadosPessoa:PessoaVO;
10
 
11
           public function PessoaEvent(type:String, voPessoa:PessoaVO) {
12
                super(type);
13
                this.dadosPessoa = voPessoa;
14
 
15
           }
16
 
17
             public override function clone():Event {
18
                 return new PessoaEvent(type, dadosPessoa);
19
             }
20
      }
21
}
22
 
23


Esta Class começa por fazer o “extends” da Class Event, na linha 9, criamos uma constante do tipo de String que irá identificar o “type” do nosso evento para usar depois como por exemplo usamos o CLICK num MouseEvent, na linha 10 criamos uma instância de PessoaVO, para guardar os dados do form e posteriormente enviar os mesmos pela instância de evento criada. O constructor da Class é bastante simples e terá como parâmetros o “tipo ” de evento criado, e a instância, neste caso, de PessoaVO. na linha seguinte (13), chamamos o constructor da Class “Pai” para passar o tipo de evento criado, aqui não se passa qualquer parâmetro extra pois a Class “Event” não contêm parâmetros adicionais. Na linha 14 atribuímos á instância da class “dadosPessoa” os valores recebidos no parâmetro voPessoaConstructor da Class. Por fim é necessário efectuar o overrride do método clone da class Event, de forma a que esta instância de evento tenha um comportamentos normal de um evento como o “Bubbling” por exemplo, nesta definição retornamos o event criando a instância do novo evento e passando os dados armazenados na instância da PessoaVO. do


Por fim criamos a Document Class do nosso ficheiro:


 ActionScript |  copy code |? 
01
02
package {
03
      import flash.display.MovieClip;
04
       import flash.events.MouseEvent;
05
 
06
       public class MainEventPessoa extends MovieClip {
07
 
08
            public var pessoa:PessoaVO;
09
 
10
             public function MainEventPessoa() {
11
                       pessoa = new PessoaVO;
12
 
13
                       registarBtn.addEventListener(MouseEvent.CLICK, registar);
14
                       this.addEventListener(PessoaEvent.PESSOA, receberPessoa);
15
 
16
               }
17
 
18
                private function receberPessoa(e:PessoaEvent):void {
19
                       registosTa.appendText("\n------------------\n" +
20
                        "Nome: " + String(e.dadosPessoa.nome) + "\n" +
21
                        "Idade: " + String(e.dadosPessoa.idade) + "\n" +
22
                        "Nome: " + String(e.dadosPessoa.empregado) + "\n");
23
                 }
24
 
25
                 private function registar(e:MouseEvent):void {
26
                        pessoa.nome = nomeTi.text;
27
                        pessoa.idade = int(idadeTi.text);
28
                        pessoa.empregado = empregadoCb.selected;
29
 
30
                        dispatchEvent(new PessoaEvent("pessoa", pessoa));
31
                    }
32
 
33
             }
34
 
35
  }
36


Nesta Document Class, começamos por criar uma instância de PessoaVO, onde iremos atribuir os valores dos dados que irão ser preenchidos no FORM, na linha 13, definimos o evento click no botão registar  que irá inicializar toda a sequência do script. o Listener do clicar em Registar vai associar os dados dos campos do form ás propriedades da instância de PEssoaVO (pessoa) linhas 26 a 28, na linha 30 “criamos” um evento do tipo PessoaEvent, onde iremos incluir nos parâmetros do constructor, o nosso PessoaVO com o nome “pessoa”. Na linha 14 a nossa Aplicação recebe o evento “PessoaEvent.PESSOA“, e chama o listener das linhas 18 a 22 que irá acrescentar(para os mais esquecidos deverão sempre usar o método appendText da Class TextField, e não o operador ” += ” para concatenar strings) á TextArea os dados que recebeu no “Evento Object” e que acedemos na propriedade “dadosPessoa” deste.


espero que este Post seja esclarecedor para muitos de vós, não hesitem em colocar questões ou sugestões para explicações futuras, deixo aqui tb um ficheiro zip com os ficheiros exemplificando o mini-tutorial.



							
                            
Continue Reading