Resolvi blogar

AjaxTags JavaScript-JSP Library - updateField - Descrição dos campos

2011-12-09T12:57:00.001-08:00

<ajax:updateField

action='botaoAtualizar'
baseUrl='/aluno.do?perform=atualizarValores'
parameters='idCurso={idCurso}, idMatricula={idMatricula}'
source='idAluno'
target='periodo,situacaoMatricula,situacaoFinanceira'
parser='new ResponseXmlParser()'>

</ajax:updateField>

Parâmetros da tag updateField:

São obrigatórios:

baseURL - a URL do método que deve ser executado no servidor

action - caso use um botão para disparar o AJAX, é aqui que deve indicar seu ID

source - elemento que, ao ocorrer um determinado evento, chama o método configurado na baseURL
target - ID dos elementos que receberão o valor retornado pelo método chamado, separados por vírgula, sem espaços e na mesma sequência que aparecem na página.

action - ID do botão ou da tag de imagem que vai disparar o evento ao ser clicado.

Não obrigatórios:

parameters - outros parâmetros que serão passados para o método no servidor, por request.
'abc={cde}'

abc - nome do atributo que sera colocado no request
cde - ID do input que tem o valor a ser colocado no request, em 'abc'
cde também pode ser um valor (Ex: 'abc=13')

parser - o parser que será usado ao receber a resposta do método

preFunction - nome da função javascript que deve ser executada antes de chamar o método no servidor

postFunction - nome da função javascript que deve ser executada depois que o método chamado no servidor terminar de responder

errorFunction - nome da função javascript que deve ser executada caso o servidor retorne uma exceção

AjaxTags JavaScript-JSP Library - updateField

2011-12-09T08:31:00.001-08:00

Esta tag é utilizada quando você tem um ou mais campos a serem preenchidos e, à partir de uma ação, outros campos são calculados baseados nas informações entradas pelo usuário. Um exemplo é você digitar o ID de um usuário e então preencher os campos de nome, endereço e telefone automaticamente.

O exemplo abaixo é bem simples, mas dá para ter uma ideia de como fazer. Em outro post vou explicar um pouco mais os parâmetros do updateField.

Primeiro, como fazer o método na Action (estou usando o struts):

AlunoAction.java

public ActionForward atualizarValores( ActionMapping mapping,

ActionForm form,

HttpServletRequest request,

HttpServletResponse response) {

//configurar o header para não fazer cache

response.setContentType("text/xml");

response.setHeader("Cache-Control", "no-cache");

// Faz a busca, executa o que precisa executar

Integer idAluno = Integer.parseInt(request.getParameter("idAluno").toString());

Integer idCurso = Integer.parseInt(request.getParameter("idCurso").toString());

Integer idMatricula = Integer.parseInt(request.getParameter("idMatricula").toString());

Aluno aluno = servico.getAluno(idMatricula, idAluno, idCurso);

// utilizar o helper do AjaxTags para criar o XML dos dados

AjaxXmlBuilder ajax = new AjaxXmlBuilder();

ajax.setEncoding("ISO-8859-1");

ajax.addItem("periodo", aluno.getPeriodo().toString());

ajax.addItem("situacaoMatricula", aluno.getSituacaoMatricula.toString());

ajax.addItem("situacaoFinanceira", aluno.getSituacaoFinanceira.toString());

// escrever o conteúdo XML do Ajax para a saída

ServletOutputStream out = response.getOutputStream();

out.print(ajax.toString());

out.close();

// não redirecionar para uma visão

return null;

}

Aqui é o exemplo de como fazer o JSP.

AlunoVisualizarSituacao.jsp

<%@ taglib uri="http://ajaxtags.org/tags/ajax" prefix="ajax"%>

<input class="button"

id="botaoAtualizar"

name="botaoAtualizar"

value='Atualizar'

type="button" />

</form>

<ajax:updateField action='botaoAtualizar'

baseUrl='/aluno.do?perform=atualizarValores'

parameters='idCurso={idCurso}, idMatricula={idMatricula}'

source='idAluno'

target='periodo,situacaoMatricula,situacaoFinanceira'

parser='new ResponseXmlParser()'>

</ajax:updateField>

Para mais informações, acessar o site do projeto: http://ajaxtags.sourceforge.net/index.html

O blog...

2011-12-09T08:14:00.001-08:00

Já aconteceu de eu fazer algo e depois de muito tempo precisar fazer outra coisa igual ou parecida. E, como não é uma coisa que faço sempre, vem à minha cabeça aquela pergunta: "como é mesmo que faz isso?".
Por este motivo resolvi anotar as coisas que acredito que possam ser úteis no futuro. Mas, já que vou anotar, por que não colocar em um blog, onde a informação pode ser útil para mais alguém, que talvez esteja enfrentando a mesma dificuldade que eu enfrentei para encontrar um exemplo ou uma explicação? Por isso... Resolvi blogar!
Claro que a ideia não é fazer um manual completo de nada. E talvez meus exemplos sejam limitados. Porém, lembro que é apenas uma anotação feita por mim, para mim, mas que pode ser útil para alguém mais. De qualquer forma, bom proveito!