instalamos el Tomcat en el puerto 8080 que viene por

Creo que uno de los trabajos mas tediosos cuando se empieza a probar una tecnología que uno desconoce, es
armar el ambiente, ver que librerías se usan, donde conseguirlas, y demás problemas que pueden surgir.
Muchas veces los tutoriales o libros nos muestran un "Hola Mundo" de prueba, pero no sabemos por donde
empezar!
•
•
•
•
•
Voy a mostrarles que es necesario para implementar un Hola Mundo en JSF con el Ide Eclipse.
Que necesitamos?
Apache Tomcat 6.0.20
Eclipse Galileo
JRE 6
JSF 1.2 api e implementación
JSTL 1.2 api e implementación.
Para correr Jsf necesitmos un web container; vamos a utilizar Apache Tomcat 6.0.20. Si usamos Windows,
podemos descargar el paquete Core-->Windows Service Installer, que viene con un instalador. Si
instalamos el Tomcat en el puerto 8080 que viene por defecto, podemos probar si la
instalación salió bien abriendo un navegador y en la url escribimos http://localhost:8080,
deberíamos ver una pantalla similar:
Vamos a utilizar el Ide Eclipse Galileo, esta versión es para desarrollar aplicaciones EE y Web, también viene
con herramientas para utilizar JPA, JSF, y otros. Una vez descargado descomprimimos el archivo en el
disco, generalmente se descomprime en c:\Eclipse en el caso de utilizar Windows.
Ya tenemos el Ide y el Web Container. Recordemos que para utilizar Tomcat 6 necesitamos JRE 6.
Bien, vamos a utilizar JSF 1.2. Para ello necesitamos descargar las librerías Jsf Api y Jsf Imp; la api y la
implementacion respectivamente. Descarguemos la implementación desde el Project Mojarra,
precisamente el archivo 1.2_13.Binary, que contiene un .Zip con el nombre mojarra-1.2_13-binary.zip,
aquí se encuentran las librerías que necesitamos, también documentos y ejemplos. Creamos un directorio
que se llame librerías, en el c:. Abrimos el .Zip descargado, buscamos el directorio lib, y copiamos los
archivos jsf-api.jar y jsf-impl.jar al directorio c:\librerías.
Por último necesitamos descargar la JSTL 1.2; la api y la implementación. De aquí obtenemos 2 jars, jstlapi-1.2.jar y jstl-impl-1.2.jar. Una vez descargadas las librerías, lo recomendable es que se copien en el
directorio lib del tomcat, para que cada proyecto que use Tomcat, disponga de las librerías. Si instalamos el
tomcat en C:\Archivos de programa\Apache Software Foundation\Tomcat 6.0, vemos que dentro se encuentra
el directorio lib.
Configurando el server
Aprovenchando que tenemos el Apache Tomcat debidamente instalado, vamos a integrarlo al eclipse para que
nuestros proyectos web puedan usarlo, sino irremediablemente no funcionarán.
Accedemos al menú Window-> Preferences, se abrirá un diálogo.
Navegamos por el árbol, seleccionamos Server y Runtime Environments. Aquí debemos especificar que
servidor vamos a utilizar. Presionamos Add y se nos despliegan posibles servidores a usar. Nosotros
seleccionamos Apache Tomcat 6.0.
Clickeamos Next y nos piden la configuración del servidor. En Tomcat installation directory, debemos
introducir la ruta donde se instaló el Tomcat; en mi caso lo instalé en la ubicación por defecto C:\Archivos de
programa\Apache Software Foundation\Tomcat 6.0.
Luego seleccionamos la JRE a utilizar, puede ser por defecto u otra que tengamos instalada. Recuerden que
el Tomcat 6.0 necesita JRE 6.
Listo! ya tenemos el servidor Apache Tomcat 6.0 listo para utilizar en nuestros proyectos web.
Creando el proyecto
Si seguimos con éxito los pasos anteriores vamos a poder crear nuestro primer proyecto en JSF. Vamos a
llamarlo "Hola Mundo"; nombre pocas veces usado...
Una vez abierto el eclipse, hacemos botón derecho sobre el Project Explorer, y seleccionamos New ->
Dynamic Web Porject.
Nos encontramos con un Diálogo preguntandonos por las propiedades del proyecto que vamos a crear.
En Project Name, escribimos el nombre del proyecto, en nuestro caso HolaMundo. En el comboTarget
Runtime, nos preguntan que servidor vamos a usar, desplegamos y seleccionamos Apache Tomcat v6.0.
En Configuration debemos especifiacar que el proyecto va a utilizar JavaServer Faces 1.2.
Presionamos Next; la pantalla siguiente nos pregunta si queremos cambiar los directorios donde se encuentran
los .java ources y los .class generados. Si no tenemos intención de cambiarlos presionamos Next. Vamos a
ver que aparece el siguiente diálogo.
El Context root es lo que se llama el contexto de la aplicación web. Las páginas que accedamos mediante el
navegador, van a tener la siguiente url: http://ServerName:port/contextRoot/pages, supongamos que
estamos corriendo localmente nuestro proyecto y queremos acceder a inicio.html, en el navegador
escribimos, http://localhost:8080/HolaMundo/inicio.html. Se ve claramente queHolaMundo es nuestro
contexto.
En el Content directory vamos a guardar nuestras páginas html, jsp, archivos css, javascript, etc.
Seguimos adelante y vemos que la próxima pantalla es un poco distinta de las demás. Aquí se nos pide que
configuremos JSF.
Necesitamos decirle al proyecto donde se encuentran las librerías de JSF. Las mismas las descargamos en el
directorio c:\librerias. Presionemos Manage Libraries.
A nuestra libería le pondremos el nombre JSF_1.2_Libreria.
Bien, la librería está creada, pero no tiene los jars que descargamos anteriormente y guardamos enc:\librerias.
Agreguémoslos. Presionamos Add JARs.
Tenemos que ir al directorio c:\librerias, y seleccionars los jars jsf-api y jsf-impl.
Una vez agregados los jars, tildamos la librería recien creada.
Ya estamos en condiciones de finalizar la configuración del proyecto. Seguramente nos llama la atención la
parte inferior del diálogo. Veamos que es.
/WEB-INF/faces-config.xml es el xml de configuración que utiliza JSF; en el se especifica la navegación,
managed beans, converters y muchas cosas mas.
JFS utiliza un servlet, en este caso de llama Faces Servlet. Si vemos URL Mapping Patterns, tiene el
valor /faces/*. Esto significa que todas las url que sean precedidas por /faces, serán manejadas por el Faces
Servlet. Por ejemplo, si accedemos al recurso http://localhost:8080/HolaMundo/faces/inicio.jsp, éste será
manejado por el servlet en cuestión y puede utilizar las propiedades de JSF.
En el próximo tutorial vamos a codificar nuestro primer Hola Mundo!, espero les halla servido.