码迷,mamicode.com
首页 > Web开发 > 详细

netcore项目使用swagger开发

时间:2019-09-06 21:16:57      阅读:123      评论:0      收藏:0      [点我收藏+]

标签:接口   支持   res   mic   中间件   http   gen   netcore   一个   

首先我创建一个netcore项目,我使用的工具是vs2019

技术图片

 

 这里需要注意的是,看情况选择是否开启身份验证,一般是没有需求的,这里因为我是测试使用所以需要取消勾兑为https配置,并且我没有启用docker支持,因为这个

项目我只是写接口,所以我创建的是一个webapi项目

点击创建,生成项目

技术图片

 

 因为要使用swagger,所以我们需要安装指定的组件包,现在我们使用nuget安装组件

技术图片

 

 安装后我们需要去startup中进行配置

首先我们在ConfigureServices中尽心注册swagger服务

//注册swagger服务
services.AddSwaggerGen(c =>
{
// 添加文档信息
c.SwaggerDoc("v1", new Info { Title = "CoreWebApi", Version = "v1" });
});

然后我们在Configure中启用swagger中间件

// 启用Swagger中间件
app.UseSwagger();

// 配置SwaggerUI
app.UseSwaggerUI(c =>
{
c.SwaggerEndpoint("/swagger/v1/swagger.json", "CoreWebApi");
c.RoutePrefix = string.Empty;
});

接着配置的xml文件

技术图片

 

 

接着我们运行我们的项目

技术图片

 

 已经看到我们已经出现了swagger的界面,那么我们尝试一下调用

技术图片

 

 忽然发现我们这个上面并没有每个接口的备注,这是咋回事那?看来我们还需要配置一些东西

技术图片

 

 我们接着去ConfigureServices中配置

技术图片

 

 再次运行项目查看

技术图片

 

 如我们所愿,备注都已经出来了

 

 

 

 

 

 

 

 

 

 

 

 

 

 

netcore项目使用swagger开发

标签:接口   支持   res   mic   中间件   http   gen   netcore   一个   

原文地址:https://www.cnblogs.com/ITzhangyunpeng/p/11478277.html

(0)
(0)
   
举报
评论 一句话评论(0
登录后才能评论!
© 2014 mamicode.com 版权所有  联系我们:gaon5@hotmail.com
迷上了代码!