Utilisation de l'interface EJB UDDI (déconseillée)

L'interface de programme d'application (API) Enterprise JavaBeans (EJB) du composant UDDI Registry permet de publier, de rechercher et de supprimer des entrées de registre UDDI. Toutefois, l'interface EJB UDDI est déconseillée et prend uniquement en charge les demandes d'API UDDI version 2.

Avant de commencer

WebSphere Application Server et le registre UDDI doivent être installés et en cours d'exécution. Vous ne pouvez pas utiliser le client d'EJB depuis une machine sur laquelle WebSphere Application Server n'est pas installé.

Pourquoi et quand exécuter cette tâche

Fonction obsolète Fonction obsolète: L'interface EJB UDDI est déconseillée dans WebSphere Application Server version 6.0.depfeat

Les classes client requises pour l'interface EJB se trouvent dans racine_serveur_app/UDDIReg/clients/uddiejbclient.jar. Pour obtenir la documentation Java™ relative à ces classes, consultez les informations relatives aux API supplémentaires.

L'API EJB se compose de deux beans session sans état, un pour l'API d'interrogation (com.ibm.uddi.ejb.InquiryBean) et un autre pour l'API de publication (com.ibm.uddi.ejb.PublishBean), dont les méthodes publiques constituent une interface EJB pour le registre UDDI. Toutes les méthodes publiques de la classe InquiryBean correspondent aux fonctions de l'API d'interrogation UDDI Version 2, cependant que toutes les méthodes publiques de la classe PublishBean correspondent aux fonctions de l'API de publication UDDI Version 2. Certaines fonctions des API UDDI version 2 ne sont pas implémentées ; c'est le cas par exemple de get_authToken, discard_authToken et get_businessDetailExt.

Chaque interface comporte des groupes de méthodes surchargées correspondant aux opérations définies dans la spécification UDDI 2.0. Il existe ainsi une méthode distincte pour chaque variante majeure d'une fonction. Par exemple, l'opération find_business de la spécification UDDI est représentée par dix variantes de méthodes findBusiness, chacune offrant un moyen de recherche différent (recherche par nom ou par argument categoryBag).

Les arguments des méthodes de l'interface EJB sont des objets Java du module com.ibm.uddi.datatypes. D'une façon générale, il existe une correspondance bi-univoque entre les classes de ce module et les éléments du schéma XML de la spécification UDDI Version 2. Certains éléments XML UDDI font toutefois exception à cette règle ; il s'agit par exemple des éléments correspondant à un objet string côté Java. Pour plus de détails, reportez-vous à la documentation Java relative au module com.ibm.uddi.datatypes dans les informations sur les API supplémentaires.

Les méthodes de la classe InquiryBean EJB mappent vers le rôle d'interrogation EJB, cependant que les méthodes de la classe PublishBean EJB mappent vers le rôle de publication EJB. Les rôles d'interrogation et de publication EJB protègent l'interface EJB, comme décrit dans Contrôle d'accès pour les interfaces du registre UDDI. Si le mappage de rôles est tel qu'une méthode requiert un ID utilisateur authentifié WebSphere Application Server, un programme client peut fournir l'ID utilisateur et le mot de passe à la demande de WebSphere Application Server ou en fournissant le code d'application consigné dans le domaine par défaut à l'aide de l'ID utilisateur et du mot de passe. Pour déterminer comment indiquer l'ID utilisateur et le mot de passe lors de la configuration de la sécurité, utilisez le fichier de configuration sas.client.props.

Pour utiliser le client EJB, procédez comme suit :

Procédure

  1. Configurez votre environnement pour la communication avec WebSphere Application Server : [AIX][HP-UX][Linux][Solaris][z/OS]
    . racine_serveur_app/bin/setupCmdLine.sh
    [Windows]
    racine_serveur_app/bin/setupCmdLine.bat
    [IBM i]
    . racine_serveur_app/bin/setupCmdLine

    [AIX][HP-UX][IBM i][Linux][Solaris][z/OS]Notez qu'un espace suit le point (.)

  2. Vérifiez que votre variable CLASSPATH inclut le fichier uddiejbclient.jar (du répertoire racine_serveur_app/UDDIReg/clients), ainsi que le code de votre client.
  3. Compilez vos programmes client d'EJB : [AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
    $JAVA_HOME/bin/javac -extdirs $WAS_EXT_DIRS:$JAVA_HOME/jre/lib/ext 
    -classpath $WAS_CLASSPATH:$CLASSPATH yourcode.java
    [Windows]
    %JAVA_HOME%/bin/javac -extdirs $WAS_EXT_DIRS:%JAVA_HOME%/jre/lib/ext 
    -classpath %WAS_CLASSPATH%:%CLASSPATH% yourcode.java
  4. Exécutez les programmes compilés : [AIX][HP-UX][Linux][IBM i][Solaris][z/OS]
    $JAVA_HOME/bin/java -Djava.ext.dirs=$WAS_EXT_DIRS:$JAVA_HOME/jre/lib/ext 
    -Dwas.install.root=$WAS_HOME -Dserver.root=$WAS_HOME $CLIENTSAS $CLIENTSOAP 
    -cp $WAS_CLASSPATH:$WAS_HOME/UDDIReg/clients/uddiejbclient.jar:$CLASSPATH 
    <class name> <args>
    [Windows]
    %JAVA_HOME%\bin\java -Djava.ext.dirs=%WAS_EXT_DIRS%;%JAVA_HOME%\jre\lib\ext 
    -Dwas.install.root=%WAS_HOME% -Dserver.root=%WAS_HOME% %CLIENTSAS% %CLIENTSOAP% 
    -cp %WAS_CLASSPATH%;%WAS_HOME%\UDDIReg\clients\uddiejbclient.jar:%CLASSPATH% 
    <class name> <args>

    Assurez-vous que votre instruction PATH commence par racine_serveur_app/java/bin.


Icône indiquant le type de rubrique Rubrique de tâche



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=twsu_ejb
Nom du fichier : twsu_ejb.html