Framework ZK
Conocimientos esenciales
Estructura del proyecto
Contenido
Código fuente
Todo el código fuente presente en estos artículos están disponibles en github. Como la aplicación de ejemplo tiene 3 configuraciones diferentes, el código fuente está dividido en 3 branches: master, chapter 9 y chapter 10.
El branch master contiene los ejemplos del capítulo 3 al 8. El branch chapter9 contiene los ejemplos de integración con el Framework Spring y el branch chapter10 contiene ejemplos que integran Spring framework y JPA para persistir información en la base de datos.
Puedes hacer click en el botón ZIP para descargar en su totalidad el branch que tengas abierto en formato zip.
Ejecutar la aplicación de ejemplo
Después de que descargues el código fuente, reconocerás enseguida que es un proyecto Maven, con el plugin de Jetty configurado para ejecutarlo. Por lo tanto, si tienes Maven instalado y configurado, puede ejecutar el ejemplo con un simple comando (para el ejemplo hemos utilizado Maven 3.0.3).
Navega a la carpeta raiz del código que has descargado, llamada "zkessentials" y escribe el siguiente comando:
mvn jetty:run
Ahora lo único que tienes que hacer es abrir un navegador y visitar la URL: http://localhost:8080/essentials/, y deberías ver la siguiente pantalla en tu navegador.
Estructura del proyecto
Las siguiente imágen muestra en 2 árboles la estructura del proyecto de la aplicación de ejemplo. Es una estructura por defecto de Maven, y todo el código fuente está debajo de la carpeta src/man. En la primera columna vemos que el código java está en la carpeta src/main/java y en la segunda vemos que el código web está en la carpeta src/main/webapp
Nombramos el código fuente agrupándolo por capítulos, según corresponda. cada paquete contiene las clases utilizadas en los ejemplos de ese capítulo. Algunas clases que se reutilizan en la mayoría de ejemplos están en un paquete a parte y se reutiliza en los diferentes capítulos.
Las clases que están en el paquete org.zkoss.essentials.entity.* son entidades. Las que están en org.zkoss.essentials.service.* son interfaces que a su vez tendrán diferentes implementaciones según el capítulo.
Los ficheros de página ZUL los hemos apartado en carpetas por cada capítulo en src/main/webapp.
En la carpeta WEB-INF, el fichero web.xml contiene una mínima configuración para ejecutar y configurar ZK, si quieres más detalle puedes visitar: http://books.zkoss.org/wiki/ZK_Installation_Guide/Quick_Start/Create_and_Run_Your_First_ZK_Application_Manually
En la misma carpeta WEB-INF el fichero zk.xml es opcional, te permite establecer configuraciones adicionales para modificar el comportamiento por defecto de ZK, para más información visita: http://books.zkoss.org/wiki/ZK_Configuration_Reference/zk.xml.
Referencias
Este documento es un extracto de la documentación oficial del Framework ZK, traducido y ampliado por Francisco Ferri. Colaborador de Potix (creadores del Framework ZK). Si quieres contactar con él puedes hacerlo en franferri@gmail.com, en twitter @franciscoferri o en LinkedIn