Criar sua primeira função Java usando o IntelliJ IDEA

Este artigo mostra:

  • Como criar uma função Java disparada por HTTP em um projeto IntelliJ IDEA.
  • Etapas para testar e depurar o projeto no IDE (ambiente de desenvolvimento integrado) em seu próprio computador.
  • Instruções para implantar o projeto de função para o Azure Functions

Se você não tiver uma assinatura do Azure, crie uma conta gratuita antes de começar.

Configurar seu ambiente de desenvolvimento

Para criar e publicar funções Java no Azure usando o IntelliJ, instale o seguinte software:

Instalação e credenciais

  1. Na caixa de diálogo Configurações/Preferências do IntelliJ IDEA (Ctrl+Alt+S), selecione Plug-ins. Em seguida, localize o Azure Toolkit for IntelliJ no Marketplace e clique em Instalar. Depois de instalado, clique em Reiniciar para ativar o plug-in.

    Plug-in do Azure Toolkit for IntelliJ no Marketplace

  2. Para entrar sua conta do Azure, abra a barra lateral Azure Explorer e, em seguida, clique no ícone Entrar no Azure na barra na parte superior (ou no menu IDEA Ferramentas/Azure/Entrada no Azure). O comando de Entrada do IntelliJ no Azure

  3. Na janela Entrar no Azure, selecione Logon do Dispositivo e, em seguida, clique em Entrar (outras opções de entrada).

    A janela Entrar no Azure com o logon no dispositivo selecionado

  4. Clique em Copiar e Abrir na caixa de diálogo Logon no Dispositivo do Azure.

    A janela da caixa de diálogo Logon no Azure

  5. No navegador, cole o código de dispositivo (que foi copiado quando você clicou em Copiar e Abrir na última etapa) e, em seguida, clique em Avançar.

    O navegador de logon do dispositivo

  6. Na caixa de diálogo Selecionar Assinaturas, selecione as assinaturas que deseja usar e, em seguida, clique em Selecionar.

    A caixa de diálogo Selecionar Assinaturas

Criar seu projeto local

Nesta seção, você usará o Azure Toolkit for IntelliJ para criar um projeto local do Azure Functions. Mais adiante neste artigo, você publicará o código de função no Azure.

  1. Abra a caixa de diálogo Bem-vindo do IntelliJ, selecione Criar Projeto para abrir um assistente de Novo projeto e selecione Azure Functions.

    Criar um projeto de função

  2. Selecione Gatilho Http, clique em Avançar e siga o assistente para percorrer todas as configurações nas páginas a seguir, depois, confirme a localização do projeto e clique em Concluir. O Intellj IDEA abrirá o novo projeto.

    Criar uma conclusão do projeto de função

Executar o projeto localmente

  1. Navegue até src/main/java/org/example/functions/HttpTriggerFunction.java para ver o código gerado. Ao lado da linha 17, você observará a presença de um botão Executar verde. Clique nele e selecione Executar 'azure-function-exam...' , você verá que seu aplicativo de funções está sendo executado localmente com alguns logs.

    Projeto de execução local

    Saída do projeto de execução local

  2. Você pode experimentar a função usando o navegador para acessar o ponto de extremidade impresso, como http://localhost:7071/api/HttpTrigger-Java?name=Azure.

    Execução local de resultado do teste de função

  3. O log também é impresso no IDEA. Agora, interrompa o aplicativo da função clicando no botão parar.

    Log de teste de função de execução local

Depurar o projeto localmente

  1. Para depurar o código de função em seu projeto localmente, selecione o botão Depurar na barra de ferramentas. Se você não vir a barra de ferramentas, habilite-a escolhendo Exibir > Aparência > Barra de ferramentas.

    Botão do aplicativo de função de depuração local

  2. Clique na linha 20 do arquivo src/main/java/org/example/functions/HttpTriggerFunction.java para adicionar um ponto de interrupção e acesse o ponto de extremidade http://localhost:7071/api/HttpTrigger-Java?name=Azure novamente. Você verá que o ponto de interrupção foi atingido e poderá tentar mais recursos de depuração, como step, watch e evaluation. Interrompa a sessão de depuração clicando no botão parar.

    Interrupção do aplicativo de função de depuração local

Implantar o projeto no Azure

  1. Clique com o botão direito do mouse no seu projeto no Explorador de Projeto do IntelliJ e selecione Azure -> Implantar no Azure Functions

    Implantar projeto no Azure

  2. Se você ainda não tiver qualquer Aplicativo de Funções, clique + na linha Função. Digite o nome do aplicativo de funções e escolha plataforma adequada, aqui podemos simplesmente aceitar o padrão. Clique em OK e o novo aplicativo de funções que você acabou de criar será selecionado automaticamente. Clique em Executar para implantar as funções.

    Criar aplicativo de função no Azure

    Implantar o aplicativo de funções no log do Azure

Gerenciar aplicativos de funções no IDEA

  1. Você pode gerenciar seus aplicativos de funções com o Azure Explorer. No IDEA, clique em Aplicativo de Funções: você verá todos os aplicativos de funções aqui.

    Exibir aplicativos de funções no Explorer

  2. Clique para selecionar em um dos seus aplicativos de funções e clique com o botão direito do mouse, selecione Mostrar Propriedades para abrir a página de detalhes.

    Mostrar propriedades do aplicativo de funções

  3. Clique com o botão direito do mouse no aplicativo de função HttpTrigger-Java e selecione Disparar Função, você verá que o navegador está aberto com a URL do gatilho.

    Captura de tela mostra um navegador com o U R L.

Adicionar mais funções ao projeto

  1. Clique com o botão direito do mouse no pacote org.example.functions e selecione Nova -> Classe de Função do Azure.

    Adicionar funções à entrada do projeto

  2. Preencha o nome de classe HttpTest, selecione HttpTrigger no assistente para criar classe de função e clique em OK para criar. Dessa forma, você pode criar funções como desejar.

    A captura de tela mostra a caixa de diálogo Criar Classe de Função.

    Adicionar funções à saída do projeto

Limpar funções

  1. Excluir funções no Azure Explorer

    A captura de tela mostra Excluir selecionado em um menu de contexto.

Próximas etapas

Você criou um projeto do Java com uma função disparada por HTTP, executou-o no computador local e implantou-o no Azure. Agora, estenda sua função por meio da...