使用 IntelliJ 在 Azure 中建立第一個 Java 函數
本文顯示如何使用 Java 和 IntelliJ 來建立 Azure 函數。
具體而言,本文會顯示:
- 如何在 IntelliJ IDEA 專案中建立已觸發 HTTP 的 Java 函數。
- 在您自己的電腦上對整合式開發環境 (IDE) 中的專案進行測試和偵錯的步驟。
- 將函數專案部署至 Azure Functions 的指示。
必要條件
- 具有有效訂用帳戶的 Azure 帳戶。 免費建立帳戶。
- Azure 支援的 Java 開發工具套件 (JDK) 版本 8、11、17 或 21。 (目前僅 Linux 上的預覽版支援 Java 21)
- 已安裝的 IntelliJ IDEA Ultimate Edition 或 Community Edition
- Maven 3.5.0+
- 最新的函式核心工具
安裝外掛程式並登入
若要安裝 Azure Toolkit for IntelliJ,然後登入,請遵循下列步驟:
在 IntelliJ IDEA 的 [設定/喜好設定] 對話方塊 (Ctrl+Alt+S) 中,選取 [外掛程式]。 然後,在 Marketplace 中尋找適用於 IntelliJ 的 Azure 工具組,然後選取 [安裝]。 安裝之後,選取 [ 重新啟動 ] 以啟動外掛程式。
若要登入您的 Azure 帳戶,請開啟 [Azure 總管] 提要欄位,然後在頂端的列中選取 [Azure 登入] 圖示(或從 [IDEA] 功能選取 [Azure > 登入工具>]。
在 [ Azure 登入 ] 視窗中,選取 [OAuth 2.0],然後選取 [ 登入]。 如需其他登入選項,請參閱 Azure Toolkit for IntelliJ 登入指示。
在瀏覽器中,使用您的帳戶登入,然後返回 IntelliJ。 在 [選取訂用帳戶] 對話框中,選取您想要使用的訂用帳戶,然後選取 [選取]。
建立本機專案
若要使用 Azure Toolkit for IntelliJ 來建立本機 Azure Functions 專案,請遵循下列步驟:
開啟 IntelliJ IDEA 的 [歡迎使用] 對話方塊,並選取 [新增專案] 以開啟新增專案精靈,然後選取 [Azure Functions]。
選取 [Http 觸發程式],然後選取 [下一步 ],並遵循精靈來流覽下列頁面中的所有設定。 確認您的專案位置,然後選取 [ 完成]。 Intellj IDEA 接著會開啟您的新專案。
在本機執行專案
若要在本機執行專案,請遵循下列步驟:
重要
您必須將 JAVA_HOME 環境變數正確設定為使用 Maven 進行程式碼編譯期間所使用的 JDK 目錄。 請確定 JDK 的版本至少要與 Java.version
設定相同。
導覽至 src/main/java/org/example/functions/HttpTriggerFunction.java 以查看所產生的程式碼。 在第 24 行旁邊,您應該會看到綠色 的 [執行] 按鈕。 選取它,然後選取 [ 執行 'Functions-azur...']。 您應該會看到函式應用程式以一些記錄在本機執行。
您可以從瀏覽器存取所顯示的端點 (例如
http://localhost:7071/api/HttpExample?name=Azure
) 來嘗試函數。記錄也會顯示在您的 IDEA 中。 選取 [停止] 以停止函式應用程式。
在本機對專案進行偵錯
若要在本機對專案進行偵錯,請遵循下列步驟:
選取工具列中的 [偵錯] 按鈕。 如果您未看到工具列,則請選擇 [檢視] > [外觀] > [工具列] 予以啟用。
選取 src/main/java/org/example/functions/HttpTriggerFunction.java檔案的第 20 行以新增斷點。 再次存取端點
http://localhost:7071/api/HttpTrigger-Java?name=Azure
,您應該發現已叫用斷點。 然後,您可以嘗試更多偵錯功能,例如 [步驟]、[監看式] 和 [評估]。 選取 [停止] 以停止偵錯會話。
在 Azure 中建立函數應用程式
使用下列步驟,在您的 Azure 訂用帳戶中建立函式應用程式和相關資源:
在IDEA的 Azure Explorer 中,以滑鼠右鍵按兩下 [函式應用程式 ],然後選取 [ 建立]。
選擇 [更多 設定,並在提示字元中提供下列資訊:
提示 選取項目 訂用帳戶 選擇要使用的訂用帳戶。 資源群組 選擇函式應用程式的資源群組。 名稱 指定新函式應用程式的名稱。 在這裡,您可以接受預設值。 平台 視需要選取 [Windows-Java 17 ] 或其他平臺。 區域 若要獲得較佳的效能,請選擇您附近的區域。 裝載選項 選擇函式應用程式的裝載選項。 計劃 選擇您想要使用的 App Service 方案定價層,或選取 + 以建立新的 App Service 方案。 重要
若要在 Flex 取用方案中建立您的應用程式,請選取 [彈性耗用量]。 Flex 使用量方案目前為預覽狀態。
選取 [確定]。 建立函式應用程式之後會顯示通知。
將專案部署至 Azure
若要將專案部署至 Azure,請遵循下列步驟:
選取並展開 IntelliJ 專案總管中的 Azure 圖示,然後選取 [部署至 Azure -> 部署至 Azure Functions]。
您可以從上一節選取函式應用程式。 若要建立新的帳戶,請在 [函式] 行上選取 + 。 輸入函式應用程式名稱,然後選擇適當的平臺。 在這裡,您可以接受預設值。 選取 [ 確定 ],並自動選取您所建立的新函式應用程式。 選取 [ 執行 ] 以部署函式。
從 IDEA 管理函數應用程式
若要在 IDEA 中使用 Azure Explorer 來管理函數應用程式,請遵循下列步驟:
選取 [ 函式應用程式 ] 以查看所有列出的函式應用程式。
選取其中一個函式應用程式,然後按下滑鼠右鍵,然後選取 [ 顯示屬性 ] 以開啟詳細數據頁面。
以滑鼠右鍵按兩下 HttpTrigger-Java 函式應用程式,然後在瀏覽器中選取 [觸發函式]。 您應該會看到瀏覽器是以觸發程式 URL 開啟。
將更多函數新增至專案
若要將更多函數新增至專案,請遵循下列步驟:
以滑鼠右鍵按兩下套件 org.example.functions ,然後選取 [ 新增 -> Azure 函式類別]。
填入類別名稱 HttpTest ,然後選取 [建立函式類別精靈] 中的 [HttpTrigger ],然後選取 [ 確定 ] 以建立。 這樣,您就可以視需要建立新的函數。
清除函數
在 IDEA 中使用 Azure Explorer 選取其中一個函數應用程式,並按一下滑鼠右鍵,然後選取 [刪除]。 此命令可能需要幾分鐘的時間來執行。 完成後,狀態會在 Azure Explorer 中重新整理。
下一步
您已使用 HTTP 觸發的函數建立 Java 專案,並在本機電腦上執行,然後將其部署至 Azure。 現在,請繼續閱讀下列文章來擴充您的函數: