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

• Uma conta do Azure com uma assinatura ativa. Crie uma conta gratuitamente.
• Um JDK (Java Development Kit com suporte do Azure), versão 8, 11, 17 ou 21. (No momento, o Java 21 só tem suporte na versão prévia no Linux)
• Um IntelliJ IDEA Ultimate Edition ou Community Edition instalado
• Maven 3.5.0+
• Versão mais recente do Functions Core Tools

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.

   

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).

   

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.

   

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.

   

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.

   

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.

   

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/HttpTriggerFunction.java para ver o código gerado. Ao lado da linha 24, 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.

   

   

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

   

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

   

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.

   

2. Selecione a linha 20 do arquivo src/main/java/org/example/functions/HttpTriggerFunction.java para adicionar um ponto de interrupção. Acesse o ponto de extremidade http://localhost:7071/api/HttpTrigger-Java?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.

   

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.

   

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.

   

   

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.

   

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.

   

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.

   

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.

   

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.

   

   

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.

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:

Adição de uma associação de saída de fila do Armazenamento do Azure