如果項(xiàng)目采取前后端分離的模式進(jìn)行開發(fā)，那么我們的WebAPI最終是需要提供給前端頁面來進(jìn)行調(diào)用的。

那么在進(jìn)行對(duì)接之前必須要保證我們的WebAPI沒有Bug，在這種情況下作為開發(fā)者對(duì)API的自行測試就顯得尤為重要。

WebAPI的測試推薦兩種方式進(jìn)行：

• （1）使用PostMan測試WebAPI；
• （2）在WebAPI中集成Swagger；

一、利用PostMan測試WebAPI

PostMan的安裝和基本使用：

1.官方下載地址：https://www.postman.com/downloads/

2.啟動(dòng)后可以跳過輸入賬號(hào)步驟

3.點(diǎn)擊+號(hào)或者“新建請(qǐng)求”來創(chuàng)建一個(gè)新的請(qǐng)求

4.PostMan的工作界面

（1）測試Get接口

實(shí)體類：

public class Student
{
    public string StuNo { get; set; }    //學(xué)號(hào)
    public string StuName { get; set; }  //姓名
    public string StuSex { get; set; }   //性別
    public Student(string no, string name, string sex)
    {
   		this.StuNo = no;    this.StuName = name;    this.StuSex = sex;
    }
}

API接口：

public List<Student> Get()
{
    List<Student> list = new List<Student>();
    list.Add(new Student("001", "孫悟空", "男"));
    list.Add(new Student("002", "豬八戒", "男"));
    list.Add(new Student("003", "白骨精", "女"));
    return list;
}

接口測試：

• 【1】輸入API地址；
• 【2】請(qǐng)求方法選擇GET；

（2）測試POST接口

• 【1】輸入API地址；
• 【2】請(qǐng)求方法選擇POST；
• 【3】在Body中輸入請(qǐng)求體中的參數(shù)名和值；

實(shí)體類：

public class Student
{
    public string StuNo { get; set; }    //學(xué)號(hào)
    public string StuName { get; set; }  //姓名
    public string StuSex { get; set; }   //性別
    public Student(string no, string name, string sex)
    {
   		this.StuNo = no;    this.StuName = name;    this.StuSex = sex;
    }
}

API接口：

public IHttpActionResult Post([FromBody] Student stu)
{
    string str = string.Format("Post類型獲取的數(shù)據(jù)(學(xué)號(hào):{0},姓名:{1},性別:{2})", stu.StuNo, stu.StuName, stu.StuSex);
    return Json(new { Msg = str });
}

接口測試：

（3）其它接口測試

常見的接口類型有GET,POST,PUT,DELETE類型，其中PUT類型和DELETE類型的測試在學(xué)習(xí)后面的RESTFul API中可進(jìn)行。

二、在WebAPI中集成Swagger

在使用WebAPI開發(fā)完接口之后，編寫API說明文檔是一件繁瑣的事情，但是有了Swagger，就可以快速地自動(dòng)生成API說明。

Swagger 是一個(gè)規(guī)范和完整的框架，用于可視化地生成、描述、調(diào)用WebAPI文檔。

【1】打開Nuget 包管理軟件，查找 swagger，進(jìn)行Swashbuckle 組件的安裝

【2】開啟項(xiàng)目的XML注釋位置（選中項(xiàng)目，右鍵-->屬性-->生成-->輸出-->XML文檔文件）

【3】在App_Start中中會(huì)自動(dòng)生成SwaggerConfig配置文件，對(duì)此文件進(jìn)行修改。

找到如下代碼，修改版本號(hào)及標(biāo)題：

c.SingleApiVersion("v1", "Chp02-項(xiàng)目測試");

找到如下代碼，將注釋進(jìn)行打開:

//c.IncludeXmlComments(GetXmlCommentsPath());

添加GetXmlCommentsPath()函數(shù)，函數(shù)中的路徑填寫步驟2中設(shè)置的路徑

public static string GetXmlCommentsPath()
{
	return $@"{System.AppDomain.CurrentDomain.BaseDirectory}\bin\WebApplication1.XML";
}

【4】訪問Swagger UI，通過如下地址訪問：

http://localhost:65075/swagger

如果Swagger UI中中文顯示亂碼，則可以選中SwaggerConfig文件，選擇文件-->高級(jí)保存選項(xiàng)，將編碼設(shè)置為UTF-8。

【5】利用Swagger UI進(jìn)行API接口的測試：

到此這篇關(guān)于測試ASP.Net WebAPI項(xiàng)目的文章就介紹到這了。希望對(duì)大家的學(xué)習(xí)有所幫助，也希望大家多多支持腳本之家。

最新評(píng)論