asp.net core 中配置swagger

以web Api为例

  1. 引入nuget包
    在这里插入图片描述
    2.在starup内完成依赖注入
 public void ConfigureServices(IServiceCollection services)
        {
            services.AddControllers();
            services.AddSwaggerGen(s =>
            {
                s.SwaggerDoc("V1", new OpenApiInfo()  //这个v1 是给机器看的。
                {
                    Title = "test",       下边的信息是给人看的。
                    Version = "Version--0",
                    Description = "测试Swagger的使用方法"
                } );  ;});

此处OpenApiInfo配置的信息会在swagger文件的相关信息显示
在这里插入图片描述
3.配置中间件管道

     #region 使用Swagger中间件
            app.UseSwagger();
            app.UseSwaggerUI(s =>
            {
                s.SwaggerEndpoint("/swagger/V1/swagger.json", "test1");
                //其中的V1和前边(给机器看的)的相对应;
            });
    #endregion 

此处配置的SwaggerEndpoint的相关信息会出在swagger的相关位置
在这里插入图片描述
4.如何调出swagger界面:
按F5运行后,在显示的界面的本地url后面直接加swagger,点击回车即可。后缀相关部分浏览器会自动填写
例如: http://localhost:5000/swagger/index.html

参考文献:
参考文献
如感觉侵权,联系侵删;

posted @ 2020-06-09 16:58  沧海一声笑rush  阅读(118)  评论(0编辑  收藏  举报