使用 Java 和 IntelliJ 创建第一个 Azure 函数Create your first Azure function with Java and IntelliJ

本文介绍:This article shows you:

  • 如何使用 IntelliJ IDEA 创建无服务器函数项目How to create a serverless function project with IntelliJ IDEA
  • 在自己的计算机上的集成开发环境 (IDE) 中测试和调试函数的步骤Steps for testing and debugging the function 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

若要使用 Java 和 IntelliJ 开发函数,请安装以下软件:To develop a function with Java and 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 OK.

    “选择订阅”对话框

创建本地项目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.

    创建 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.

    创建 Functions 项目 - 完成

在本地运行函数应用Run the Function App 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.

    本地运行 Functions 项目

    本地运行函数 - 输出

  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 by clicking the stop button.

    本地运行函数 - 测试日志

在本地调试函数应用Debug the Function App locally

  1. 现在,尝试在本地调试你的函数应用。单击工具栏中的“调试”按钮(如果看不到该按钮,请单击“视图”->“外观”->“工具栏”以启用工具栏)。Now let's try to debug your Function App locally, click the Debug button in the toolbar (if you don't see it, click View -> Appearance -> Toolbar to enable 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 Function App 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 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 - 运行

    将函数部署到 Azure - 日志

在 IDEA 中管理 Azure FunctionsManage Azure Functions from IDEA

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

    在资源管理器中查看函数

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

    显示函数属性

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

    将函数部署到 Azure - 运行

向项目添加更多函数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 资源管理器中删除 Azure 函数Deleting Azure Functions in Azure Explorer

    向项目中添加函数 - 选择触发器

后续步骤Next steps

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