使用vs2019加.net core 对WeiApi的创建过程详解

时间:2021-11-17 06:06:14

vs2019创建webapi

1.创建新的项目

使用vs2019加.net core 对WeiApi的创建过程详解

2.选择.net core的asp .net core web应用程序

使用vs2019加.net core 对WeiApi的创建过程详解

3.定义项目名称和存放地点

使用vs2019加.net core 对WeiApi的创建过程详解

4.选择api创建项目

使用vs2019加.net core 对WeiApi的创建过程详解

5.删除原本的无用的类

使用vs2019加.net core 对WeiApi的创建过程详解

6.添加新的方法类

7.设置路由

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
using microsoft.aspnetcore.components;
using system;
using system.collections.generic;
using system.linq;
using system.threading.tasks;
 
namespace webapi.controllers
{
 
  /// <summary>
  /// 设置路由
  /// </summary>
  [route("api/[controller]/[action]")]
  public class calculation
  {
 
 
  }
}

使用vs2019加.net core 对WeiApi的创建过程详解

8.下面开始写你所需要的接口方法

我们分别创建一个post两个get的方法

方法如下

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
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>
  /// 设置路由
  /// </summary>
  [route("api/[controller]/[action]")]
  [apicontroller]
  public class calculation
  {
 
    /// <summary>
    /// 获取文本
    /// </summary>
    /// <returns></returns>
    [httpget]
    public actionresult<string> get()
    {
      return "hello world!";
    }
    /// <summary>
    /// 两数相加
    /// </summary>
    /// <param name="num1">第一个数</param>
    /// <param name="num2">第二个数</param>
    /// <returns></returns>
    [httpget]
    public actionresult<int> sum(int num1, int num2)
    {
      return num1 + num2;
    }
    /// <summary>
    /// 两数相减
    /// </summary>
    /// <param name="param">参数</param>
    /// <returns></returns>
    [httppost]
    public actionresult<int> subtract(param param)
    {
      int result = param.num1 - param.num2;
      return result;
    }
 
 
  }
 
  /// <summary>
  /// 参数
  /// </summary>
  public class param
  {
    /// <summary>
    /// 第一个数
    /// </summary>
    public int num1 { get; set; }
    /// <summary>
    /// 第二个数
    /// </summary>
    public int num2 { get; set; }
  }
}

9.开始调试

使用vs2019加.net core 对WeiApi的创建过程详解

在调试中修改路径为api/calculation/get

开始运行,结果为

使用vs2019加.net core 对WeiApi的创建过程详解

别的方法自行加参数修改

为了方便对api接口进行管理和调试,我使用了swagger框架。为了更好地可视化运行我的接口

1.为项目添加nuget包    swashbuckle.aspnetcore

使用vs2019加.net core 对WeiApi的创建过程详解

2.在startup的configureservices方法里加入下面的代码,注册swagger生成器,定义一个文档,设置xml文档的注释路径

使用vs2019加.net core 对WeiApi的创建过程详解

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
services.addmvc().setcompatibilityversion(compatibilityversion.version_2_2);
      //配置swagger
      //注册swagger生成器,定义一个swagger 文档
      services.addswaggergen(c =>
      {
        c.swaggerdoc("v1", new openapiinfo
        {
          version = "v1",
          title = "接口文档",
          description = "restful api"
        });
        // 为 swagger 设置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方法里加入下面的代码,启用

中间件服务使用生成swagger和swaggerui

使用vs2019加.net core 对WeiApi的创建过程详解

?
1
2
3
4
5
6
7
8
9
//启用中间件服务生成swagger
      app.useswagger();
      //启用中间件服务生成swagger,指定swagger json终结点
      app.useswaggerui(c =>
      {
        c.swaggerendpoint("/swagger/v1/swagger.json", "web app v1");
        c.routeprefix = string.empty;//设置根节点访问
      });
      app.usemvc();

4.然后右击项目继续选择属性,在生成中选择输出路径

并且勾选xml文档

使用vs2019加.net core 对WeiApi的创建过程详解

5.清空调试的路径

使用vs2019加.net core 对WeiApi的创建过程详解

6.直接启动

使用vs2019加.net core 对WeiApi的创建过程详解

到此这篇关于使用vs2019加.net core 对weiapi的创建过程详解的文章就介绍到这了,更多相关vs2019加.net core 对weiapi的创建内容请搜索服务器之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持服务器之家!

原文链接:https://www.cnblogs.com/BINDAI/archive/2020/07/03/13229145.html