Pular para o conteúdo principal

Facelets ainda mais divertido! Parte II

De volta ao Facelets, na primeira parte mantive o foco na utilização de templates e técnicas de reutilização visando maior agilidade para desenvolver telas com JSF, mas o Facelets vai bem além disso! Nesse post vou comentar e mostrar um pouco sobre a criação de componentes UI (User Interface) usando xhtml - na minha opinião esse é o grande diferencial da tecnologia.

Com esse recurso é possível customizar / padronizar componentes usando xhtml + tags JSF + JavaScript + Css, sem código Java. A ideia é bem próxima ao Tag File em uma rápida comparação com JSP (JavaServer Pages), mas no caso do Facelets feito de uma forma ainda mais simples e com aderência a (infra)estrutura do JSF.

Vou descrever o mesmo cenário da primeira parte, um sistema composto por vários cadastros (Create Read Update Delete). Pensando especificamente em cada formulário, usando como exemplo um rascunho ou protótipo para o cadastro de Fornecedores, podemos assumir o seguinte formato:
  • campos para preenchimento:

  • barra com botões para cada operação:
Vale a ressalva que nos exemplos apresentados na sequência deixei a parte visual muito simples, focando justamente no mecanismo de componentes da tecnologia.

Mesmo com a utilização de templates uma parte do trabalho ainda é repetitiva e chata, como a criação da barra de botões para Salvar / Cancelar (Voltar para listagem) / Excluir. Podemos criar um componente através do Facelets para centralizar e resolver a barra de botões, evitando um pouco do costumeiro "copia (ctrl-c) e cola (ctrl-v)".

A seguir o código inicial da barra de botões:
<ui:composition 
    xmlns:h="http://java.sun.com/jsf/html"  
    xmlns:f="http://java.sun.com/jsf/core"
    xmlns:ui="http://java.sun.com/jsf/facelets">
  <h:panelGrid columns="3">
    <h:commandButton action="#{mbean[acaoSalvar]}" value="Salvar" />
    <h:commandButton action="#{mbean[acaoCancelar]}" value="Cancelar"
       immediate="true"/>
    <h:commandButton action="#{mbean[acaoExcluir]}" value="Excluir"/>
  </h:panelGrid>
</ui:composition>
barraBotoes.xhtml (dentro do diretório WEB-INF)

A próxima etapa seria definir o componente no descritor de taglib, habilitando a utilização na tela. Exemplo:
<?xml version="1.0"?>  
<!DOCTYPE facelet-taglib PUBLIC "-//Sun Microsystems, Inc.//DTD Facelet Taglib 1.0//EN" "facelet-taglib_1_0.dtd">  
<facelet-taglib>  
  <namespace>http://www.globalcode.com.br/facelets</namespace>  
  <tag>  
    <tag-name>barraBotoes</tag-name>  
    <source>barraBotoes.xhtml</source>  
  </tag>  
</facelet-taglib>
globalcode.tag.xml

Importante, para o Facelets considerar essa taglib precisamos informa-la no web.xml via o parâmetro facelets.LIBRARIES, dessa forma:
...
<context-param>  
  <param-name>facelets.LIBRARIES</param-name>  
  <param-value>/WEB-INF/globalcode.tag.xml</param-value>  
</context-param> 
...

Na sequência o trecho do formulário de Fornecedores acionando o componente barraBotoes, no xmlns mapeamos o namespace da taglib da globalcode com alias g, além de definir a referência do managed bean fornecedorMB e os nomes das respectivas actions
<ui:composition template="/cadastro.xhtml"
    ...
    xmlns:g="http://www.globalcode.com.br/facelets">
  <ui:define name="principal">  
    <h:form>
       ...  
       <g:barrabotoes mbean="#{fornecedorMB}" acaosalvar="doSalvar" 
          acaocancelar="doCancelar" acaoexcluir="doExcluir" />
    </h:form>  
  </ui:define>  
</ui:composition>  
formFornecedores.xhtml

A primeira versão do componente é bem simples, só agrupa três h:commandButton no mesmo h:panelGrid, pouco flexível e inteligente. Poderíamos criar novos recursos fazendo com que o programador tenha menos trabalho e mais flexibilidade, por exemplo:

  • cada h:commandButton tem um valor padrão para action se não informado. O desenvolvedor só deve definir as propriedades acaoSalvar / acaoCancelar / acaoExcluir caso o nome do método no managed bean não siga esse padrão.
  • o h:commandButton de exclusão só deveria aparecer caso exista um registro, ou seja, em modo de edição do cadastro. Podemos criar uma propriedade para tratar isso e usá-la no rendered.
  • permitir ao desenvolvedor a escolha do alinhamento dos botões no formato Horizontal (default) ou Vertical.

A lógica para validar propriedades dentro xhtml pode ser implementada usando algumas tags do core JSTL (JavaServer Pages Standard Tag Library).


Veja a nova versão do componente:
<ui:component xmlns:h="http://java.sun.com/jsf/html"
    xmlns:f="http://java.sun.com/jsf/core"
    xmlns:ui="http://java.sun.com/jsf/facelets"
    xmlns:c="http://java.sun.com/jstl/core">
  <!-- caso o ñ recebe property para action, usa padrão -->
  <c:if test="#{empty acaoSalvar}">
    <c:set var="acaoSalvar" value="doSalvar"></c:set>
  </c:if>
  <c:if test="#{empty acaoCancelar}">
    <c:set var="acaoCancelar" value="doCancelar"></c:set>
  </c:if>
  <c:if test="#{empty acaoExcluir}">
    <c:set var="acaoExcluir" value="doExcluir"></c:set>
  </c:if>

  <!-- valida a property (flag) para mostrar o botão Excluir -->
  <c:if test="#{empty renderizaExcluir}">
    <c:set var="renderizaExcluir" value="true"></c:set>
  </c:if>
  
  <!-- define o comportamento de alinhamento -->
  <c:if test="#{empty alinhamento || alinhamento != 'vertical'}" 
     var="bAlinhamento">
    <c:set var="colunas" value="3"></c:set>
  </c:if>
  <c:if test="#{alinhamento eq 'vertical'}">
    <c:set var="colunas" value="1"></c:set>
  </c:if>
  
  <h:panelGrid columns="#{colunas}" rendered="#{mbean ne null}">
  <h:commandButton action="#{mbean[acaoSalvar]}" value="Salvar" />
  <h:commandButton action="#{mbean[acaoCancelar]}" value="Cancelar"
     immediate="true" />
  <h:commandButton action="#{mbean[acaoExcluir]}" value="Excluir"
     rendered="#{renderizaExcluir}" />
  </h:panelGrid>
</ui:component>
barrabotoes.xhtml

Agora no formulário de Fornecedores a nova maneira de acionar o componente:
<ui:composition template="/cadastro.xhtml"
    ...
    xmlns:g="http://www.globalcode.com.br/facelets">
  <ui:define name="principal">
    <h:form>

      ...

      <g:barraBotoes mbean="#{fornecedorMB}" alinhamento = "vertical"
         renderizaExcluir="#{fornecedorMB.fornecedor.id ne null}"/>

    </h:form>
  </ui:define>
</ui:composition>
formFornecedores.xhtml

Nesse exemplo o formulário de fornecedores uso os botões na vertical, em uma coluna. Caso o fornecedor ainda não tenha sido salvo o botão de exclusão não é renderizado. Um detalhe é que o managed bean FornecedorMB segue a padrão de nome para os metódos do cadastro, retirando a verbosidade na chamada da tag.

Esse mecanismo também pode ser aplicado em situações aonde um componente possui alguma complexidade que poderia ser escondida. Seria interessante definir em algumas telas inputs com mascara simplificando para o usuário preenchimento de CPF / CNPJ / Telefone / CEP / ou qualquer informação que tenha um formato de preenchimento.

A idéia seria customizar o inputText com código JavaScript aplicando a mascara, mas codificar JavaScript nem sempre é uma tarefa simples. Por isso vou usar o JQuery. Sou fã dessa library que simplifica muito a utilização de JavaScript, quem ainda não usou esta perdendo tempo! O JQuery adota conceito de plugins, o Masked Input Plugin faz justamente esse trabalho.

A seguir o exemplo desse input customizado, o inputMask.xhtml:
<ui:component xmlns:h="http://java.sun.com/jsf/html"
    xmlns:f="http://java.sun.com/jsf/core"
    xmlns:ui="http://java.sun.com/jsf/facelets">
  <script>
    jQuery(function($){
      $("input[id*='#{id}']").mask('#{mascara}');
    });
  </script>

  <h:inputText id="#{id}" value="#{value}" styleClass="masked"/>
</ui:component>
inputMask.xhtml

O código acima utiliza a função JQuery para buscar o input (text) pelo ID (identificador) e aplica a mascara. Um pré-requisito para esse código funcionar corretamente é importar os arquivos js do JQuery e plugin. Para centralizar o import podemos colocá-lo no cadastro.xhtml, o template das telas de cadastro, veja esse trecho de código:
<script src="js/jquery.js" type="text/javascript">
</script>
<script src="js/jquery.maskedinput.js" type="text/javascript">
</script>

No formulário de Fornecedor podemos aplicar esse componente para os campos de CNPJ e Telefone, veja o codigo completo:
<ui:composition template="/cadastro.xhtml"
    xmlns:ui="http://java.sun.com/jsf/facelets"
    xmlns:h="http://java.sun.com/jsf/html"
    xmlns:f="http://java.sun.com/jsf/core"
    xmlns:g="http://www.globalcode.com.br/facelets">
  <ui:define name="principal">
    <h:form>
      <h:inputHidden value="#{fornecedorMB.fornecedor.id}" id="idFornecedor" />
      <h:panelGrid columns="2">
        <h:outputLabel value="Nome" for="iNome" />
        <h:inputText value="#{fornecedorMB.fornecedor.nome}"
           id="iNome" />

        <h:outputLabel value="Cnpj" for="iCnpj" />
        <g:inputMask id="iCnpj" value="#{fornecedorMB.fornecedor.cnpj}"
           mascara="99.999.999/9999-99" />

        <h:outputLabel value="Fone"/>
        <g:inputMask id="fone" value="#{fornecedorMB.fornecedor.nome}"
           mascara="9999-9999" />
      </h:panelGrid>
   
      <h:messages showDetail="true" showSummary="true" />

      <g:barraBotoes mbean="#{fornecedorMB}"  
         renderizaExcluir="#{fornecedorMB.fornecedor.id ne null}"/>
    </h:form>
  </ui:define>
</ui:composition>
formFornecedores.xhtml

O digito 9 representa qualquer número entre 0 e 9, maiores detalhes sobre o formato podem ser encontrados no site do plugin. Veja aqui demonstrações desse plugin.

No caso de um componente mais complexo composto por sub-tags ou que necessite de processamento em Java, podemos usar o mecanismo de TagHandler - para mais detalhes acesse o site do Facelets.
O objetivo dos 2 posts foi ilustrar de uma maneira simples e rápida como o Facelets é uma alternativa interessante abordando recursos que aumentam a produtividade do desenvolvimento favorecendo a manutenabilidade, com qualidade. Outro fator de peso é a chegada do JavaSever Faces 2.0 que adota a tecnologia como padrão de criação das telas.

Além dos Minicursos oferecidos pela Globalcode, você pode aprender mais sobre essa tecnologia no treinamento Core Web, veja detalhes aqui.

Links:
- Facelets Project
- JSF 2 / Mojarra Project
- Tutorial JQuery

Eder Magalhães
http://twitter.com/edermag
http://www.yaw.com.br

Comentários

mchiareli disse…
oq vc usou para criar as imagens do protótipo?
leandro disse…
onde está a primeira parte?
Unknown disse…
Leandro a primeira parte aqui:
http://blog.globalcode.com.br/2009/08/facelets-uma-forma-mais-agil-para.html
Wanderlei Magri disse…
Opa, gostaria de saber se tem como usar essa funcao ou algo semelhante para recuperar o id gerado pelo jsf tipo: jQuery(function($){$("input[id*='#{id}']").mask('#{mascara}');});
essa funcao vc usa ja para colocar a mascara certo, gostaria q ela fosse utilizada somente para pegar o id gerado algo +- assim:
var id = jQuery(function($){$("input[id*='#{id}']").id;});
Tem como ou tem algum jeito de fazer isso?
Obrigado desde ja.
Anônimo disse…
Olá!! Ótimo post!

Como eu faria para passar um parâmetro pelos mbeans do exemplo? A função funciona legal se estou com um único objeto! Mas nun dataTable tenho o objeto no atributo var....

Obrigado
andre disse…
Tenho uma duvida, com a utilização de facelets, eu sempre tenho que usar arquivos .xhtml?
Ou posso fazer um template e usar dentro de arquivos jsf?
Programmerms disse…
Ola , tdo certo ?

Seguinte nao consigo fazer rodar o componente.
Ola , nao estou conseguindo fazer rodar o

da um erro dizendo que o atributo do componotente nao foi registrado na interface.

Eta igualzinho ao teu exemplo , na verdade so copiei e colei .... oq pode estar errado ?


Vlw
paulojeronimo disse…
O Bruno Borges fez uma pequena referência a este post, fazendo um código com funcionalidades similares e publicando-o no link http://bit.ly/c0KexP
Unknown disse…
Muito legal o artigo, eder. Parabéns!

Como sempre direto ao ponto, sem fazer fita.

Perfeito!

Postagens mais visitadas deste blog

Compilador GWT, não se preocupe com JavaScript!

Nesse post vou escrever um pouco sobre o Compilador do Google Web Toolkit , qual é o seu papel no kit, além de algumas dicas para o dia-a-dia no desenvolvimento com a tecnologia. Como exemplo vou usar um novo Projeto Web no Eclipse criado a partir do Google Plugin   para desenvolvimento GWT e/ou App Engine, acesse aqui mais informações e download. Depois de instalar o plugin, dentro do Eclipse siga a sequência para criar o projeto: New - Others - Google - Web Application Project - Defina o nome do projeto e a estrutura raiz de pacotes - Finish. Vou adotar como nome do projeto appGWT e pacote br.com.globalcode . O plugin gera uma aplicativo pronto que permite ao usuário preencher um campo e realizar o envio ao servidor de forma assíncrona (Ajax), quando o servidor responde um Dialog é apresentado com a mensagem de retorno. Para testar a aplicação é só executar o projeto com a opção Wep Application . Veja: O GWT, como já foi comentado , adota um conceito bem interess

O que é Lógica de programação?

Este é o segundo de uma série de posts voltados aos leitores do blog que estão dando início à carreira de desenvolvimento de software. O assunto de hoje é a lógica de programação. Para ler antes: Entendendo como funciona a programação de computadores: linguagens de programação, lógica, banco de dados A lógica de programação é um pré-requisito para quem quer se tornar um desenvolvedor de software, independente da linguagem de programação que se pretende utilizar. Mas o que é de fato a Lógica de Programação e como saber se eu tenho esse pré-requisito? A lógica de programação nada mais é do que a organização coerente das instruções do programa para que seu objetivo seja alcançado. Para criar essa organização, instruções simples do programa, como mudar o valor de uma variável ou desenhar uma imagem na tela do computador, são interconectadas a estruturas lógicas que guiam o fluxo da execução do programa. Isso é muito próximo ao que usamos em nosso cotidiano para realizar atividad

Dica rápida: Apagando registros duplicados no MySQL

Ola pessoal, Sei que vocês estão acostumados a ver posts meus sobre tecnologia móvel ou algo relacionado, mas hoje vou falar sobre um pequeno "truque" que usei esse final de semana com o MySQL. Eu estava desenvolvendo o lado servidor de uma nova aplicação mobile (ahh, então "tem a ver" com mobile hehe), e quando fui fazer alguns testes percebi que tinha quase 7 mil registros duplicados (!!!) na minha base de dados! Bom, o meu primeiro reflexo como programador foi pensar em fazer um "programinha" Java para buscar e deletar todos esses registros duplicados. Mas ai, resolvi tirar as teias de aranha dos neurônios e usar os vários anos de experiência que passei com SQL e criar uma query que fizesse esse trabalho todo de uma vez!! E a query ficou assim: delete from TABLE_NAME USING  TABLE_NAME, TABLE_NAME  AS  auxtable WHERE   ( NOT  TABLE_NAME.id  =  auxtable.id ) AND   ( TABLE_NAME.name  =  auxtable.name ) Explicação direta: TABLE_NAME

Devo fazer um curso ou ler um livro?

Acredito que todos os instrutores ou professores, independentemente da área, escola ou centro de treinamento, já devam ter recebido essa pergunta alguma vez na vida: devo fazer um curso ou ler um livro? Para responder a essa pergunta, precisamos avaliar os prós e contras de cada opção. Trabalho com treinamento há algum tempo e, hoje, recebi essa pergunta de um aluno. Não adianta responder a ou b sem argumentar, demonstrando as opções conforme a situação do aluno. O conteúdo, a forma de transmissão e a capacidade de assimilação do indivíduo são chaves para haver benefício maior de aprendizado. Tanto em um bom curso quanto em um bom livro, o conteúdo é a premissa básica . Por conteúdo entendemos: se está organizado; se respeita pré-requisitos; se promove o aprendizado guiado e incremental; se aborda de forma satisfatória os principais pontos; se tem bom balanço entre teoria, exemplos e prática (favorecendo exemplos e prática); se tem como premissa a acessibilidade possível (e cabível) pa

Saiba como programar para Arduino sem ter nenhum hardware disponível

O Arduino já é uma tecnologia muito difundida entre os amantes de tecnologia. É difícil encontrar um profissional da computação que não brincou um pouco com esta ferramenta de prototipagem ou, que gostaria de fazer isso. Porém, em alguns casos, o programador quer conhecer o arduino mas não dispõe de nenhum hardware, nem mesmo da placa. Como isso poderia ser resolvido? A primeira resposta seria aquela mais simples e direta: ir as compras. Isso pode ser feito em uma loja física ou pela internet. No meu caso, por exemplo, tive a felicidade de encontrar em um site (não me lembro qual) um kit arduino, com um conjunto de sensores e um DVD com 41 vídeo aulas. Mas digamos que o profissional não esteja passando por um bom momento financeiro, ou ainda, simplesmente não queira comprar o Arduino sem antes conhecê-lo um pouco melhor. Para a última situação também já existe uma resposta, e diga-se de passagem, uma excelente resposta. Trata-se do site 123D Circuits.io . Depois de criar seu u

JavaMail: Enviando mensagem HTML com anexos

Introdução Depois do post "JavaMail: Enviando e-mail com Java" , que apresentava como enviar um e-mail com Java, resolvi complementar a assunto apresentando como enviar uma mensagem formatada, em HTML , e também como realizar o envio de anexos. Bibliotecas Além da biblioteca JavaMail, veja mais no post anterior , é necessário incluir o JavaBeans Activation Framework (JAF), apenas se a versão utilizada for anterior ao JSE 6.0 , que já tem o JAF incluso. O JAF está disponível em http://www.oracle.com/technetwork/java/javase/downloads/index-135046.html , e neste download encontramos, alguns exemplos na pasta demo , documentação, incluindo javadocs, na pasta docs e a biblioteca activation.jar , que deve ser acrescentada no classpath da aplicação para versões anteriores ao JSE 6.0. Exemplo Primeiramente devemos realizar a configuração da javax.mail.Session e da javax.mail.internet.MimeMessage , estes passos podem ser vistos no post anterior . Agora vamos montar um