Erstellen und Implementieren von JET-Schablonen (JET - Java Emitter Templates) für den Assistenten 'Neue SQLJ-Datei'

Sie können Java Emitter Templates (JET) erstellen, um SQLJ-Dateien zu generieren, die die Informationen verwenden, die der Assistent Neue SQLJ-Datei erfasst.

Voraussetzung: Erstellen Sie ein JET-Projekt in der Workbench.
Für diese Task benötigen Sie Erfahrung beim Erstellen von Java Emitter Templates. Informationen zum Erstellen von Java Emitter Templates finden Sie in den folgenden englischsprachigen Artikeln auf der Website eclipse.org:

Zur Verbesserung der Lesbarkeit wird der vollständige Pfad zum Verzeichnis ...\com.ibm.datatools.sqlj in den Taskschritten weggelassen. Der vollständige Pfad lautet installationsverzeichnis\eclipse\plugins\com.ibm.datatools.sqlj.

Gehen Sie wie folgt vor, um eine JET-Schablone für den Assistenten Neue SQLJ-Datei zu erstellen und zu implementieren:

  1. Fügen Sie dem JET-Projekt ein Gerüst hinzu:
    • Importieren Sie die Datei SQLJFileSkeleton.skel in Ihr JET-Projekt. Die Datei befindet sich im Verzeichnis ...\com.ibm.datatools.sqlj\templates\skeleton.
    • Erstellen Sie ein Gerüst in Ihrem JET-Projekt. Das Gerüst muss eine Klasse definieren, die die Schnittstelle ISQLTemplate mit der Methode generate() implementiert, für die IBeanData als Parameter angegeben werden kann.
  2. Erstellen Sie Ihre Schablone in Ihrem JET-Projekt. Sie können eine Datei erstellen oder eine der Schablonen im Lieferumfang der Workbench importieren und deren Inhalt nach Bedarf ändern. Die Schablonendateien befinden sich im Verzeichnis ...\com.ibm.datatools.sqlj\templates.
    Die Anweisung JET in Ihrer Schablone muss Folgendes enthalten:
    • Einen Klassennamen, der unter allen Schablonen im Verzeichnis ...\com.ibm.datatools.sqlj\templates eindeutig ist. Ein Klassenname, der mit dem Schablonennamen übereinstimmt, ist z. B. gut geeignet.
    • Ein Attribut skeleton, das auf das verwendete Gerüst verweist.
  3. Fügen Sie die JAR-Laufzeitdatei für das SQLJ-Plug-in dem Java-Erstellungspfad Ihres Projekts hinzu. Klicken Sie im Fenster Merkmale des Projekts die Option Java-Erstellungspfad an, und führen Sie anschließend eine der folgenden Aktionen auf der Seite für Bibliotheken aus:
    • Wenn Sie eine SQLJ-Datei mit dem Assistenten Neue SQLJ-Datei erstellt haben, klicken Sie Variable hinzufügen an, und klicken Sie anschließend SQLJPLUGIN im Fenster Klassenpfadeintrag für neue Variable doppelt an.
    • Wenn Sie den Assistenten Neue SQLJ-Datei nicht verwendet haben, klicken Sie Externe JARs hinzufügen an, wechseln Sie im Fenster JAR-Auswahl in das Verzeichnis ...\com.ibm.datatools.sqlj, und klicken Sie die Datei sqlj.jar doppelt an.
    Die JAR-Laufzeitdatei für das SQLJ-Plug-in löst die Verweise in Ihrer Schablone in die Klassen des SQLJ-Plug-ins auf.
  4. Nach der erfolgreichen Kompilierung der Schablone kopieren Sie die zugehörige .sqljjet-Datei in das Verzeichnis ...\com.ibm.datatools.sqlj\templates. Wenn Sie eine neue Gerüstdatei erstellt haben, kopieren Sie sie in das Unterverzeichnis unterhalb von ...\com.ibm.datatools.sqlj, das mit dem Verweis in der Anweisung JET übereinstimmt.
  5. Fügen Sie die Beschreibung Ihrer Schablone der Datei user.properties im Verzeichnis ...\com.ibm.datatools.sqlj\template\properties hinzu. Öffnen Sie die Datei in einem Texteditor, und fügen Sie die folgenden zwei Zeilen nach den Kommentarzeilen hinzu:
    name_der_schablonendatei.label=schablonenname
    name_der_schablonendatei.desc=schablonenbeschreibung
    Der in der Bezeichnung angegebene Schablonenname wird in die Liste Schablone im Assistenten Neue SQLJ-Datei aufgenommen. Wenn die Schablone in der Liste ausgewählt wird, wird ihre Beschreibung im Anzeigefeld neben der Liste angezeigt.
  6. Verwenden Sie den Assistenten zum Erstellen einer SQLJ-Datei, wählen Sie Ihre Schablone aus, und überprüfen Sie den erzeugten Code in der generierten SQLJ-Datei.
Wenn Sie Änderungen an der Schablone vornehmen wollen, können Sie eine der folgenden Methoden verwenden: Bei der nächsten Verwendung des Assistenten Neue SQLJ-Datei zum Erstellen einer neuen SQLJ-Datei erkennt das SQLJ-Plug-in, dass Ihre Schablonendatei geändert wurde, und verwendet die aktualisierte Schablone.

Feedback