Desenvolver aplicativos Java do Microsoft Azure Service Fabric com o Visual Studio Code

2024-10-15

A extensão de Reliable ServicesFabric para Visual Studio Code facilita a criação de aplicativos Java do Microsoft Azure Service Fabric em sistemas operacionais Windows, Linux e macOS.

Este artigo mostra como compilar, implantar e depurar aplicativos do Java do Microsoft Azure Service Fabric usando o Visual Studio Code.

Importante

Aplicativos do Java do Microsoft Service Fabric podem ser desenvolvidos em máquinas Windows, mas podem ser implantados nos clusters do Linux do Azure apenas. Não há suporte para a depuração de aplicativos Java no Windows.

Pré-requisitos

Este artigo pressupõe que você já instalou todas as dependências necessárias para seu ambiente de desenvolvimento, a extensão de serviços confiáveis da extensão Service Fabric Reliable Services e quaisquer dependências necessárias para o seu ambiente de desenvolvimento. Saiba mais, veja Guia de Introdução.

Baixar o exemplo

Este artigo usa o aplicativo de votação no repositório GitHub de amostra de início rápido do aplicativo Java do Microsoft Azure Service Fabric.

Para clonar o repositório em seu computador de desenvolvimento, execute o seguinte comando em uma janela de terminal (janela de comando no Windows):

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

Abra o aplicativo no Visual Studio Code

Abra o VS Code. Clique no ícone do Explorer na Barra de Atividade e clique em Abrir Pasta ou clique em Arquivo -> Abrir pasta. Navegue até o diretório ./service-fabric-java-quickstart/Voting na pasta onde você clonou o repositório, em seguida, clique em Ok. O workspace deve conter os mesmos arquivos mostrados na captura de tela abaixo.

Aplicativo de votação Java no workspace

Compilar o aplicativo

Aperte (Ctrl + Shift + p) para abrir a Paleta de comandos no visual Studio Code.
Pesquise e selecione o Service Fabric: criar comando do Aplicativo. A saída de compilação é enviada para o terminal integrado.

Implantar um aplicativo no cluster local

Após a compilação do aplicativo, você pode implantá-lo no cluster local.

Importante

Não há suporte para a implantação de aplicativos Java para o cluster local nos computadores do Windows.

Da Paleta de Comandos, selecione o Service Fabric: comando implantar o aplicativo (Localhost). A saída do processo de instalação é enviada para o terminal integrado.
Quando a implantação for 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. Isso pode levar algum tempo, portanto seja paciente.
Depois de verificar se o aplicativo está em execução, inicie um navegador e abra esta página: http://localhost:8080. Esta é a web front-end do aplicativo. Você pode adicionar itens e clique para votar.
Para remover o aplicativo do cluster, selecione o comando Service Fabric: Remover Aplicativo 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 que o aplicativo foi removido do cluster local.

Depurar o aplicativo

Ao depurar aplicativos no Visual Studio Code, o aplicativo deve estar executando em um cluster local. Pontos de interrupção, em seguida, podem ser adicionados ao código.

Importante

Não há suporte para a depuração de aplicativos Java nos computadores Windows.

Para preparar o VotingDataService e o aplicativo de votação para depuração, conclua as seguintes etapas:

Atualizar 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 arquivo Voting/VotingApplication/ApplicationManifest.xml. Defina as MinReplicaSetSize e os atributos TargetReplicaSetSize como "1" no elemento StatefulService:
```
      <StatefulService MinReplicaSetSize="1" ServiceTypeName="VotingDataServiceType" TargetReplicaSetSize="1">
```
Clique no ícone de depuração na barra de atividade para abrir o modo de exibição do depurador no Visual Studio Code. Clique no ícone de engrenagem na parte superior do modo de exibição do depurador e selecione Java no menu suspenso de ambiente. Abre o arquivo launch.json.
No arquivo launch.json f, defina o valor da porta na configuração denominada Depurar (anexar) a 8001. Salve o arquivo.
Implantar o aplicativo no cluster local usando o Service Fabric: implantar o comando do aplicativo (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. Definir um ponto de interrupção na primeira linha de código no try bloco no addItem método (linha 80).

Importante

Certifique-se de definir pontos de interrupção nas linhas de código executável. Por exemplo, os pontos de interrupção definidos em declarações de método, try instruções, ou catch instruções não serão detectadas pelo depurador.
Para iniciar a depuração, clique no ícone de depuração na Barra de Atividade, selecione a configuração Depurar (anexar) no menu Depurar e clique no botão Executar (seta verde).
Em um navegador da Web, acesse http://localhost:8080. Digite um novo item na caixa de texto e clique em + Adicionar. Seu ponto de interrupção deve ser atingido. Você pode usar a barra de ferramentas de depuração na parte superior do Visual Studio Code para continuar a execução, depuração parcial linhas, intervir em métodos, ou sair do método atual.
Para encerrar a sessão de depuração, clique no ícone de plug na barra de ferramentas de depuração na parte superior do Visual Studio Code.
Quando você terminar a depuração, você pode usar o Service Fabric: remover o comando do aplicativo para remover o aplicativo de votação do seu cluster local.