Commande de création de raccords

La commande createEJBStubs crée des classes de raccord pour les interfaces distantes des beans Enterprise JavaBeans (EJB) version empaquetés dans des fichiers JAR (Java archive), WAR (Web application 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.

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 - platformes basées sur UNIX
  • createEjbStubs - plateforme iSeries

La commande balaye le contenu du fichier JAR, WAR ou EAR en entrée. Elle y recherche les modules EJB 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 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.x distantes et des interfaces métier antérieures à EJB 3.x distantes dans une application Java™ 7. 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 d'imbriquer les fichiers de classes de raccord côté client dans votre application client. Si vous utilisez l'un des environnements client 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, auquel le Feature Pack for EJB 3.0 n'a pas été appliqué, ou interfaces métier antérieures à EJB 3.x qui ne figurent pas dans une application Java 7.
  • Environnements non WebSphere Application Server.

La JVM exécutant la commande createEJBStubs doit avoir sa propriété système java.io.tmpdir définie. Cette propriété doit pointer sur un répertoire existant et accessible à la fois en lecture et en écriture.

En plus de créer des raccords pour les beans empaquetés dans des fichiers EAR et JAR, cette commande crée également des raccords pour les beans contenus dans un fichier WAR. Si un fichier EAR est spécifié en entrée, et s'il contient lui-même un fichier WAR avec des interfaces distantes, des raccords sont générés pour ces interfaces.

Les raccords sont placés dans le fichier WAR, au même endroit que les interfaces distantes ou les classes de bean auxquelles ils correspondent. Si l'interface distante ou la classe de bean est placée à un endroit quelconque de la structure de répertoires WEB-INF/classes, le raccord généré est placé au même endroit. En revanche, si l'interface distante ou la classe de bean est enveloppée dans un fichier JAR, lui-même étant situé dans le répertoire WEB-INF/lib du module WAR, le raccord correspondant est inséré dans ce même fichier JAR. Si un raccord est généré pour une interface distante qui n'est pas empaquetée dans le fichier WAR, il est placé dans la structure de répertoires WEB-INF/classes, sans contrainte de niveau.

Un composant client utilise ces raccords pour communiquer avec les composants EJB exécutés à l'intérieur du serveur. Le composant client doit utiliser les instances de raccords qui ont été créées par l'outil correct.

Syntaxe

createEJBStubsnom_classe_ entrée | nom_JAR_entrée | nom_WAR_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, un fichier WAR 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 ou nom_WAR_entrée

Le premier paramètre de la commande est un élément obligatoire. Il doit contenir la classe source, le fichier JAR, le fichier WAR 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). Vous remarquerez que les segments du 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, WAR 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. Pour plus de détails, voir les sections ci-dessous.

-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, WAR 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, WAR 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, WAR 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, WAR ou EAR d'origine 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 my_path/my_beans.jar -newfile –quiet

Génère des classes de raccord pour tous les beans enterprise 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 my_path/my_Server_App.ear -logfile myLog.out

Génère des classes de raccord pour tous les beans enterprise de niveau 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 beans enterprise de niveau 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 beans enterprise de niveau 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.

createEJBStubs mon_chemin/mes_beans.war

Génère des classes de raccord pour tous les beans entreprise contenus dans le fichier WAR et ayant des interfaces distantes. La classe Bean1 est placée directement dans la structure de répertoires WEB-INF/classes (à un niveau quelconque de cette structure) ; par conséquent, le raccord correspondant est placé au même endroit. En revanche, la classe Bean2 est enveloppée dans un fichier nommé monEJB.jar, lui-même étant situé dans le répertoire WEB-INF/lib du module WAR ; par conséquent, le raccord correspondant est inséré dans ce fichier JAR.

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_3stubscmd2
Nom du fichier : rejb_3stubscmd2.html