WebSphere Extended Deployment, Version 6.0.x     Betriebssysteme: AIX, HP-UX, Linux, Solaris, Windows, z/OS

Enterprise-Bean-Stubs ändern

Bei der normalen EJB-Implementierung werden Cluster-fähige Stubs erzeugt. Diese Stubs können in einem zweiten Durchgang so geändert werden, dass sie die Weiterleitung an Partitionen unterstützen. Das Tool erzeugt aus der EAR-Datei eine neue EAR-Datei mit den geänderten Stubs. Die Stubs werden für alle EJBs geändert, die an Partitionen weitergeleitet werden können. Eine an Partitionen weiterleitbare EJB ist eine Stateless-Session-Bean mit einem fernen Interface und einer zugeordneten Router-Klasse XXX_PartitionKey.

Sie finden das Tool wpfStubUtil im Verzeichnis <WAS-Installationsstammverzeichnis>/bin. Führen Sie dieses Tool für partitionierte EAR-Dateien Enterprise Archive (EAR) nach der Ausführung von ejbdeploy aus. Im Folgenden wird die Verwendung von wpfStubUtil beschrieben. Die Ausführung des Tools kann fehlschlagen, wenn die beschriebene Reihenfolge nicht eingehalten wird.

wpfStubUtil -ear <EAR-Name> -jar <JAR-Name> -class <Klassenname> -temp <
temporäres_Arbeitsverzeichnis> [optionale Flags: -stubUpdateClasspath <Klassenpfad
> -verbose -stubDebug -keep -rmicextclasspath <Klassenpfad>
-extdirs <externe_javac-Verzeichnisse>]

Die Optionen -ear, -jar, -class und -temp sind erforderlich. Der Befehl -stubUpdateClasspath ist optional, aber wenn Sie ihn verwenden, muss er das erste Argument nach dem temporären Arbeitsverzeichnis sein.
Die Optionen sind im Folgenden beschrieben:
-ear <EAR-Name>
Die EAR-Datei mit der partitionierten Anwendung.
-jar <JAR-Name>
Die EJB-JAR-Datei in der EAR-Datei mit der partitionierten Enterprise-Bean.
-class <Klassenname>
Die Remote-Interface-Klasse der Bean.
-temp <Arbeitsverzeichnis>
Das Verzeichnis, in dem alle Arbeiten durchgeführt werden.
-stubUpdateClasspath <Klassenpfad>
(optional) Das Tool fügt seinen Klassenpfad an die Angabe des Benutzers an.
-verbose
(optional) Option für ausführliche Ausgabe des Tools.
-stubDebug
(optional) Aktiviert die zusätzliche Debug-Ausgabe im Stub. Von der Verwendung dieser Option in Produktionsumgebungen wird abgeraten.
-keep
(optional) Wenn Sie diese Option verwenden, wird der Inhalt des temporären Arbeitsverzeichnisses nach der Ausführung des Tools nicht gelöscht.
-rmicextclasspath <Klassenpfad>
(optional) Fügt die Angabe des Benutzers an den rmic-Klassenpfad an.
-extdirs <externe_javac-Verzeichnisse>
(optional) Fügt die Angabe des Benutzers an die externen javac-Verzeichnisse an.
wpfStubUtil kann alle Session-EJBs mit definierter Klasse XXX_PartitionKey aktualisieren. Bei diesen EJBs handelt es sich um PRSBs oder PSSBs.
Im Folgenden sehen Sie ein Beispiel für die Ausführung von wpfStubUtil für eine EAR-Datei, die eine PRSB-Fassaden-Bean enthält:
C:\stub>\ws\Application server\bin\wpfStubUtil.cmd -ear 
D_WPFFacadePartitionSample.ear -jar 
WPFKeyBasedPartitionEJB.jar -class com/ibm/websphere/wpf/ejb/
WPFKeyBasedPartition.class -temp \working
Es ist bereits ein Unterverzeichnis oder eine Datei \working vorhanden.
WPFC0069I: Die EAR-Datei D_WPFFacadePartitionSample.ear wird entpackt.
WPFC0070I: Die JAR-Datei WPFKeyBasedPartitionEJB.jar wird entpackt.
WPFC0071I: rmic wird für die Generierung der Stub-Quelle ausgeführt.
[rmic-Ausgabe - entfernt]
 [fertig in 2334 ms]
WPFC0072I: Die Stub-Quelle wird aktualisiert.
WPFC0073I: Die geänderte Stub-Quelle wird kompiliert.
WPFC0074I: Die JAR-Datei WPFKeyBasedPartitionEJB.jar wird neu gepackt.
WPFC0075I: Die EAR-Datei D_WPFFacadePartitionSample.ear wird neu gepackt.
Bereinigung....
Im Folgenden sehen Sie ein Beispiel für die Ausführung von wpfStubUtil für zwei EAR-Dateien mit Session-Beans, die an Partitionen weitergeleitet werden können. Für die Datei D_StockAccount.ear muss eine eine zusätzliche JAR-Datei (StockEJB.jar) an den rmic-Klassenpfad (-rmicextclasspath), stubUpdateClasspath (-stubUpdateClasspath) und die externen java-Verzeichnisse (-extdirs) angefügt werden:
C:\stub>\ws\Application server\bin\wpfStubUtil.cmd -ear D_Stock.ear 
-jar StockEJB.jar -class 
wpf/test/stock/ejb/ProcessStock.class -temp \working
Es ist bereits ein Unterverzeichnis oder eine Datei \working vorhanden.
WPFC0069I: Die EAR-Datei D_Stock.ear wird entpackt.
WPFC0070I: Die JAR-Datei StockEJB.jar wird entpackt.
WPFC0071I: rmic wird für die Generierung der Stub-Quelle ausgeführt.
[rmic-Ausgabe - entfernt]
 [fertig in 2324 ms]
WPFC0072I: Die Stub-Quelle wird aktualisiert.
WPFC0073I: Die geänderte Stub-Quelle wird kompiliert.
WPFC0074I: Die JAR-Datei StockEJB.jar wird neu gepackt.
WPFC0075I: Die EAR-Datei file D_Stock.ear wird neu gepackt.
Bereinigung....

C:\stub>\ws\Application server\bin\wpfStubUtil.cmd -ear 
D_StockAccount.ear -jar 
StockAccountEJB.jar -class wpf/test/stockaccount/ejb/
Process.class -temp \working 
-stubUpdateClasspath \stub\StockEJB.jar -rmiextclasspath \stub\ 
StockEJB.jar -extdirs 
\stub\StockEJB.jar
Es ist bereits ein Unterverzeichnis oder eine Datei \working vorhanden.
WPFC0069I: Die EAR-Datei D_StockAccount.ear wird entpackt.
WPFC0070I: Die JAR-Datei StockAccountEJB.jar wird entpackt.
WPFC0071I: rmic wird für die Generierung der Stub-Quelle ausgeführt.
[rmic-Ausgabe - entfernt]
[fertig in 2333 ms]
WPFC0072I: Die Stub-Quelle wird aktualisiert.
WPFC0073I: Die geänderte Stub-Quelle wird kompiliert.
WPFC0074I: Die JAR-Datei StockAccountEJB.jar wird neu gepackt.
WPFC0075I: Die EAR-Datei D_StockAccount.ear wird neu gepackt.
Bereinigung....
Im Folgenden sehen Sie ein Beispiel für die Ausführung von wpfStubUtil für eine EAR-Datei, die nur eine partitionierte Stateless-Session-Bean enthält:
C:\stub>\ws\Application server\bin\wpfStubUtil.cmd -ear 
D_WPFKeyBasedPartitionSample.ear 
-jar WPFKeyBasedPartitionEJB.jar -class com/ibm/websphere/wpf/ejb/
WPFKeyBasedPartition.class
 -temp \working
Es ist bereits ein Unterverzeichnis oder eine Datei \working vorhanden.
WPFC0069I: Die EAR-Datei D_WPFKeyBasedPartitionSample.ear wird entpackt.
WPFC0070I: Die JAR-Datei WPFKeyBasedPartitionEJB.jar wird entpackt.
WPFC0071I: rmic wird für die Generierung der Stub-Quelle ausgeführt.
[rmic-Ausgabe - entfernt]
[fertig in 2373 ms]
WPFC0072I: Die Stub-Quelle wird aktualisiert.
WPFC0073I: Die geänderte Stub-Quelle wird kompiliert.
WPFC0074I: Die JAR-Datei WPFKeyBasedPartitionEJB.jar wird neu gepackt.
WPFC0075I: Die EAR-Datei file D_WPFKeyBasedPartitionSample.ear wird neu gepackt.
Bereinigung....

Es kann vorkommen, dass wpfStubUtil eine Klasse nicht findet, obwohl sie in der im Klassenpfad angegebenen JAR-Datei enthalten ist. In diesem Fall müssen Sie alle Klassen aus der JAR-Datei mit der nicht gefundenen Klasse im <temporären Arbeitsverzeichnis> entpacken.




Related concepts
Programmiermodell des Partitionierungs-Feature

Konzeptartikel    

Nutzungsbedingungen | Feedback Letzte Aktualisierung: Mar 23, 2006 9:57:42 AM EST
http://publib.boulder.ibm.com/infocenter/wxdinfo/v6r0/index.jsp?topic=?topic=/com.ibm.websphere.xd.doc/info/WPF51/cwpfejbstub.html

© Copyright IBM 2005, 2006. Alle Rechte vorbehalten.
Dieses Information Center beruht auf der Eclipse-Technologie. (http://www.eclipse.org)