在 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 插件。

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

    “IntelliJ Azure 登录”命令。

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

    “Azure 登录”窗口,其中已选择“设备登录”。

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

    “选择订阅”对话框。

创建本地项目

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

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

    创建函数项目。

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

    创建函数项目完成。

在本地运行项目

若要在本地运行项目,请执行以下步骤:

重要

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

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

    在本地运行的项目。

    在本地运行的项目输出。

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

    在本地运行的函数测试结果。

  3. 日志也会显示在 IDEA 中。 通过选择“停止”来停止函数应用

    在本地运行的函数测试日志。

在本地调试项目

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

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

    在本地调试函数应用按钮。

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

    在本地调试函数应用中断。

在 Azure 中创建函数应用

使用以下步骤在 Azure 订阅中创建函数应用和相关的资源:

  1. 在 IDEA 的 Azure 资源管理器中,右键单击“函数应用”,然后选择“创建”

  2. 选择“更多设置”,并根据提示提供以下信息

    Prompt 选择
    订阅 选择要使用的订阅。
    资源组 选择函数应用的资源组。
    Name 指定新函数应用的名称。 可在此接受默认值。
    平台 根据需要选择“Windows-Java 17”或其他平台
    区域 为了获得更好的性能,请选择你附近的区域
    托管选项 为函数应用选择托管选项。
    计划 选择要使用的应用服务计划定价层,或选择 + 创建新的应用服务计划。

    重要

    若要在弹性消耗计划中创建应用,请选择“弹性消耗”弹性消耗计划目前为预览版。

  3. 选择“确定”。 创建函数应用后,会显示一条通知。

将项目部署到 Azure

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

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

    将项目部署到 Azure。

  2. 可以选择上一部分中的函数应用。 若要创建新函数应用,请选择“函数”行上的 +。 键入函数应用名称并选择适当的平台。 可在此接受默认值。 选择“确定”,将自动选择你创建的新函数应用。 选择“运行”以部署函数。

    在 Azure 中创建函数应用。

    将函数应用部署到 Azure 日志。

通过 IDEA 管理函数应用

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

  1. 选择“函数应用”,可看到列出的所有函数应用

    在资源管理器中查看函数应用。

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

    显示函数应用属性。

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

    屏幕截图显示带有 U R L 的浏览器。

向项目中添加更多函数

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

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

    添加函数到项目项。

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

    屏幕截图显示“创建函数类”对话框。

    添加函数到项目输出。

清理函数

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

屏幕截图显示从上下文菜单中选择的“删除”。

后续步骤

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