Puede instalar módulos Java EE (Java™ Platform, Enterprise Edition) en un servidor de aplicaciones proporcionado por un producto WebSphere Application Server utilizando la especificación de API de despliegue de aplicaciones Java EE (JSR-88).
Antes de empezar
Deprecated feature: La instalación de la aplicación que utiliza la especificación de la API de despliegue de aplicaciones
Java EE (JSR-88) está en desuso en la versión 8.0 de
WebSphere Application Server.
Utilice otra opción para desplegar aplicaciones en un servidor. La opción más parecida a la API de despliegue Java EE es utilizar la programación MBean Java Management
Extensions (JMX). Para obtener información sobre las opciones de despliegue, consulte
"Formas de instalar aplicaciones o módulos de empresa.".
depfeat
JSR-88 define las API (interfaces de programas de aplicación) estándar para
habilitar el despliegue de aplicaciones y módulos autónomos Java EE para plataformas de
productos Java EE. La versión 1.1 de la especificación de despliegue Java EE está
disponible en http://www.oracle.com/technetwork/java/index.html como parte de J2EE (Java 2 Platform, Enterprise Edition) 1.4 Application Server
Developer Release.
Acerca de esta tarea
JSR-88 define un contrato entre un proveedor de herramientas y una plataforma
que permite a las herramientas de diversos proveedores configura, desplegar y gestionar
aplicaciones en cualquier plataforma del producto Java EE. El proveedor de herramienta suele
facilitar herramientas de software y un entorno de desarrollo integrado (IDE) para el
desarrollo y ensamblaje de módulos de aplicaciones Java EE. La plataforma Java EE proporciona funciones de gestión de aplicaciones que despliegan,
anulan el despliegue, inician, detienen o gestionan de otra forma aplicaciones Java EE.
WebSphere Application Server es una plataforma que cumple con las especificaciones
Java EE y que implementa las API JSR-88. Complete los pasos siguientes para desplegar
(instalar) los módulos Java EE en un servidor de aplicaciones proporcionado por la
plataforma WebSphere Application Server.
Procedimiento
- Codifique un programa Java que pueda acceder a la clase DeploymentManager de JSR-88 para el producto.
- Escriba un código que busque el atributo J2EE-DeploymentFactory-Implementation-Class del manifiesto JAR.
En JSR-88, el código busca DeploymentFactory utilizando el atributo J2EE-DeploymentFactory-Implementation-Class del manifiesto JAR.
Los siguientes archivos JAR de gestión de aplicaciones de productos contienen este atributo y proporcionan soporte.
Tabla 1. Archivos JAR que contienen el atributo del manifiesto. Habilite el código para buscar DeploymentFactory utilizando el atributo de manifest de JAR.Entorno |
Archivo JAR que contiene el atributo del manifiesto |
Servidor de aplicaciones |
raíz_servidor_aplicaciones/plugins/com.ibm.ws.admin.services.jar |
Cliente de aplicación |
raíz_cliente_aplicaciones/plugins/com.ibm.ws.j2ee.client.jar |
Cliente de aplicaciones ligero |
raíz_cliente_aplic/runtimes/com.ibm.ws.admin.client_9.0.jar |
Una vez que el código haya encontrado DeploymentFactory, la herramienta de despliegue
puede crear una instancia de DeploymentFactory de WebSphere y registrarla con su DeploymentFactoryManager.
A continuación, se muestra el código de ejemplo para el entorno del servidor de aplicaciones. El código de ejemplo requiere que utilice el kit de desarrollo que se envía con el producto o que utilice el cliente conectable para el despliegue de los módulos autónomos.
Consulte Requisitos detallados del sistema WebSphere Application Server en
http://www.ibm.com/support/docview.wss?rs=180&uid=swg27006921 Para obtener información
sobre los kits de desarrollo admitidos.
import javax.enterprise.deploy.shared.factories.DeploymentFactoryManager;
import javax.enterprise.deploy.spi.DeploymentManager;
import javax.enterprise.deploy.spi.factories.DeploymentFactory;
import java.util.jar.JarFile;
import java.util.jar.Manifest;
// Obtener la clase de implementación DeploymentFactory del archivo MANIFEST.MF.
File jsr88Jar = new File(wasHome + "/plugins/com.ibm.ws.admin.services.jar");
JarFile jarFile = new JarFile(jsr88Jar);
Manifest manifest = jarFile.getManifest();
Attributes attributes = manifest.getMainAttributes();
String key = "J2EE-DeploymentFactory-Implementation-Class";
String className = attributes.getValue(key);
// Obtener una instancia de DeploymentFactoryManager
DeploymentFactoryManager dfm = DeploymentFactoryManager.getInstance();
// Crear una instancia de DeploymentFactory de WebSphere Application Server.
Class deploymentFactory = Class.forName(className);
DeploymentFactory deploymentFactoryInstance =
(DeploymentFactory) deploymentFactory.newInstance();
// Registrar la instancia de DeploymentFactory con DeploymentFactoryManager.
dfm.registerDeploymentFactory(deploymentFactoryInstance);
// Proporcionar el URI, ID de usuario y contraseña de WebSphere Application Server.
// Si desea más información, consulte el paso siguiente.
wsDM = dfm.getDeploymentManager(
"deployer:WebSphere:miservidor:8880", null, null);
- Escriba código que acceda a la instancia de DeploymentManager para el producto.
El URI del producto para despliegue tiene el formato siguiente:
"deployer:WebSphere:host:puerto"
En el ejemplo del
paso anterior, "deployer:WebSphere:miservidor:8880", se intenta conectar con el
host miservidor en el puerto 8880 mediante el conector SOAP,
que es el valor por omisión.
Puede especificar una dirección Internet Protocol Versión 6 (IPv6) para el elemento host
en el URI para despliegue. Especifique la dirección IPv6 entre corchetes ([]); por ejemplo:
"deployer:WebSphere:[dirección_IPv6]:puerto"
Asimismo, puede agregar un parámetro opcional, connectorType, en el URI para el
despliegue. Por ejemplo, para utilizar el conector RMI para acceder myserver, escriba el código del URI de esta forma:
"deployer:WebSphere:myserver:2809?connectorType=RMI"
- Opcional: Codifique un programa Java que pueda personalizar o desplegar aplicaciones Java EE o módulos utilizando el soporte JSR-88 que proporciona el producto.
- Inicie las aplicaciones Java EE desplegadas o los módulos Java EE autónomos con la
API JSR-88 utilizada para iniciar aplicaciones o módulos.
Qué hacer a continuación
Pruebe las aplicaciones o los módulos desplegados. Por ejemplo, con el navegador web vaya a la dirección URL de una aplicación desplegada y
revise el rendimiento de la aplicación. Si es necesario, actualice la aplicación.