Introdução

Uma interface web-based com poucas requisições ou requisições racionalizadas, buscando o menor número possível de atualizações redundantes ou inúteis a cada exibição de dados, é o motivo da constante renovação da internet, ou da re-formulação no método, ou nas soluções, para construção de aplicações Web.

E a cada novo método/solução encontrado surge uma nova sigla/nome, muitas das vezes este novo recurso possui como núcleo algo que já foi utilizado anteriormente, em poucos casos, como o Flash Player, houve realmente uma revolução na forma de criar e ver aplicações Web, o que não quer dizer que este novo método/solução seja inválido, pelo contrário, já que é uma re-formulação, nela foi pensada e corrigidas todas as possíveis falhas que o método/solução contivesse.

Algum tempo atrás, e não falo de pouco tempo, objetos javascript, uma linguagem client-side, como XMLHttpRequest, ActiveXObject e em poucos casos o window.createRequest, eram alvo constante de debates em fóruns e listas de discussão.
Recentemente eles tornaram a ser utilizados num grande número de novas aplicações Web, porém dentro de uma solução de desenvolvimento conhecida como AJAX.
E com a grande demanda na utilização deste recurso, surgiram soluções específicas para comunicação entre a linguagem client-side e uma linguagem server-side específica, em nosso caso o CFML.

Então falaremos de CFAJAX.

Pré-requisito

Macromedia ColdFusion MX 7
E o pacote CFAjax, aqui será utilizada a versão 1.3

Objetivo

Configurar cfajax.

Conceitos

Para tornar a aplicação mais ágil na resposta a alguns eventos disparados pelo usuário, utiliza-se o javascript para detectar tais eventos e solicitar dados do servidor através de arquivos codificados com linguagem CFML.

Passos:
1 – Cliente dispara evento;
2 – Javascript detecta evento e solicita dados ao servidor;
3 – Servidor recebe requisição CFML e retorna dados ao cliente;
4 – Javascript recebe resposta e exibe os dados

Conteúdo

Antes de tudo devemos instalar o pacote CFAjax, como qualquer pacote para solução Web, ele vem com um caminho de instalação pré-definido.
Para conhecer todos os recursos contidos nele, instalaremos todos os arquivos do pacote, porém na utilização em produção necessitaremos apenas dos arquivos contidos na pasta core, e ainda de um arquivo que possuirá todas as funções de solicitação/resposta, no pacote este arquivo é nomeado por functions.cfm.

1 – Faça o download do pacote
CFAjax;

2 – Crie o diretório ajax na raíz do seu domínio, certifique-se que ele é o um mapeamento válido no Administrador ColdFusion (ver pagina 11 do tutorial Conectando o CFMX7 ao IIS):
(os caminhos que serão vistos a seguir serão deminiados ajax_wwwroot):
IIS – c:\inetpub\wwwroot\ajax
built-in – c:\CFusionMX7\wwwroot\ajax
Tomcat – … /webapps/cfusion/ajax
JRun – …/cfusion-war/ajax

3 – Descompacte cfajax.1.3.zip no diretório criado no item anterior, obtendo os seguintes caminhos:
{ajax_wwwroot}/app
{ajax_wwwroot}/core
{ajax_wwwroot}/examples
{ajax_wwwroot}/utility
{ajax_wwwroot}/default.htm

4 – Abra o arquivo {ajax_wwwroot}/core/settings.js e edite as atribuições das variáveis de forma que recebam urls válidas para seu servidor, exemplo:

configuração default (válida para IIS) _cfscriptLocation = “http://localhost/ajax/examples/functions.cfm”;
built-in – _cfscriptLocation = “http://localhost:8500/ajax/examples/functions.cfm”;
TomCat – _cfscriptLocation = “http://localhost:8080/cfusion/ajax/examples/functions.cfm”;
JRun – _cfscriptLocation = “http://localhost:[Porta]/ajax/examples/functions.cfm”;

Obs: As demais atribuições também devem ser alteradas, seguindo os mesmos critérios das alterações acima.

5 – Abra o aquivo {ajax_wwwroot}/app/voting/voting.htm e altere (linha 32 a 34) o caminho das inclusões de script para urls completas e válidas para seu servidor, da seguinte forma:
Obs: Esta alteração deve ser feita em todos os arquivos de teste!

IIS

built-in

TomCat

JRun

6 – Teste o arquivo no browser:
IIS – http://localhost/app/voting/voting.htm
built-in – http://localhost:8500/app/voting/voting.htm
TomCat – http://localhost:8080/cfusion/app/voting/voting.htm
JRun – http://localhost:[porta]/app/voting/voting.htm

A reposta ao seu teste deve receber a seguinte resposta

Caso não visualize os RadioButtom você deve refazer os passos anteriores.

Com esta configuração concluída você pode acessar todas as aplicações de exemplo que estão em {ajax_wwwroot}/app e {ajax_wwwroot}/examples, porém lembre sempre de executar o item 5 da configuração em cada pagina que será testada.

–
Pedro Claudio – pcsilva@mxstudio.com.br
visite o fórum MXStudio ColdFusion