...
1.0 Descripción del plan de activación web geronimo
El plan de activación Geronimo para una aplicación Web, es un documento XML. Se define por el esquema geronimo-web-1.1.xsd. el cual puede encontrarse en el subdirectorio <geronimo_home>/schema/ del directorio principal de instalación de Geronimo. Este plan de activación debería encontrarse en la carpeta WEB-INF y ser llamado geronimo-web.xml e incluido en el WAR de la aplicación Web.
El plan de activación siempre debería emplear el namespace web Geronimo, y típicamente requiere elementos del Geronimo Naming namespace. Además, tiene un atributo requerido para identificar su nombre de configuración, así como un atributo opcional para seleccionar una configuración padre. Un plan de activación de aplicación Web típica incluirá los atributos siguientes y debería encontrarse en la carpeta WEB-INF:
Code Block | |||||||||
---|---|---|---|---|---|---|---|---|---|
| |||||||||
<?xml version="1.0" encoding="UTF-8"?> <web-app xmlns="http://geronimo.apache.org/xml/ns/j2ee/web-1.1" xmlns:sys="http://geronimo.apache.org/xml/ns/deployment-1.1" xmlns:naming="http://geronimo.apache.org/xml/ns/naming-1.1" xmlns:security="http://geronimo.apache.org/xml/ns/security-1.1"> ... </web-app> |
...
- Esquema Geronimo para los planes del servidor y elementos comunes (http://geronimo.apache.org/xml/ns/deployment-1.1), se usa para activar (deploy) nuevos servicios en Geronimo en un plan standalone, y también contiene elementos comunes usados por muchos otros planes.
- Los elementos sin prefijo son del namespace http://geronimo.apache.org/xml/ns/j2ee/web-1.1, mientras que los elementos con el prefijo naming: son del namespace http://geronimo.apache.org/xml/ns/naming-1.1 y los elementos con el prefijo sys: son del namespace http://geronimo.apache.org/xml/ns/deployment-1.1. Los tres namespaces son identificados en el encabezado web-app (el cual los hace disponibles en cualquier lugar dentro del documento).
- Si se emplea la versión Jetty de Geronimo, entonces el namespace del servidor puede ser usado como http://geronimo.apache.org/xml/ns/j2ee/jetty-1.1, mientras que si es Tomcat entonces puede ser usado como http://geronimo.apache.org/xml/ns/j2ee/tomcat-1.1. Por lo tanto, el uso común del namespace objetivo (target) de una aplicación Web en Geronimo es http://geronimo.apache.org/xml/ns/j2ee/web-1.1.
- ModuleID y dependencias se definen en el bloque <environment> del archivo XML. Cualquier aplicación ó módulo puede declarar un moduleID para si misma(o) mediante el elemento moduleID, y puede declarar dependencias mediante el elemento dependency. El siguiente ejemplo detalla dependencias declaradas en el bloque <environment>.
Code Block | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
<environment xmlns:dep="http://geronimo.apache.org/xml/ns/deployment-1.1"> <moduleId> <groupId>geronimo</groupId> <artifactId>HolaMundo</artifactId> <version>1.1</version> <type>war</type> </moduleId> </environment> |
...
The context root is the first segment of the URL used to access the Web application by the client. For example, if the context-root was hello, then a typical URL to the application would start with http://host:port/hello/ and a context-root value of / would be used to make this the default Web application for the server.
...