我的第一个netcore2.2 api项目搭建（二）

上一章快速使用SqlSugar搭建了netcore api项目，我的第一个netcore2.2 api项目搭建（一）

这一章实现目标二：api使用Swagger，实现api文档管理

效果图：第一张收缩，第二张展开，共有2个控制器：values和Account；控制器有注释，api有注释，实体有注释

1.1添加swagger引用

nuget搜索：Swashbuckle.AspNetCore，安装

我的第一个netcore2.2 api项目搭建（二）

1.2在startup中注册swagger

public void ConfigureServices(IServiceCollection services)
        {
            services.AddMvc().SetCompatibilityVersion(CompatibilityVersion.Version_2_2);

            //添加api管理
            // Register the Swagger generator, defining 1 or more Swagger documents
            services.AddSwaggerGen(options =>
            {
                options.SwaggerDoc("v1", new Info
                {
                    //Version = "v1",
                    Title = "MyFirst API",//" API",
                    //Description = "",
                    //TermsOfService = "None",
                    //Contact = new Contact
                    //{
                    //    Name = "",
                    //    Email = string.Empty,
                    //    Url = ""
                    //},
                    //License = new License
                    //{
                    //    Name = "Use under LICX",
                    //    Url = ""
                    //}
                });

                // Set the comments path for the Swagger JSON and UI.
                var xmlFile = $"{Assembly.GetExecutingAssembly().GetName().Name}.xml";
                var xmlPath = Path.Combine(AppContext.BaseDirectory, xmlFile);
                options.IncludeXmlComments(xmlPath, true);
                xmlPath = Path.Combine(AppContext.BaseDirectory, "JH.OPEMR.Model.xml");
                options.IncludeXmlComments(xmlPath, true);
            });
        }

View Code