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:
Nella finestra di dialogo Impostazioni/Preferenze di IntelliJ IDEA (CTRL+ALT+S) selezionare Plug-in. Quindi individuare Azure Toolkit for IntelliJ nel Marketplace e fare clic su Installa. Dopo l'installazione, fare clic su Riavvia per attivare il plug-in.
Per accedere all'account Azure, aprire la barra laterale di Azure Explorer e quindi fare clic sull'icona Di accesso di Azure nella barra in alto (o dal menu IDEA selezionare Strumenti > di accesso ad Azure > Azure).
Nella finestra Di accesso di Azure selezionare OAuth 2.0 e quindi fare clic su Accedi. Per altre opzioni di accesso, vedere Le istruzioni di accesso per Azure Toolkit for IntelliJ.
Nel browser accedere con il proprio account e quindi tornare a IntelliJ. Nella finestra di dialogo Seleziona sottoscrizioni fare clic sulle sottoscrizioni da usare e quindi fare clic su Seleziona.
Creare il progetto locale
Per usare Azure Toolkit for IntelliJ per creare un progetto di Funzioni di Azure locale, seguire questa procedura:
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.
Selezionare Trigger HTTP, quindi fare clic su Avanti e seguire la procedura guidata per esaminare tutte le configurazioni nelle pagine seguenti. Confermare il percorso del progetto, quindi fare clic su Fine. Intellj IDEA aprirà 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 .
Passare a src/main/java/org/example/functions/HttpTriggerFunction.java per visualizzare il codice generato. Accanto alla riga 24, si noterà che è presente un pulsante Verde Esegui . Fare clic su di esso e selezionare Esegui 'Functions-azur...'. Si noterà che l'app per le funzioni è in esecuzione in locale con alcuni log.
È possibile provare la funzione accedendo all'endpoint visualizzato dal browser, ad esempio
http://localhost:7071/api/HttpExample?name=Azure.
Il log viene visualizzato anche nell'IDEA. Arrestare l'app per le funzioni facendo clic sul pulsante Arresta .
Eseguire il debug del progetto in locale
Per eseguire il debug del progetto in locale, seguire questa procedura:
Selezionare il pulsante Debug sulla barra degli strumenti. Se la barra degli strumenti non viene visualizzata, abilitarla scegliendo Visualizza>barra degli strumenti aspetto.>
Fare clic sulla 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=Azuree si troverà 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 facendo clic sul pulsante Arresta .
Distribuire il progetto in Azure
Per distribuire il progetto in Azure, seguire questa procedura:
Fare clic ed espandere l'icona di Azure in Esplora progetti IntelliJ, quindi selezionare Distribuisci in Azure -> Distribuisci in Funzioni di Azure.
Se non si dispone ancora di un'app per le funzioni, fare clic + sulla riga Funzione . Digitare il nome dell'app per le funzioni e scegliere la piattaforma appropriata. Qui è possibile accettare il valore predefinito. Fare clic su OK e la nuova app per le funzioni creata verrà selezionata automaticamente. Fare clic su Run (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:
Fare clic su App per le funzioni per visualizzare tutte le app per le funzioni elencate.
Fare clic per 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.
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:
Fare clic con il pulsante destro del mouse sul pacchetto org.example.functions e scegliere Nuovo -> Classe di funzioni di Azure.
Immettere il nome della classe HttpTest e selezionare HttpTrigger nella creazione guidata classe di funzioni, quindi fare clic su 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 verrà 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: