在 Azure 中使用 IntelliJ 创建你的第一个 Java 函数

  • 项目

本文介绍如何使用 Java 和 IntelliJ 创建 Azure 函数。

具体而言，本文介绍了以下内容：

  • 如何在 IntelliJ IDEA 项目中创建 HTTP 触发的 Java 函数。
  • 在自己的计算机上的集成开发环境 (IDE) 中测试和调试项目的步骤。
  • 将函数项目部署到 Azure Functions 的说明。

必备条件

安装插件并登录

若要安装 Azure Toolkit for IntelliJ 并登录，请执行以下步骤：

  1. 在 IntelliJ IDEA 的“设置/首选项”对话框中 (Ctrl+Alt+S) 中，选择“插件”。 然后，在“市场”中找到“Azure Toolkit for IntelliJ”并单击“安装”。 安装后，单击“重启”以激活该插件。

    Azure Toolkit for IntelliJ plugin in Marketplace.

  2. 若要登录到你的 Azure 帐户，请打开边栏中的“Azure 资源管理器”，然后单击顶部栏中的“Azure 登录”图标（或者在 IDEA 菜单中选择“工具”>“Azure”>“Azure 登录”）。

    The IntelliJ Azure Sign In command.

  3. 在“Azure 登录”窗口中选择“OAuth 2.0”，然后单击“登录” 有关其他登录选项，请参阅 Azure Toolkit for IntelliJ 的登录说明。

    The Azure Sign In window with device login selected.

  4. 在浏览器中，使用帐户登录，然后返回到 IntelliJ。 在“选择订阅”对话框中，单击要使用的订阅，然后单击“选择”。

    The Select Subscriptions dialog box.

创建本地项目

要使用 Azure Toolkit for IntelliJ 创建一个本地 Azure Functions 项目，请遵循以下步骤：

  1. 打开 IntelliJ IDEA 的“欢迎使用”对话框，选择“新建项目”以打开新建项目向导，然后选择“Azure Functions”。

    Create function project.

  2. 选择“HTTP 触发器”，然后单击“下一步”并按照向导的指示完成以下页面中的所有配置。 确认项目位置，然后单击“完成”。 随后，Intellj IDEA 将打开新项目。

    Create function project finish.

在本地运行项目

若要在本地运行项目，请执行以下步骤：

重要

必须将 JAVA_HOME 环境变量正确设置为在使用 Maven 编译代码期间使用的 JDK 目录。 确保 JDK 的版本至少与 Java.version 设置一样高。

  1. 导航到 src/main/java/org/example/functions/HttpTriggerFunction.java，查看生成的代码。 在第 24 行旁边，可以看见一个绿色的“运行”按钮。 单击按钮并选择“运行 'Functions-azur…'”。 你将看到函数应用在本地运行，其中包含一些日志。

    Local run project.

    Local run project output.

  2. 可通过从浏览器（如 http://localhost:7071/api/HttpExample?name=Azure）访问显示的终结点来试用该函数。

    Local run function test result.

  3. 日志也会显示在 IDEA 中。 单击“停止”按钮可停止函数应用。

    Local run function test log.

在本地调试项目

若要在本地调试项目，请执行以下步骤：

  1. 选择工具栏中的“调试”按钮。 如果未看到工具栏，请通过选择“视图”>“外观”>“工具栏”来启用它。

    Local debug function app button.

  2. 单击文件“src/main/java/org/example/functions/HttpTriggerFunction.java”的第“20”行以添加断点。 再次访问终结点 http://localhost:7071/api/HttpTrigger-Java?name=Azure，可以发现断点已命中。 接下来，可以尝试更多调试功能，例如“单步执行”、“监视”和“计算”。 单击“停止”按钮，可停止调试会话。

    Local debug function app break.

将项目部署到 Azure

若要将项目部署到 Azure，请执行以下步骤：

  1. 在 IntelliJ 项目资源管理器中单击并展开 Azure 图标，然后选择“部署到 Azure -> 部署到 Azure Functions”。

    Deploy project to Azure.

  2. 如果你还没有任何函数应用，请单击“函数”行中的 +。 键入函数应用名称并选择适当的平台。 可在此接受默认值。 单击“确定”，将自动选择你创建的新函数应用。 单击“运行”以部署函数。

    Create function app in Azure.

    Deploy function app to Azure log.

通过 IDEA 管理函数应用

若要在 IDEA 中使用“Azure 资源管理器”管理函数应用，请执行以下步骤：

  1. 单击“函数应用”，可看到列出的所有函数应用。

    View function apps in explorer.

  2. 单击以选择任一函数应用，然后右键单击并选择“显示属性”，以打开详细信息页。

    Show function app properties.

  3. 右键单击“HttpTrigger-Java”函数应用，然后选择“在浏览器中的触发器函数”。 可以看到使用触发器 URL 打开浏览器。

    Screenshot shows a browser with the U R L.

向项目中添加更多函数

若要向项目添加更多函数，请执行以下步骤：

  1. 右键单击 org.example.functions 包，然后选择“新建”->“Azure 函数类”。

    Add functions to the project entry.

  2. 在“创建函数类”向导中填写类名 HttpTest 并选择 HttpTrigger，然后单击“确定”即可创建。 采用这种方式，你可根据需要创建新的函数。

    Screenshot shows the Create Function Class dialog box.

    Add functions to the project output.

清理函数

在 IDEA 中使用“Azure 资源管理器”选择任一函数应用，然后右键单击并选择“删除”。 此命令可能需要几分钟才能运行。 完成后，状态将在“Azure 资源管理器”中刷新。

Screenshot shows Delete selected from a context menu.

后续步骤

你已使用 HTTP 触发的函数创建了一个 Java 项目，在本地计算机上运行了该项目，并将其部署到了 Azure。 现在，请继续学习以下文章来扩展函数：

添加 Azure 存储队列输出绑定