Base de connaissances > Automation Engine et systèmes cibles > Java EE/JMX > Création de MBeans à partir des services web

Création de MBeans à partir des services web

Mode d'emploi pour la création de MBeans sur la base de services web.

Ce mode d'emploi présuppose des connaissances de Java et des services web.

Attention : L'Automation Engine n'offre aucune prise en charge des services web, ni des MBeans !

Généralités

Automation Engine prend en charge les services Web via l'utilisation de MBeans avec l'Agent JMX. De nombreux éditeurs offrent la plupart du temps, au lieu de MBeans, les services web qui permettent d'accéder à leurs applications. Ce mode d'emploi vous montre, étape par étape, comment créer un MBean à partir d'un service web existant. Nous utilisons comme exemple le service web "CurrencyConvertor", qui met à disposition Generic Objects Technologies Ltd. Il offre les derniers cours de conversion du change.

Il vous faut :

un Agent JMX
un accès au service web (WDSL, URL, paramètres)
Apache Axis (disponible gratuitement)

Attention : il n'est possible de créer des MBeans que pour les services web synchrones ! Les services web asynchrones sont d'une utilisation bien plus complexe et nécessitent une manipulation individuelle.

Testez exhaustivement le MBean créé !

Installation

	1.	Configurer Apache Axis

Téléchargez les fichiers d'Apache Axis de http://ws.apache.org/axis. Installez Apache Axis comme indiqué dans la documentation.

	2.	Générer les classes Java pour l'exécution des services web

Démarrez l'outil "WSDL2Java" d'Apache Axis. Il s'agit d'un générateur-enveloppeur de services web. Vous pouvez, par exemple, utiliser Eclipse comme environnement de développement. Saisissez l'adresse WSDL "http://www.webservicex.com/CurrencyConvertor.asmx?wsdl" comme paramètre de saisie.

Les classes Java suivantes sont alors créées :

	3.	Créer un MBean pour l'utilisation des classes Java

Au cours de cette étape, vous créez un MBean qui utilise les classes Java générées pour exécuter le service web via JMX. Quelques remarques introductives sur les directives de programmation de MBeans :

Un modèle MBean standard se compose d'une interface et d'une classe qui le mettent en œuvre.
L'interface possède le même nom que la classe plus le suffixe "MBean".

Dans l'exemple suivant, la classe s'appelle "Converter" et l'interface "ConverterMBean.java". Créez les deux fichiers, par exemple dans un package nommé "com.uc4.ws". Le code complet pour l'interface et la classe est le suivant :

ConverterMBean.java :

package com.uc4.ws;

import java.rmi.RemoteException;
import javax.xml.rpc.ServiceException;

public interface ConverterMBean {
double convertCurrency(String fromCurrency, String toCurrency)
throws ServiceException, RemoteException, IllegalArgumentException;
}

Converter.java :

package com.uc4.ws;

import java.rmi.RemoteException;
import javax.xml.rpc.ServiceException;
import NET.webserviceX.www.Currency;
import NET.webserviceX.www.CurrencyConvertorLocator;
import NET.webserviceX.www.CurrencyConvertorSoap;

public class Converter implements ConverterMBean {
public double convertCurrency(String fromCurrency, String toCurrency)
throws ServiceException, RemoteException, IllegalArgumentException {
CurrencyConvertorLocator locator = new CurrencyConvertorLocator();
CurrencyConvertorSoap soap = locator.getCurrencyConvertorSoap();
return soap.conversionRate(
Currency.fromString(fromCurrency),
Currency.fromString(toCurrency));
}
}

La méthode "convertCurrency" contient l'exécution du service web et utilise les classes Java générées. Elle crée une instance du localisateur de service et appelle la méthode "getCurrencyConvertorSoap" pour recevoir une souche SOAP. Ce modèle (localisateur-souche) est décrit dans la documentation d'Apache Axis.

La souche procède à l'appel du service web. Les paramètres sont convertis de "java.lang.String" à des objets "NET.webserviceX.www.Currency", étant donné que seuls des types de données simples peuvent être utilisés dans MBeans. Le résultat, c'est-à-dire le cours du change actuel, est renvoyé.

	4.	Créer un fichier JAR pour le MBean et les classes Java

Créez, à l'aide d'un script Ant, un fichier JAR commun pour les deux fichiers du MBean et des classes Java générées. Dans l'exemple qui suit, un fichier nommé "exampleMBean.jar" est généré.

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<project name="uc4" default="exampleMBean.jar">
<property name="classes_dir" value="bin" />
<target name="exampleMBean.jar" description="Web Service MBean">
<jar jarfile="exampleMBean.jar" basedir="${classes_dir}"/>
</target>
</project>

Dans un environnement de développement comme Eclipse, il ne vous faut pas de script Ant et vous pouvez créer le fichier JAR directement à l'aide d'une commande de menu.

	5.	Démarrer l'Agent JMX avec le MBean

Enregistrez le fichier JAR créé ainsi que les fichiers JAR d'Apache Axis dans le chemin de classe de l'Agent JMX. L'appel pour démarrer l'Agent JMX est le suivant sous Windows :

Java -cp axis.jar;commons-discovery-0.2.jar;commons-logging-1.0.4.jar;
wsdl4j-1.5.1.jar;saaj.jar;exampleMBean.jar;ucxjjmx.jar;jaxrpc.jar com/uc4/ex/jmx/UCXJMX

Sous UNIX, le point-virgule ";" doit être remplacé par un deux-points ":".

L'Agent JMX ne requiert aucun Serveur d'application et peut s'exécuter de manière autonome. Une implémentation JMX est cependant nécessaire à l'exécution. Pour garantir cela, il suffit d'installer Java version 5. Cette version contient les packages JMX nécessaires de version 1.2.

Utilisation

	1.	Créer le Job JMX

Identifiez-vous au système AE à l'aide de l'Interface Utilisateur.
Créez un Job JMX et sélectionnez, dans son onglet Attributs, l'Agent JMX qui contient le MBean. N'oubliez pas non plus de sélectionner un objet Login adapté.
Allez dans l'onglet Forme. Cliquez sur le bouton pour insérer une nouvelle ligne. Pour que le MBean puisse être utilisé, il doit tout d'abord être enregistré auprès du Serveur MBean. Dans la catégorie "Serveur Mbean", sélectionnez donc la fonction "Enregistrer un Mbean" à l'aide d'un double-clic.

La fonction JMX_CREATE_MBEAN crée une instance du MBean et l'enregistre dans le Serveur MBean local.

Dans le champ "Classe", saisissez le nom de classe complet du MBean. Dans notre exemple, il s'agit de "com.uc4.ws.Converter".
Dans le champ "Nom d'objet", vous devez entrer la désignation devant être assignée au MBean. Cette désignation doit être unique dans le Serveur MBean. La désignation se compose de deux parties séparées par deux-points ":". La première partie indique le nom de domaine et la seconde les propriétés-clés. Dans notre exemple, il s'agit de "com.uc4:name=CurrencyConverter".

Le nom de domaine peut contenir tout caractère sauf ":", "*" et "?". Pour éviter les collisions entre MBeans et d'autres éditeurs, il est recommandé d'utiliser l'inverse du nom DNS de votre société pour le nom de domaine.

Les propriétés clés permettent d'assigner au MBean un nom unique dans le domaine. Elles sont séparées par une virgule ",". Une propriété clé se compose comme suit : propriété=valeur. La propriété ne doit correspondre à aucun attribut du MBean. Le nombre de propriétés clés n'est pas limité et l'ordre n'a pas non plus d'importance. Une propriété clé peut contenir tout caractère sauf des guillemets, des virgules, ":", "=", "*" et "?". Saisissez au moins une propriété clé.

Activez le paramètre "Termine normalement si déjà enregistré".

Enregistrez le Job JMX et exécutez-le. Cela a pour effet d'enregistrer le MBean dans le Serveur MBean. Il s'affiche désormais dans le navigateur MBean, comme on peut le voir à l'étape suivante.

	2.	Utiliser le MBean

Il est possible d'utiliser le MBean grâce aux opérations qu'il offre. Cliquez sur le bouton dans l'onglet Forme du Job JMX pour insérer une nouvelle ligne. Dans la catégorie "Opérations", sélectionnez la fonction "Appeler une Opération" en effectuant un double-clic.

La fonction JMX_INVOKE exécute une opération d'un MBean.

Cliquez sur le bouton "Afficher..." pour ouvrir le navigateur MBean.

Sélectionnez, à gauche, le MBean "CurrencyConverter". Le tableau de droite affiche les opérations JMX qui sont à la disposition du MBean.
Mettez en surbrillance l'opération "convertCurrency" et cliquez sur OK. Les champs "Nom Mbean" et "Opération" sont remplis automatiquement avec la valeur correcte.
Saisissez, dans le champ "Paramètres", deux codes de monnaie séparés par une virgule. "USD,EUR" a par exemple pour effet la fourniture par le MBean du cours du change du dollar en euro.
Exécutez le Job JMX. Le cours du change est généré dans le rapport.

Lisez le rapport avec la fonction script PREP_PROCESS_REPORT pour utiliser les valeurs fournies par les MBeans dans d'autres traitements ultérieurs. Les Exemples contiennent la description des étapes requises.