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:
Los parámetros son los siguientes:
El group ID del arquetipo es
El archetype ID. Vaadin es compatible actualmente con los siguientes arquetipos:
Versión del arquetipo a usar. Este normalmente debería ser
Este es utilizado para el nombre del paquete Java y normalmente debe ser su nombre de dominio invertido, tal comocom.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.
Identificador del artifact, este es, su proyecto. El identificador puede contener caracteres alfanuméricos, menos, y subrayado.
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.
Como será empaquetado el proyecto. Normalmente este es un
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
Figura 2.8. Un Nuevo Proyecto Vaadin con
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
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:
El goal especial arranca el servidor Jetty en el puerto 8080 y despliega la aplicación. Luego puede abrirlo en un navegador web en
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".
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
archetypeGroupIdEl group ID del arquetipo es
com.vaadin para arquetipos Vaadin.archetypeArtifactIdEl archetype ID. Vaadin es compatible actualmente con los siguientes arquetipos:
vaadin-archetype-cleanes un nuevo proyecto con un esqueleto barebone para una aplicación Vaadin regular. El archivopom.xmlincluye como-comentario las definiciones para los widgets adicionales.vaadin-archetype-widgetes un esqueleto para un proyecto con widgets personalizados.vaadin-archetype-sampletambié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-addones 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 proyectovaadin-arquetipo-clean.vaadin-archetype-touchkites 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.
archetypeVersionVersión del arquetipo a usar. Este normalmente debería ser
LATEST.groupIdEste es utilizado para el nombre del paquete Java y normalmente debe ser su nombre de dominio invertido, tal como
artifactIdIdentificador del artifact, este es, su proyecto. El identificador puede contener caracteres alfanuméricos, menos, y subrayado.
versionNú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.
packagingComo 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 packageLa 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:runEl 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 |
Siguiente Capítulo 3. Arquitectura |
Muy bueno
ResponderBorrar