Wiki Markup |
---|
{scrollbar} |
Anchor | ||||
---|---|---|---|---|
|
Tabla de Contenidos para los Planes de Activación de Geronimo V1.1
- Introducción
- Planes de Activación de Apache Geronimo v1.1
- Conoce Planes de Activación con Ejemplo (Se incluirán ejemplos completos)
- Activando y Desactivando a un Simple HolaMundo (módulo war,web.xml,geronimo-web.xml)
- Activando y Desactivando AddressBook (JAR con EJB,ejb-jar.xml,openejb.xml)
- Discusión
- Conclusión
Introducción
En Geronimo cada Cada servicio, aplicación , ó recurso es en Geronimo esta configurado con un plan de activación xml. Planes de activación son la versión propia de Geronimo de los descriptores de activación J2EE. También Aún son archivos XML basados en los esquemas XML y almacenando contienen los detalles de configuración para un módulo de aplicación en especÃfico. Mediante los planes de activación no sólo activas los , además de activar módulos de aplicación , también activas puedes activar otras configuraciones, como un reino de seguridad; consulta las secciones ... y ... para obtener algunos ejemplos. Este artÃculo se organiza en las secciones siguientes: -
...
Planes de Activación de Apache Geronimo v1.1
La siguiente tabla ilustra la ubicación de archivo y nombre de los descriptores de activación tanto para J2EE estándar y para especÃficos de Apache Geronimo.
Archivo | Descriptores de Activación Estándar en la especificación J2EE | Plan de Activación especÃfico de Apache Geronimo |
---|---|---|
Archivo de Aplicación Web (WAR) | web.xml bajo el directorio WEB-INF | geronimo-web.xml |
Archivo de Aplicación Enterprise Web (EAR) | application.xml | geronimo-application.xml |
Archivo de Recursos Conectores J2EE (RAR) | ra.xml | geronimo-ra.xml |
Archivo de Aplicación Cliente J2EE (JAR) | client.xml | geronimo-application-client.xml |
JAR que contiene EJBs | ejb-jar.xml bajo el directorio META-INF | openejb-jar.xml |
...
Planes de
...
Consideraciones
Asumimos que ya tengas instalado correctamente a Geronimo V1.1, ya sea la versión con Tomcat ó Jetty, completamente funcional. En caso contrario, por favor consulta mayores detalles para conseguirlo en Instalando Geronimo.
Planes de activación para un Módulo WAR
Activando y desactivando un ejemplo HolaMundo.
Esta sección pretende mostrarte el cómo funciona el plan de activación para cada uno de los distintos módulos de aplicación.
Primero consideremos al ejemplo "HolaMundo", cuyo plan de activación especÃfico de Geronimo, se encuentra en un Archivo de Aplicación Web (WAR), bajo el directorio WEB-INF y con el nombre geronimo-web.xml.
A continuación se muestran los pasos para entender al plan de activación para el ejemplo "HolaMundo"
.Crea una carpeta llamada <app_home> en tu directorio de trabajo
2.Abre un nuevo archivo de texto, llamándolo "HolaMundo.jsp", dentro del directorio <app_home>
3.Copia y pega al siguiente código en el archivo "HolaMundo.jsp".
HolaMundo.jsp
...
<%@ page language="java" contentType="text/html; charset=ISO-8859-1"
pageEncoding="ISO-8859-1"%>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title>¡HolaMundo!</title>
</head>
<body bgcolor="#707DB8">
<h1>
<font face="courier" color="white">
Hola mundo desde GERONIMO V1.1!
</font>
</h1>
<font face="courier" color="white"> ${datetime}</font>
</html>
activación detallados
Cada plan de activación será discutido de forma independiente y se encuentran disponibles en los lugares siguientes: -
Herramienta de Activación
4.Crea un nuevo folder llamado "WEB-INF" dentro de <app-home>.
5.Crea un nuevo archivo de texto llamándolo "geronimo-web.xml" (usa letras simples); se trata del plan de activación propio de apache geronimo1.1 para este ejemplo.
6.Copia y pega el siguiente código xml en el archivo previo, y guárdalo dentro del directorio <app_home\WEB-INF>.
geronimo-web.xml
...
<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://geronimo.apache.org/xml/ns/j2ee/web-1.1">
<dep:environment xmlns:dep="http://geronimo.apache.org/xml/ns/deployment-1.1">
<dep:moduleId>
<dep:groupId>geronimo</dep:groupId>
<dep:artifactId>HolaMundo</dep:artifactId>
<dep:version>1.1</dep:version>
<dep:type>war</dep:type>
</dep:moduleId>
</dep:environment>
<context-root>/hola</context-root>
</web-app>
7.Abre otro nuevo archivo de texto y guárdalo dentro del directorio <app_home\WEB_INF>, llamándolo "web.xml".
8.Copia y Pega al siguiente código xml en el archivo previo, y posteriormente guárdalo.
web.xml
...
<?xml version="1.0" encoding="UTF-8"?>
<web-app version="2.4"
xmlns="http://java.sun.com/xml/ns/j2ee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee
http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd">
<welcome-file-list>
<welcome-file>HolaMundo.jsp</welcome-file>
</welcome-file-list>
</web-app>
Plan de activación para geronimo-application.xml y openejb-jar.xml
El siguiente ejemplo es una libreta de direcciones Email que cubre como activar Aplicaciones J2EE en una computadora con Apache Geronimo V1.1. El ejemplo AddressBook ha usado JSP, Struts EJB y mysql como la base de datos. Aquà se asume que tienes el conocimiento básico y experiencia sobre EJB, JSP y servlets con otros servidores de aplicaciones.
AddressBook usa JSP principalmente para la lógica de presentación y su código HTML. Servlets crean la capa controlador de una arquitectura Modelo-Vista-Controlador (MVC) tÃpica, y funciona como la interfaz entre las capas de presentación y modelo.
La arquitectura de tres capas se muestran en la siguiente figura.
El siguiente diagrama muestra como se organiza el código en la aplicación
...
AddressBook
|_org.apache.geronimo.sample.addressbook.ejb
| |_AddressBookEntryBean.java
| |_AddressBookSessionBean.java
|_org.apache.geronimo.sample.addressbook.struts
| |_AddressBookEntryForm.java
| |_CreateEntry.java
| |_EditEntry.java
| |_ListAddress.java
| |_SaveEntry.java
|_org.apache.geronimo.sample.addressbook.pages
| |_EditAddressBook.jsp
| |_footer.jsp
| |_ListAddressBookPage.jsp
| |_navigation.jsp
| |_site-template.jsp
|
|_resource
|_ear
| |_META_INF
| | |_application.xml
| | |_geronimo-application.xml
| |_mysql-plan.xml
| |_tranql-connector-1.0-SNAPSHOT.rar
|
|_ejb
| |_META_INF
| |_openejb-jar.xml
|_merge
| |_README.txt
| |_servlets.xml
| |_servlets-mappings.xml
| |_struts-controller.xml
| |_strust-data-sources.xml
| |_struts-forms.xml
| |_struts-plugins.xml
| |_taglibs.xml
|
|_webapp
|_images
|_pages
|_style
|
|_WEB_INF
| |_classes
| | |_resources
| | |_application.properties
| |_conf
| | |_struts-config.xml
| | |_validation.xml
| |
| |_tld
| |_geronimo-jetty.xml
| |_tiles-defs.xml
| |_validator-rules.xml
|_index.jsp
JSP y Struts
Las clases de acción Struts se encuentran en el directorio AddressBook/src/org/apache/geronimo/sample/addressbook/struts. Los JSPs se encuentran en el directorio AddressBook/src/webapp/pages.
EJB
Apache Geronimo usa OpenEJB como el sistema contenedor de EJB. El ejemplo contiene dos EJBs:
Container-managed entity EJB
Stateless session EJB
Activando un Pool de Conexiones perfilado-para-Aplicación
Un pool de conexiones perfilado para las peticiones de una Aplicación, es visible sólo para la aplicación que le activó. Para activar un pool de conexiones de esa Ãndole, debes seguir los pasos seguientes.
1.Especificar al módulo conector en el descriptor de activación de la aplicación.
2.Especificar al plan de activación del conector en el descriptor de activación de aplicación propio-de-geronimo.
3.Empaquetar al EAR de la aplicación.
Especificar al Módulo Conector en el Descriptor de Activación de la Aplicación
El descriptor de activación de aplicación (AddressBook/resources/ear/META-INF/application.xml) deberÃa definir al módulo conector TranQL, como se muestra a continuación.
...
<application
xmlns="http://java.sun.com/xml/ns/j2ee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee
http://java.sun.com/xml/ns/j2ee/application_1_4.xsd"
version="1.4">
<module>
<ejb>addressbook-ejb.jar</ejb>
</module>
<module>
<web>
<web-uri>addressbook.war</web-uri>
<context-root>/addressbook</context-root>
</web>
</module>
<module>
<connector>tranql-connector-1.1.rar</connector>
</module>
</application>
NOTA : Es obligatorio el empaquetar al archivo RAR conector junto con el archivo EAR de aplicación.
Especificar al Plan de Activación del Conector en el Descriptor de Activación de Aplicación propio-de-Geronimo.
Especifica al archivo del plan de activación del conector en el Descriptor de Activación de Aplicación propio de Geronimo (AddressBook/resources/ear/ear/META-INF/geronimo-application.xml) como se muestra a continuación.
Plan de Activación para Módulo RAR
Plan de Activación para JAR conteniendo un Módulo EJB
...