Documentos de Académico
Documentos de Profesional
Documentos de Cultura
Crear Una Aplicacion JBoss Seam Con Eclipse
Crear Una Aplicacion JBoss Seam Con Eclipse
06/06/2011 |
Autor elomas
Que es SEAM?
Seam es una potente plataforma de desarrollo de cdigo abierto para construir aplicaciones ricas de
Internet en Java. Seam integra tecnologas como JavaScript asncrono y XML (AJAX), JavaServer Faces
(JSF), Java Persistence (JPA), Enterprise Java Beans (EJB 3.0) y Business Process Management (BPM)
en una unificada y completa solucin de pila, con sofisticadas herramientas.
Seam ha sido diseado desde cero para eliminar la complejidad en la arquitectura y los niveles de la API.
Permite a los desarrolladores ensamblar aplicaciones web complejas con simples clases Java anotadas,
un amplio conjunto de componentes de interfaz de usuario, y muy poco XML. Soporte nico de SEAM
para las conversaciones y la administracin del estado declarativa puede introducir una experiencia de
usuario ms sofisticada y, al mismo tiempo la eliminacin de los errores comunes que se encuentran en
las aplicaciones web tradicionales.
Crear un Aplicacin Seam con eclipse
Una aplicacin Seam la podemos crear mediante seam-gen el cual es una herramienta de linea de
comandos, y mediante el IDE eclipse.
Para nuestro ejemplo vamos a utilizar los siguente:
1.
jdk-6 (Descargar)
2.
eclipse-jee-helios (Descargar)
3.
jbosstools-3.2.0.GA (Descargar)
4.
jboss-seam-2.2.2.Final (Descargar)
5.
jboss-as-distribution-6.0.0.Final (Descargar)
6.
postgresql-8.4.3-1 (Descargar)
7.
postgresql-8.4-701.jdbc (Descargar)
Una vez que hemos decargado todo, instalamos JDK y configuramos el JAVA_HOME, instalamos JBoss
tools en nuestro eclipse, y empezamos (De la instalacin y configuracin de estas herramientas existen
muchos tutoriales).
Empezamos a crear nuestra aplicacin, para lo cual vamos a necesitar una base de datos definida para
nuestra aplicacin, para este ejemplo unicamente vamos a utilizar una base de datos simple en cual
vamos a tener 2 tablas relacionadas.
Aqui le dejo el script de la base da datos que vamos a utilizar:
01
02
03
04
05
06
07
08
09
10
11
12
13
14
15
16
17
Para el ejemplo el nombre de nuestra base de datos va a ser TestSeam, estamos trabajando en nuestro
servidor postgres local por lo tanto la direccin del servidor es localhost, y el puerto es el puerto por
defecto es decir el 5432. Esta informacin la vamos a utilizar mas adelante.
Lo primero que vamos a hacer en este momento es abrir nuestro eclipse al cal instalamos los plugins de
JBoss Tools, y empezamos con la creacin y configuracin del proyecto al cual lo vamos a
denominar SeamTest.
1.- En la barra de men vamos a File > New > Other y se nos abre un wizard para la creacin del
proyecto, en el campo de texto del wizard escribimos la palabra seam, de la siguiente manera:
2.- Seleccionamos la opcion Seam Web Project y damos clic en el botn Next. Nos aparece la
siguiente pgina del wizard
3.- En el campo Project name, ponemos el nombre del proyecto el cual dijimos que se iba a
llamar SeamTest, en el campo Target runtime damos clic en el botn New Runtime Nos aparece la
siguiente pantalla
En esta ventana seleccionamos JBoss Community > JBoss 6.0 Runtime, que es el servidor con el cual
vamos a trabajar en este ejemplo, ademas chequeamos la opcion Create a new local server, y damos
clic en el botn Next >, nos parace la siguiente ventana
En la seccin Home Directory, damos clic el botn Browse y buscamos la carpeta en la que
descomprimimos
nuestro
jboss-as-distribution-6.0.0.Final
que
descargamos,
en
la
seccin Directoryseleccionamos default que es la instancia del servidor en la que va a correr nuestro
proyecto y damos clic en Finish y listo tenemos configurado nuestro runtime.
4.- Damos clic en el botn siguiente de nuestro Wizard New Seam Project y nos aparece las siguiente
pgina del wizard, en esta pgina no vamos a hacer nada unicamente vamos a dar clic en Next >, ya que
aqui se aade las carpetas que van a contener el codigo fuente y no necesitamos mas que la src.
4.- En la cuarta pgina del wizard, tenemos un campo para poner nuestro Context root, que para este
ejemplo va a ser el mismo.El contexto root es el nombre con el cual se va a deployar nuestra aplicacin y
con
el
cual
lo
vamos
a
poder
ver
en
el
navegador
http://<servidor>:<puerto>/<context_root>.Ejm: http://localhost:8080/SeamTest. Y ademas tenemos otro
campo para el Content directory, en este campo vamos a poner el nombre de nuestra carpeta que va a
tener todo el contenido web, por estandar vamos e dejarla con el mismo nombre.
La seccin URL Mapping Patterns, son las extensiones que nos va a mapear como pginas SEAMque
para este caso son todas las .seam, por eso es que tenemos como valor *.seam.
Una vez que tenemos lista esta pgina del wizard damos clic en el botn Next >.
6.- Esta pgina del wizard es la que va a tener toda la configuracin de nuestro proyecto seam. La
pantalla es la siguiente
En esta ventana vamos primero a agregar nuestro Seam Runtime, para lo cual vamos a la
seccinGeneral en la parte donde dice Seam Runtime le damos clic en el botn Add para agregar un
nuevo runtime de seam, si es que no tenemos agregado uno. Y nos aparece la siguiente ventana.
En esta ventana damos clic en el botn Browse, buscamos la carpeta en la cual descomprimimos
nuestro jboss-seam-2.2.2.Final que descargamos, y damos clic en Aceptar y nuestra ventana deberia
quedar de la siguiente manera
Una vez listo esto damos clic en el botn Finish y listo tenemos configurado nuestro Seam Runtime.
Ahora la pgina de nuestro wizard debera estar de la siguiente manera.
Luego tenemos una seccin que dice Deploy as, y tenemos dos opciones WAR y EAR, nosotros
tenemos que seleccionar una de estas opciones, para nuestro ejemplo vamos a dejar seleccionada la
opcin WAR la cual es por default.
Ahora vamos a la seccin Database, en esta seccin vamos a configurar la conexin a la base de datos
de nuestra aplicacin. Para lo cual en la seccin Database Type seleccionamos PostgreSQL, y en la
seccin Connection profile damos clic en el botn New y nos aparece la siguiente ventana.
En esta ventana debemos seleccionar el driver JDBC de postgres, como no tenemos ninguno vamos a
agregar uno. Para eso damos clic el icono que se encuentra en la parte derecha del comboBox, el
botn New Driver Definition. Una vez que damos clic en dicho botn nos parace una nueva ventana.
En esta ventana seleccionamos PostgresSQL JDBC Driver y podemos ver en la parte superior que nos
sale un error, debido a que no encuentra el driver para ello vamos a la pestaa JAR List.
En esta pestaa vamos a dar clic en el botn Add JAR/Zip y se nos abre un navegador de archivos
buscamos nuestro postgresql-8.4-701.jdbc.jar que descargamos y damos clic en Abrir. La pantalla nos
deberia quedar de la siguiente manera.
La ltimo que nos queda hacer es seleccionar la opcin postgresql-8.1-404.jdbc2.jar y dar clic en el
botn Remove JAR/Zip, una vez que realizamos esto vemos que se nos habilita el botn OK damos clic
ahi y hemos terminado de configurar el driver.
Nuevamente regresamos a la pantalla New JDBC Connection Profile pero esta pantalla ya nos aparece
de la siguiente manera.
Si el mensaje es Ping succeeded! quiere decir que la informacion ingresamos correctamente, y se realizo
la conexin a la base de datos. Entonces damos clic en el botn OK del mensaje, y luego en el
botn Finish de la ventana y asi hemos terminado nuestra configuracin para la seccin Connection
Profile.
En la seccin Database Schema Name, colocamos el nombre de nuestro esquema que en este caso
como no creamos ninguno es public, adicionalmente dejamos en blanco el campo Database Catalog
Name, deseleccionamos las opciones DB Tables already exists in database, y la opcin Recreate
database table and data on deploy.
Y en la ltima seccin Code Generation, ponemos el nombre del paquete que va a contener nuestros
beans, el que va a contener el modelo, y deseleccionamos la opcin Create Test Project ya que no
necesitamos un proyecto para test para este ejemplo.
La ventana nos queda de la siguiente manera.
Una vez que tenemos listo damos click en Finish esperamos un momento, luego nos sale un mensaje
que nos dice que nuestro proyecto esta asociado con seam, si deseamos abrir la perspectiva de seam
damos clic en si y listo hemos creado nuestro proyecto Seam.
ndice de contenidos.
1.
2.
3.
4.
5.
6.
7.
8.
Introduccin.
Entorno
Configuracin del proyecto (seam setup)
Generando la estructura del proyecto (seam new-project)
Generando la funcionalidad del proyecto (seam generate-entities)
Despliegue del proyecto
Probando la aplicacin
Conclusiones.
1. Introduccin
Este tutorial pretende ser una gua introductoria al Framework JBoss Seam utilizando el seam-gen.
El seam-gen es una utilidad que trae JBoss Seam para crear el cdigo fuente de la aplicacin con
el nico requisito de tener una base de datos del que sacar la lgica de negocio en base al modelo
de datos especificado. El proceso de creacin no puede ser ms sencillo, nos ir preguntando el
nombre del proyecto, ubicacin del servidor de aplicaciones, la base de datos que queremos
utilizar, nombres de paquetes, empaquetamiento del proyecto (ear/war), etc. Con esto generar la
aplicacin que nos servir de base para continuar desarrollando la lgica de negocio y dems
funcionalidades del proyecto. Iremos viendo los pasos necesarios para crear una aplicacin web de
una sencilla biblioteca.
2. Entorno
El tutorial est escrito usando el siguiente entorno:
Hardware: Porttil Acer Aspire 5920G (Core Duo T8300 2.4GHz, 3GB RAM, 320 GB HD).
Sistema operativo: Windows Vista
JBoss Seam 2.2.0.GA
JBoss AS 5.1.0.GA
JDK 1.6
Apache Ant 1.7.1
una serie de propiedades que se necesitan para crear la estructura del proyecto y que debemos ir
configurando.
27.
[echo] JDBC URL: jdbc:mysql://localhost:3306/biblioteca
28.
[echo] Database username: biblioteca
29.
[echo] Database password: *****
30.
[echo]
31.
[echo] Type 'seam create-project' to create the new project
32. BUILD SUCCESSFUL
Tambin se habr generado un build.properties en D:\Desarrollo\jboss-seam-2.2.0.GA\seam-gen
para que con una tarea de Ant se genere todo el proyecto
Antes de ejecutar el script de creacin del proyecto necesitamos tener una base de datos de donde
Seam pueda sacar la estructura necesaria. La base de datos de la biblioteca que vamos a crear es
muy sencilla, tendr tres tablas (libro, autor y reserva). El script de creacin de la base de datos y
las tablas es el siguiente:
view plainprint?
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
29.
30.
31.
32.
33.
34.
35.
36.
37.
38.
39.
40.
41.
Como se puede ver nos ha creado los ficheros de configuracin de Eclipse (.classpath y .project) y
tambin de Netbeans (carpeta nbproject) para que podamos abrir el proyecto en nuestro IDE
favorito.
Si navegamos por la estructura de directorios que nos ha creado vemos algunas clases
interesantes, por ejemplo las clases Authenticator y AuthenticatorBean dentro del directorio
src\main\com\autentia\tutoriales\entity para securizar nuestra biblioteca y que nicamente
puedan acceder usuarios autorizados. Por defecto aade el siguiente cdigo:
view plainprint?
1. @Stateless
2. @Name("authenticator")
3. public class AuthenticatorBean implements Authenticator {
4.
@Logger private Log log;
5.
6.
@In Identity identity;
7.
@In Credentials credentials;
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23. }
7. Probando la aplicacin
Antes de arrancar el servidor ser necesario copiar el driver MySQL al directorio server/default/lib
de JBoss. Para arrancar ejecutamos el script D:\Servidores\jboss-5.1.0.GA\bin\run.bat y entramos
en la aplicacin mediante http://localhost:8080/biblioteca
Nos logamos en la aplicacin pinchando en la opcin 'Login' situada en la parte superior derecha.
Por defecto Seam configura la seguridad de manera que permite ver los listados sin necesidad de
estar logado pero s que lo requiere para dar de alta, modificar o borrar una entidad. Esta
lgicamente podremos configurarlo en funcin de nuestras necesidades. Observad tambin que los
textos no estn estn en ingls. Para ponerlos en espaol basta con crear un
messages_es.properties y aadir un nuevo soporte para el idioma espaol en el faces-config.xml
Ya slo nos queda probar la aplicacin que nos ha generado Seam. Para ello accedemos a las
opciones 'Libro List' y 'Socio List' para dar de alta unos cuantos datos con los que probar.
Alta de un libro
Listado de libros
Listado de socios
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
package com.autentia.tutoriales.action;
import
import
import
import
import
com.autentia.tutoriales.entity.*;
java.util.ArrayList;
java.util.List;
org.jboss.seam.annotations.Name;
org.jboss.seam.framework.EntityHome;
@Name("libroHome")
public class LibroHome extends EntityHome<Libro> {
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
29.
30.
31.
32.
33.
34.
35.
36.
37.
38.
39.
40.
41.
42.
43.
44.
45.
46.
47.
48.
49. }
Componente LibroList
view plainprint?
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
package com.autentia.tutoriales.action;
import
import
import
import
com.autentia.tutoriales.entity.*;
org.jboss.seam.annotations.Name;
org.jboss.seam.framework.EntityQuery;
java.util.Arrays;
@Name("libroList")
public class LibroList extends EntityQuery<Libro> {
private static final String EJBQL = "select libro from Libro libro";
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
29.
30. }
Si queremos generar la interfaz con ICEFaces en lugar de Richfaces nicamente tendramos que
cambiar el parmetro 'icefaces=y' dentro del build.properties generado dentro de
D:\Desarrollo\jboss-seam-2.2.0.GA\seam-gen\build.properties.
8. Conclusiones.
Como aspecto ms importante a destacar de la utilidad seam-gen de JBoss Seam es su facilidad
de uso y la flexibilidad que te da, ya que permite configurar el proyecto a nuestro gusto. Tambin
es verdad que no aporta todo lo que necesitamos pero es til para empezar con un proyecto con
JBoss Seam desde cero.
Como aspecto negativo est que no nos crea el proyecto para maven, espero que esto lo mejoren
en futuras versiones.
http://www.jboss.org/jbosside/download/old_downloads.html
http://download.jboss.org/jbosstools/updates/stable/helios/
http://www.jboss.com/products/platforms/application/
para descargar herramientas jboss