Desenvolver aplicativos Java Service Fabric com o Visual Studio Code

2025-04-04

A extensão Service Fabric Reliable Services para VS Code facilita a criação de aplicativos Java Service Fabric em sistemas operacionais Windows, Linux e macOS.

Este artigo mostra como criar, implantar e depurar um aplicativo Java Service Fabric usando o Visual Studio Code.

Importante

Os aplicativos Java do Service Fabric podem ser desenvolvidos em máquinas Windows, mas podem ser implantados somente em clusters Linux do Azure. A depuração de aplicativos Java não é suportada no Windows.

Pré-requisitos

Este artigo pressupõe que você já tenha instalado o VS Code, a extensão de Serviços Confiáveis do Service Fabric para VS Code e quaisquer dependências necessárias para seu ambiente de desenvolvimento. Para saber mais, consulte Introdução.

Transferir o exemplo

Este artigo usa o aplicativo Voting no repositório GitHub de exemplo de início rápido do aplicativo Java do Service Fabric.

Para clonar o repositório para sua máquina de desenvolvimento, execute o seguinte comando em uma janela do terminal (janela de comando no Windows):

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

Abra o aplicativo no VS Code

Abra o VS Code. Clique no ícone do Explorer na barra de atividades e clique em Abrir pasta ou clique em Arquivo -> Abrir pasta. Navegue até o diretório ./service-fabric-java-quickstart/Voting na pasta onde clonou o repositório e clique em OK. O espaço de trabalho deve conter os mesmos arquivos mostrados na captura de tela abaixo.

Aplicação de votação Java no espaço de trabalho

Criar o aplicativo

Pressione (Ctrl + Shift + p) para abrir a Paleta de comandos no VS Code.
Procure e selecione o comando Service Fabric: Build Application . A saída de construção é enviada para o terminal integrado.

Implantar o aplicativo no cluster local

Depois de criar o aplicativo, você pode implantá-lo no cluster local.

Importante

A implementação de aplicativos Java no cluster local não é suportada em máquinas Windows.

Na Paleta de comandos, selecione o comando Service Fabric: Deploy Application (Localhost). A saída do processo de instalação é enviada para o terminal integrado.
Quando a implantação estiver concluída, inicie um navegador e abra o Service Fabric Explorer: http://localhost:19080/Explorer. Você deve ver que o aplicativo está em execução. Isto pode levar algum tempo, por isso seja paciente.
Depois de verificar se o aplicativo está em execução, inicie um navegador e abra esta página: http://localhost:8080. Este é o front-end web do aplicativo. Você pode adicionar itens e clicar neles para votar.
Para remover o aplicativo do cluster, selecione o comando Service Fabric: Remove Application da Paleta de Comandos. A saída do processo de desinstalação é enviada para o terminal integrado. Você pode usar o Service Fabric Explorer para verificar se o aplicativo foi removido do cluster local.

Depurar o aplicativo

Ao depurar aplicações no VS Code, a aplicação deve estar a ser executada num cluster local. Os pontos de interrupção podem então ser adicionados ao código.

Importante

A depuração de aplicativos Java não é suportada em máquinas Windows.

Para preparar o VotingDataService e a aplicação de votação para fazer debug, conclua as seguintes etapas:

Atualize o arquivo Voting/VotingApplication/VotingDataServicePkg/Code/entryPoint.sh . Comente o comando na linha 6 (use '#') e adicione o seguinte comando na parte inferior do arquivo:
```
java -Xdebug -Xrunjdwp:transport=dt_socket,address=8001,server=y,suspend=n -Djava.library.path=$LD_LIBRARY_PATH -jar VotingDataService.jar
```
Atualize o ficheiro ApplicationManifest.xmlVoting/VotingApplication/ . Defina os atributos MinReplicaSetSize e TargetReplicaSetSize como "1" no elemento StatefulService :
```
      <StatefulService MinReplicaSetSize="1" ServiceTypeName="VotingDataServiceType" TargetReplicaSetSize="1">
```
Clique no ícone Depurar na barra de atividades para abrir a visualização do depurador no VS Code. Clique no ícone de engrenagem na parte superior da visualização do depurador e selecione Java no menu suspenso do ambiente. O arquivo launch.json é aberto.
No arquivo launch.json, defina o valor da porta na configuração chamada Debug (Attach) como 8001. Salve o arquivo.
Implante o aplicativo no cluster local usando o comando Service Fabric: Deploy Application (Localhost ). Verifique se o aplicativo está em execução no Service Fabric Explorer. Seu aplicativo agora está pronto para ser depurado.

Para definir um ponto de interrupção, conclua as seguintes etapas:

No Explorer, abra o arquivo /Voting/VotingDataService/src/statefulservice/VotingDataService.java . Defina um ponto de interrupção na primeira linha de código do bloco try no método addItem (linha 80).

Importante

Certifique-se de definir pontos de interrupção em linhas executáveis de código. Por exemplo, os pontos de interrupção definidos em declarações de método, try instruções ou catch instruções serão ignorados pelo depurador.
Para começar a depuração, clique no ícone Depurar na Barra de Atividades, selecione a configuração Depurar (Anexar) no menu de depuração e clique no botão Executar (seta verde).
Num navegador, vá para http://localhost:8080. Digite um novo item na caixa de texto e clique em + Adicionar. O seu ponto de interrupção deve ser atingido. Você pode usar a barra de ferramentas Debug na parte superior do VS Code para continuar a execução, passar por linhas, entrar em métodos ou sair do método atual.
Para encerrar a sessão de depuração, clique no ícone de plugue na barra de ferramentas Depurar na parte superior do VS Code.
Quando terminar a depuração, você poderá usar o comando Service Fabric: Remove Application para remover o aplicativo de votação do cluster local.