网站防恶意注册,建设银行手机网站首页,做群头像的网站在线制作,wordpress许愿墙文章目录
一、基类#xff1a;ControllerBase二、API 控制器类属性三、使用 Get() 方法提供天气预报结果 在深入探讨如何编写自己的 PizzaController 类之前#xff0c;让我们先看一下 WeatherController 示例中的代码#xff0c;了解它的工作原理。 在本单元中#xff0c…文章目录
一、基类ControllerBase二、API 控制器类属性三、使用 Get() 方法提供天气预报结果 在深入探讨如何编写自己的 PizzaController 类之前让我们先看一下 WeatherController 示例中的代码了解它的工作原理。 在本单元中你将了解 WeatherController 如何在几十行代码中使用 ControllerBase 基类和几个 .NET 属性来生成正常工作的 Web API。 了解这些概念后便可以编写自己的 PizzaController 类了。
以下是整个 WeatherController 类的代码。 如果你还不明白请不要担心。 现在来逐步完成这一过程。
using Microsoft.AspNetCore.Mvc;namespace ContosoPizza.Controllers;[ApiController]
[Route([controller])]
public class WeatherForecastController : ControllerBase
{private static readonly string[] Summaries new[]{Freezing, Bracing, Chilly, Cool, Mild, Warm, Balmy, Hot, Sweltering, Scorching};private readonly ILoggerWeatherForecastController _logger;public WeatherForecastController(ILoggerWeatherForecastController logger){_logger logger;}[HttpGet(Name GetWeatherForecast)]public IEnumerableWeatherForecast Get(){return Enumerable.Range(1, 5).Select(index new WeatherForecast{Date DateTime.Now.AddDays(index),TemperatureC Random.Shared.Next(-20, 55),Summary Summaries[Random.Shared.Next(Summaries.Length)]}).ToArray();}
}一、基类ControllerBase
控制器是一个公共类具有一个或多个称为“操作”的公共方法。 按照惯例控制器放在项目根目录的 Controllers 目录中。 操作通过路由被公开为 HTTP 终结点。 因此对 https://localhost:{PORT}/weatherforecast 的 HTTP GET 请求将执行 WeatherForecastController 类的 Get() 方法。
首先要注意的是此类继承自 ControllerBase 基类。 这个基类提供了许多用于处理 HTTP 请求的标准功能让你可以专注于应用程序的特定业务逻辑。 备注 如果你在 ASP.NET Core 中开发过 Razor Pages 或模型-视图-控制器 (MVC) 体系结构那么你已使用过 Controller 类。 不要通过从 Controller 类派生来创建 Web API 控制器。 Controller 派生自 ControllerBase并添加了对视图的支持因此它用于处理网页而不是 Web API 请求。 二、API 控制器类属性
有两个重要属性应用到了 WeatherForecastController如以下代码所示
[ApiController]
[Route([controller])]
public class WeatherForecastController : ControllerBase[ApiController] 启用固定行为使生成 Web API 更加容易。 一些行为包括参数源推理、将属性路由作为一项要求以及模型验证错误处理增强功能*。
[Route] 定义路由模式 [controller]。 [controller] 令牌替换为用控制器的名称不区分大小写无 Controller 后缀。 此控制器处理对 https://localhost:{PORT}/weatherforecast 的请求。 备注 路由可能包含静态字符串如 api/[controller] 中所示。 在此示例中此控制器将处理对 https://localhost:{PORT}/api/weatherforecast 的请求。 三、使用 Get() 方法提供天气预报结果
WeatherForecastController 包括由 [HttpGet(Name “GetWeatherForecast”)] 属性指定的单个控制器操作。 此属性将 HTTP GET 请求路由到 public IEnumerable Get() 方法。 如你所见在上一个练习中向 https://localhost:{PORT}/weatherforecast 发出请求会导致返回天气预报结果。
本模块的后面部分会介绍其他常见操作与执行 CRUD 操作GET、PUT、POST、DELETE的 Web API 相关联。 但 API 控制器只需要实现一个控制器操作。
在本例中你将获取返回的 WeatherForecast 项的完整列表。 GET 操作还允许通过传递标识符来检索单个项。 在 ASP.NET 中可以使用 [HttpGet(“{id}”)] 特性检索单个项。 在下一练习中将实现该属性。
现在你已了解了 Web API 控制器的基本组件现在可以创建自己的 PizzaController 类了。
