Anterior

Siguiente

2.5. Crear un Proyecto con Maven

La librería principal de Vaadin y todo los complementos Vaadin están disponibles a través de un repositorio Maven y por lo tanto puede utilizarse fácilmente con Apache Maven. Puede utilizar Maven con un interfaz-grafica de Eclipse o NetBeans, o utilizando la línea de comandos como se describe en esta sección.

Puede crear un nuevo proyecto Maven con el siguiente comando:

$ mvn archetype:generate
    -DarchetypeGroupId=com.vaadin
    -DarchetypeArtifactId=vaadin-archetype-clean
    -DarchetypeVersion=LATEST
    -DgroupId=tu.compania -DartifactId=nombre-proyecto -Dversion=1.0 -Dpackaging=war

Los parámetros son los siguientes:

archetypeGroupId
El group ID del arquetipo es com.vaadin para arquetipos Vaadin.

archetypeArtifactId
El archetype ID. Vaadin es compatible actualmente con los siguientes arquetipos:

• vaadin-archetype-clean es un nuevo proyecto con un esqueleto barebone para una aplicación Vaadin regular. El archivo pom.xml incluye como-comentario las definiciones para los widgets adicionales.
• vaadin-archetype-widget es un esqueleto para un proyecto con widgets personalizados.
• vaadin-archetype-sample también es para el proyecto con widgets personalizados, pero el esqueleto incluye el ejemplo Color Picker utilizado en el Capítulo 11, Desarrollar Nuevos Componentes.
• vaadin-archetype-addon es para proyectos de complementos Vaadin. Este empaqueta el complemento para que pueda ser publicado en el Directorio Vaadin. El arquetipo es para complementos del lado del servidor y no incluye las definiciones necesarias para la construcción de un conjunto de widgets. Si su complemento incluye o requiere que no sean los widgets de la librería principal Vaadin, debe copiar las definiciones necesarias desde un POM de un proyecto vaadin-arquetipo-clean.
• vaadin-archetype-touchkit es para proyectos con Vaadin TouchKit, descrito en el Capítulo 19, Aplicaciones Mobiles con TouchKit. Tenga en cuenta que este arquetipo utiliza la versión con licencia AGPL de TouchKit, que exige que el proyecto también debe ser licenciado bajo la licencia AGPL.

archetypeVersion
Versión del arquetipo a usar. Este normalmente debería ser LATEST.

groupId
Este es utilizado para el nombre del paquete Java y normalmente debe ser su nombre de dominio invertido, tal como com.example.myproject. El group ID es utilizado también para el nombre del paquete fuente de Java de su proyecto, por lo que debe ser compatible con Java - sólo caracteres alfanuméricos y un subrayado.

artifactId
Identificador del artifact, este es, su proyecto. El identificador puede contener caracteres alfanuméricos, menos, y subrayado.

version
Número de la versión inicial de su aplicación. El número debe obedecer al formato de la numeración de la versión de Maven.

packaging
Como será empaquetado el proyecto. Normalmente este es un war.

La creación de un proyecto puede tardar un poco ya que Maven busca todas las dependencias. La estructura del proyecto creado se muestra en la Figura 2.8, "Un Nuevo Proyecto Vaadin con vaadin-archetype-clean".

Figura 2.8. Un Nuevo Proyecto Vaadin con vaadin-archetype-clean

Compilar y Ejecutar la Aplicación

Antes de que la aplicación pueda ser desplegada, debe ser compilada y empaquetada como un paquete WAR. Usted puede hacer esto con el goal package de la siguiente manera:

$ mvn package
La ubicación del paquete WAR resultante debe mostrarse en el comando de salida. Luego puede desplegarlo en su servidor de aplicaciones favorito.

La forma más fácil de ejecutar aplicaciones Vaadin con Maven es utilizar el servidor web ligero Jetty. Después de compilar el paquete, todo lo que necesita hacer es teclear:

$ mvn jetty:run
El goal especial arranca el servidor Jetty en el puerto 8080 y despliega la aplicación. Luego puede abrirlo en un navegador web en http://localhost:8080/nombre-proyecto.

Utilizar Complementos y Conjuntos de Widget Personalizados

Si utiliza complementos Vaadin que incluyen un conjunto de widgets o hace sus widgets personalizados, necesita habilitar la compilación de conjunto de widget en el POM. La configuración requerida se describe en la Sección 15.5, "Usar Complementos en un Proyecto Maven".

Anterior 2.4. Crear un Proyecto con Netbeans

Arriba Inicio

Siguiente Capítulo 3. Arquitectura

Anterior

Siguiente

2.4 Crear un Proyecto con NetBeans

Vaadin no tiene un plugin oficial para NetBeans en este momento, por lo que las tareas tienen que hacerse más manualmente que con Eclipse.

Tiene dos opciones para crear un proyecto Vaadin en NetBeans: como un proyecto de aplicación web regular o como un proyecto Maven. Abarcamos estas dos formas en las siguientes secciones.

2.4.1. Proyecto de Aplicación Web Regular

En esta sección se describe la manera básica de crear un proyecto de aplicación Vaadin en NetBeans. Este enfoque es útil si no desea utilizar Maven, pero requiere más trabajo manual.

1. Abra Archivo → Proyecto Nuevo....
2. Seleccione Java Web → Web Application y haga clic en Next.
3. Proporcione un nombre al proyecto, como miproyecto. Como el nombre del proyecto también se utiliza por defecto como la ruta de contexto, este debe contener sólo caracteres alfanuméricos, subrayado y signo menos. Haga clic en Siguiente.
4. Seleccione un servidor. La referencia de herramienta de programación recomienda Apache Tomcat, ya que muchas instrucciones en este libro se dan específicamente para Tomcat, pero cualquier otro servidor debería funcionar igual de bien. Haga clic en Siguiente.
5. Haga clic en Finish.

El proyecto es creado. Sin embargo, es un simple esqueleto para un proyecto web basado en una aplicación JSP. Para que sea un proyecto Vaadin adecuado, es necesario incluir la librería Vaadin, crear la clase application y definir el descriptor de despliegue web.xml.

2.4.2. Proyecto Maven desde un Arquetipo Vaadin

La creación de un proyecto Maven con el arquetipo Vaadin es más simple que un proyecto de aplicación web regular en NetBeans. Este crea un esqueleto de la aplicación, define el descriptor de despliegue web.xml, y también recupera automáticamente la librería más reciente de Vaadin.

1. Seleccione Archivo → Proyecto Nuevo....
2. Seleccione Maven → Project from Archetype y haga clic en Siguiente.
3. Seleccione un arquetipo desde un repositorio:
   
   
   • Si ha utilizado Vaadin con Maven antes, puede que ya tenga el arquetipo en el repositorio local - seleccione Archetypes from Local Repository.
   • Agregue un nuevo arquetipo haciendo clic en Add. Para Group Id, poner com.vaadin. Para Artifact Id, poner vaadin-archetype-clean para un proyecto normal, vaadin-archetype-widget para un proyecto widget GWT personalizado, o vaadin-archetype-sample para un esqueleto más avazado de application. Para Version, poner LATEST o especificar el número de la versión. A continuacion, haga clic en OK.
     
     Figura 2.6. Agregar un Nuevo Arquetipo en NetBeans
     
     
     A continuacion seleccione el Arquetipo personalizado - vaadin-archetype-clean (LATEST) desde el arbol de seleccion.
   Haga clic en Siguiente.
4. En el paso Nombre y ubicación, introduzca el Nombre del Proyecto, el cual se recomienda que sea sólo carácteres alfabéticos en minúsculas, ya que también es utilizado como una sugerencia para el nombre del paquete Java del proyecto. Modifique los otros parámetros de su proyecto y haga clic en Terminar.
   
   Figura 2.6. Agregar un Nuevo Arquetipo en NetBeans
   
   

La creación del proyecto puede tomar un tiempo ya que Maven carga todas las dependencias necesarias. Una vez creado, se puede ejecutar haciendo clic derecho sobre el proyecto en la vista Proyectos y seleccionando Ejecutar. En la ventana Select deployment server que se abre, seleccione Apache Tomcat y haga clic en Aceptar. Si todo va bien, NetBeans inicia el servidor y lanza el navegador por defecto para mostrar la aplicación web.

Anterior 2.3. Tu Primera Proyecto con Vaadin

Arriba Inicio

Siguiente 2.5. Crear un Proyecto con Maven