Pular para o conteúdo principal

JSF 2 - Composite Components, você não precisa mais ser um ninja

Estamos em uma nova era da computação, os dados não estão mais localizados em um banco dentro de sua empresa, vivemos a explosão de redes sociais, informações são geradas a todo instante, e se torna essencial que sua aplicação conheça os serviços disponíveis na web e consumam suas APIs geralmente disponíveis por serviços REST.

Legal, mas como ficam meus aplicativos Java EE neste novo cenário? Para quem vem acompanhando a evolução da plataforma, é notório que todo esforço vem sendo utilizado para aumentar a produtividade e a integração com novos serviços.
Basicamente duas especificações surgem com muita força para atender este cenário, a JSR - 314 (JSF-2) e JSR - 311 (JAX-RS), neste post exploraremos a JSR-314 (JSF2) e sua nova forma de criar Composite Components.

Uma das grandes queixas dos desenvolvedores JSF era a complexidade em criar composite components, era necessário um vasto conhecimento sobre o ciclo de vida de uma aplicação JSF.
Agora, você não precisa ser mais um “ninja” em JSF para ter seus components reutilizáveis. Sua distribuição também ficou bastante simples, basta apenas o seu componente estar localizado no web root da sua aplicação ou empacotado em um JAR.

Bem, vamos a um pouco de código.

* Para este exemplo estou utilizando NetBeans 6.8.1 com Glassfish V3


A ideia básica deste post é criar um componente de vídeo para ser utilizado em várias partes do nosso sistema.

Crie um novo projeto Arquivo -> Novo Projeto, escolha Java Web -> Aplicação Web, e pressione próximo.

Vamos chamar nosso projeto de Globalcoders - homenagem ao blog - pressione próximo novamente. Na próxima tela, escolha como servidor Glassfish V3 - ou outro de sua preferência - a versão do Java EE, selecione Java EE 6, pressione próximo.

Na próxima tela, o NetBeans irá perguntar quais os Frameworks que você deseja utilizar, selecione JavaServer Faces 2, clique em finalizar.
Agora no web root de nossa aplicação constitua um diretório de resources, aqui será a residência de nosso componente.

A especificação do JSF2, define que:

A ocorrência da String “http://java.sun.com/jsf/composite/” em uma declaração de namespace XML Facelet, tudo que estiver após a última “/” é considerado como sendo uma biblioteca de recurso.

Ou seja, crie uma pasta chamada videocomp, e dentro desta pasta criaremos um arquivo chamado video.xhtml.

Quando desejar utilizar este componente, deve colocar na declaração de namespace a seguinte String: “http://java.sun.com/jsf/composite/videocomp”.

A estrutura de nosso projeto ficará assim:

Pronto, agora que já temos a estrutura, codificaremos o nosso componente.

Utilizaremos os recursos do HTML5, a tag <video>, e chamadas assíncronas com novo componente de ajax do JSF2.

Veja o código abaixo:

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml"
xmlns:cc="http://java.sun.com/jsf/composite"
xmlns:h="http://java.sun.com/jsf/html"
xmlns:f="http://java.sun.com/jsf/core">

<cc:interface>
<cc:attribute name="nomeBotao" />
<cc:attribute name="caminhoVideo" required="true" />
<cc:attribute name="alterarVideo" method-signature="void action()" />
</cc:interface>

<cc:implementation>
<h:form>
<h:panelGrid id="video">
<video controls="controls">
<source src="#{cc.attrs.caminhoVideo}" />
</video>
</h:panelGrid>

<h:commandButton value="#{cc.attrs.nomeBotao}" action="#{cc.attrs.alterarVideo}">
<f:ajax execute="@this" render="video" />
</h:commandButton>

</h:form>
</cc:implementation>
</html>
Como você pode ver, o código é bem simples. A primeira tag define quais as características do componente.

A segunda tag definimos como será a sua implementação.

Nela veja a tag <video> presente na nova especificação do HTML5, como ela podemos colocar vídeos em nossas páginas de forma muito fácil, outro novo elemento é a tag do JSF2, semelhantes as tags Ajax4jsf e Trinidad, minimizando a utilização de outros frameworks de terceiros.

Ela é responsável por disponibilizar a chamada ajax no CommandButton. A utilização desta tag é extremamente simples, basicamente temos dois atributos: o “execute”, responsável por enviar nossa requisição, e o “render”, onde informamos o que será renderizado novamente.

Pronto, temos nosso componente de vídeo simples.



<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml"
xmlns:video="http://java.sun.com/jsf/composite/videocomp">
<h:head>
<title>Globalcoders</title>
</h:head>
<h:body>

<video:video nomeBotao="Alterar Clipe"
caminhoVideo="#{videoControle.caminhoVideo}"
alterarVideo="#{videoControle.alterarVideo}"/>

</h:body>
</html>


Agora basta chamar o componente na index.xhtml ou qualquer outra página que desejar dentro de seu sistema.

Observe que na declaração do namespace, colocamos o nome do nosso diretório videocomp.

Outro ponto importante quando vamos utilizar o componente, informamos os parâmetros necessários para seu funcionamento, por exemplo, a action do botão.

O download do código fonte pode ser feito aqui

Até a próxima.

Raphael Adrien
http://twitter.com/raphaeladrien

Comentários

Bastante interessante, Raphael, até pra quem é mais leigo em JSF2.

Eu que não entendo tanto acho que consegui entender a idéia.

Mas nos browsers de hoje já da para conferir o resultado tranquilo?
Raphael disse…
Sim, basta seu browser dar suporte a tag video.
Vc pode verificar o suporte do seu browser neste site http://html5test.com/
Olá olá a todos!

JSF sempre me chamou a atenção.
Falta só estudar mais, mas logo chego lá ( será meu próximo ponto a ser estudado no mundo java hehe ).

Então, não tenho nada revolucionário a comentar, pela pouca experiência com JSF, masss como nosso amigo Marcelo Ricardo, pela forma que o Rapha mostrou, até pareceu ser uma coisa fácil hehehe.

Quais livros de JSF são indicados para estudo? ( pode ser em ingles... amazon ta ai pra dar um help =] )

Parabéns a todos pelo Blog, continuem postando sempre!!

Abração!
Raphael disse…
Lucas, existe bastante material de qualidade disponível na internet.
Dá uma olhada na lista de JSF Group (http://migre.me/41Lhu), e alguns blogs como do @rponte (http//rponte.com.br/).
Ainda temos tb os minicursos da iniciativa #open4education, especialmente este http://migre.me/41Luo que acontece com certa freqüência via webcast.
Mas já que você pediu um livro, veja este JavaServer Faces 2.0 - The Complete Reference (http://migre.me/41KJm) - @edburns e Chris Schalk
Vitor disse…
Este comentário foi removido pelo autor.
Vitor disse…
salve galera...
show de bola o post...

tenho um problema com o composite components que ainda não consegui resolver,
Raphael, pode me passar o email pra entrar em contato contigo??

tentei colocar o código aí no comentario mas não rolou por causa das tags...
Raphael disse…
Vitor, acabei de enviar um e-mail para vc. Manda lá sua dúvida.

[]`s
Glesio disse…
Rafael, estou tendo problemas com composite ao tentar ler um objeto managedbean e listener dentro do composite component.
Rodrigo Bento disse…
A idéia do JSF 2.0 + Facelets e composite components especificamente é muito bonita. Infelizmente há um número gritante de bugs que torna a utilização desse recurso praticamente impraticável. Por isso se você pegou a idéia mas não consegue fazer alguma coisa simples funcionar, tente dar uma olhada na lista de bugs. Já 'perdi' muito tempo com isso.
olá.
se eu acessar a url /resources/videocomp/video.xhtml e colocar para o navegador mostrar o codigo fonte da página, ele vai mostrar o código puro da página. tem como evitar isto ???
Pontin disse…
Olá Raphael...

Como você disse "Agora no web root de nossa aplicação constitua um diretório de resources, aqui será a residência de nosso componente.".

Só funciona dessa maneira o componente.
Mas gostaria de saber se tem como criar o componente em uma pasta fora do resources, e indicar ela como uma taglib?

Conhece alguma forma? Desde já agraeço.
Bruno disse…
Sim Pontin, use a tag ui:fragment do facelets, assim nao sera necessario estar dentro da pasta resources. porém é necesario criar o arquivo facelet-taglib.xml para referenciar sua nova tag.
Eduardo disse…
Raphael, muito obrigado pelo post, mas existe a possibilidade de nos repassar o código-fonte desse projeto, eu não estou conseguindo colocar pra rodar esse componente.
Obrigado.
Ben Nelson disse…
JSF FOR LIFE

Postagens mais visitadas deste blog

2º Bate Papo do SP-GTUG - Divulgação

Pessoal, Para aqueles que já estiveram presentes nas atividades do SP-GTUG (encontros ou bate papos na Globalcode), e para os que ainda não puderam estar presentes, teremos um novo bate papo acerca de mais duas tecnologias do Google: AdSense e Python no GAE. Este será o nosso segundo bate papo do SP-GTUG, nos mesmos moldes dos minicursos da Globalcode . Local e data O bate papo acontecerá no dia 27/03/10, das 10:00 às 13:00 na Globalcode. Para fazer sua inscrição e participar acesse a home da Globalcode e vá até a parte de "Minicursos Gratuitos da Semana ". Conteúdo das apresentações Abaixo seguem as descrições passadas pelos palestrantes: Título: "Algoritmos em Python" Resumo: Python é uma linguagem considerada frugal, simples, sem ser simplória! Entenda como construir algoritmos ninjas com essa linguagem, adotada pela Google e pelo MIT. Veremos muito, muito código, desde algoritmos clássicos até tutoriais do

10 reasons why we love JSF

1. One-slide technology: it's so simple that I can explain basic JSF with one slide. 2. Easy to extend: components, listeners, render kit, Events, Controller, etc. 3. Real-world adoption: JBoss, Exadel, Oracle, IBM, ... 4. Architecture model: you can choose between more than 100 different architecture. 5. Open-mind community: using JSF you are going to meet very interesting people. 6. We are using JSF the last 5 years and we found very good market for JSF in Brazil 7. Progress: look to JSf 1.1 to JSF 1.2, JSF 1.2 to JSF 2.0. People are working really hard! 8. Many professionals now available 9. It's a standard. It's JCP. Before complain, report and help! 10. Ed Burns, spec leader, is an old Globalcode community friend! EXTRA: My wife is specialist in JSF. She's my F1 for JSF :) Nice job JSF community! -Vinicius Senger

Gosta de informática e sonha ser programador Java um dia ?

A Globalcode está procurando jovens que queiram ser programadores no futuro, para fazer parte de sua equipe de vendas e operacional na unidade Paraíso em São Paulo somente. O grande diferencial é o planejamento para carreira de programador. O planejamento de cursos do portifólio da Globalcode: Academia do Programador, Academia Java, Academia Web, Robótica, Eletrônica, etc, será realizado periodicamente de acordo com o desempenho e interesse individual. Atenção : Este não é um estágio para trabalhar com Java, são duas vagas CLT administrativas para pessoas que queiram ser programadores no futuro. Perfil : Conhecimentos de informática básica, saber lidar com pessoas e trabalhar em equipe. Deve ter concluído o ensino médio, ter boa escrita, ser organizado, responsável, comprometido e dinâmico. Interesse por computação, programação, internet, robótica, eletrônica,... Temos duas vagas para jovem-aprendiz abertas: 1) Setor operacional No dia a dia Serviços externos Controle de estoqu

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

TDC INNOVATION lança University Pass

Modalidade de ingresso tem como objetivo ajudar na capacitação dos universitários Uma pesquisa realizada em 2020 pela Associação Brasileira das Empresas de Tecnologia da Informação e Comunicação (Brasscom) diz que até o ano de 2024 o Brasil precisará de cerca de 420 mil profissionais na área de Tecnologia da Informação. Porém, por ano, a mesma pesquisa diz que o país forma apenas 46 mil profissionais capacitados no nicho. Pensando nisso, para ajudar na formação e capacitação desses jovens profissionais, o TDC INNOVATION, segunda edição do ano do The Developer's Conference, lança o University Pass, modalidade de ingresso que possibilita aceso digital gratuito a todas as palestras do evento, ou com 50% de desconto para quem preferir ir pessoalmente. Com o tema central “Desafios para a criação do futuro Digital”, o TDC INNOVATION ocorrerá entre 1 e 3 de junho, de forma híbrida: presencialmente no Centro de Convenções CentroSul, em Florianópolis, e com transmissão simultaneamente pela