Sviluppare applicazioni Java di Service Fabric con Visual Studio Code

2024-10-15

L'estensione Reliable Services di Service Fabric per Visual Studio Code consente di creare con facilità applicazioni Java di Service Fabric su sistemi operativi Windows, Linux e macOS.

Questo articolo illustra come compilare e distribuire un'applicazione Java di Service Fabric ed eseguirne il debug usando Visual Studio Code.

Importante

Le applicazioni Java di Service Fabric possono essere sviluppate su computer Windows, ma possono essere distribuite solo in cluster Linux di Azure. Il debug di applicazioni Java non è supportato in Windows.

Prerequisiti

Questo articolo presuppone che siano già installati Visual Studio Code, l'estensione Reliable Services di Service Fabric per Visual Studio Code e le dipendenze necessarie per l'ambiente di sviluppo. Per altre informazioni, vedere l'introduzione.

Scaricare l'esempio

In questo articolo viene usata l'applicazione Voting inclusa nel repository GitHub degli esempi di avvio rapido per applicazioni Java di Service Fabric.

Per clonare il repository nel computer di sviluppo, eseguire il comando seguente da una finestra di terminale (finestra di comando in Windows):

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

Aprire l'applicazione in Visual Studio Code

Aprire VS Code. Fare clic sull'icona di esplorazione sulla barra delle attività e quindi su Apri cartella o File -> Apri cartella. Passare alla directory ./service-fabric-java-quickstart/Voting nella cartella in cui è stato clonato il repository e quindi fare clic su OK. L'area di lavoro dovrebbe contenere gli stessi file illustrati nello screenshot seguente.

Applicazione Java Voting nell'area di lavoro

Compilare l'applicazione

In Visual Studio Code premere CTRL+MAIUSC+P per aprire il riquadro comandi.
Cercare e selezionare il comando Service Fabric: Build Application (Service Fabric: Compila applicazione). L'output della compilazione viene inviato al terminale integrato.

Distribuire l'applicazione nel cluster locale

Dopo aver compilato l'applicazione, è possibile distribuirla nel cluster locale.

Importante

La distribuzione di applicazioni Java nel cluster locale non è supportata nei computer Windows.

Dal riquadro comandi selezionare il comando Service Fabric: Deploy Application (Localhost) (Service Fabric: Distribuisci applicazione - Localhost). L'output del processo di installazione viene inviato al terminale integrato.
Al termine della distribuzione, avviare un browser e aprire Service Fabric Explorer: http://localhost:19080/Explorer. Si noterà che l'applicazione è in esecuzione. Questa operazione potrebbe richiedere tempo.
Dopo aver verificato se l'applicazione è in esecuzione, avviare un browser e aprire questa pagina: http://localhost:8080. Questo è il front-end Web dell'applicazione. È possibile aggiungere elementi e fare clic su di essi per votare.
Per rimuovere l'applicazione dal cluster, selezionare il comando Service Fabric: Remove Application (Service Fabric: Rimuovi applicazione) dal riquadro comandi. L'output del processo di disinstallazione viene inviato al terminale integrato. È possibile usare Service Fabric Explorer per verificare che l'applicazione sia stata rimossa dal cluster locale.

Eseguire il debug dell'applicazione

Quando si esegue il debug in Visual Studio Code, l'applicazione deve essere in esecuzione su un cluster locale. È quindi possibile aggiungere punti di interruzione al codice.

Importante

Il debug di applicazioni Java non è supportato nei computer Windows.

Per preparare il pacchetto VotingDataService e l'applicazione Voting per il debug, seguire questa procedura:

Aggiornare il file Voting/VotingApplication/VotingDataServicePkg/Code/entryPoint.sh. Impostare come commento il comando sulla riga 6 usando il simbolo di cancelletto (#) e aggiungere il comando seguente alla fine del file:
```
java -Xdebug -Xrunjdwp:transport=dt_socket,address=8001,server=y,suspend=n -Djava.library.path=$LD_LIBRARY_PATH -jar VotingDataService.jar
```
Aggiornare il file Voting/VotingApplication/ApplicationManifest.xml. Impostare su "1" gli attributi MinReplicaSetSize e TargetReplicaSetSize nell'elemento StatefulService:
```
      <StatefulService MinReplicaSetSize="1" ServiceTypeName="VotingDataServiceType" TargetReplicaSetSize="1">
```
Fare clic sull'icona di debug sulla barra delle attività per aprire la visualizzazione del debugger in Visual Studio Code. Fare clic sull'icona a forma di ingranaggio nella parte superiore della visualizzazione del debugger e selezionare Java dal menu a discesa degli ambienti. Viene aperto il file launch.json.
Nel file launch.json impostare il valore della porta nella configurazione denominata Debug (Attach) su 8001. Salvare il file.
Distribuire l'applicazione nel cluster locale tramite il comando Service Fabric: Deploy Application (Localhost) (Service Fabric: Distribuisci applicazione - Localhost). Verificare se l'applicazione è in esecuzione in Service Fabric Explorer. L'applicazione è ora pronta per il debug.

Per impostare un punto di interruzione, seguire questa procedura:

In Explorer aprire il file /Voting/VotingDataService/src/statefulservice/VotingDataService.java. Impostare un punto di interruzione sulla prima riga di codice nel blocco try del metodo addItem (riga 80).

Importante

Assicurarsi di impostare i punti di interruzione sulle righe eseguibili del codice. Ad esempio, i punti di interruzione impostati su dichiarazioni di metodo, istruzioni try o istruzioni catch non vengono rilevati dal debugger.
Per avviare il debug, scegliere l'icona di debug sulla barra delle attività, selezionare la configurazione Debug (Attach) dal menu del debug e fare clic sul pulsante di esecuzione (freccia verde).
In un Web browser passare a http://localhost:8080. Digitare un nuovo elemento nella casella di testo e fare clic su + Aggiungi. Verrà raggiunto il punto di interruzione. È possibile usare la barra degli strumenti di debug nella parte superiore di Visual Studio Code per procedere al debug, eseguire le istruzioni, entrare nei metodi o uscire dal metodo corrente.
Per terminare la sessione di debug, scegliere l'icona a forma di spina sulla barra degli strumenti di debug nella parte superiore di Visual Studio Code.
Al termine del debug, è possibile usare il comando Service Fabric: Remove Application (Service Fabric: Rimuovi applicazione) per rimuovere l'applicazione Voting dal cluster locale.