Acessando dados com Flash Remoting
por Neto LealVeremos a seguir a simples tarefa de acessar dados no servidor usando apenas o ActionScript. Sem a necessidade de nenhuma outra linguagem server-side.
O Macromedia ColdFusion MX traz consigo o pacote Flash Remoting que tambem pode ser ser executado em outros servidores WEB como o .NET por exemplo. Este pacote permite o desenvolvedor, resgatar dados do seu servidor usando apenas o ActionScript.
Nesse artigo vou mostrar como preencher um ListBox (Componente) a partir de uma consulta à banco de dados.
Para criar esse exemplo usei um DataSource chamado "cfsnippets" padrão do admin do ColdFusion .
O segundo passo, é criar o arquivo ActionScript que irá executar no servidor.
Seu código é o seguinte://Arquivo employees.asr
function getEmp(id){
var where = (id != 0)? "where emp_id = " + id: "";
var ret = CF.query(
"cfsnippets",
"select * from Employees " + where
);
var ret_array = new Array(id,ret);
return ret_array;
}
Ess função irá receber um parâmetro chamado "id" que será o identificador do funcionário a ser pesquisado. Se esse parâmentro for 0 (zero) a consulta deverá retornar todos os funcionários da tabela. Caso o valor do "id" seja diferente de 0 (zero) a consulta deverá retornar apenas o funcionário com "id" igual ao informado.
Para isso usamos o método do objeto "CF" chamado "query" que executa um comando SQL no servidor e retorna um Recordset.
o retorno da função devolve ao flash um array contendo o "id" especificado e no segundo índice o recordset retornado pelo método CF.query
Agora vamos ao código do cliente:/*
Primeiro incluímos o arquivo NetServices.as que contém o objeto NetServices. Esse objeto é o responsável para criar conexão entro o cliente e o servidor Remoting.
*/
#include "NetServices.as"
/*
O arquivo "NetDebug.as" é opcional. Esse arquivo cria o objeto NetDebug que contém o método "trace" responsável para depuração de seu código.
*/
#include "NetDebug.as"
/*
O arquivo "DataGlue.as" cria o objeto DataGlue. Esse objeto cria uma interação entre o objeto RecordSet (criado pelo NetServices.as) e os Flash MX UI components. Esse objeto é muito útil para se criar aplicativos Rich.
*/
#include "DataGlue.as"
//Esse método serve para "limpar" os textos de uma determinada Timeline ou MovieClip.
MovieClip.prototype.limpaCampos = function() {
for (t in this) {
if (t instanceof TextField) {
t.text = "";
}
}
};
//Definimos a URL padrão de onde se encontram os seus services no servidor Remoting
NetServices.setDefaultGatewayURL("http://localhost:8500/flashservices/gateway");
//Criamos uma conexão e atribuímos ao objeto cfServer_conn
cfServer_conn = NetServices.createGatewayConnection();
/*
o método getService funciona da seguinte forma:
digamos que seu arquivo employees.asr esteja situado dentro de um diretório chamado "teste_neto_cf1" na raiz do seu servidor (C:\CFusionMX\wwwroot\teste_neto_cf1). este serviço será acessado pelo id "teste_neto_cf1.employees".
O segundo parâmetro do método significa a linha do tempo que será "guardado" o resultado do método. Nesse caso o this foi usado. Ou seja, a linha do tempo atual.
*/
serv = cfServer_conn.getService("teste_neto_cf1.employees", this);
//O método "getEmp" é o nome da function criada no arquivo "employees.asr"
serv.getEmp(0);
/*
A função getEmp_result tem esse nome seguindo uma convenção adotada pelo Remoting. O sufixo "_result" indica que essa função será executada quando o "getEmp" responder. O parâmetro "res" irá receber o resultado da função no servidor.
Nesse caso será um array onde o primeiro parâmetro é o "id" informado e o segundo é o recordset resultado do CF.query.
*/
function getEmp_result(res) {
st_txt.text = "";
if (res[0] == 0) {//Se o id for 0 (zero) indica que deverá ser preenchido o listBox
/*
O seguinte método preenche o listBox "lstEmp_lst" passado no primeiro parâmetro da seguinte forma:
res[1] -> objeto RecordSet retornado do banco de dados
"#FirstName#" -> Chave do Recordset que será o label do valor do listBox
"#emp_id#" -> Chave do Recordset que será o data do listBox
*/
DataGlue.bindFormatStrings(lstEmp_lst, res[1], "#FirstName#", "#emp_id#");
} else {//Se o id nao for 0 (zero) será mostrado os detalhes do funcionário selecionado
/*
Abaixo usamos o método getItemAt do objeto RecordSet que retorna o valor de uma chave do objeto
o método pede um índice (nesse caso 0) e a chave desejada.
*/
nome_txt.text = res[1].getItemAt(0)["FirstName"];
lnome_txt.text = res[1].getItemAt(0)["LastName"];
fone_txt.text = res[1].getItemAt(0)["Phone"];
}
}
/*
Abaixo definimos a função pegaDados como sendo o changeHandler do componente listBox
*/
lstEmp_lst.setChangeHandler("pegaDados");
function pegaDados() {
_root.limpaCampos();
st_txt.text = "Atualizando...";
//Abaixo usamos o mesmo getEmp passando como parâmetro o id do funcionário selecionado no listBox
serv.getEmp(lstEmp_lst.getSelectedItem().data);
}
Bem, vimos aqui como é simples a tarefa de integração com banco de dados usando Flash Remoting
Vimos tambem que é possível integrar totalmente usando APENAS ActionScript.
Agora é botar a mão na massa nessa poderosa tecnologia que chegou pra ficar !
Até a próxima !!
postado por Neto Leal em 8:09 AM
