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/preferencji środowiska IntelliJ IDEA (Ctrl+Alt+S) wybierz pozycję Wtyczki. Następnie znajdź pozycję Azure Toolkit for IntelliJ w witrynie Marketplace i kliknij pozycję Install (Zainstaluj). Po zainstalowaniu kliknij przycisk Uruchom ponownie , aby aktywować wtyczkę.
Aby zalogować się do konta platformy Azure, otwórz pasek boczny eksploratora platformy Azure, a następnie kliknij ikonę Logowanie do platformy Azure na pasku u góry (lub z menu IDEA wybierz pozycję Narzędzia > Zaloguj się do platformy Azure>).
W oknie Logowanie do platformy Azure wybierz pozycję OAuth 2.0, a następnie kliknij 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 kliknij subskrypcje, których chcesz użyć, a następnie kliknij 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 kliknij przycisk Dalej i postępuj zgodnie z kreatorem, aby przejść przez wszystkie konfiguracje na poniższych stronach. Potwierdź lokalizację projektu, a następnie kliknij przycisk Zakończ. Intellj IDEA otworzy 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/HttpTriggerFunction.java , aby zobaczyć wygenerowany kod. Obok wiersza 24 zauważysz, że jest zielony przycisk Uruchom . Kliknij go i wybierz pozycję Uruchom polecenie "Functions-azur...". Zobaczysz, że aplikacja funkcji działa 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/HttpExample?name=Azure.
Dziennik jest również wyświetlany w środowisku IDEA. Zatrzymaj aplikację funkcji, klikając przycisk 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.>
Kliknij wiersz 20 pliku src/main/java/org/example/functions/HttpTriggerFunction.java , aby dodać punkt przerwania. Ponownie uzyskaj dostęp do punktu końcowego
http://localhost:7071/api/HttpTrigger-Java?name=Azurei znajdziesz punkt przerwania. Następnie możesz wypróbować więcej funkcji debugowania, takich jak Krok, Obserwowanie i Ocena. Zatrzymaj sesję debugowania, klikając przycisk Zatrzymaj.
Wdrażanie projektu na platformie Azure
Aby wdrożyć projekt na platformie Azure, wykonaj następujące kroki:
Kliknij 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.
Jeśli nie masz jeszcze żadnej aplikacji funkcji, kliknij + w wierszu funkcji . Wpisz nazwę aplikacji funkcji i wybierz odpowiednią platformę. W tym miejscu możesz zaakceptować wartość domyślną. Kliknij przycisk OK , a nowa utworzona aplikacja funkcji zostanie automatycznie wybrana. Kliknij pozycję Run (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:
Kliknij pozycję Aplikacja funkcji i zobaczysz listę wszystkich aplikacji funkcji.
Kliknij, aby wybrać 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. Zobaczysz, że przeglądarka jest otwierana przy użyciu adresu 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ę Nowy —> Klasa funkcji platformy Azure.
Wypełnij nazwę klasy HttpTest i wybierz pozycję HttpTrigger w kreatorze tworzenia klasy funkcji, a następnie kliknij 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: