ASP.Net.WebAPI和工具PostMan

星河队长 2024-07-08 08:03:01 阅读 77

1.WebAPI概述

1.1 WebAPI

WebAPI 是一种传统的方式,用于构建和暴露 RESTUI风格的Web服务。它提供了丰富的功能和灵活性,可以处理各种HTTP请求,并支持各种数据格式,如JSON、XML等。

WebAPI使用控制器(Controllers)和动作方法(ActionMethods)的概念、通过路由配置将请求映射到相应的方法上。

开发人员可以使用各种属性和过滤器来处理请求、控制访问权限、验证数据等。

1.2 MinimaIAPI

MinimaIAPI 是ASP.NET COre6引入的一种新的轻量级 API开发模型。

它旨在简化 API的创建过程,提供更简洁、更集中的代码结构。

MinimalAP1基于函数式编程模型,通过一个顶级的webAppiication 类来配置路由和请求处理。开发人员可以使用链式调用的方式定义路由、请求处理逻辑和中间件。这种模型更加直观和易于理解,尤其适合构建小型的、单一用途的 WebAPI。

与WebAPI相比,MinimalAPI的主要区别包括:

1.代码量更少:MinimalAPI基于函数式编程模型,代码更加简洁、消除了控制器和动作方法的概念。

2.更少的依赖项:MinimalAPI不需要使用额外的NuGet包,只需使用ASP.NET Core 本身的核心包即可。

3.更直观的路由配置:MinimaAP1使用链式调用的方式定义路由,路由配置更加直观和易于理解。

4.更轻量级的应用:由于代码量少、依赖项少,MinimalAPI应用程序的启动时间更快,内存占用更小。

2.新建WebAPI

Web API项目模板提供了一个入门版控制器:

[ApiConyroller]

[Route(“[controller]”)]

public class WeatherForecastController : ControllerBase

Web API控制器通常应派生自 ControllerBase 而不是 Controler。Controller派生自ControlerBase,并添加对视图的支持,因此它用于处理 Web页面,而不是WebAPI请求。如果同一控制器必须支持视图和 Web API,则派生自Controller.

在这里插入图片描述

可以勾选https或不勾选

在这里插入图片描述

在这里插入图片描述

在program.cs中自带举例代码如下

<code>using Microsoft.AspNetCore.Builder;

using Microsoft.AspNetCore.Mvc;

var builder = WebApplication.CreateBuilder(args);

// Add services to the container.

var app = builder.Build();

// Configure the HTTP request pipeline.

var summaries = new[]

{

"Freezing", "Bracing", "Chilly", "Cool", "Mild", "Warm", "Balmy", "Hot", "Sweltering", "Scorching"

};

app.MapGet("/weatherforecast", () =>

{

var forecast = Enumerable.Range(1, 5).Select(index =>

new WeatherForecast

(

DateTime.Now.AddDays(index),

Random.Shared.Next(-20, 55),

summaries[Random.Shared.Next(summaries.Length)]

))

.ToArray();

return forecast;

});

app.Run();

internal record WeatherForecast(DateTime Date, int TemperatureC, string? Summary)

{

public int TemperatureF => 32 + (int)(TemperatureC / 0.5556);

}

运行程序默认打开浏览器显示数据如下

在这里插入图片描述

同样的在上述文件中添加get和post方法如下

<code>app.MapGet("/api/user/login", () =>

{

return "hello api";

});

app.MapPost("/api/user/loginPost", ([FromForm] string username, [FromForm] string password) =>

{

return "hello api" + username + "-" + password;

});

点击运行,使用PostMan软件测试如下:

在这里插入图片描述

工具Postman软件介绍

Postman是一款API测试和开发环境的软件,旨在简化API开发过程、测试和文档编制。以下是关于Postman的详细介绍和使用方法:

一、Postman软件介绍

功能概述:Postman提供了一套功能强大的工具,帮助开发人员更轻松地构建、测试和调试Web服务。它可以发送任何类型的HTTP请求(GET, HEAD, POST, PUT等),附带任何数量的参数和headers。无论是开发人员进行接口调试,还是测试人员做接口测试,Postman都是首选工具之一。

开发者背景:Postman由Abhinav Asthana等人创建,现已成为世界领先的API平台。它简化了API生命周期的每个步骤,并简化了协作,使开发人员能够更快地创建更好的API。

二、Postman使用方法

安装Postman:

访问Postman官方网站(https://www.getpostman.com/),下载最新版本。

根据自己电脑的系统选择对应的版本进行下载。

双击下载的安装包,进入安装界面,按照提示完成安装。个人使用可以选择跳过登录和注册,直接进入主界面。

界面介绍:

顶部菜单:包含文件、编辑、视图和帮助等常用功能。

Home:显示个人主页,包括提醒、工作区等信息。

Workspace:工作区域,可以创建和管理不同的项目。

Explorer:查看关于Postman的公共API、团队、工作区和集合。

其他功能:如搜索、邀请成员、设置、通知、账户管理和升级等。

发送请求:

点击界面左上角的“+”号,打开一个新的请求页。

在请求的URL中输入要发送请求的URL地址。

选择请求方法(GET、POST等),并填写必要的请求参数和headers。

点击“Send”按钮发送请求,查看响应结果。

集合与环境:

集合(Collections):一组API的集合,相当于是一个综合的板块。可以在集合下创建包和各种请求。

环境(Environments):管理API执行环境的地方,有全局变量和环境变量应对一些请求不断变化。可以创建不同的环境(如开发环境、测试环境等),并在不同环境中切换。

响应结果比较与测试用例:

Postman提供响应结果的比较功能,可以用来写测试用例。可以保存请求和响应结果作为测试用例,并在后续测试中比较实际响应与预期响应是否一致。

其他高级功能:

Mock Servers:设置Mock服务器的地方,主要用于联调测试,不拖慢测试的进度。

Monitors:定期运行集合以检查其性能和响应情况。

Flows:通过拖放UI连接一系列请求从而创建API工作流。

总之,Postman是一款功能强大的API测试和开发环境软件,通过简单直观的界面和丰富的功能支持开发人员更高效地构建、测试和调试Web服务。



声明

本文内容仅代表作者观点,或转载于其他网站,本站不以此文作为商业用途
如有涉及侵权,请联系本站进行删除
转载本站原创文章,请注明来源及作者。