Capítulo 2 Utilizando ejemplos del manual Este capítulo le explica todo lo necesario para instalar, armar y ejecutar los ejemplos. Este cubre los siguientes temas: Software requerido Iniciar y detener el servidor de aplicación Iniciar la consola de administración Iniciar y detener el servidor de base de datos de Java Construyendo los ejemplos Ejemplo del manual de estructura de directorio Depurando aplicaciones Java EE
Software necesario El siguiente software es necesario para ejecutar los ejemplos. El paquete de ficheros del manual La edición estándar de la plataforma Java El sistema servidor de aplicaciones Java de Sun versión 9.1 El IDE NetBeans Ant de Apache El paquete de ficheros del manual El código fuente de ejemplos del manual se encuentra en el paquete de ficheros del manual. Para obtener el paquete de ficheros del manual debe ir a http://java.sun.com/javaee/5/docs/tutorial/information/download.html. el paquete de ficheros del manual es un fichero zip que se puede descomprimir en el lugar que se desee. Luego que haya instalado el paquete de ficheros del manual, el código fuente se encuentra en el directoriotutinstall/javaeetutorial5/examples/, donde tut-install es el directorio donde se ha instalado el manual. El directorio de ejemplos contiene subdirectorios para cada una del as tecnologías discutidas en este manual. Edición estándar de la plataforma Java Para construir, desplegar y ejecutar los ejemplos, se necesita una copia de la edición estándar de la plataforma Java 5.0 o la edición estándar de la plataforma Java 6.0 (J2SE 5.0 o JDK 6). Podemos bajar la J2SE 5.0 de http://java.sun.com/javase/downloads/index_jdk5.jsp. Se puede bajar la JDK 6 dehttp://java.sun.com/javase/downloads/. Bajar la actualización actual de JDK no incluye otro software (como NetBeans o Java EE). Sistema servidor de aplicación Java de Sun 9.1 El sistema servidor de aplicación Java de Sun 9.1 es el objetivo como ambiente de construcción y ejecución de los ejemplos de manual. Para crear, desplegar y ejecutar los ejemplos, necesita una copia del servidor de aplicación y opcionalmente el IDE NetBeans. Se puede bajar el servidor de aplicación dehttp://java.sun.com/javaee/downloads/. Nota - También se puede ejecutar los ejemplos del servidor usando el sistema servidor de aplicación Java de Sun 9.0, o GlassFish V2. Tips de instalación del servidor de aplicación
Durante la instalación del servidor de aplicación: Acepte el nombre de usuario administrador por defecto y especifica una contraseña. El nombre de usuario es admin. Recuerde la contraseña que especifique(or ejemplo, adminadmin). Necesitará el nombre de usuario y la contraseña. Seleccione el botón de radio que indica que no va a solicitar usuario y contraseña para el usuario administrador. Recuerde el puerto http en donde el servidor es instalado. Este manual asume que se está aceptando el puerto por defecto 8080. Si el puerto 8080 está en uso durante la instalación y el instalador elige otro puerto o si decide cambiarlo, se necesitara actualizar el fichero de propiedades en común (que se describe en la siguiente sección) y los ficheros de configuración para algunos de los ejemplos del manual para reflejar el puerto correcto.
Este manual se refiere al directorio donde se instala el servidor de aplicación como as-install. Por ejemplo, el directorio de instalación por defecto en Microsoft Windows es C:\Sun\AppServer, así es que asinstall esC:\Sun\AppServer. Luego de que se instale el servidor de aplicación, agregue los siguientes directorios en su variable de entornoPATH para evitar tener que especificar el nombre completo cuando se utilicen comandos: as-install/bin as-install/lib/ant/bin IDE NetBeans El ambiente de desarrollo integrado NetBeans es un IDE libre, de código abierto para desarrollar aplicaciones Java, incluyendo aplicaciones empresariales. NetBeans soporta la plataforma Java EE5. Se pueden construir empaquetar, desplegar y ejecutar los ejemplos de este manual desde NetBeans. Puede bajar el IDE de NetBeans desde http://www.netbeans.org/. La versión actual del IDE de NetBeans IDE es 5.5.1. Junto con el IDE, necesitara instalar Hotfixes para los componentes Java EE. Para instalar el IDE NetBeans 5.5.1 Hotfixes, realice los siguientes pasos: 1.
Baje e instale el IDE NetBeans IDE 5.5.1 FCS, luego inícielo.
2.
En el IDE NetBeans, Select Tools → Update Center. El asistente de actualización del sistema se abre.
3.
Seleccione que se verifique en la web las actualizaciones disponibles para actualizaciones disponibles y nuevos módulos.
4.
En el panel para conexión Select Update Center(s), seleccione Netbeans Hotfix Update Center.
5.
Si es necesario, haga clic en el botón de configuración de Proxy y configure el proxy para permitir que el centro de actualización se conecte.
6.
Presione siguiente para que el centro de actualización se conecte para actualizar.
7.
En el panel de las actualizaciones disponibles y nuevos módulos seleccione NetBeans Hotfix Update Center y haga clic en agregar. Dos módulos aparecen en el panel de incluir en la instalación.
8.
Presione en siguiente.
9.
Lea y acepte la licencia. Los módulos que se seleccionan serán bajados y las firmas digitales validadas y verificadas.
10. Presione en siguiente. 11. Presione en finalizar. 12. Presione OK en el cuadro de diálogo del IDE para reiniciar. El IDE se reiniciará para instalar los módulos. Ant de apache Ant es una herramienta de construcción basada en tecnología Java desarrollada por la Apache Software Foundation (http://ant.apache.org/), y es utilizada para construir, empaquetar y desplegar los ejemplos del manual. Ant esta incluido con el servidor de aplicación. Para utilizar el comando ant, agregue as-install/lib/ant/bin a su variable de ambiente PATH.
Iniciando y deteniendo el servidor de aplicación Para iniciar el servidor de aplicación, abra una ventana de terminal de Windows y ejecute lo siguiente: asadmin start-domain --verbose domain1
Un domain es un grupo de una o mas instancias de servidor de aplicación manejadas por un administrador de servidor. Asociadas con este dominio está lo siguiente: El número de puerto del servidor de aplicación. El puerto por defecto es 8080. El número de puerto del servidor de administración. El valor por defecto para este puerto es 4848. El nombre y contraseña del usuario administrador.
Usted indica estos valores cuando instalas el servidor de aplicación. Los ejemplos en este manual asumen que elige estos puertos por defecto. Sin argumentos, el comando start-domain inicia el dominio por defecto, que es domain1. La bandera -verbose hace que toda la salida del registro y depuración aparezca en la ventana de terminal o línea de comando (también se escribirá en el registro del servidor que se encuentra en domain-dir/logs/server.log). O, en Windows se puede utilizar: Programs → Sun Microsystems → Application Server PE 9 → Start Default Server Luego de que el servidor ha completado su secuencia de arranque se tendrá la siguiente salida: Domain domain1 started.
Para detener el servidor de aplicación, abra una ventana de terminal o línea de comando y ejecute: asadmin stop-domain domain1
O en Windows, elija: Programs → Sun Microsystems → Application Server PE 9 → Stop Default Server Cuando el servidor se ha detenido verá la siguiente salida: Domain domain1 stopped.
Iniciando la consola de administración Para administrar el servidor de aplicación y manejar usuarios, recursos y aplicaciones Java EE, use la herramienta llamada consola de administración. El servidor de aplicación debe ejecutarse antes de que se invoque la consola de administración. Para hincar la consola de administración abra un navegador enhttp://localhost:4848/asadmin/. O en Windows, desde el menú de inicio elija: Programs → Sun Microsystems → Application Server PE 9 → Application Server
Iniciando y deteniendo el servidor de base de datos Java DB El servidor de aplicación incluye la base de datos Java DB. Para iniciar el servidor de base de datos Java DB, abra una terminal Windows o línea de comandos y ejecute: asadmin start-database
En Windows, del menú inicio elija: Programs → Sun Microsystems → Application Server PE 9 → Start Java DB Para detener el servidor Java DB, abra un terminal o línea de comandos y ejecute: asadmin stop-database
En Windows, desde el menú inicio elija: Programs → Sun Microsystems → Application Server PE 9 → Stop Java DB Por información acerca de la base de datos Java DB incluida en el servidor de aplicación veahttp://developers.sun.com/javadb/.
Construyendo los ejemplos Los ejemplos del manual están distribuidos con un fichero de configuración para NetBean o Ant. Los directorios para construir los ejemplos son proporcionados en cada capítulo. Cualquiera de los dos pueden ser utilizados para construir, empaquetar, desplegar y ejecutar los ejemplos. Construir los ejemplos utilizando el IDE NetBeans Para ejecutar los ejemplos del manual en el IDE NetBeans, de debe registrar su instalación de servidor de aplicación como una instancia de servidor NetBeans. Siga estas instrucciones para registrar el servidor de aplicación en el IDE NetBeans. 1.
Select Tools→Server Manager para abrir el cuadro de diálogo Server Manager.
2.
Haga clic en agregar servidor.
3.
Bajo servidor, seleccione Sun Java System Application Server y presione siguiente.
4.
Bajo la localización de plataforma entre la localización de la instalación de su servidor de aplicación.
5.
Seleccione registrar dominio local por defecto y presione siguiente.
6.
Bajo nombre y contraseña del administrador entre el nombre y la contraseña creada cuando se instalo el servidor de aplicación.
7.
Presione en finalizar.
Construyendo los ejemplos en la línea de comandos utilizando Ant Las propiedades para construir, comunes para todos los ejemplos están especificadas en el ficherobuild.properties en el directorio tut-install/javaeetutorial5/examples/bp-project/. Se debe crear este fichero antes de que se pueda ejecutar los ejemplos. Copie el fichero build.properties.sample parabuild.properties y modifíquelo para reflejar su ambiente. Los ejemplos utilizan el sistema de construcción y la estructura de distribución de aplicación de Java BluePrints. Para ejecutar los scripts de Ant, se debe configurar las propiedades de construcción en común en el ficherotutinstall/javaeetutorial5/examples/bp-project/build.properties como sigue: Configure la propiedad javaee.home para indicar la ubicación de la instalación de su servidor de aplicación. El proceso de construcción utilice la propiedad javaee.home para incluir las librerías en as-install/lib/ en la ruta de clases. Todos los ejemplos que ejecutan en el servidor de aplicación incluyen la librería de JavaEE asinstall/lib/javaee.jar. en la ruta de clases para construir. Algunos ejemplos utilizan librerías adicionales en as-install/lib/; las librerías necesarias son indicadas en los diferentes capítulos.
Nota - En Windows, se deben escapar todas las barras invertidas en la propiedad javaee.home con otras barras invertidas o utilice barras como separadores de rutas. De esta forma si la instalación de su servidor de aplicación esta en C:\Sun\AppServer, se debe configurar javaee.home con javaee.home = C:\\Sun\\AppServer o javaee.home=C:/Sun/AppServer.
Configure la propiedad javaee.tutorial.home a la ubicación de su manual. Esta propiedad es utilizada por Ant para el despliegue y creación. Por ejemplo, en UNIX: javaee.tutorial.home=/home/username/javaeetutorial5 En Windows: javaee.tutorial.home=C:/javaeetutorial5 No instale el manual en una ubicación con espacios en la ruta. Si usted no acepta los valores por defecto para el usuario y contraseña del administrador, configure la propiedad admin.user a el valor que se ha especificado cuando se instaló el servidor de aplicación, y configure la contraseña para el usuario administrador en el fichero admin-password.txt que se encuentra en tutinstall/javaeetutorial5/examples/common/ directory a el valor que ha especificado cuando se instaló el servidor de aplicación. Ni no se utilizó el Puerto 8080, configure la propiedad domain.resources.port a el valor especificado cuando se instaló el servidor de aplicación.
Estructura de directorio de los ejemplos. Para facilitar el desarrollo iterativo y mantener las fuentes separadas de los ficheros compilados, los ejemplos del manual utiliza la estructura de aplicación de Java BluePrints. Cada módulo de aplicación tiene la siguiente estructura: build.xml: Fichero de creación de Ant src/java: Fichero fuente de Java para el módulo src/conf: Ficheros de configuración para el modulo, con excepción de aplicaciones web web: Páginas JSP y HTML, hojas de estilo, ficheros de etiquetas e imágenes web/WEB-INF: ficheros de configuración para aplicaciones web nbproject: fichero de proyectos de NetBeans Los ejemplos que tienen múltiples módulos de aplicación empaquetados en un archive de aplicación empresarial (o EAR) tiene directorios de submódulos que usan las convenciones de nombres siguientes: example-name-app-client: Clientes de aplicación example-name-ejb: Ficheros JAR de beans empresariales example-name-war: aplicaciones web
Los ficheros de construcción de Ant (build.xml) distribuidos con los ejemplos contienen objetivos para crear un subdirectorio build para copiar y compilar los ficheros en ese directorio; un subdirectorio dist que guarda el fichero de módulo empaquetado; y un directorio client-jar, que guarda los JAR de aplicaciones clientes recuperados.
Depurando aplicaciones Java EE Esta sección describe como determinar que está causando un error en el despliegue o ejecución de su aplicación. Utilizando el servidor de registro (Log) Una forma de depurar ampliaciones el buscar en el servidor de registro en domain-dir/logs/server.log. El registro contiene la salida de su servidor de aplicación y de sus aplicaciones. Se pueden registrar mensajes desde cualquier clase Java en su aplicación con System.out.println y las APIs de registro de Java (documentadas en http://java.sun.com/javase/6/docs/technotes/guides/logging/index.html) y de componentes web con el método ServletContext.log. Si se inicia el servidor de aplicación con la bandera --verbose, todos los registros y salida de depuración aparecerá en la ventana de terminal o línea de comando y en el registro del servidor. Se puede ver el registro del servidor con un editor de texto o con el visor de registro de la consola de administración. Para usar el visor de registro: 1.
Seleccione el nodo de servidor de aplicación.
2.
Seleccione la pestaña de registro.
3.
Haga clic en el botón de abrir visor de registros. El visor de registros se abrirá y desplegará 40 entradas.
Si se desea desplegar otras entradas: 1.
Haga clic en el botón de modificar búsqueda.
2.
Especifique cualquier restricción en las entradas que desea ver.
3.
Haga clic en el botón de búsqueda al final del visor de registro.
Utilizando un depurador El servidor de aplicación soporta la arquitectura de depuración de la plataforma Java (JPDA). Con JPDA se puede configurar el servidor de aplicación para comunicar la información de depuración utilizando un socket. Para depurar una aplicación utilizando un depurador: 1.
Habilite la depuración en el servidor de aplicación usando la consola de administración: 1.
Seleccione el nodo de servidor de aplicación.
2.
Seleccione la pestaña de configuración de JVM. Las opciones de depuración por defecto están configuradas en: -Xdebug -Xrunjdwp:transport=dt_socket,server=y, suspend=n,address=9009 Como se puede ver, el puerto del socket de depuración por defecto es el 9009. Se puede cambiar este a un puerto que no esté en uso por el servidor de aplicación u otro servicio.
2.
3.
Marque la casilla de verificación de habilitado del campo de depuración
4.
Haga clic en el botón de guardar.
Detenga el servidor de aplicación y inícielo nuevamente.
Copyright © 2004-2007 Grupo Cabezudo Se permite la copia de esta información siempre y cuando se especifique claramente que fue extraida de este sitio. Última actualización: Jueves 30 de octubre del 2008 20:27:19 UTC