Wednesday, June 11, 2008

Tutorial JBoss Seam

Nesse tutorial vou mostrar como instalar o eclipse, o JBoss AS, o JBoss Seam, JBoss Tools e criar uma aplicação usando essas ferramentas.

Tutorial JBoss Seam

1 – Introdução

O JBoss Seam é uma emenda como o próprio nome diz, sendo um framework que não consta na especificação oficial JEE 5.
Utilizando a estrutura do Java EE 5 o JBoss Seam é um facilitador da programação para todos os componentes em uma aplicação web.
Focando a produtividade do programador e a escalabilidade da aplicação.
Este tutorial irá explicar como montar o ambiente para desenvolvimento usando o Seam.


2 – Requisitos

JDK (jdk-6u6-windows-i586-p). http://java.sun.com/javase/downloads/index.jsp
Eclipse (eclipse-jee-europa-winter-win32) http://www.eclipse.org/downloads/
JBoss AS (jboss-4.2.2.GA) http://www.jboss.org/jbossas/downloads/
JBoss Seam (jboss-seam-2.0.2.GA) http://www.seamframework.org/Download
JBoss Tools (JBossTools-2.0.1.GA-ALL-win32) http://www.jboss.org/tools/download/index.html


3 – Instalação

1 - Instalar o JDK.
Para instalar o JDK basta rodar o executável.
Segue o link para maiores esclarecimentos:
http://java.sun.com/javase/6/webnotes/install/index.html

2 – Criar uma pasta para o ambiente
Vou criar uma pasta para a instalação do ambiente somente para facilitar na organização.
Crie uma pasta chamada ambiente no diretório C:.
O caminho ficará o seguinte: C:\ambiente

3 – Instalar o eclipse
O eclipse pode ser baixando em uma versão .zip.
Descompacte o eclipse dentro da pasta ambiente.
O caminho ficará o seguinte: C:\ambiente\eclipse

4 – Instalar JBoss AS
Descompacte o JBoss AS dentro da pasta ambiente.
O caminho ficará o seguinte: C:\ambiente\jboss-4.2.2.GA

5 – Instalar JBoss Seam
Descompacte o JBoss Seam dentro da pasta ambiente.
O caminho ficará o seguinte: C:\ambiente\jboss-seam-2.0.2.GA

6 – Instalar o JBoss Tools
Descompacte o JBoss Tools dentro da pasta do ambiente.
O caminho para extrair será o seguinte: C:\ambiente


4 – Configuração

1 – Configurar o Eclipse
Criar uma pasta workspace dentro de ambiente.
O caminho ficará o seguinte: C:\ambiente\workspace
Executar o eclipse c:\ambiente\eclipse\eclipse.
Trocar o workspace para c:\ambiente\workspace
Alterar a perspectiva para Seam.
Window → Open Perspective → Other → Seam.

2 – Configurar o JBoss AS
Window → Preferences → Server → Installed Runtimes → Add
JBoss, a division of Red Hat → JBoss 4.2 Runtime
Altere o home directory para: C:\ambiente\jboss-4.2.2.GA
Configuration: default.

3 – Configurar a visualização do servidor
JBoss Server View → Clicar com o direito → New Server
JBoss AS 4.2 → Next → Next → Finish

4 – Configurar Conectividade
Window → Preferences → Connectivity → Driver Definitions
Hipersonic DB → 1.8 → Add
Hipersonic DB → 1.8 → Hypersonic DB
Driver File(s):
hsqldb.jar → Remove Jar/Zip
Add Jar/Zip C:\ambiente\jboss-4.2.2.GA\server\default\lib\hsqldb.jar
OK


5 – Criação de um projeto

1 – Criar um projeto
File → New → Seam Web Project
Name: agenda
Configurations: Dynamic Web Project with Seam 2.0
Next → Next → Next → Next
Seam runtime: Add
Home Folder: C:\ambiente\jboss-seam-2.0.2.GA
Deploy as: WAR
Database Type: HSQL
Connection profile: HSQL
Finish

2 – Adicionar o projeto ao JBoss
No JBoss Server View
Clique com o direito em JBoss 4.2 Server → Add and remove projects
Agenda → Add → Finish

3 – Iniciar o JBoss
Clique com o direito em JBoss 4.2 Server → Publish
Clique com o direito em JBoss 4.2 Server → Start

4 – Acessar o sistema
Abra um browser e digite: http://localhost:8080/agenda


6 – Conclusão

Com isso temos um ambiente de desenvolvimento gratuito.
E com o poder do Eclipse, JBoss AS, JBoss Seam e JBoss Tools.

7 - Atualização

Para uma versão mais nova do Tutorial JBoss Seam veja o post:
http://silvionetto.blogspot.com/2010/08/ambiente-seam.html

17 comments:

Erick Magnus said...

Muito legal, me ajudou a dar os primeiros passos no JBoss Seam :-)

Espero que possa continuar com mais artigos sobre essa integração Eclipse-JBossSeam.

wesley.dotnet said...

Mas criar componentes Stateless (local) não funfa para este ambiente. Você tem alguma opinião?
Obrigado

cristiano said...

Caro amigo, estou usando o Eclipse Ganymede e não encontrei onde altero a perspectiva para Seam
conforme descrito assim no Europa:
Window → Open Perspective → Other → Seam.

Marvin said...

Cristiano, diferente do tutorial, vc deve descompactar o conteúdo de Jboss Tools nas respectivas pastas do eclipse (resource e plugin) e não na pasta ambiente !

Ruinaldo said...

Bom dia Silvio, fui montar o meu ambiente e na hora de criar o meu projeto disse que a versão do seam não era compativel Baixei os sequintes arquivos:
1. eclipse-jee-ganymede-SR1-win32.zip
2. jboss-4.2.3.GA-jdk6.zip
3. jboss-seam-2.1.1.GA.tar.gz
4.JBossTools-3.0.0.CR1-R200812191611-ALL-win32.zip
e na hora de criar o projeto parei neste passo:
Seam runtime: Add
Home Folder: C:\ambiente\jboss-seam-2.1.1.GA
Aqui ele apresentou este erro: The selected seam appears to be of an incompatible version '2.1.1.GA'
É bem verdade que a versaõ que você recomedou usar não foi esta"2.1.1.GA" porém eu não encontrei esta "jboss-seam-2.0.2.GA"

Ruinaldo said...

Silvio mais uma coisa mais embaixo na mesma tela que apresenta o erro tem um campo onde podemos escolher a versão porém só tema a 1.2

danilo said...

Ruinaldo, vc deve mudar a versão do seam no Facets, na primeira tela do wizard, onde tem configuration, clique em modify e troque a versão do seam para 2.0, ele só vai ter dar a opção de escolher o seam da mesma versão que tiver no Facets.

abraço

Carlos Henrique said...

Eu sei que este tutorial foi escrito já há algum tempo. Eu tentei seguir os passos mas com versões mais atualizadas dos programas, mas tive problemas por não encontrar as mesmas opções descritas na configuração o JBoss e Eclipse.
Seguem os programas baixados:
- eclipse-jee-ganymede-SR1-win32.zip
- jboss-5.0.0.GA-jdk6.zip
- jboss-seam-2.1.1.GA.zip
- JBossTools-2.1.2.GA-ALL-win32.zip
Alguém pode me ajudar com a montagem desse ambiente de desenvolvimento? Eu sou completamente novo com isso, mas tenho que aprender o mais rápido possível.
Obrigado desde já. Se preferir podem me mandar por e-mail (CHLC1966@YAHOO.COM)
Carlos

biande said...

Carlos Henrique e a quem possa interessar, acabei de montar meu ambiente aqui com o Eclipse Ganymede, jboss-5.0.1.GA, jboss-seam-2.1.1.GA e JBossTools-ALL-win32-3.0.0.GA-R200903141626-H5.
Algumas configurações em Window -> Preferences estão em lugares diferentes, mas para mim que tenho praticamente nenhuma intimidade com o Eclipse foi possível configurar tudo perfeitamente, inclusive criar o projeto e executá-lo, sem problema algum.
Abraços

leo said...

pessoal, to tentando instalar o Jboss no mac os x...ja to arrancando os cabelos de doido e nao consigo, nem acho tutorial de como instalar essa porra no mac os x...ate consigo colocar algumas coisas...mas qdo vai pra parte de configurar o servidor jboss...da erro e nao sei onde mexer, se alguem souber ficaria agradecido

Silvio Netto said...

Olá pessoal.
Vou atualizar esse tutorial.
Mas vamos ai pro que eu puder ajudar.
Quanto ao Mac OS.
Eu uso o Snow Leopard e funciona muito bem.
Qual o erro?
Posta ai pra gente poder ajudar.

Leo said...

Bom post

Luiz Henrique said...

mano...

segui os passos direitinho (mas talvez esteja errando em algum lugar, pq nao deu certo), mas qdo inicio o eclipse ele nao tem a perspectiva 'Seam' e tbem nao conseguir configurar o jboss AS....

mais alguma dica?!
onde posso estar errando!?

Cambota said...

* O tutorial que eu segui foi esse, a diferença foi que eu peguei as versões mais atualizadas que estão nele, só o jbosstools que mudou um pouco vem num pacotão com todos os plugins já.

http://silvionetto.blogspot.com/2008/06/tutorial-jboss-seam.html

o nome do arquivo do jbosstools que eu baixei, jbosstools-3.2.0.M1.aggregate-Update-2010-07-20_01-43-30-H34

* ai chegando no passo da instalação do jbosstools do tutorial acima, você ignora ele e passa para esse tutorial:
http://www.jboss.org/tools/download/installation/update_3_1.html

você vai começar direto na parte 7 do tutorial, eu instalei o pacote inteiro com todos os plugins. nessa parte vai aparecer muitas janelas, mas é só dar next msm...

* depois é so voltar para o primeiro tutorial e continuar na parte de configuração. Alguns caminhos e nomes das opções que estão no tutorial mudaram um pouco, mas você irá achar com facilidade.



eu montei esse "guiazinho" prum amigo meu, ta muito alto nível, mas acho que da para entender, tive dificuldade pra instalar mas com base nesse tutorial e umas buscas no google eu consegui.

vlw!

Silvio Netto said...

Ai pessoal dei uma atualizada!!! :D

Daniela Lopes said...

Silvio, legal o seu tutorial!

Sabe me dizer por que está ocorrendo este erro:

"org.jboss.deployment.DeploymentException: url file:/C:/jboss/jboss-4.2.2.GA/server/default/deploy/Agenda-ear.ear/jboss-el.jar could not be opened, does it exist?"

Este mesmo erro já ocorreu em relação ao arquivo jboss-seam.jar, agora é com o jboss-el.jar (conforme acima.

Que posso fazer?

Grata,
Daniela

Silvio Netto said...

Olá Daniela,

Te aconcelho a usar o tutorial mais recente escrito em 2010.
Esse ai foi escrito em 2008 e pode haver incompatibilidade e problemas devido as versões dos jars atuais.
Assim como a versão do JBoss e do próprio Seam.
Segue o link de como montar o ambiente: http://silvionetto.blogspot.com/2010/08/ambiente-seam.html