首页 > Web开发 > 详细

ASP.NET CORE 3.1 项目实战一

时间:2020-08-30 14:57:39      阅读:352      评论:0      收藏:0      [点我收藏+]

一:使用swagger基本使用后台API

使用NuGet 包管理器下载Swashbuckle.AspNetCore

在Startup类的ConfigureServices方法里面注入服务:

 public void ConfigureServices(IServiceCollection services)
   {
       services.AddSwaggerGen(m =>
        {
          m.SwaggerDoc("v1", new OpenApiInfo { Title = "Web API", Version = "v1" });
        });
        services.AddControllers();
   }

在Startup类的Configure方法里面添加Swagger有关的中间件:

     public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
        {
            if (env.IsDevelopment())
            {
                app.UseDeveloperExceptionPage();
            }

            app.UseHttpsRedirection();

            app.UseRouting();

            app.UseAuthorization();

            // 添加Swagger有关中间件
            app.UseSwagger();
            app.UseSwaggerUI(m => 
            { 
                m.SwaggerEndpoint("/swagger/v1/swagger.json", "Web API"); 
            });

            app.UseEndpoints(endpoints =>
            {
                endpoints.MapControllers();
            });
        }

默认启用swagger ui页面,需要修改launchSettings.json中的profileslaunchUrl:"swagger/index.html"

技术分享图片

 

 如果需要方法的注释和方法参数的注释,需要对接口做XML注释:

 安装Microsoft.Extensions.PlatformAbstractions

 修改ConfigureServices方法,增加下面的方法:

    public void ConfigureServices(IServiceCollection services)
        {
            // 添加Swagger
            services.AddSwaggerGen(m =>
            {
                m.SwaggerDoc("v1", new OpenApiInfo { Title = "Web API", Version = "v1" });
                // 获取xml文件名
                var xmlFile = $"{Assembly.GetExecutingAssembly().GetName().Name}.xml";
                // 获取xml文件路径
                var xmlPath = Path.Combine(AppContext.BaseDirectory, xmlFile);
                // 添加控制器层注释,true表示显示控制器注释
                m.IncludeXmlComments(xmlPath, true);
            });

            services.AddControllers();
        }

项目右键,选择属性,勾选“XML文档文件”,如下图所示:

技术分享图片

 

ASP.NET CORE 3.1 项目实战一

原文:https://www.cnblogs.com/smileZeng/p/13585054.html

(0)
(0)
   
举报
评论 一句话评论(0
关于我们 - 联系我们 - 留言反馈 - 联系我们:wmxa8@hotmail.com
© 2014 bubuko.com 版权所有
打开技术之扣,分享程序人生!