Tutorial Proyecto Web Con Eclipse
Si se han seguido todos los tutoriales anteriores
(Instalacin Eclipse,Instalacin Plugin, Instalacin Servidor), ha estas
alturas ya debemos tener nuestro ambiente de desarrollo listo para trabajar.
En este tutorial vamos a crear un proyecto Web con un pequeo Demo de
aplicacin funcional, Mediante eclipse crearemos un nuevo proyecto JSF
(Java Server Faces) y realizaremos una serie de configuraciones que nos
permitirn generar nuestro cdigo fuente Base desde el cual podremos
seguir trabajando.......................Empecemos.
Requisitos.
IDE Eclipse
Plugin JBoss Tools
JBoss [Link]
JDK 1.6
Variable de Entorno JBOSS_HOME
Variable de Entorno JAVA_HOME
Creacin Del Proyecto.
Desde Eclipse vamos a "File/New/Other..." all se cargar una ventana
donde ingresaremos en el campo la palabra jsf, de esta forma nos aparece
la opcin de JSF Project (Recordemos que para que esta opcin este
disponible, debe estar previamente instalado el plugin JBoss Tools), la
seleccionamos y damos click en Next
Posteriormente ingresamos el nombre del proyecto, dejamos el campo por
defecto JSF Environment y seleccionamos en Template la
opcin JSFKickStartWithoutLibs, con esto, le decimos a Eclipse que
vamos a crear un demo de una aplicacin web (el demo es muy bsico pero
cuenta con interfaz grfica, bean y reglas de navegacin), sino entonces
crearamos el proyecto en blanco, solo con la estructura y configuracin
inicial.
Presionamos Next, acto seguido se carga una ventana donde debemos
configurar el servidor de nuestra aplicacin, (eso sucede porque no se
asign previamente el servidor) indicndonos que el server es requerido,
presionamos en New para asociar el servidor.
Se cargar una ventana donde seleccionaremos el server con el que vamos
a trabajar, para este caso usaremos [Link] que instalamos
previamente en algn directorio de nuestra mquina.
Damos Click en Next y se carga otra ventana indicndonos que se debe
asignar la ruta donde se encuentra alojado server, para esto presionamos
en el botn Browse y buscamos el directorio de instalacin del JBoss
Despus de encontrar el directorio lo seleccionamos y regresamos a la
ventana inicial con la configuracin deseada.
Como vemos ya no tenemos ningn error o advertencia, ahora solo nos
queda dar en Finishpara crear el proyecto, despus de esto se cargara una
ventana de dialogo donde nos preguntan si deseamos cambiar a la
perspectiva Web Development perspective esto es opcional.
Como vemos nuestro proyecto fue creado, y en caso de haber seleccionado
"Yes" en la ventana de dialogo, estaremos en la perspectiva
mencionada (Se puede evidenciar en la esquina superior derecha de
Eclipse)
Esta perspectiva est ms orientada al diseo, puesto que simplemente con
arrastrar y soltar podemos agregar componentes a nuestras pginas, ms
adelante veremos cmo.
Si no se defini esta perfectiva igual seguiremos trabajando normalmente
(para los que no nos gusta arrastrar y soltar) pero en caso de que queramos
acceder a ella, simplemente por"Windows/Open Perspective" la
buscamos y listo.
Ya teniendo nuestro proyecto creado, vamos a hacer un pequeo recorrido
por la estructura del mismo, podemos empezar ya, pero a modo personal
me gusta trabajar con la vistaNavigator ya que me parece un poquito ms
ordenada, sin embargo pueden seguir trabajando por el Project
Explorer (Es cuestin de gustos) Para esto seleccionamos
Window/Show View/Navigator
y listo, tenemos la nueva opcin de navegacin, ahora s, veamos la
estructura del proyecto.
Como vemos tenemos nuestro proyecto web funcional, tenemos el archivo
[Link], el directorio JavaSource que contiene la clase [Link], un bean
creado por defecto, que tiene los mtodos set y get necesarios, Tenemos
tambin un archivo de propiedades donde se establecen todos los mensajes
o texto que tendrn las etiquetas del aplicativo. Tambin podemos ver un
directorio pages que contiene las pantallas de la aplicacin y dentro del
WEB-INF encontramos por ejemplo el archivo [Link] con las
reglas de navegacin entre pginas.
Si ingresamos a la pgina [Link] vemos que gracias al
plugin JBoss Toolspodemos trabajar con las opciones de solo cdigo,
cdigo y pantalla, adems de una vista previa de lo que estamos haciendo.
En la imagen anterior tambin se puede ver en el panel de la derecha las
opciones que brinda la perspectiva recomendada por eclipse, como se
mencion anteriormente solo sera cuestin de elegir el componente que
necesitamos y arrastrarlo al cdigo.
Carga del Servidor desde Eclipse
Para poder desplegar nuestra aplicacin, tenemos que hacer uso del
servidor, para eso desde Eclipse, en caso de que no se encuentre la vista
de servidores, se cargar desdeWindows/Show view/Server all
presionamos click derecho y agregamos new server
Se cargar nuevamente una ventana donde definiremos el servidor a
utilizar, realizando un proceso similar a los anteriores, nuevamente
escogemos JBoss v4.2 y presionamos finish.
Vemos como ha quedado agregado correctamente el servidor.
Ahora aumentaremos el tiempo de espera del servidor, ya que en ocasiones
cuando tenemos aplicaciones muy grandes, el servidor no permite el
despliegue, pues por defecto el tiempo de espera es muy corto, para esto
simplemente damos doble click en el server y aumentamos el tiempo en la
opcin TimesOuts
Ahora para el despliegue de la aplicacin desde eclipse podemos pararnos
en el servidor y dar click derecho, luego seleccionar la opcin Run o
simplemente desde este mismo icono en las opciones de la esquina.
Luego de esto se muestra el progreso del despliegue desde la consola de
Eclipse, vemos que todo est correcto y esperamos hasta que nos indique
que se ha iniciado, tambin se pueden ver otras opciones, por ejemplo
desde el cuadrito rojo podemos finalizar el despliegue (Vemos que es igual
al despliegue desde el [Link] del servidor como evidenciamos en el
tutorialanterior).
Ahora para ejecutar nuestra aplicacin, damos click derecho al [Link] y
seleccionamos run as/run on server (En algunas versiones de Eclipse,
haciendo esto no permite la ejecucin desde el index, tendramos que
verificar haciendo lo mismo pero desde la pgina [Link],
posiblemente se deba a algn error en el plugin)
Acto seguido se carga una ventana indicndonos el servidor configurado,
presionamos Next.
Despus se carga otra donde nos da la opcin de agregar el proyecto que
queremos desplegar, en caso de que no est agregado previamente, o si
queremos agregar otros proyectos asociados al nuestro.
Al presionar Finish se abre un navegador propio de eclipse donde podemos
ver nuestra aplicacin en funcionamiento.
La aplicacin cuenta con reglas de navegacin definidas, tambin el campo
se encuentra validado, por ejemplo, si ingresamos una cadena menor a 3
caracteres, nos informar mediante un error en pantalla.
Luego nos devolvemos usando la flecha "atrs" del navegador e
ingresamos un nombre valido, presionamos el botn y ahora si nos
redirecciona a otra pgina enviando el nombre ingresado como parmetro.
Tambin podemos ver la aplicacin desde cualquier navegador,
simplemente copiamos la ruta generada y con el servidor arriba la podemos
probar.
Si vamos a la carpeta deploy de nuestro servidor, vemos que se ha
generado un archivo .war el cual es el empaquetado del proyecto, lo que
permite que la aplicacin sea desplegada.
Debemos tener en cuenta que este archivo se genera porque desplegamos
el proyecto desde Eclipse, definimos cual servidor asociar y dimos Run
desde ah, entonces el IDE lo que hace es leer esas configuraciones y
almacenar el empaquetado en la carpeta Deploy.
tambin podemos desplegar la aplicacin desde el [Link] como vimos en
otro tutorial, pero la aplicacin que se desplega es la ultima almacenada en
el server, ya que los cambios que hagamos, para que se puedan evidenciar,
tendramos que desplegarlos desde el Eclipse.
En el prximo tutorial, veremos una forma de automatizar ese proceso por
medio de tareas Ant, las cuales podemos configurar para que al ejecutar
una tarea, se realicen una serie de pasos predefinidos como por ejemplo
generar el empaquetado del proyecto, establecer la ruta del mismo, copiarlo
a otro directorio, generar documentacin, entre muchas otras opciones que
esta herramienta nos ofrece.
Nos vemos en una prxima entrada!!!