Erstellen Ihrer ersten Java-Funktion in Azure mit IntelliJ
In diesem Artikel erfahren Sie, wie Sie Java und IntelliJ verwenden, um eine Azure-Funktion zu erstellen.
Insbesondere wird in diesem Artikel Folgendes gezeigt:
- Erstellen einer durch HTTP ausgelösten Java-Funktion in einem IntelliJ IDEA-Projekt.
- Schritte zum Testen und Debuggen des Projekts in der integrierten Entwicklungsumgebung (IDE) auf Ihrem eigenen Computer.
- Anweisungen zum Bereitstellen des Funktionsprojekts in Azure Functions
Voraussetzungen
- Ein Azure-Konto mit einem aktiven Abonnement. Sie können kostenlos ein Konto erstellen.
- Ein von Azure unterstütztes Java Development Kit (JDK), Version 8, 11, 17 oder 21. (Java 21 wird derzeit nur unter Linux in der Vorschau unterstützt)
- Eine installierte Instanz von IntelliJ IDEA (Ultimate Edition oder Community Edition)
- Maven 3.5.0 oder höher
- Aktuelle Version von Function Core Tools
Installieren des Plug-Ins und Anmelden
Führen Sie die folgenden Schritte aus, um das Azure-Toolkit für IntelliJ zu installieren und sich dann anzumelden:
Wählen Sie im Dialogfeld mit den Einstellungen/Voreinstellungen von IntelliJ IDEA (STRG+ALT+S) die Option Plugins (Plug-Ins) aus. Suchen Sie anschließend unter Marketplace nach Azure Toolkit for IntelliJ (Azure-Toolkit für IntelliJ), und klicken Sie auf Install (Installieren). Klicken Sie nach Abschluss der Installation auf Restart (Neu starten), um das Plug-In zu aktivieren.
Öffnen Sie zur Anmeldung beim Azure-Konto die Randleiste Azure Explorer, und klicken Sie dann auf der Leiste oben auf das Symbol für die Azure-Anmeldung (oder wählen Sie im IDEA-Menü Tools > Azure > Azure Sign In (Azure-Anmeldung) aus).
Wählen Sie im Fenster Azure Sign In (Azure-Anmeldung) die Option OAuth 2.0 aus, und klicken Sie dann auf Sign in (Anmelden). Weitere Anmeldeoptionen finden Sie unter Anleitung zur Anmeldung für das Azure-Toolkit für IntelliJ.
Melden Sie sich im Browser mit Ihrem Konto an, und kehren Sie dann zu IntelliJ zurück. Klicken Sie im Dialogfeld Select Subscriptions (Abonnements auswählen) auf die Abonnements, die Sie verwenden möchten, und klicken Sie dann auf Select (Auswählen).
Erstellen Ihres lokalen Projekts
Führen Sie die folgenden Schritte aus, um mithilfe des Azure-Toolkits für IntelliJ ein lokales Azure Functions-Projekt zu erstellen:
Öffnen Sie das Willkommensdialogfeld von IntelliJ IDEA, wählen Sie New Project (Neues Projekt) aus, um den Assistenten zum Erstellen eines neuen Projekts zu öffnen, und wählen Sie dann Azure Functions aus.
Wählen Sie HTTP-Trigger aus, klicken Sie auf Next (Weiter), und gehen Sie im Assistenten alle Konfigurationen auf den nachfolgenden Seiten durch. Bestätigen Sie den Projektspeicherort, und klicken Sie dann auf Finish (Fertig stellen). Ihr neues Projekt wird anschließend in Intellj IDEA geöffnet.
Lokales Ausführen des Projekts
Führen Sie die folgenden Schritte aus, um das Projekt lokal auszuführen:
Wichtig
Sie müssen die Umgebungsvariable JAVA_HOME ordnungsgemäß auf das JDK-Verzeichnis festlegen, das bei der Codekompilierung mit Maven verwendet wird. Stellen Sie sicher, dass die Version des JDK mindestens so hoch ist wie die Java.version-Einstellung.
Navigieren Sie zu src/main/java/org/example/functions/HttpTriggerFunction.java, um den generierten Code anzuzeigen. Neben der Zeile 24 sehen Sie eine grüne Schaltfläche Run (Ausführen). Klicken Sie darauf, und wählen SieRun 'Functions-azur...' ('Functions-azur...' ausführen) aus. Ihre Funktions-App wird lokal mit wenigen Protokollen ausgeführt.
Sie können die Funktion ausprobieren, indem Sie über den Browser (etwa über
http://localhost:7071/api/HttpExample?name=Azure) auf den angezeigten Endpunkt zugreifen.
Das Protokoll wird auch in IDEA angezeigt. Beenden Sie die Funktions-App, indem Sie auf die Schaltfläche Stop (Beenden) klicken.
Lokales Debuggen des Projekts
Führen Sie die folgenden Schritte aus, um das Projekt lokal zu debuggen:
Wählen Sie auf der Symbolleiste die Schaltfläche Debug (Debuggen) aus. Wenn die Symbolleiste nicht angezeigt wird, aktivieren Sie sie, indem Sie Ansicht>Darstellung>Symbolleiste auswählen.
Klicken Sie auf Zeile 20 der Datei src/main/java/org/example/functions/HttpTriggerFunction.java, um einen Breakpoint hinzuzufügen. Greifen Sie erneut auf den Endpunkt
http://localhost:7071/api/HttpTrigger-Java?name=Azurezu, und der Breakpoint wird erreicht. Sie können dann weitere Debugfunktionen wie Step, Watch und Evaluation ausprobieren. Beenden Sie die Debugsitzung, indem Sie auf die Schaltfläche Stop (Beenden) klicken.
Bereitstellen Ihres Projekts in Azure
Führen Sie die folgenden Schritte aus, um Ihr Projekt in Azure bereitzustellen:
Klicken Sie im IntelliJ-Projekt-Explorer auf das Azure-Symbol, und erweitern Sie es, und wählen Sie dann An Azure bereitstellen-> An Azure Functions bereitstellen aus.
Falls Sie noch keine Funktions-App besitzen, klicken Sie in der Zeile Function (Funktion) auf +. Geben Sie den Namen der Funktions-App ein, und wählen Sie eine geeignete Plattform aus. Hier können Sie einfach den Standardwert übernehmen. Klicken Sie auf OK, und die von Ihnen erstellte neue Funktions-App wird automatisch ausgewählt. Klicken Sie zum Bereitstellen der Funktionen auf Ausführen.
Verwalten von Funktions-Apps aus IDEA
Führen Sie die folgenden Schritte aus, um Ihre Funktions-Apps mit Azure Explorer in IDEA zu verwalten:
Klicken Sie auf Function App (Funktions-App), und alle Ihre Funktions-Apps werden aufgelistet.
Klicken Sie zum Auswählen einer Funktions-App, und klicken Sie dann mit der rechten Maustaste darauf. Wählen Sie Show Properties (Eigenschaften anzeigen) aus, um die Detailseite zu öffnen.
Klicken Sie mit der rechten Maustaste auf die Funktions-App HttpTrigger-Java, und wählen Sie dann Trigger Function in Browser (Triggerfunktion im Browser) aus. Sie sehen, dass der Browser mit der Trigger-URL geöffnet wird.
Hinzufügen weiterer Funktionen zum Projekt
Um dem Projekt weitere Funktionen hinzuzufügen, führen Sie die folgenden Schritte aus:
Klicken Sie mit der rechten Maustaste auf das Paket org.example.functions, und wählen Sie Neu > Azure Function Class (Azure-Funktionsklasse) aus.
Geben Sie im Assistenten zum Erstellen von Funktionsklassen den Klassennamen HttpTest ein, und wählen Sie HttpTrigger aus. Klicken Sie zum Erstellen auf OK. Auf diese Weise können Sie nach Bedarf neue Funktionen erstellen.
Bereinigen von Funktionen
Wählen Sie in Azure Explorer in IDEA eine Funktions-App aus, klicken Sie dann mit der rechten Maustaste, und wählen Sie Delete (Löschen) aus. Die Ausführung dieses Befehls kann mehrere Minuten dauern. Wenn er abgeschlossen ist, wird der Status in Azure Explorer aktualisiert.
Nächste Schritte
Sie haben ein Java-Projekt mit einer über HTTP ausgelösten Funktion erstellt, auf Ihrem lokalen Computer ausgeführt und in Azure bereitgestellt. Erweitern Sie nun Ihre Funktion, indem Sie mit dem folgenden Artikel fortfahren: