在 Azure 中使用 IntelliJ 创建你的第一个 Java 函数Create your first Java function in Azure using IntelliJ

本文介绍:This article shows you:

  • 如何在 IntelliJ IDEA 项目中创建 HTTP 触发的 Java 函数。How to create an HTTP-triggered Java function in an IntelliJ IDEA project.
  • 在自己的计算机上的集成开发环境 (IDE) 中测试和调试项目的步骤。Steps for testing and debugging the project in the integrated development environment (IDE) on your own computer.
  • 将函数项目部署到 Azure Functions 的说明Instructions for deploying the function project to Azure Functions

如果没有 Azure 订阅,可在开始前创建一个试用帐户If you don't have an Azure subscription, create a trial account before you begin.

设置开发环境Set up your development environment

若要使用 IntelliJ 创建 Java 函数并将其发布到 Azure,请安装以下软件:To create and publish Java functions to Azure using IntelliJ, install the following software:

安装和登录Installation and sign in

  1. 在 IntelliJ IDEA 的“设置/首选项”对话框中 (Ctrl+Alt+S) 中,选择“插件”。In IntelliJ IDEA's Settings/Preferences dialog (Ctrl+Alt+S), select Plugins. 然后,在“市场”中找到“Azure Toolkit for IntelliJ”并单击“安装”。 Then, find the Azure Toolkit for IntelliJ in the Marketplace and click Install. 安装后,单击“重启”以激活该插件。After installed, click Restart to activate the plugin.

    市场中的 Azure Toolkit for IntelliJ 插件

  2. 若要登录到你的 Azure 帐户,请打开边栏中的“Azure 资源管理器”,然后单击顶部栏中的“Azure 登录”图标(或者在 IDEA 菜单中选择“工具”>“Azure”>“Azure 登录”)。 To sign in to your Azure account, open sidebar Azure Explorer, and then click the Azure Sign In icon in the bar on top (or from IDEA menu Tools/Azure/Azure Sign in). “IntelliJ Azure 登录”命令The IntelliJ Azure Sign In command

  3. 在“Azure 登录”窗口中选择“设备登录”,然后单击“登录”(其他登录选项)。 In the Azure Sign In window, select Device Login, and then click Sign in (other sign in options).

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

  4. 在“Azure 设备登录”对话框中单击“复制并打开”。 Click Copy&Open in Azure Device Login dialog .

    “Azure 登录”对话框窗口

  5. 在浏览器中粘贴设备代码(在最后一个步骤中单击“复制并打开”时已复制),然后单击“下一步”。 In the browser, paste your device code (which has been copied when you click Copy&Open in last step) and then click Next.

    设备登录浏览器

  6. 在“选择订阅”对话框中选择要使用的订阅,然后单击“选择”。 In the Select Subscriptions dialog box, select the subscriptions that you want to use, and then click Select.

    “选择订阅”对话框

创建本地项目Create your local project

本节介绍如何使用 Azure Toolkit for IntelliJ 创建一个本地 Azure Functions 项目。In this section, you use Azure Toolkit for IntelliJ to create a local Azure Functions project. 稍后在本文中,你要将函数代码发布到 Azure。Later in this article, you'll publish your function code to Azure.

  1. 打开“欢迎使用 IntelliJ”对话框,选择“创建新项目”以打开“新建项目”向导,然后选择“Azure Functions”。Open IntelliJ Welcome dialog, select Create New Project to open a new Project wizard, select Azure Functions.

    创建函数项目

  2. 选择“HTTP 触发器”,然后单击“下一步”并按照向导的指示完成以下页面中的所有配置;确认项目位置,然后单击“完成”;然后,Intellj IDEA 将打开新项目。Select Http Trigger, then click Next and follow the wizard to go through all the configurations in the following pages; confirm your project location then click Finish; Intellj IDEA will then open your new project.

    创建函数项目 - 完成

在本地运行项目Run the project locally

  1. 导航到 src/main/java/org/example/functions/HttpTriggerFunction.java,查看生成的代码。Navigate to src/main/java/org/example/functions/HttpTriggerFunction.java to see the code generated. 在第 17 行旁,你可看到一个绿色的“运行”按钮。单击它并选择“运行 azure-function-exam…”,你即可看到函数应用在本地运行,并带有一些日志 。Beside the line 17, you will notice that there is a green Run button, click it and select Run 'azure-function-exam...', you will see that your function app is running locally with a few logs.

    在本地运行的项目

    在本地运行的项目 - 输出

  2. 可通过从浏览器访问打印的终结点(如 http://localhost:7071/api/HttpTrigger-Java?name=Azure)来试用该函数。You can try the function by accessing the printed endpoint from browser, like http://localhost:7071/api/HttpTrigger-Java?name=Azure.

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

  3. 日志还会在 IDEA 中输出。现在,单击“停止”按钮,停止该函数应用。The log is also printed out in your IDEA, now, stop the function app by clicking the stop button.

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

在本地调试项目Debug the project locally

  1. 若要在本地调试项目中的函数代码,请在工具栏中选择“调试”按钮。To debug the function code in your project locally, select the Debug button in the toolbar. 如果未看到工具栏,请通过选择“视图” > “外观” > “工具栏”来启用它。 If you don't see the toolbar, enable it by choosing View > Appearance > Toolbar.

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

  2. 单击文件 src/main/java/org/example/functions/HttpTriggerFunction.java 的第 20 行,添加一个断点,然后再次访问终结点 http://localhost:7071/api/HttpTrigger-Java?name=Azure,你会发现断点已命中。可试用更多调试功能,如“单步执行”、“监视”和“评估” 。Click on line 20 of the file src/main/java/org/example/functions/HttpTriggerFunction.java to add a breakpoint, access the endpoint http://localhost:7071/api/HttpTrigger-Java?name=Azure again , you will find the breakpoint is hit, you can try more debug features like step, watch, evaluation. 单击“停止”按钮,停止调试会话。Stop the debug session by click the stop button.

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

将项目部署到 AzureDeploy your project to Azure

  1. 在 IntelliJ 项目资源管理器中右键单击你的项目,选择“Azure”->“部署到 Azure Functions”Right click your project in IntelliJ Project explorer, select Azure -> Deploy to Azure Functions

    将项目部署到 Azure

  2. 如果你还没有任何函数应用,单击“无可用函数,单击以创建一个新函数”。If you don't have any Function App yet, click No available function, click to create a new one.

    在 Azure 中创建函数应用

  3. 键入函数应用名称并选择适当的订阅/平台/资源组/应用服务计划,你也可在此处创建资源组/应用服务计划。Type in the function app name and choose proper subscription/platform/resource group/App Service plan, you can also create resource group/App Service plan here. 然后,保持应用设置不变,单击“确定”,等待几分钟以创建新函数应用。Then, keep app settings unchanged, click OK and wait some minutes for the new function app to be created. 待“正在创建新的函数应用…”进度条消失。After Creating New Function App... progress bar disappears.

    将函数应用部署到 Azure - 创建应用向导

  4. 选择要部署的函数应用(自动选择你刚刚创建的新函数应用)。Select the function app you want to deploy to, (the new function app you just created will be automatically selected). 单击“运行”以部署函数。Click Run to deploy your functions.

    屏幕截图显示“部署 Azure Functions”对话框。

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

通过 IDEA 管理函数应用Manage function apps from IDEA

  1. 可在 IDEA 中通过“Azure 资源管理器”来管理函数应用。单击“函数应用”,即可在此处看到你的所有函数应用 。You can manage your function apps with Azure Explorer in your IDEA, click on Function App, you will see all your function apps here.

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

  2. 单击以选择函数应用之一,然后右键单击它,选择“显示属性”可打开详细信息页。Click to select on one of your function apps, and right click, select Show Properties to open the detail page.

    显示函数应用属性

  3. 右键单击 HttpTrigger-Java 函数应用,然后选择“触发器函数”,你可看到浏览器打开了触发器 URL。Right click on your HttpTrigger-Java function app, and select Trigger Function, you will see that the browser is opened with the trigger URL.

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

向项目中添加更多函数Add more functions to the project

  1. 右键单击 org.example.functions 包,然后选择“新建”->“Azure 函数类”。Right click on the package org.example.functions and select New -> Azure Function Class.

    向项目添加函数 - 项

  2. 在“创建函数类”向导中填写类名 HttpTest并选择 HttpTrigger,单击“确定”即可创建。采用这种方式,你可根据需要创建新的函数。Fill in the class name HttpTest and select HttpTrigger in the create function class wizard, click OK to create, in this way, you can create new functions as you want.

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

    向项目添加函数 - 输出

清理函数Cleaning up functions

  1. 在 Azure 资源管理器中删除函数Deleting functions in Azure Explorer

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

后续步骤Next steps

你已使用 HTTP 触发的函数创建了一个 Java 项目,在本地计算机上运行了该项目,并将其部署到了 Azure。You've created a Java project with an HTTP triggered function, run it on your local machine, and deployed it to Azure. 现在,通过以下方式扩展函数Now, extend your function by...