Habilitar autocompletado de etiquetas para JSF en un proyecto Eclipse gestionado por Maven.
0. Índice de contenidos.
1. Introducción
Este es un tutorial sencillo, pero muy útil, sobre como habilitar Eclipse para que tengamos el soporte de autocompletado de etiquetas en
nuestros fuentes JSF. En un proyecto creado por Elcipse no hay que configurar nada, pero si el proyecto lo gestiona Maven y nosotros
trabajamos con un plugin como m2eclipse, por defecto, no tenemos dicho soporte, hay que habilitarlo.
¿Podemos trabajar sin autocompletado?, Si, pero seremos más felices trabajando con sugerencias y teniendo de primera mano la documentación del api. Sin duda.
2. Entorno.
El tutorial está escrito usando el siguiente entorno:
- Hardware: Portátil MacBook Pro 17′ (2.93 GHz Intel Core 2 Duo, 4GB DDR3 SDRAM).
- Sistema Operativo: Mac OS X Snow Leopard 10.6.1
- Eclipse Helios SR2
3. Habilitar la faceta de JSF en un proyecto Maven.
La configuración es simple, pero tiene sus pequeños detalles. Lo primero es acceder a las propiedades de nuestro proyecto web pulsando sobre el mismo: botón derecho > properties.
En la sección de project facets, deberíamos tener algo similar a esto:
Seleccionamos JSF, con el número de versión con el que trabaje nuestro proyecto, en la captura, la versión 1.2:
En la parte inferior se muestra el enlace «Further configuration required…», pulsando sobre el mismo nos mostrará una ventana
como la que sigue:
En esta ventana tenemos que seleccionar la librería de JSF con la que estamos trabajando y para ello:
- podemos indicar una librería de usuario o añadirla seleccionando los jars que ya tenemos en local de la implementación de JSF con la que trabajemos, o
- podemos seleccionar una versión para su descarga de internet, pulsando sobre el icono de download. En este caso se descarga a disco para su uso.
Tanto si usamos una opción como la otra no debemos seleccionar «include libraries with this application». Las librerias de nuestra aplicación
las gestiona maven y no queremos que incluya las seleccionadas en nuestro proyecto.
Nosotros vamos a usar la primera técnica creando una librería de usuario seleccionando los jars que ya tenemos en local en el repositorio de maven.
Para ello, una vez pulsando el botón de librerías se mostrará una ventana como la que sigue:
Tras pulsar sobre «New» nos solicita un nombre para la librería
Lo siguiente es añadir los dos jars de JSF, el del api y el de la implementación, los podemos buscar bajo el repositorio de maven
puesto que ya las deberíamos tener descargadas en el repositorio local:
La ventana de configuración de JSF quedaría como sigue:
Solo queda pulsar «OK».
El «facetado» de nuestro proyecto implica que Eclipse modifique «levemente» la configuración del descriptor de despliegue web.xml para
añadir las siguientes líneas:
Tenemos que eliminarlas del fichero para no modificar los ficheros de configuración que, hasta ahora, veníamos usando.
Con todo ello, deberíamos tener el soporte de autocompletado en nuestros fuentes JSF:
4. Conclusiones.
Como os decía, simple pero con algún «truco».
Si os hacía falta, espero que lo disfrutéis.
Un saludo.
Jose
