Se você é daquelas pessoas que estão sempre dando uma olhada nas notícias do mundo Java EE, então você certamente já ouviu falar de um framework chamado Seam, desenvolvido pelo motha-fucka (no bom sentido, claro) Gavin King, um feliz e bem-sucedido funcionário da JBoss, empresa esta que foi comprada, a alguns meses, pela inescrupulosa Red Hat…

Introdução

Enfim, vamos deixar essa história de conspiração alienígena para um outro post e comentar sobre o tal do JBoss Seam. Eu mesmo já havia tentado fazer o Seam funcionar, mas sem sucesso. Eis que ontem eu estava de bobeira e me veio a idéia de tentar novamente e, depois de quase apelar para uma macumba, acabou funcionando!

Caso você ainda não conheça nada sobre o JBoss Seam, eu aconselho que você dê uma olhada na página do projeto e nas aplicações de demonstração que estão on-line por aí… ah, e tem também um artigo que saiu na MundoJava 19, que mostra algumas informações interessantes para quem quer começar a trabalhar com o Seam.

Este tutorial é daqueles tipo “passo-a-passo”, e está dividido em três partes: a primeira mostra como configurar o ambiente de desenvolvimento, a segunda mostra uma aplicação JSF comum (bem simples mesmo) de cadastro e, na terceira e última parte, introduziremos o framework Seam. É realmente uma aplicação bem simples… se você já deu uma olhada nas aplicações de exemplo que acompanham o Seam, você perceberá que a aplicação que desenvolveremos é muito parecida - se não igual - à aplicação “Registration“. Mas enfim, melhor do que conseguir rodar uma aplicação que já está pronta é criarmos a nossa do zero, não é mesmo? Fica melhor para entendermos o processo de criação e configuração dos frameworks.

Então, vamos parar com essa conversinha afiada e ir ao ponto que nos interessa!

Baixando os arquivos

Antes de começarmos a desenvolver, você precisa baixar alguns arquivos. Segue a lista:

• JBoss JEMS Installer, versão 1.2.0 BETA - Esta era a última versão disponível quando o tutorial foi criado. NÃO baixe uma versão anterior a esta, pois lá na frente poderá ocorrer erros no módulo de EJB 3.0, por algumas funções ainda não estarem presentes e que são utilizadas pelo JBoss Seam;
• JBoss Seam 1.0.1 GA - Embora exista para download a versão 1.1 Beta, prefira baixar a versão 1.0.1, pois foi nesta que eu testei e funcionou… se você quiser mesmo assim baixar a versão 1.1 Beta, baixe por sua conta e risco;
• NetBeans 5.5 - Eu utilizei o NetBeans 5.5 pois ele melhorou muito no quesito EJB3/JSF. Se você quiser utilizar outras ferramentas, novamente, o faça por sua conta e risco;

Acho que são só esses programas… não que seja pouco, pois eles já demandam um bom tempo de download, né?!

Montando o ambiente

Antes de criarmos o projeto no NetBeans, descompacte os pacotes do JBoss e do Seam em um local qualquer na sua máquina e vamos adicionar, tanto o JBoss quanto o Seam, no seu NetBeans.

Então, instale e abra o NetBeans.. as instruções são next, next, next e install (não necessariamente nesta ordem). Para adicionar as bibliotecas do Seam, vá até o menu Tools - Library Manager e crie uma nova Library chamada “Seam”, ou outro nome que você queria. Configure tal Library de acordo com a imagem:

Ok, para adicionar o servidor JBoss, vá até o menu Tools - Server Manager e crie um novo Servidor. Selecione o servidor JBoss Application Server 4 e indique a localização da pasta onde ele está instalado.

Então, vamos ao NetBeans. Crie um novo projeto de acordo com as imagens:

Pressione “Finish” para concluir a criação do nosso projeto. E… é só! Chega ao fim a primeira parte do tutorial. Não deixe de visitar as outras duas partes, onde criaremos uma aplicação Seam funcional!

UPDATE: Não deixe de conferir as partes dois e três do tutorial!