Compartilhar via


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

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

Especificamente, 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.

Pré-requisitos

Instalar o plug-in e entrar

Para instalar o Azure Toolkit for IntelliJ e entrar nele, siga estas etapas:

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

    Plug-in do Azure Toolkit for IntelliJ no Marketplace.

  2. Para entrar em sua conta do Azure, abra a barra lateral Azure Explorer e selecione o ícone Entrada do Azure na barra superior (ou no menu IDEA, selecione Ferramentas > Azure >Entrada do Azure).

    O comando de Entrada do IntelliJ no Azure.

  3. Na janela Entrada no Azure, selecione OAuth 2.0 e clique em Entrar. Para outras opções de entrada, confira as Instruções de entrada do Azure Toolkit for IntelliJ.

    A janela Entrar no Azure com o logon no dispositivo selecionado.

  4. No navegador, entre com sua conta e volte para o IntelliJ. Na caixa de diálogo Selecionar Assinaturas, selecione as assinaturas que deseja usar e selecione Selecionar.

    A caixa de diálogo Selecionar Assinaturas.

Criar seu projeto local

Para usar o Azure Toolkit for IntelliJ para criar um projeto local do Azure Functions, siga estas etapas:

  1. Abra a caixa de diálogo Bem-vindo(a) do IntelliJ IDEA, selecione Novo 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 mostradas. Confirme o local do projeto e selecione Concluir. Intellj IDEA, em seguida, abre seu novo projeto.

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

Executar o projeto localmente

Para executar o projeto localmente, siga estas etapas:

Importante

Você deve ter a variável de ambiente JAVA_HOME definida corretamente para o diretório do JDK que é 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 recente quanto a configuração Java.version.

  1. Navegue até src/main/java/org/example/functions/HttpTriggerJava.java para ver o código gerado. Ao lado da linha 17, você deverá ver um botão Executar verde. Selecione-o e selecione Executar 'Functions-azur...'. Você deverá ver seu aplicativo de funções em execução localmente com alguns logs.

    Projeto de execução local.

    Saída do projeto de execução local.

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

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

  3. O log também é exibido no IDEA. Interrompa o aplicativo de funções selecionando Interromper.

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

Depurar o projeto localmente

Para depurar o projeto localmente, siga estas etapas:

  1. 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. Selecione a linha 20 do arquivo src/main/java/org/example/functions/HttpTriggerJava.java para adicionar um ponto de interrupção. Acesse o ponto de extremidade http://localhost:7071/api/HttpTriggerJava?name=Azure novamente e você deve descobrir que o ponto de interrupção foi atingido. Depois, experimente mais recursos de depuração, como Etapa, Inspeção e Avaliação. Interrompa a sessão de depuração selecionando Parar.

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

Criar o aplicativo de funções no Azure

Use as seguintes etapas para criar um aplicativo de funções e recursos relacionados em sua assinatura do Azure:

  1. No Azure Explorer em seu IDEA, clique com o botão direito do mouse em Aplicativo de funções e selecione Criar.

  2. Selecione Mais configurações e forneça as seguintes informações nos prompts:

    Prompt Seleção
    Assinatura Escolha a assinatura a ser usada.
    Grupo de Recursos Escolha o grupo de recursos para seu aplicativo de funções.
    Nome Especifique o nome de um novo aplicativo de funções. Aqui você pode aceitar os valores padrão.
    Plataforma Selecione Windows-Java 17 ou outra plataforma, conforme apropriado.
    Região Para obter um melhor desempenho, escolha uma região perto de você.
    Opções de hospedagem Escolha as opções de hospedagem para seu aplicativo de funções.
    Plano Escolha o tipo de preço do plano do Serviço de Aplicativo que você deseja usar ou selecione + para criar um novo plano do Serviço de Aplicativo.

    Importante

    Para criar seu aplicativo no plano consumo flex, selecione Consumo Flex. O plano de Consumo Flex está atualmente em versão preliminar.

  3. Selecione OK. Uma notificação é exibida após a criação do aplicativo de funções.

Implantar o projeto no Azure

Para implantar o projeto no Azure, siga estas etapas:

  1. Selecione e expanda o ícone do Azure no Gerenciador de Projetos do IntelliJ e selecione Implantar no Azure –> Implantar no Azure Functions.

    Implantar projeto no Azure.

  2. Você pode selecionar o aplicativo de funções na seção anterior. Para criar um novo, selecione + na linha Função. Digite o nome do aplicativo de funções e escolha a plataforma adequada. Aqui, você pode aceitar o valor padrão. Selecione OK e o novo aplicativo de funções criado é selecionado automaticamente. Selecione Executar para implantar suas funções.

    Criar aplicativo de funções no Azure.

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

Gerenciar aplicativos de funções no IDEA

Para gerenciar seus aplicativos de funções com o Azure Explorer no IDEA, siga estas etapas:

  1. Selecione Aplicativo de Funções para ver todos os aplicativos de funções listados.

    Exibir aplicativos de funções no Explorer.

  2. Selecione um dos aplicativos de funções e clique com o botão direito do mouse e 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ções HttpTrigger-Java e selecione Função Gatilho no Navegador. Você deve 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

Para adicionar mais funções ao 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.

    Adicionar funções à entrada do projeto.

  2. Preencha o nome da classe HttpTest e selecione HttpTrigger no assistente criar classe de função e selecione OK para criar. Dessa forma, você pode criar funções conforme o desejado.

    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

Selecione um dos aplicativos de funções usando o Azure Explorer no IDEA, clique nele 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.

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 a função continuando para o seguinte artigo: