.netcore简单集成Swagger

简单集成Swagger，这里选择NSwag.其可以生产C#客户端调用代码。

PM> Install-Package NSwag.AspNetCore

 注册Nswag.

 

 public void ConfigureServices(IServiceCollection services)
        {
            services.AddControllers();
            services.AddSwaggerDocument(options =>
            {
                options.Title = "深圳达林.Forestry.Api";
                options.Version ="1.0";
                options.Description = "达林-林业系统API接口";
                options.AllowReferencesWithProperties = true;
            });
            //services.AddOpenApiDocument();
        }

 

添加Nswag 中间件，这样就算简单的集成了。

        public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
        {
            if (env.IsDevelopment())
            {
                app.UseDeveloperExceptionPage();
            }
            app.UseRouting();
            app.UseAuthorization();
            app.UseEndpoints(endpoints =>
            {
                endpoints.MapControllers();
            });
            app.UseOpenApi(); //添加swagger生成api文档（默认路由文档 /swagger/v1/swagger.json）
            app.UseSwaggerUi3();//添加Swagger UI到请求管道中(默认路由: /swagger).
        }

配置项目

 

运行,下篇讲解多版本API的实现。