Tworzenie pierwszej funkcji Java na platformie Azure przy użyciu środowiska IntelliJ
W tym artykule pokazano, jak utworzyć funkcję platformy Azure przy użyciu języków Java i IntelliJ.
W szczególności w tym artykule przedstawiono następujące elementy:
- Jak utworzyć funkcję Java wyzwalaną przez protokół HTTP w projekcie IntelliJ IDEA.
- Kroki testowania i debugowania projektu w zintegrowanym środowisku projektowym (IDE) na własnym komputerze.
- Instrukcje dotyczące wdrażania projektu funkcji w usłudze Azure Functions.
Wymagania wstępne
- Konto platformy Azure z aktywną subskrypcją. Utwórz konto bezpłatnie.
- Zestaw Java Development Kit (JDK) pomoc techniczna platformy Azure ed w wersji 8, 11, 17 lub 21. (Język Java 21 jest obecnie obsługiwany tylko w wersji zapoznawczej tylko w systemie Linux)
- Zainstalowane środowisko IntelliJ IDEA w wersji Ultimate Edition lub Community Edition
- Maven 3.5.0+
- Najnowsze narzędzia Function Core Tools
Instalowanie wtyczki i logowania
Aby zainstalować zestaw narzędzi Azure Toolkit for IntelliJ, a następnie się zalogować, wykonaj następujące kroki:
W oknie dialogowym Ustawienia/preferencje środowiska IntelliJ IDEA (Ctrl+Alt+S) wybierz pozycję Wtyczki. Następnie znajdź zestaw narzędzi Azure Toolkit for IntelliJ w witrynie Marketplace i wybierz pozycję Zainstaluj. Po zainstalowaniu wybierz pozycję Uruchom ponownie , aby aktywować wtyczkę.
Aby zalogować się do konta platformy Azure, otwórz pasek boczny eksploratora platformy Azure, a następnie wybierz ikonę Logowanie do platformy Azure na pasku u góry (lub z menu IDEA wybierz pozycję Narzędzia > Logowanie do platformy Azure>).
W oknie Logowanie do platformy Azure wybierz pozycję OAuth 2.0, a następnie wybierz pozycję Zaloguj. Aby uzyskać inne opcje logowania, zobacz Instrukcje logowania dla zestawu narzędzi Azure Toolkit for IntelliJ.
W przeglądarce zaloguj się przy użyciu konta, a następnie wróć do środowiska IntelliJ. W oknie dialogowym Wybieranie subskrypcji wybierz subskrypcje, których chcesz użyć, a następnie wybierz pozycję Wybierz.
Tworzenie projektu lokalnego
Aby utworzyć lokalny projekt usługi Azure Functions za pomocą zestawu narzędzi Azure Toolkit for IntelliJ, wykonaj następujące kroki:
Otwórz okno dialogowe Powitalne środowiska IntelliJ IDEA, wybierz pozycję Nowy projekt, aby otworzyć kreatora nowego projektu, a następnie wybierz pozycję Azure Functions.
Wybierz pozycję Wyzwalacz HTTP, a następnie wybierz pozycję Dalej i postępuj zgodnie z kreatorem, aby przejść przez wszystkie konfiguracje na poniższych stronach. Potwierdź lokalizację projektu, a następnie wybierz pozycję Zakończ. Intellj IDEA otwiera nowy projekt.
Lokalne uruchamianie projektu
Aby uruchomić projekt lokalnie, wykonaj następujące kroki:
Ważne
Zmienna środowiskowa JAVA_HOME musi być poprawnie ustawiona na katalog JDK używany podczas kompilowania kodu przy użyciu narzędzia Maven. Upewnij się, że wersja zestawu JDK jest co najmniej tak wysoka, jak ustawienie Java.version .
Przejdź do pliku src/main/java/org/example/functions/HttpTriggerJava.java , aby zobaczyć wygenerowany kod. Obok wiersza 17 powinien zostać wyświetlony zielony przycisk Uruchom . Wybierz go, a następnie wybierz pozycję Uruchom polecenie "Functions-azur...". Powinna zostać wyświetlona aplikacja funkcji uruchomiona lokalnie z kilkoma dziennikami.
Możesz wypróbować funkcję, korzystając z wyświetlonego punktu końcowego z przeglądarki, na przykład
http://localhost:7071/api/HttpTriggerJava?name=Azure.
Dziennik jest również wyświetlany w środowisku IDEA. Zatrzymaj aplikację funkcji, wybierając pozycję Zatrzymaj.
Lokalne debugowanie projektu
Aby debugować projekt lokalnie, wykonaj następujące kroki:
Wybierz przycisk Debuguj na pasku narzędzi. Jeśli pasek narzędzi nie jest widoczny, włącz go, wybierając pozycję Wyświetl>pasek narzędzi wyglądu.>
Wybierz wiersz 20 pliku src/main/java/org/example/functions/HttpTriggerJava.java , aby dodać punkt przerwania. Ponownie uzyskaj dostęp do punktu końcowego
http://localhost:7071/api/HttpTriggerJava?name=Azurei upewnij się, że punkt przerwania został trafiony. Następnie możesz wypróbować więcej funkcji debugowania, takich jak Krok, Obserwowanie i Ocena. Zatrzymaj sesję debugowania, wybierając pozycję Zatrzymaj.
Tworzenie aplikacji funkcji na platformie Azure
Wykonaj następujące kroki, aby utworzyć aplikację funkcji i powiązane zasoby w ramach subskrypcji platformy Azure:
W eksploratorze platformy Azure w środowisku IDEA kliknij prawym przyciskiem myszy pozycję Aplikacja funkcji, a następnie wybierz polecenie Utwórz.
Wybierz pozycję Więcej ustawień i podaj następujące informacje w monitach:
Monit Wybór Subskrypcja Wybierz subskrypcję, która ma zostać użyta. Grupa zasobów Wybierz grupę zasobów dla aplikacji funkcji. Nazwa/nazwisko Określ nazwę nowej aplikacji funkcji. W tym miejscu możesz zaakceptować wartość domyślną. Platforma Wybierz odpowiednią platformę Windows-Java 17 lub inną platformę. Region Aby uzyskać lepszą wydajność, wybierz region blisko Ciebie. Opcje hostingu Wybierz opcje hostingu dla aplikacji funkcji. Planowanie Wybierz warstwę cenową planu usługi App Service, której chcesz użyć, lub wybierz, + aby utworzyć nowy plan usługi App Service. Wybierz przycisk OK. Po utworzeniu aplikacji funkcji zostanie wyświetlone powiadomienie.
Wdrażanie projektu na platformie Azure
Aby wdrożyć projekt na platformie Azure, wykonaj następujące kroki:
Wybierz i rozwiń ikonę platformy Azure w Eksploratorze projektów IntelliJ, a następnie wybierz pozycję Wdróż na platformie Azure —> Wdróż w usłudze Azure Functions.
Możesz wybrać aplikację funkcji z poprzedniej sekcji. Aby utworzyć nowy, wybierz pozycję + w wierszu Funkcji . Wpisz nazwę aplikacji funkcji i wybierz odpowiednią platformę. W tym miejscu możesz zaakceptować wartość domyślną. Wybierz przycisk OK , a nowa utworzona aplikacja funkcji zostanie automatycznie wybrana. Wybierz pozycję Uruchom , aby wdrożyć funkcje.
Zarządzanie aplikacjami funkcji z poziomu środowiska IDEA
Aby zarządzać aplikacjami funkcji za pomocą programu Azure Explorer w środowisku IDEA, wykonaj następujące kroki:
Wybierz pozycję Aplikacja funkcji, aby wyświetlić listę wszystkich aplikacji funkcji.
Wybierz jedną z aplikacji funkcji, a następnie kliknij prawym przyciskiem myszy i wybierz polecenie Pokaż właściwości , aby otworzyć stronę szczegółów.
Kliknij prawym przyciskiem myszy aplikację funkcji HttpTrigger-Java , a następnie wybierz pozycję Wyzwalaj funkcję w przeglądarce. Powinna zostać wyświetlona przeglądarka z adresem URL wyzwalacza.
Dodawanie kolejnych funkcji do projektu
Aby dodać więcej funkcji do projektu, wykonaj następujące kroki:
Kliknij prawym przyciskiem myszy pakiet org.example.functions i wybierz pozycję Nowa —> Klasa funkcji platformy Azure.
Wypełnij nazwę klasy HttpTest i wybierz pozycję HttpTrigger w kreatorze tworzenia klasy funkcji, a następnie wybierz przycisk OK , aby utworzyć. W ten sposób można tworzyć nowe funkcje zgodnie z potrzebami.
Czyszczenie funkcji
Wybierz jedną z aplikacji funkcji przy użyciu eksploratora platformy Azure w środowisku IDEA, a następnie kliknij prawym przyciskiem myszy i wybierz polecenie Usuń. Uruchomienie tego polecenia może potrwać kilka minut. Po zakończeniu stan zostanie odświeżyny w eksploratorze platformy Azure.
Następne kroki
Utworzono projekt Java z funkcją wyzwalaną przez protokół HTTP, uruchomiono go na komputerze lokalnym i wdrożono go na platformie Azure. Teraz rozszerz funkcję, przechodząc do następującego artykułu: