Entwickeln von Java Service Fabric-Anwendungen mit Visual Studio Code

2024-10-15

Die Service Fabric Reliable Services-Erweiterung für VS Code erleichtert die Erstellung von Java Service Fabric-Anwendungen unter den Betriebssystemen Windows, Linux und macOS.

In diesem Artikel wird das Erstellen, Bereitstellen und Debuggen einer Java Service Fabric-Anwendung mit Visual Studio Code beschrieben.

Wichtig

Service Fabric Java-Anwendungen können zwar auf Windows-Computern entwickelt, jedoch nur in Azure Linux-Clustern bereitgestellt werden. Das Debuggen von Java-Anwendungen wird unter Windows nicht unterstützt.

Voraussetzungen

In diesem Artikel wird davon ausgegangen, dass Sie VS Code, die Service Fabric Reliable Services-Erweiterung für VS Code sowie alle für Ihre Entwicklungsumgebung erforderlichen Abhängigkeiten bereits installiert haben. Weitere Informationen finden Sie unter Erste Schritte.

Herunterladen des Beispiels

In diesem Artikel wird die Anwendung Voting im GitHub-Repository aus dem Schnellstart-Beispiel der Service Fabric Java-Anwendung verwendet.

Um das Repository auf Ihren Entwicklungscomputer zu klonen, führen Sie den folgenden Befehl über ein Terminalfenster (Befehlsfenster in Windows) aus:

git clone https://github.com/Azure-Samples/service-fabric-java-quickstart.git

Öffnen der Anwendung in VS Code

Öffnen Sie Visual Studio Code. Klicken Sie auf das Explorer-Symbol in der Aktivitätsleiste und dann auf Ordner öffnen, oder klicken Sie auf Datei -> Ordner öffnen. Navigieren Sie zum Verzeichnis ./service-fabric-java-quickstart/Voting in dem Ordner, in den Sie das Repository geklont haben, und klicken Sie dann auf OK. Der Arbeitsbereich sollte die im folgenden Screenshot gezeigten Dateien enthalten.

Java-Anwendung Voting im Arbeitsbereich

Erstellen der Anwendung

Drücken Sie (STRG+UMSCHALT+P), um die Befehlspalette in VS Code zu öffnen.
Suchen Sie den Befehl Service Fabric: Anwendung erstellen, und wählen Sie ihn aus. Die Buildausgabe wird an das integrierte Terminal gesendet.

Bereitstellen der Anwendung im lokalen Cluster

Nachdem Sie die Anwendung erstellt haben, können Sie sie im lokalen Cluster bereitstellen.

Wichtig

Die Bereitstellung von Java-Anwendungen im lokalen Cluster wird auf Windows-Computern nicht unterstützt.

Wählen Sie in der Befehlspalette den Befehl Service Fabric: Anwendung bereitstellen (Localhost) aus. Die Ausgabe des Installationsvorgangs wird an das integrierte Terminal gesendet.
Starten Sie nach Abschluss der Bereitstellung einen Browser, und öffnen Sie Service Fabric Explorer: http://localhost:19080/Explorer. Es sollte angezeigt werden, dass die Anwendung ausgeführt wird. Dies kann einige Zeit dauern. Haben Sie daher etwas Geduld.
Nachdem Sie sichergestellt haben, dass die Anwendung ausgeführt wird, starten Sie einen Browser. Öffnen Sie folgende Seite: http://localhost:8080. Hierbei handelt es sich um das Web-Front-End der Anwendung. Sie können Elemente hinzufügen und zum Abstimmen auf sie klicken.
Wählen Sie in der Befehlspalette den Befehl Service Fabric: Anwendung entfernen aus, um die Anwendung aus dem Cluster zu entfernen. Die Ausgabe des Deinstallationsvorgangs wird an das integrierte Terminal gesendet. Mithilfe von Service Fabric Explorer können Sie überprüfen, ob die Anwendung aus dem lokalen Cluster entfernt wurde.

Debuggen der Anwendung

Beim Debuggen von Anwendungen in VS Code muss die Anwendung in einem lokalen Cluster ausgeführt werden. Dem Code können Haltepunkte hinzugefügt werden.

Wichtig

Das Debuggen von Java-Anwendungen wird auf Windows-Computern nicht unterstützt.

Gehen Sie wie folgt vor, um den VotingDataService und die Anwendung Voting auf das Debuggen vorzubereiten:

Aktualisieren Sie die Datei Voting/VotingApplication/VotingDataServicePkg/Code/entryPoint.sh. Kommentieren Sie den Befehl in Zeile 6 (mit '#') aus, und fügen Sie den folgenden Befehl am Ende der Datei hinzu:
```
java -Xdebug -Xrunjdwp:transport=dt_socket,address=8001,server=y,suspend=n -Djava.library.path=$LD_LIBRARY_PATH -jar VotingDataService.jar
```
Aktualisieren Sie die Datei Voting/VotingApplication/ApplicationManifest.xml. Legen Sie für die Attribute MinReplicaSetSize und TargetReplicaSetSize im Element StatefulService den Wert „1“ fest:
```
      <StatefulService MinReplicaSetSize="1" ServiceTypeName="VotingDataServiceType" TargetReplicaSetSize="1">
```
Klicken Sie in der Aktivitätsleiste auf das Symbol zum Debuggen, um die Debuggeransicht in VS Code zu öffnen. Klicken Sie auf das Zahnradsymbol am oberen Rand der Debuggeransicht, und wählen Sie im Dropdownmenü der Umgebung Java aus. Die Datei „launch.json“ wird geöffnet.
Legen Sie in der Datei „launch.json“ für den Port in der Konfiguration mit dem Namen Debug (Attach) (Debuggen (anfügen)) den Wert 8001 fest. Speichern Sie die Datei.
Stellen Sie die Anwendung für den lokalen Cluster mithilfe des Befehls Service Fabric: Anwendung bereitstellen (Localhost) bereit. Stellen Sie sicher, dass die Anwendung in Service Fabric Explorer ausgeführt wird. Ihre Anwendung kann jetzt gedebuggt werden.

Gehen Sie wie folgt vor, um einen Haltepunkt festzulegen:

Öffnen Sie in Explorer die Datei /Voting/VotingDataService/src/statefulservice/VotingDataService.java. Legen Sie für die erste Codezeile im try-Block in der addItem-Methode (Zeile 80) einen Haltepunkt fest.

Wichtig

Stellen Sie sicher, dass Sie Haltepunkte für ausführbare Codezeilen festlegen. Für Methodendeklarationen, try-Anweisungen oder catch-Anweisungen festgelegte Haltepunkte werden vom Debugger beispielsweise übersehen.
Klicken Sie in der Aktivitätsleiste auf das Debugsymbol, wählen Sie im Debugmenü die Konfiguration Debug (Attach) (Debuggen (anfügen)) aus, und klicken Sie auf die Schaltfläche zum Ausführen (grüner Pfeil), um mit dem Debuggen zu beginnen.
Rufen Sie in einem Web browser http://localhost:8080 auf. Geben Sie im Textfeld ein neues Element ein, und klicken Sie auf + Hinzufügen. Ihr Haltepunkt sollte erreicht werden. Mithilfe der Debug-Symbolleiste am oberen Rand von VS Code können Sie die Ausführung fortsetzen, Zeilen überspringen, in Methoden springen oder die aktuelle Methode verlassen.
Klicken Sie in der Debugsymbolleiste am oberen Rand von VS Code auf das Steckersymbol, um die Debugsitzung zu beenden.
Wenn Sie mit dem Debuggen fertig sind, können Sie die Anwendung Voting mit dem Befehl Service Fabric: Anwendung entfernen aus Ihrem lokalen Cluster entfernen.