练习 - 使用 Visual Studio 在本地创建和测试 Azure 函数

12 分钟

Visual Studio 为创建和测试 Azure 函数应用提供了一个绝佳环境。在将 Azure Functions 部署到云之前，可在本地开发 Azure Functions 并验证其是否正常运行。

在奢侈手表在线网站场景中，函数的要求为：当给定手表的型号时，该函数返回有关手表的详细信息。需要返回的数据包括制造商、表壳背面类型（实心、透明或雕刻）、外圈、表盘样式、表壳表面处理、珠宝数量等信息。

在本练习中，你将使用 Visual Studio 对此函数的一个版本进行本地实现和测试。

注意

在开始本练习之前，请确保已安装 Visual Studio 2022，以及 Web 和云工作负载扩展 ASP.NET 和 Web 开发和Azure 开发。

创建 Azure 函数应用

使用 Azure Functions 模板创建 Azure 函数应用。

启动“Visual Studio 安装程序”并在“Visual Studio 2022”开始页上，选择“修改” 。
请确保选择“ASP.NET 和 Web 开发”以及“Azure 开发”且均可用，（如果不选择“下载时安装”），然后选择“关闭”。
在“Visual Studio 2022”开始页上，选择“启动”。
在“开始”菜单上，选择“新建项目”。随即显示“创建新项目”页。
搜索或滚动到“Azure Functions”模板，然后选择“下一步”。

随即显示“配置新项目”页。输入以下值。

字段	值
项目名称	WatchPortalFunction
位置	通过浏览到文件夹或在本地计算机上创建文件夹，选择要存储项目的位置。
解决方案名称	接受“WatchPortalFunction”（默认）。
将解决方案和项目放在同一目录中	未勾选（未选择）。此设置将确保此模块的文件夹结构正确。

“配置新项目”页面的屏幕截图，其中突出显示了“新建”。

选择“下一页”。
“其他信息”页面出现。

选择以下值。

字段	值
Dotnet 版本	*.NET 6.0（长期支持）
函数触发器	Http 触发器
将 Azurite 用作运行时存储账户 (AzureWebJobsStorage)	选中
启用 Docker	未选中
授权级别	匿名

如果 Visual Studio 通知显示更新已准备就绪，选择“刷新”。

选择“创建” 。

显示 Azure Functions 触发器的屏幕截图，其中突出显示了 HTTP 触发器。

Visual Studio 创建 WatchPortalFunction 项目，并显示代码编辑器窗口中的 Functions 应用源代码文件 Function1.cs。该文件包含名为 Function1 的类的代码。

如下面的示例代码所示，Function1 类包含 HTTP 触发器模板中的样板代码。 Run 方法使用 [FunctionName ("Function1")] 属性进行批注。在上一单元中，我们了解到 Run 方法的样板参数是一个 HttpRequest 对象，其中包含触发函数的请求的详细信息，以及用于记录跟踪信息的跟踪日志条目。

namespace WatchPortalFunction
{
    public static class Function1
    {
        [FunctionName("Function1")]
        public static async Task<IActionResult> Run(
        [HttpTrigger(AuthorizationLevel.Anonymous, "get", "post", Route = null)] HttpRequest req,
        ILogger log)
        {
            log.LogInformation("C# HTTP trigger function processed a request.");

            string name = req.Query["name"];

            string requestBody = await new StreamReader(req.Body).ReadToEndAsync();
            dynamic data = JsonConvert.DeserializeObject(requestBody);
            name = name ?? data?.name;

            return name != null
                ? (ActionResult)new OkObjectResult($"Hello, {name}")
                : new BadRequestObjectResult("Please pass a name on the query string or in the request body");
        }
    }
}

创建 WatchInfo Azure Function

在“视图”菜单中，选择“解决方案资源管理器”。在“解决方案资源管理器”窗口中，右键单击“WatchPortalFunction”Azure Functions 项目，接着在上下文菜单中选择“添加”“新建 Azure 函数”。
在“添加新项 - WatchPortalFunction”窗口中，选择“Azure Functions”。在“名称”字段中，输入“WatchInfo.cs”，然后选择“添加”。
在“新建 Azure 函数 - WatchInfo”窗口中，选择“Http 触发器”。在“授权级别”下拉列表中，选择“匿名”，然后选择“添加”。

Visual Studio 会创建一个新函数，并使用 Run 属性对 [FunctionName("WatchInfo")] 方法进行批注。

在 Run 函数的正文中，删除 log.LogInformation 行后的代码。结果应如下所示。

namespace WatchPortalFunction
{
    public static class WatchInfo
    {
        [FunctionName("WatchInfo")]
        public static async Task<IActionResult> Run(
            [HttpTrigger(AuthorizationLevel.Anonymous, "get", "post", Route = null)] HttpRequest req,
            ILogger log)
        {
            log.LogInformation("C# HTTP trigger function processed a request.");
        }
    }
}

将以下代码插入 Run 行后的 log.LogInformation 方法的正文中。

// Retrieve the model id from the query string
string model = req.Query["model"];

// If the user specified a model id, find the details of the model of watch
if (model != null)
{
    // Use dummy data for this example
    dynamic watchinfo = new { Manufacturer = "abc", CaseType = "Solid", Bezel = "Titanium", Dial = "Roman", CaseFinish = "Silver", Jewels = 15 };

    return (ActionResult)new OkObjectResult($"Watch Details: {watchinfo.Manufacturer}, {watchinfo.CaseType}, {watchinfo.Bezel}, {watchinfo.Dial}, {watchinfo.CaseFinish}, {watchinfo.Jewels}");
}
return new BadRequestObjectResult("Please provide a watch model in the query string");

此代码从 HTTP 请求中的查询字符串中读取 model 参数，并返回该监视模型的详细信息。在此示例代码中，我们创建了无论 watchinfo 值如何都会返回的虚拟 model 数据。此函数返回包含这些详细信息的响应。或者，如果 HTTP 请求不包含查询字符串，该函数将返回错误消息。在实际示例中，你会使用 model 值来查找并返回正确的 watchinfo。

在本地测试 Azure Function

在命令栏上，选择“调试”“开始调试”。

Visual Studio 生成 Azure 函数应用并启动 Azure Functions 运行时。运行时启动时，将打开“输出”窗口以显示消息。运行时准备就绪后，将显示一个 HTTP 函数列表以及可用于触发每个函数的 URL。
打开 Web 浏览器，并输入运行时窗口中显示的 URL 默认 URL 是 http://localhost:7071/api/WatchInfo?model=abc，因此，这就是我们在本练习中所使用的 URL。此请求触发 WatchInfo 函数，并将模型 abc 作为查询字符串参数传递。 Web 浏览器应显示函数生成的虚拟详细信息。
输入 URL http://localhost:7071/api/WatchInfo。此请求不包含查询字符串。触发器返回错误响应，Web 浏览器显示 Please provide a watch model in the query string 消息。
关闭 Web 浏览器，但保持 Azure 函数应用正常运行。
在 Visual Studio 中，在从查询字符串检索模型的代码行上设置断点。
重启 Web 浏览器，然后输入不带查询字符串的 URL http://localhost:7071/api/WatchInfo。

Visual Studio 在暂停执行的断点处突出显示代码。
在 Visual Studio 中，按 F10 跳过断点处的语句。
在“调试器”窗口的“Autos”选项卡中，验证变量是否为。该变量显示此值，因为查询字符串不包含模型参数。
再次按 F10，并验证控件是否跳转到返回 BadRequestObjectResult 对象的语句。
按 F5 继续运行该方法并返回到 Web 浏览器。应显示相同的错误消息。
在 Web 浏览器中，输入带有查询字符串和模型参数的 URL。在调试器中单步调试函数，并验证是否正确检索了模型。应使用参数的值填充 model 变量，并将模型的详细信息作为 OkObjectResult 对象返回。
在菜单栏上，选择“调试”“停止调试”>。

在本练习中，你已了解如何在 Visual Studio 中使用 Azure Functions 工具扩展简化 Azure Function 应用的创建体验，后者可让你使用熟悉的工具来生成和调试代码。

练习 - 使用 Visual Studio 在本地创建和测试 Azure 函数

创建 Azure 函数应用

创建 WatchInfo Azure Function

在本地测试 Azure Function

反馈