Commande de création de raccords

La commande createEJBStubs permet de créer des classes de raccord pour les interfaces distantes des beans Enterprise JavaBeans (EJB) Version 3.0 qui figurent dans un fichier JAR (Java™ archive) ou EAR (Enterprise archive). Elle fournit également une option permettant de créer une classe de raccord unique à partir d'une classe d'interface se trouvant dans un répertoire ou un fichier JAR. Plusieurs options de commande sont fournies pour la mise en forme des classes de raccord générées. Pour plus d'informations, voir les sections Syntaxe et Exemples ci-après.

Cette commande se trouve dans le répertoire <WAS_HOME>/bin et peut prendre les différentes formes suivantes, selon la plateforme :
  • createEJBStubs.bat - plateformes Windows
  • createEJBStubs.sh - plateformes basées sur Unix
  • createEjbStubs - plateforme iSeries

La commande balaye le contenu du fichier JAR ou EAR en entrée. Elle y recherche les modules EJB version 3.0 qui contiennent des beans avec interfaces distantes. Lorsque les interfaces distantes ont été trouvées, les classes de raccord correspondantes sont générées et empaquetées en fonction des options définies dans la commande. Si l'entrée spécifiée est une classe d'interface indiquée seule, l'outil suppose qu'il s'agit d'une classe d'interface distante EJB version 3.0 et génère une classe de raccord distante.

Pour bon nombre de scénarios côté client, la fonction de déploiement JIT (Just-In-Time) de WebSphere Application Server génère de manière dynamique les classes de raccord RMI-IIOP nécessaires à l'appel des interfaces métier EJB 3.0 distantes. Toutefois, il existe des scénarios dans lesquels l'environnement de déploiement JIT n'est pas disponible pour générer ces classes de manière dynamique. Dans ces scénarios, la commande createEJBStubs doit être utilisée plutôt que de générer et imbriquer les fichiers de classes de raccord côté client dans votre application client. Si vous utilisez l'un des environnements suivants, utilisez la commande createEJBStubs :
  • Clients Java Standard Edition (SE) nus "Bare", où l'environnement client est une machine virtuelle Java SE.
  • Conteneur WebSphere Application Server (conteneur Web, conteneur EJB ou conteneur d'application client) provenant d'une version antérieure à la version 7, ou auquel le Feature Pack for EJB 3.0 n'a pas été appliqué.
  • Environnements non WebSphere Application Server.

Syntaxe

createEJBStubs nom_classe_entrée | nom_JAR_entrée | nom_EAR_entrée [-help] [-newfile [nouveau_fichier]] [-updatefile [fichier_mise_jour]] [-quiet] [-verbose] [-logfile fichier_journal] [-appendlog] [-cp chemin_accès_classes] [-trace]
createEJBStubs
Il s'agit de la commande permettant de créer des classes de raccord EJB pour un fichier de classe d'interface unique, un fichier JAR ou un fichier EAR. Lorsqu'elle est appelée sans arguments, ou seulement avec l'argument –help, la commande createEJBStubs affiche une liste des options pouvant être définies, ainsi qu'une liste d'exemples d'appels avec des explications détaillées.
nom_classe_entrée ou nom_EAR_entrée ou nom_JAR_entrée

Le premier paramètre de la commande est un élément obligatoire. Il doit contenir la classe source, le fichier JAR ou le fichier EAR à traiter.

Ce paramètre peut être le nom qualifié complet d'une classe d'interface unique (par exemple, com.ibm.monInterfaceDistante). Il est à noter que les segments de nom de package sont séparés par des caractères ".", qu'aucun nom de chemin ne précède le nom de classe et que l'extension ".class" n'est pas incluse. Pour cette entrée de classe d'interface, vous devez utiliser l'option de chemin d'accès aux classes (p. ex. –cp mon_chemin, ou –cp mon_chemin/mes_interfaces.jar) pour définir l'emplacement de la classe d'interface. La classe de raccord générée sera placée dans l'arborescence définie par le package, en commençant par le répertoire d'où la commande est appelée.

Ce paramètre peut également être un fichier JAR ou EAR. Dans ce cas, le chemin doit être défini (p. ex. mon_chemin/mon_app_serveur.ear). Les classes de raccord générées seront placées dans le ou les mêmes modules que les beans, ou dans le ou les mêmes modules que les classes d'interface distantes, selon que l'option –updatefile est définie ou non. Vous trouverez des détails ultérieurement dans cette section.

-help
Indique la syntaxe des commandes, y compris une liste des options pouvant être indiquées, ainsi que des exemples d'appels avec des explications détaillées.
-newfile [nouveau_fichier]
Demande à générer un nouveau fichier contenant d'une part les fichiers d'origine des JAR ou EAR spécifiés en entrée, d'autre part les classes de raccord. Lorsque cette option n'est pas définie, les raccords sont réécrits dans le fichier JAR ou EAR d'origine. Si cette option est définie, mais que le nom nouveau_fichier n'est pas fourni, un nouveau nom de fichier est construit en ajoutant "_withStubs" au nom de fichier JAR ou EAR en entrée. Cette option n'est pas autorisée lorsque le premier paramètre en entrée est une classe d'interface.
-updatefile [fichier_mise_jour]
Demande qu'un second fichier (par exemple en plus du fichier en entrée) soit mis à jour avec les classes de raccord. Cette option fournit également un comportement d'empaquetage différent. Les classes de raccords sont placées dans le ou les mêmes modules que les classes d'interface distante. Par opposition, lorsque cette option n'est pas définie, les classes de raccords sont placées dans le ou les mêmes modules que les classes de bean. Si cette option est définie, mais que le nom fichier_mise_jour n'est pas défini, seul le fichier JAR ou EAR original est mis à jour avec les classes de raccord. Cette option n'est pas autorisée lorsque le premier paramètre en entrée est une classe d'interface.
-quiet
Demande la suppression des messages. L'option -quiet ne peut pas être définie en même temps que les options –verbose ou –trace. Des messages d'erreur sont toujours affichés.
-verbose
Demande que des messages d'information supplémentaires soient émis en sortie. L'option -verbose ne peut pas être définie en même temps que les options -quiet ou –trace.
-logfile fichier_journal
Demande que les messages figurent dans un fichier journal en plus de la console. Si cette option n'est pas définie, le nom fichier_journal doit aussi être indiqué.
-appendlog
Demande que les messages soient ajoutés à un fichier journal existant. Si cette option est indiquée, l'option -logfile doit également être précisée.
-cp chemin_classe
Demande que le chargeur de classe inclue le chemin d'accès aux classes indiqué, où se trouvent des fichiers de classe ou des fichiers jar supplémentaires nécessaires au chargement des classes d'interface distantes. Le chemin d'accès aux classes peut contenir plusieurs segments où chaque chemin est séparé du précédent par le caractère de séparation de chemins par défaut du système d'exploitation. Chaque chemin peut définir un fichier JAR ou un répertoire. Si cette option est définie, le nom chemin_classe doit également être indiqué.
-trace
Demande que la sortie de trace détaillée soit générée. Cette opération à pour but de collecter des informations utiles au service IBM® pour qu'il résolve l'incident. La sortie de trace est uniquement en anglais. Cette option ne peut pas être définie en même temps que les options –quiet ou –verbose.

Exemples

createEJBStubs com.ibm.monInterfaceDistante -cp mon_chemin

Génère la classe de raccord d'une classe d'interface distante et la place dans l'arborescence définie par le package, en commençant par le répertoire en cours. Le répertoire mon_chemin sera utilisé comme chemin d'accès aux classes. Si la classe d'interface distante à traiter est dans un fichier JAR, la syntaxe –cp mon_chemin/mes_interfaces.jar doit être utilisée dans la spécification de chemin d'accès aux classes.

createEJBStubs mon_chemin/mes_beans.jar -newfile –quiet

Génère des classes de raccord pour tous les EJB de niveau 3.0 contenus dans le fichier mes_beans.jar et ayant des interfaces distantes. Les classes de raccord générées et le contenu du fichiers JAR original est empaqueté dans un nouveau fichier JAR nommé “mes_beans_withStubs.jar” car le paramètre de nom facultatif nouveau_fichier n'est pas défini avec l'option –newfile. Les messages de sortie sont supprimés hormis ceux de notification des erreurs.

createEJBStubs mon_chemin/mon_app_serveur.ear -logfile monJournal.out

Génère des classes de raccord pour tous les EJB de niveau 3.0 contenus dans le fichier mon_app_serveur.ear et ayant des interfaces distantes. Les classes de raccord générées sont placées dans le fichier EAR d'origine car l'option –newfile n'est pas définie. Les classes de raccord sont regroupées dans le ou les mêmes modules que les classes de bean car l'option –updatefile n'est pas définie. Les messages ne sont pas écrits dans le fichier journal monJournal.out et dans la fenêtre de commande.

createEJBStubs mon_chemin/mon_app_serveur.ear -updatefile mon_chemin/mes_interfaces_client.jar

Génère des classes de raccord pour tous les EJB de niveau 3.0 contenus dans le fichier mon_app_serveur.ear et ayant des interfaces distantes. Les classes de raccord générées sont placées dans le fichier EAR d'origine et dans le fichier mes_interfaces_client.jar. Les classes de raccord sont regroupées dans le ou les mêmes modules que les classes d'interface distante car l'option –updatefile n'est pas définie.

createEJBStubs mon_chemin/mon_app_serveur.ear –updatefile

Génère des classes de raccord pour tous les EJB de niveau 3.0 contenus dans le fichier mon_app_serveur.ear et ayant des interfaces distantes. Les classes de raccord générées sont placées uniquement dans le fichier EAR d'origine car le paramètre facultatif nom mise_jour_fichier n'est pas fourni avec l'option –updatefile. Les classes de raccord sont regroupées dans le ou les mêmes modules que les classes d'interface distante car l'option –updatefile n'est pas définie.

Icône indiquant le type de rubrique Rubrique de référence



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=rejb_3stubscmd
Nom du fichier : rejb_3stubscmd.html