使用vs2019加.net core 對(duì)WeiApi如何創(chuàng)建

本篇內(nèi)容介紹了“使用vs2019加.net core 對(duì)WeiApi如何創(chuàng)建”的有關(guān)知識(shí)，在實(shí)際案例的操作過(guò)程中，不少人都會(huì)遇到這樣的困境，接下來(lái)就讓小編帶領(lǐng)大家學(xué)習(xí)一下如何處理這些情況吧！希望大家仔細(xì)閱讀，能夠?qū)W有所成！

vs2019創(chuàng)建webapi

1.創(chuàng)建新的項(xiàng)目

2.選擇.NET CORE的ASP .NET CORE WEB應(yīng)用程序

3.定義項(xiàng)目名稱(chēng)和存放地點(diǎn)

4.選擇API創(chuàng)建項(xiàng)目

5.刪除原本的無(wú)用的類(lèi)

6.添加新的方法類(lèi)

7.設(shè)置路由

using Microsoft.AspNetCore.Components;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Threading.Tasks;

namespace WEBAPI.Controllers
{

  /// <summary>
  /// 設(shè)置路由
  /// </summary>
  [Route("api/[controller]/[action]")]
  public class Calculation
  {


  }
}

8.下面開(kāi)始寫(xiě)你所需要的接口方法

我們分別創(chuàng)建一個(gè)post兩個(gè)get的方法

方法如下

using System;
using System.Collections.Generic;
using System.Linq;
using System.Threading.Tasks;
using Microsoft.AspNetCore.Mvc;
using Microsoft.Extensions.Logging;

namespace WEBAPI.Controllers
{

  /// <summary>
  /// 設(shè)置路由
  /// </summary>
  [Route("api/[controller]/[action]")]
  [ApiController]
  public class Calculation
  {

    /// <summary>
    /// 獲取文本
    /// </summary>
    /// <returns></returns>
    [HttpGet]
    public ActionResult<string> Get()
    {
      return "Hello World!";
    }
    /// <summary>
    /// 兩數(shù)相加
    /// </summary>
    /// <param name="num1">第一個(gè)數(shù)</param>
    /// <param name="num2">第二個(gè)數(shù)</param>
    /// <returns></returns>
    [HttpGet]
    public ActionResult<int> Sum(int num1, int num2)
    {
      return num1 + num2;
    }
    /// <summary>
    /// 兩數(shù)相減
    /// </summary>
    /// <param name="param">參數(shù)</param>
    /// <returns></returns>
    [HttpPost]
    public ActionResult<int> Subtract(Param param)
    {
      int result = param.num1 - param.num2;
      return result;
    }


  }

  /// <summary>
  /// 參數(shù)
  /// </summary>
  public class Param
  {
    /// <summary>
    /// 第一個(gè)數(shù)
    /// </summary>
    public int num1 { get; set; }
    /// <summary>
    /// 第二個(gè)數(shù)
    /// </summary>
    public int num2 { get; set; }
  }
}

9.開(kāi)始調(diào)試

在調(diào)試中修改路徑為api/Calculation/get

開(kāi)始運(yùn)行,結(jié)果為

別的方法自行加參數(shù)修改

為了方便對(duì)api接口進(jìn)行管理和調(diào)試,我使用了Swagger框架。為了更好地可視化運(yùn)行我的接口

1.為項(xiàng)目添加NuGet包　　　　Swashbuckle.AspNetCore

2.在Startup的ConfigureServices方法里加入下面的代碼，注冊(cè)Swagger生成器，定義一個(gè)文檔，設(shè)置xml文檔的注釋路徑

services.AddMvc().SetCompatibilityVersion(CompatibilityVersion.Version_2_2);
      //配置Swagger
      //注冊(cè)Swagger生成器，定義一個(gè)Swagger 文檔
      services.AddSwaggerGen(c =>
      {
        c.SwaggerDoc("v1", new OpenApiInfo
        {
          Version = "v1",
          Title = "接口文檔",
          Description = "RESTful API"
        });
        // 為 Swagger 設(shè)置xml文檔注釋路徑
        var xmlFile = $"{Assembly.GetExecutingAssembly().GetName().Name}.xml";
        var xmlPath = Path.Combine(AppContext.BaseDirectory, xmlFile);
        c.IncludeXmlComments(xmlPath);
      });
      services.AddMvc(x => x.EnableEndpointRouting = false);

3.在Configure方法里加入下面的代碼，啟用

中間件服務(wù)使用生成Swagger和SwaggerUI

//啟用中間件服務(wù)生成Swagger
      app.UseSwagger();
      //啟用中間件服務(wù)生成Swagger，指定Swagger JSON終結(jié)點(diǎn)
      app.UseSwaggerUI(c =>
      {
        c.SwaggerEndpoint("/swagger/v1/swagger.json", "Web App V1");
        c.RoutePrefix = string.Empty;//設(shè)置根節(jié)點(diǎn)訪問(wèn)
      });
      app.UseMvc();

4.然后右擊項(xiàng)目繼續(xù)選擇屬性,在生成中選擇輸出路徑

并且勾選xml文檔

5.清空調(diào)試的路徑

6.直接啟動(dòng)

“使用vs2019加.net core 對(duì)WeiApi如何創(chuàng)建”的內(nèi)容就介紹到這里了，感謝大家的閱讀。如果想了解更多行業(yè)相關(guān)的知識(shí)可以關(guān)注億速云網(wǎng)站，小編將為大家輸出更多高質(zhì)量的實(shí)用文章！