Azure 应用服务中的 API 应用、ASP.NET 和 Swagger 入门_.NET_编程开发_程序员俱乐部

本文是系列教程的第一篇，介绍如何使用 Azure 应用服务中有助于开发和托管 RESTful API 的功能。本教程介绍 Swagger 格式 API 元数据的支持。

学习内容：

• 如何通过 Visual Studio 2015 中的内置工具在 Azure 应用服务中创建和部署 API 应用。
• 如何使用 Swashbuckle NuGet 包动态生成 Swagger API 元数据，以便自动进行 API 发现。
• 如何使用 Swagger API 元数据自动生成 API 应用的客户端代码。

示例应用程序概述

本教程使用简单的待办事项列表示例应用程序。该应用程序包含单页应用程序 (SPA) 前端、ASP.NET Web API 中间层和 ASP.NET Web API 数据层。

下面是 AngularJS 前端的屏幕截图。

Visual Studio 解决方案包含三个项目：

• ToDoListAngular - 前端：用于调用中间层的 AngularJS SPA。

• ToDoListAPI - 中间层：调用数据层，对待办事项执行 CRUD 操作的 ASP.NET Web API 项目。

• ToDoListDataAPI - 数据层：对待办事项执行 CRUD 操作的 ASP.NET Web API 项目。

三层体系结构是可以使用 API 应用实现的多种体系结构之一，此处仅用它来进行演示。每一层中的代码尽可能以最简单的方式来演示 API 应用功能；例如，数据层使用服务器内存而不是数据库作为持久性机制。

完成本教程后，将创建两个在云中应用服务 API 应用中启动并运行的 Web API 项目。

本系列教程的下一篇文章会将 SPA 前端部署到云中。

先决条件

• ASP.NET Web API - 本教程中的说明假设读者基本了解如何在 Visual Studio 中使用 ASP.NET Web API 2。

• Azure 帐户 - 可以打开 Azure 帐户。

• Visual Studio 2015 和用于 .NET 的 Azure SDK - SDK 会自动安装 Visual Studio 2015（如果尚未安装）。

  • 在 Visual Studio 中，单击“帮助”->“关于 Microsoft Visual Studio”，确保安装了“Azure App Service Tools v2.9.1”或更高版本。

 下载示例应用程序及后续操作，感兴趣的朋友可以点击这里继续阅读。