Creare la prima funzione Java in Azure con IntelliJ

Questo articolo illustra come usare Java e IntelliJ per creare una funzione di Azure.

In particolare, questo articolo illustra quanto segue:

• Come creare una funzione Java attivata da HTTP in un progetto IntelliJ IDEA.
• Passaggi per il test e il debug del progetto nell'ambiente di sviluppo integrato (IDE) nel proprio computer.
• Istruzioni per la distribuzione del progetto di funzione in Funzioni di Azure.

Prerequisiti

• Un account Azure con una sottoscrizione attiva. Creare un account gratuitamente.
• Java Development Kit (JDK) supporto tecnico di Azure ed, versione 8, 11, 17 o 21. Java 21 è attualmente supportato solo in anteprima solo in Linux.
• IntelliJ IDEA Ultimate Edition o Community Edition installato
• Maven 3.5.0+
• Ultima versione di Function Core Tools

Installare il plug-in e accedere

Per installare Azure Toolkit for IntelliJ e quindi eseguire l'accesso, seguire questa procedura:

1. Nella finestra di dialogo Impostazioni/Preferenze di IntelliJ IDEA (CTRL+ALT+S) selezionare Plug-in. Individuare quindi Azure Toolkit for IntelliJ nel Marketplace e selezionare Installa. Dopo l'installazione, selezionare Riavvia per attivare il plug-in.

   

2. Per accedere all'account Azure, aprire la barra laterale di Azure Explorer e quindi selezionare l'icona Di accesso di Azure nella barra in alto (o nel menu IDEA selezionare Strumenti > di accesso ad Azure > Azure).

   

3. Nella finestra Accesso di Azure selezionare OAuth 2.0 e quindi selezionare Accedi. Per altre opzioni di accesso, vedere Le istruzioni di accesso per Azure Toolkit for IntelliJ.

   

4. Nel browser accedere con il proprio account e quindi tornare a IntelliJ. Nella finestra di dialogo Seleziona sottoscrizioni selezionare le sottoscrizioni da usare e quindi selezionare Seleziona.

   

Creare il progetto locale

Per usare Azure Toolkit for IntelliJ per creare un progetto di Funzioni di Azure locale, seguire questa procedura:

1. Aprire la finestra di dialogo Benvenuto di IntelliJ IDEA, selezionare Nuovo progetto per aprire una nuova procedura guidata di progetto, quindi selezionare Funzioni di Azure.

   

2. Selezionare Trigger HTTP, quindi selezionare Avanti e seguire la procedura guidata per esaminare tutte le configurazioni nelle pagine seguenti. Confermare il percorso del progetto e quindi selezionare Fine. Intellj IDEA apre quindi il nuovo progetto.

   

Eseguire il progetto in locale

Per eseguire il progetto in locale, seguire questa procedura:

Importante

È necessario che la variabile di ambiente JAVA_HOME sia impostata correttamente sulla directory JDK usata durante la compilazione del codice tramite Maven. Assicurarsi che la versione di JDK sia almeno elevata dell'impostazione Java.version .

1. Passare a src/main/java/org/example/functions/HttpTriggerFunction.java per visualizzare il codice generato. Accanto alla riga 24, dovrebbe essere visualizzato un pulsante Verde Esegui . Selezionarlo e quindi selezionare Esegui 'Functions-azur...'. Verrà visualizzata l'app per le funzioni in esecuzione in locale con alcuni log.

   

   

2. È possibile provare la funzione accedendo all'endpoint visualizzato dal browser, ad esempio http://localhost:7071/api/HttpExample?name=Azure.

   

3. Il log viene visualizzato anche nell'IDEA. Arrestare l'app per le funzioni selezionando Arresta.

   

Eseguire il debug del progetto in locale

Per eseguire il debug del progetto in locale, seguire questa procedura:

1. Selezionare il pulsante Debug sulla barra degli strumenti. Se la barra degli strumenti non viene visualizzata, abilitarla scegliendo Visualizza>barra degli strumenti aspetto.>

   

2. Selezionare la riga 20 del file src/main/java/org/example/functions/HttpTriggerFunction.java per aggiungere un punto di interruzione. Accedere di nuovo all'endpoint http://localhost:7071/api/HttpTrigger-Java?name=Azure e si noterà che il punto di interruzione viene raggiunto. È quindi possibile provare altre funzionalità di debug, ad esempio Step, Watch e Evaluation. Arrestare la sessione di debug selezionando Arresta.

   

Creare l'app per le funzioni in Azure

Usare la procedura seguente per creare un'app per le funzioni e le risorse correlate nella sottoscrizione di Azure:

1. In Azure Explorer in IDEA fare clic con il pulsante destro del mouse su App per le funzioni e quindi scegliere Crea.

2. Selezionare Altro Impostazioni e specificare le informazioni seguenti alle richieste:

   Richiesta	Selezione
   Abbonamento	scegliere la sottoscrizione da usare.
   Gruppo di risorse	Scegliere il gruppo di risorse per l'app per le funzioni.
   Nome	Specificare il nome per una nuova app per le funzioni. Qui è possibile accettare il valore predefinito.
   Piattaforma	Selezionare Windows-Java 17 o un'altra piattaforma in base alle esigenze.
   Area	per prestazioni ottimali, scegliere un'area vicina.
   Opzioni di hosting	Scegliere le opzioni di hosting per l'app per le funzioni.
   Piano	Scegliere il piano tariffario servizio app che si vuole usare oppure selezionare + per creare un nuovo piano servizio app.

   Importante

   Per creare l'app nel piano a consumo Flex, selezionare Flex Consumption (Consumo flessibile). Il piano A consumo Flex è attualmente in anteprima.

3. Seleziona OK. Una notifica viene visualizzata dopo la creazione dell'app per le funzioni.

Distribuire il progetto in Azure

Per distribuire il progetto in Azure, seguire questa procedura:

1. Selezionare ed espandere l'icona di Azure in Esplora progetti IntelliJ, quindi selezionare Distribuisci in Azure -> Distribuisci in Funzioni di Azure.

   

2. È possibile selezionare l'app per le funzioni nella sezione precedente. Per crearne uno nuovo, selezionare + nella riga Funzione . Digitare il nome dell'app per le funzioni e scegliere la piattaforma appropriata. Qui è possibile accettare il valore predefinito. Selezionare OK e la nuova app per le funzioni creata viene selezionata automaticamente. Selezionare Esegui per distribuire le funzioni.

   

   

Gestire le app per le funzioni da IDEA

Per gestire le app per le funzioni con Azure Explorer in IDEA, seguire questa procedura:

1. Selezionare App per le funzioni per visualizzare tutte le app per le funzioni elencate.

   

2. Selezionare una delle app per le funzioni, quindi fare clic con il pulsante destro del mouse e selezionare Mostra proprietà per aprire la pagina dei dettagli.

   

3. Fare clic con il pulsante destro del mouse sull'app per le funzioni HttpTrigger-Java e quindi scegliere Trigger Function in Browser (Attiva funzione nel browser). Si noterà che il browser viene aperto con l'URL del trigger.

   

Aggiungere altre funzioni al progetto

Per aggiungere altre funzioni al progetto, seguire questa procedura:

1. Fare clic con il pulsante destro del mouse sul pacchetto org.example.functions e scegliere Nuovo -> Classe di funzioni di Azure.

   

2. Immettere il nome della classe HttpTest e selezionare HttpTrigger nella creazione guidata classe di funzioni, quindi selezionare OK per creare. In questo modo, è possibile creare nuove funzioni nel modo desiderato.

   

   

Pulizia delle funzioni

Selezionare una delle app per le funzioni usando Azure Explorer in IDEA, quindi fare clic con il pulsante destro del mouse e scegliere Elimina. L'esecuzione di questo comando potrebbe richiedere diversi minuti. Al termine, lo stato viene aggiornato in Azure Explorer.

Passaggi successivi

È stato creato un progetto Java con una funzione attivata tramite HTTP, eseguirlo nel computer locale e distribuirlo in Azure. Estendere ora la funzione continuando con l'articolo seguente:

Aggiungere un'associazione di output della coda di Archiviazione di Azure