QuickStart Guide es
From Documentation
Need the English Version?
Translated by Sergio Cerro Pascual
Antes de empezar
Nuevo contenedor de servlets (Servidor Web Java)?
Antes de desarrollar aplicaciones web java (y ejecutar la demo ZK en tu máquina), necesitas instalar un contenedor de Servlets. Apache Tomcat es uno de los más populares contenedores de Servlets, debido a su facilidad de uso y de instalación.
| | |
|---|---|
| Documentación | http://tomcat.apache.org/tomcat-6.0-doc/index.html |
Eres nuevo en el lenguaje Java?
No necesitas conocer Java para usar ZK, todas las interfaces de usuario ricas pueden ser implementadas en un HTML - como lenguaje de marcas denominado ZUML-. Sin embargo, para completar una aplicación web, tú o tu equipo necesitaréis algunos conocimientos básicos de java.
Aquí están algunos de los mejores tutoriales.
Preparando un entorno para ejecutar ZK
Prerrequisitos
Si aún no tienes instaladas las siguientes aplicaciones en tu ordenador, por favor, descarga e instálalas primero.
- Java SE Development Kit (JDK)
- Servidor de aplicaciones
- Librería ZK
Obteniendo el Kit de Desarrollo SE (JDK)'
- 1. Descarga JDK 6 Update 14.
- 2. Sigue los pasos de este tutorial Installation instructions para completar la instalación
Obteniendo un servidor de aplicaciones - Apache Tomcat
- Descarga Apache Tomcat 6.0
- Sigue el siguiente tutorial Apache Setup instructions para completar la instalación.
- Nota: Recomendamos que uses el puerto 8080.
Obteniendo la librería de ZK
- De ZK Studio 0.9.4, esta empaquetado con la última versión estable de la librería ZK, actualmente ZK3.6.1.
- Descarga la última versión de ZK library.
- Descomprime zk-bin-xxx.zip en tu disco duro, (e.g. C:\), por favor, consulta here para conocer la lista de archivos y directorios que se incluyen en la distribución de ZK.
Preparando el IDE Eclipse (Recomendado)
Instalando Eclipse
- Descarga e instalalo desde Eclipse IDE for Java EE Developers
Instalando K Studio
Sigue paso a paso el siguiente tutorial Installation Guide to install ZK Studio.
Definiendo el Servidor de aplicaciones (Apache Tomcat)
- desde el menu ve a Windows > Preferences...
- Selecciona Server > Runtime Environments, then click Add
- Selecciona Apache > Apache Tomcat v6.0 and haz click en Next
- Navega hasta seleccionar Apache Tomcat directorio raíz e.g. C:\Program Files\Apache Software Foundation\Tomcat 6.0
- Haz Click Finish
Configurando la librería ZK
ZK estudio ya viene con la librería ZK(por ejemplo, ZK 3.6.1) no necesitas configurarla. Para más información, por favor, dirígete a How to Import ZK library
Running a sample application
No installation required
Visit ZK Demo to experience the simplicity and richness of ZK right NOW!
Running a sample application
Notice: Make sure you have installed the following packages:
- Java JDK
- An Application Server (Tomcat)
- Eclipse (OPTIONAL)
IF you have NOT installed these packages please refer to the previous chapter.
Downloading the ZK demo
- Download zk-demo-3.6.1.zip.
- Unzip zk-demo-3.6.1.zip, to say C:\
Running the sample application without an IDE
- Copy zkdemo.war (eg. C:\zk-demo-3.6.1\zkdemo.war). to the $TOMCAT_HOME\webapps directory.
- Start Apache Tomcat.
- Open your browser and navigate to http://localhost:8080/zkdemo/userguide.
Ejecutando la aplicación de ejemplo con un IDE
- Select File(fichero) > Import(importar) .
- En el diálogo de la opción "importar", selecciona Web > WAR file y posteriorente haz click en Next (siguiente).
- Usa el botón "Browse" para localizar el fichero "zkdemo.war" (e.g. C:\zk-demo-3.6.1\zkdemo.war).
- Haz click en Finish para importar el proyecto web.
- Haz click con el botón derecho del ratón en el proyecto zkdemo que aparece en el navegador y selecciona Run As > Run on Server (ejecutar como > ejecutar en servidor)
- Selecciona Apache > Tomcat v6.0 Server' en la ventana de diálogo del tipo de servidor y haz click en Finish (terminar)
- Una vista será activada, haz click en el enlace "ZK Demo" para explorar el proyecto zkdemo.
Ejecutar la aplicación de ejemplo en otros servidores de aplicaciones
IBM WebSphere
BEA WebLogic
JBoss
Oracle OC4J and Oracle OPMN Release 3
Liferay
Pluto
Jetty
Resin
Creando una aplicación "Hola Mundo" desde cero (sin IDE)
Creando un proyecto web
- Sigue la estructura del proyecto anterior y crea la estructura de directorios dentro de $TOMCAT_HOME\webapps, por ejemplo MiAplicacion (eg.C:\Program Files\Apache Software Foundation\Tomcat 6.0\webapps\MiAplicacion\).
+MiAplicacion
+WEB-INF
+lib
web.xml
zk.xml
index.zul
Desplegando la librería ZK
- Copia los siguientes ficheros jar en $TOMCAT_HOME\webapps\PROJECT NAME\WEB-INF\lib
zk-bin-3.6.0\dist\lib\*.jar zk-bin-3.6.0\dist\lib\ext\*.jar zk-bin-3.6.0\dist\lib\zkforge\*.jar
Creando el fichero "web.xml"
- Copia las siguientes lineas dentro de $TOMCAT_HOME\webapps\PROJECT NAME\WEB-INF\web.xml
<?xml version="1.0" encoding="UTF-8"?> <web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://java.sun.com/xml/ns/javaee" xmlns:web="http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd" id="WebApp_ID" version="2.5"> <display-name>MyApp</display-name> <listener> <description> Used to cleanup when a session is destroyed</description> <display-name> ZK Session Cleaner</display-name> <listener-class>org.zkoss.zk.ui.http.HttpSessionListener</listener-class> </listener> <servlet> <description> The servlet loads the DSP pages.</description> <servlet-name>dspLoader</servlet-name> <servlet-class> org.zkoss.web.servlet.dsp.InterpreterServlet</servlet-class> </servlet> <servlet> <description> ZK loader for ZUML pages</description> <servlet-name>zkLoader</servlet-name> <servlet-class> org.zkoss.zk.ui.http.DHtmlLayoutServlet</servlet-class> <init-param> <param-name>update-uri</param-name> <param-value>/zkau</param-value> </init-param> <load-on-startup>1</load-on-startup> </servlet> <servlet> <description> The asynchronous update engine for ZK</description> <servlet-name>auEngine</servlet-name> <servlet-class> org.zkoss.zk.au.http.DHtmlUpdateServlet</servlet-class> </servlet> <servlet-mapping> <servlet-name>dspLoader</servlet-name> <url-pattern>*.dsp</url-pattern> </servlet-mapping> <servlet-mapping> <servlet-name>zkLoader</servlet-name> <url-pattern>*.zul</url-pattern> </servlet-mapping> <servlet-mapping> <servlet-name>zkLoader</servlet-name> <url-pattern>*.zhtml</url-pattern> </servlet-mapping> <servlet-mapping> <servlet-name>auEngine</servlet-name> <url-pattern>/zkau/*</url-pattern> </servlet-mapping> <welcome-file-list> <welcome-file>index.html</welcome-file> <welcome-file>index.htm</welcome-file> <welcome-file>index.jsp</welcome-file> <welcome-file>default.html</welcome-file> <welcome-file>default.htm</welcome-file> <welcome-file>default.jsp</welcome-file> <welcome-file>index.zul</welcome-file> </welcome-file-list> </web-app>
Crea el fichero "zk.xml"
- Copia las siguientes líneas dentro de $TOMCAT_HOME\webapps\PROJECT NAME\WEB-INF\zk.xml
<?xml version="1.0" encoding="UTF-8"?> <!-- Created by ZK Studio --> <zk> </zk>
Creando tu primera página web
- Crea index.zul bajo $TOMCAT_HOME\webapps\PROJECT NAME\ y copia las siguientes líneas dentro.
<window title="My First window" border="normal" width="200px"> Hello, World! </window>
Ejecuta tu aplicación
- Arranca Apache Tomcat.
- Navega en tu navegador web a http://localhost:8080/MiAplicacion/.
Creando una aplicación "hola mundo" desde cero (con un IDE)
Nota: Asegúrate de haber instalado "Java JDK","Servidor de aplicaciones" y "ZK Studio" en tu PC o dirígete a previous chapter.
Creando un nuevo Proyecto ZK
Con la versión liberada de ZK Studio no tendrás que crear un nuevo proyecto web dinámico y configurar las opción para ZK. Puedes crear un nuevo proyecto "ZK", elegir tu paquete y recostarte mientras ZK Studio hace el resto por tí.
El siguiente swf demuestra cómo crear un nuevo proyecto ZK usando Eclipse 3.4 y ZK Studio:
Para más detalles, por favor, dirígete a Create a New ZK Project
Creando un nuevo fichero ZUL
- 1. Haz click con el botón derecho en la carpeta WebContent en la vista Explorado de Proyectoo la vista Explorado de paquetes y selecciona New> ZUL.
- 2. Teclea index.zul en el nombre de fichero y haz click en Finish (terminar).
- 3. El nuevo fichero creado será abierto con el editor ZUL.
Running the ZUL file
- 1. Haz click con el botón derecho del ratón en "MiAplicacion" y en el menú emergente selecciona "Ejecutar como > Ejecutar en servidor"
- 2. Selecciona Apache > Tomcat v6.0 Server en la ventana de diálogo del servidor y haz click en Finish (terminar)
- 3. Mira el resultado en tu navegador.
