Crie sua primeira função Java no Azure usando o IntelliJ

Este artigo mostra como usar Java e IntelliJ para criar uma função do Azure.

Especificamente, este artigo mostra:

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

Pré-requisitos

Instale o plugin e inicie sessão

Para instalar o Kit de Ferramentas do Azure para IntelliJ e, em seguida, iniciar sessão, siga estes passos:

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

    Azure Toolkit for IntelliJ plugin in Marketplace.

  2. Para iniciar sessão na sua conta do Azure, abra a barra lateral do Azure Explorer e, em seguida, clique no ícone de Início de Sessão do Azure na barra na parte superior (ou, no menu IDEA, selecione Ferramentas > Azure > Iniciar sessão).

    The IntelliJ Azure Sign In command.

  3. Na janela Entrar do Azure, selecione OAuth 2.0 e clique em Entrar. Para outras opções de entrada, consulte Instruções de entrada para o Kit de Ferramentas do Azure para IntelliJ.

    The Azure Sign In window with device login selected.

  4. No browser, inicie sessão com a sua conta e, em seguida, volte ao IntelliJ. Na caixa de diálogo Selecionar Subscrições, clique nas subscrições que pretende utilizar e, em seguida, clique em Selecionar.

    The Select Subscriptions dialog box.

Criar o seu projeto local

Para usar o Kit de Ferramentas do Azure para IntelliJ para criar um projeto local do Azure Functions, siga estas etapas:

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

    Create function project.

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

    Create function project finish.

Executar localmente o projeto

Para executar o projeto localmente, execute estas etapas:

Importante

Você deve ter a variável de ambiente JAVA_HOME definida corretamente para o diretório JDK usado durante a compilação de código usando o Maven. Certifique-se de que a versão do JDK seja pelo menos tão alta quanto a Java.version configuração.

  1. Navegue até src/main/java/org/example/functions/HttpTriggerFunction.java para ver o código gerado. Ao lado da linha 24, você notará que há um botão verde Executar . Clique nele e selecione Executar 'Functions-azur...'. Você verá que seu aplicativo de função está sendo executado localmente com alguns logs.

    Local run project.

    Local run project output.

  2. Você pode tentar a função acessando o ponto de extremidade exibido do navegador, como http://localhost:7071/api/HttpExample?name=Azure.

    Local run function test result.

  3. O log também é exibido na sua IDEA. Pare o aplicativo de função clicando no botão Parar .

    Local run function test log.

Depurar o projeto localmente

Para depurar o projeto localmente, siga estas etapas:

  1. Selecione o botão Depurar na barra de ferramentas. Se não vir a barra de ferramentas, ative-a escolhendo Ver>Barra de Ferramentas de Aspeto.>

    Local debug function app button.

  2. Clique na linha 20 do arquivo src/main/java/org/example/functions/HttpTriggerFunction.java para adicionar um ponto de interrupção. Acesse o ponto de extremidade novamente e você verá que o ponto http://localhost:7071/api/HttpTrigger-Java?name=Azure de interrupção foi atingido. Em seguida, você pode tentar mais recursos de depuração, como Etapa, Observação e Avaliação. Pare a sessão de depuração clicando no botão Parar .

    Local debug function app break.

Implantar seu projeto no Azure

Para implantar seu projeto no Azure, siga estas etapas:

  1. Clique e expanda o ícone do Azure no IntelliJ Project explorer e, em seguida, selecione Implantar no Azure -> Implantar no Azure Functions.

    Deploy project to Azure.

  2. Se você ainda não tiver nenhum aplicativo de função, clique + na linha Função . Digite o nome do aplicativo da função e escolha a plataforma adequada. Aqui você pode aceitar o valor padrão. Clique em OK e o novo aplicativo de função que você criou será selecionado automaticamente. Clique em Run (Executar) para implementar as funções.

    Create function app in Azure.

    Deploy function app to Azure log.

Gerir aplicações funcionais a partir do IDEA

Para gerenciar seus aplicativos de função com o Azure Explorer em seu IDEA, siga estas etapas:

  1. Clique em Function App e você verá todos os seus aplicativos de função listados.

    View function apps in explorer.

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

    Show function app properties.

  3. Clique com o botão direito do mouse em seu aplicativo de função HttpTrigger-Java e, em seguida, selecione Função de gatilho no navegador. Você verá que o navegador é aberto com o URL de gatilho.

    Screenshot shows a browser with the U R L.

Adicionar mais funções ao projeto

Para adicionar mais funções ao seu projeto, siga estas etapas:

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

    Add functions to the project entry.

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

    Screenshot shows the Create Function Class dialog box.

    Add functions to the project output.

Funções de limpeza

Selecione um dos seus aplicativos de função usando o Azure Explorer em sua IDEA, clique com o botão direito do mouse e selecione Excluir. Esse comando pode levar vários minutos para ser executado. Quando terminar, o status será atualizado no Azure Explorer.

Screenshot shows Delete selected from a context menu.

Próximos passos

Você criou um projeto Java com uma função acionada por HTTP, execute-o em sua máquina local e implante-o no Azure. Agora, estenda sua função continuando para o seguinte artigo:

Adding an Azure Storage queue output binding (Adicionar um enlace de saída da fila de Armazenamento do Azure)