SQLJ-Anwendungen, die CMP verwenden, mit dem Tool "ejbdeploy" implementieren

Integrieren Sie SQL- (Structured Query Language) in Java™-(SQLJ)-Anweisungen in Ihren Anwendungen, um die Effizienz von Transaktionen mit Ihren Datenbanken zu maximieren. Bevor Ihre Anwendungen SQLJ nutzen können, müssen Sie die Anwendung implementieren und die SQLJ-Profile anpassen, die erstellt werden. Der Anwendungsserver stellt Funktionen für die Verwendung von SQLJ als Persistenzmechanismus für Enterprise-Beans bereit, die CMP (Container-managed Persistence, über Container realisierte Transaktionspersistenz) verwenden. Verwenden Sie das Tool "ejbdeploy", um die Anwendung zu implementieren.

Informationen zu diesem Vorgang

Sie können SQLJ-Anwendungen mit dem Tool "ejbdeploy" implementieren, um die Unternehmensanwendung in einer eigenständigen Umgebung zu implementieren.
Alternativ können Sie die im Anwendungsserver integrierte erweiterte SQLJ-Unterstützung für Anwendungen verwenden, die CMP verwenden. Die folgenden neuen Features werden bereitgestellt:
  • CMP-Beans während der Anwendungsinstallation im Anwendungsserver implementieren.
  • SQLJ-Profile über die Administrationskonsole oder über Scripting anpassen und binden.
  • SQLJ-Anwendungen erneut anpassen und binden, ohne die Anwendung erneut installieren zu müssen.
Diese Erweiterungen verringern die Komplexität der Installation, Implementierung und Anpassung von SQLJ-Anwendungen für CMP und BMP (Bean-managed Persistence, über JavaBeans realisierte Transaktionspersistenz). Weitere Informationen finden Sie im Artikel zum Implementieren von SQLJ-Anwendungen, die CMP verwenden.

Vorgehensweise

  1. Erstellen Sie eine Top-down-Zuordnung zu einer DB2-Datenbank.
  2. Kopieren Sie die Datei sqlj.zip aus Ihrer DB2-Installation in ein Verzeichnis auf Ihrer Workstation.
  3. Ändern Sie den Java-Erstellungspfad des JAR-Projekts für Ihre Unternehmensanwendung, und fügen Sie die Datei sqlj.zip ein.
  4. Verwenden Sie Rational Application Developer oder den DB2-SQLJ-Umsetzer, um SQLJ automatisch umzusetzen.
    • Verwenden Sie Rational Application Developer wie folgt:
      1. Klicken Sie im Projektnavigator auf Name_des_EJB-JAR-Projekts > Quellenordner > META-INF > backends > Datenbankversion.
      2. Öffnen Sie die Datei "Map.mapxmi" im Zuordnungseditor.
      3. Heben Sie in der Anzeige Overview den Namen Ihres JAR-Projekts in der Spalte "Enterprise Beans" hervor. Sie müssen den Namen des JAR-Projekts hervorheben und nicht den Namen der einer der aufgelisteten Enterprise-Beans.
      4. Klicken Sie in der Anzeige Properties auf SQLJ.
      5. Setzen Sie Is using SQLJ? auf True.
      6. Setzen Sie Translator Module auf den vollständig qualifizierten Pfad der Datei "sqlj.zip" auf Ihrer Workstation.
      7. Speichern Sie die Datei "Map.mapxmi".
      8. Exportieren Sie die EAR-Datei.
    • Verwenden Sie den DB2-SQLJ-Umsetzer. Dieses Tool erstellt eine Version der ".sqlj"-Datei mit der Erweiterung ".java" und ein serialisiertes Profil mit der Erweiterung ".ser", das später für die Verarbeitung verwendet wird. Weitere Informationen zum SQLJ-Umsetzertool finden Sie in der DB2-Dokumentation.
  5. Implementieren Sie die EAR-Datei mit dem Tool "ejbdeploy".
    1. Vergewissern Sie sich, dass das Verzeichnis "Stammverzeichnis_des_Anwendungsservers/bin" in Ihrem Klassenpfad enthalten ist.
    2. Führen Sie das Befehlsdienstprogramm "ejbdeploy" mit der Option -sqlj aus. Der Befehl "ejbdeploy" generiert eine EAR-Datei mit dem von Ihnen angegebenen Namen und ein Ant-Script mit dem Namen Anwendungsname.ear.xml.
      Beispiel:
      ejbdeploy d:\Anwendungsname.ear           
                working d:\deployed_Anwendungsname.ear 
                -sqlj           
                -dbvendor DB2UDB_V81           
                -cp "C:\PROGRA~1\IBM\SQLLIB\java\sqlj.zip"
      Fehler vermeiden Fehler vermeiden: Geben Sie die Position der Datei "sqlj.zip" für den SQLJ-Umsetzer mit der Option "-cp", der Klassenpfadoption, an. Der Befehl "ejbdeploy" ruft die Datei sqlj.zip nicht über Ihren Systemklassenpfad auf.gotcha
  6. Wählen Sie die Option für Anpassung aus.
    • Verwenden Sie die SQLJ-Unterstützung des Anwendungsservers. Installieren Sie die implementierte Anwendung, um die SQLJ-Profile über den Anwendungsserver oder Scripting anzupassen.
      1. Installieren Sie die Unternehmensanwendung im Anwendungsserver.
        Fehler vermeiden Fehler vermeiden: Wählen Sie während der Anwendungsinstallation nicht die Option Enterprise-Beans implementieren in der Administrationskonsole aus. Wenn Sie die Enterprise-Beans über die Administrationskonsole erneut implementieren, gehen die vorgenommenen Anpassungsänderungen verloren.gotcha
      2. Passen Sie die SQLJ-Profile an.
        • Informationen zur Administrationskonsolunterstützung finden Sie im Artikel zur Anpassung und Bindung von Profilen für Structured Query Language in Java-(SQLJ)-Anwendungen.
        • Informationen zur Scripting-Unterstützung finden Sie im Artikel zur Befehlsgruppe für die Anwendungsverwaltung für das Objekt "AdminTask".
    • Verwenden Sie das Tool "db2sqljcustomize", um die SQLJ-Profile anzupassen und zu binden. Lesen Sie dazu den Artikel zum Anpassen und Binden von SQLJ-Profilen mit dem Tool "db2sqljcustomize".

Symbol, das den Typ des Artikels anzeigt. Taskartikel



Symbol für Zeitmarke Letzte Aktualisierung: 25.05.2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tdat_sqljdeploycmptool
Dateiname:tdat_sqljdeploycmptool.html