C# ABP WebApi与Swagger UI的集成

本文是配置WebApi与Swagger UI，能够参照 http://www.cnblogs.com/farb/p/ABPSwaggerUIIntegration.html

 

1. 安装swagger nuget包

首先，将Swagger安装到WebApi项目中。咱们安装到WebApi类库中，包为 Install-Package Swashbuckle.Core，以下：

 

2. 配置 WebApiModule

咱们打开WebApi类库下面的WebApiModule类，由于咱们的项目叫MyThirdABP，因此类叫MyThirdABPWebApiModule。

首先，在类里面加入方法：

        public override void PreInitialize()
        {
            Configuration.Modules.AbpWeb().AntiForgery.IsEnabled = false;
            base.PreInitialize();
        }

        private void ConfigureSwaggerUi()
        {
            Configuration.Modules.AbpWebApi().HttpConfiguration
            .EnableSwagger(c =>
            {
                c.SingleApiVersion("v1", "SwaggerIntegrationDemo.WebApi");
                c.ResolveConflictingActions(apiDescriptions => apiDescriptions.First());
                //将application层中的注释添加到SwaggerUI中
                var baseDirectory = AppDomain.CurrentDomain.BaseDirectory;

                var commentsFileName = "bin\\MyThirdABP.Web.XML";
                var commentsFile = Path.Combine(baseDirectory, commentsFileName);
                //将注释的XML文档添加到SwaggerUI中
                c.IncludeXmlComments(commentsFile);
            })
            .EnableSwaggerUi();
        }

而后，在Initialize方法中，调用ConfigureSwaggerUi的方法。

        public override void Initialize()
        {
            IocManager.RegisterAssemblyByConvention(Assembly.GetExecutingAssembly());

            Configuration.Modules.AbpWebApi().DynamicApiControllerBuilder
                .ForAll<IApplicationService>(typeof(MyThirdABPApplicationModule).Assembly, "app")
                .Build();
            ConfigureSwaggerUi();
        }

 

代码已经完毕，可是咱们要注意的一点，咱们看到ConfigureSwaggerUi方法里面，commentsFileName变量是指定路径的。因此咱们要在路径下面作一些配置。

选中Web项目，而后右键属性—>生成—>输出—>勾选 XML文档文件，而且把内容复制到commentsFileName变量中。

 

3. 运行Swagger

首先，咱们将web设为启动项目。在路径后面加入 /swagger/ui/index，以下：

 

到此，启动成功。

 

能够关注本人的公众号，多年经验的原创文章共享给你们。