zoukankan      html  css  js  c++  java
  • .NetCore3.1配置Swagger==》显示接口XML以及实体XML

    一、在Startup中进行配置以及调用

    #region swagger接口帮助文档 在ConfigureServices中注册服务
    
                services.AddHttpClient();
                services.AddSingleton<MessageHandleService>();
                services.AddHostedService<MessageFileSaveService>();
                if (configuration["tencentIM:syncMessage"] == "1")
                {
                    services.AddHostedService<MessageManageService>();
                }
    
                services.AddSwaggerGen(c =>
                {
                    c.SwaggerDoc("v1", new OpenApiInfo
                    {
                        Title = "接口名称-自定义",
                        Version = "v1.0",
                        Description = "框架说明文档"
                    }
                    );
                    // 为 Swagger 设置xml文档注释路径
                    var basePath = AppContext.BaseDirectory;
                    //var xmlFile = $"{Assembly.GetExecutingAssembly().GetName().Name}.xml";
              
              
              //当前接口目录下生成该文件 binDebug
    etcoreapp3.1MyDemo.WebApi.xml

    var xmlPath = Path.Combine(basePath, "MyDemo.WebApi.xml");
              if (File.Exists(xmlPath))
                    {
                        c.IncludeXmlComments(xmlPath, true);
                    }
              //当前接口目录下生成该文件 binDebug
    etcoreapp3.1MyDemo.Data.xml
                    var xmlModelPath = Path.Combine(basePath, "MyDemo.Data.xml");
              
    if (File.Exists(xmlModelPath))
              {
                 c.IncludeXmlComments(xmlModelPath);
              }
              });
              }
    #endregion
       public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
            {
                if (env.IsDevelopment())
                {
                    app.UseDeveloperExceptionPage();
                }
                else
                {
    
                }
    
                app.UseRouting();
            
           //将中间件添加到管道中
    app.UseSwagger(); app.UseSwaggerUI(option
    => { option.SwaggerEndpoint("/swagger/v1/swagger.json", "MyDemo-API"); }); app.UseEndpoints(endpoints => { endpoints.MapControllers(); }); }

    二、配置XML文档的输出路径-右击项目-生成标志

     

     

     

     

  • 相关阅读:
    VSCode编写 Vue 项目标签内显示写CSS提示设置
    Vue 炫酷 Echarts 图表
    vue 动态生成拓扑图
    Vue 全局 websocket
    Vue 自定义组件v-model父子组件传值双向绑定
    vue项目Echarts更新数据是数据表展示错版
    Vue图片加载错误、图片加载失败的处理
    Vue 使用 Ant-d 简单实现左侧菜单栏和面包屑功能
    Vue Echarts图表dataZoom缩放区域根据数据量显示
    Echarts图例数据太多实现滚动效果
  • 原文地址:https://www.cnblogs.com/ABC-wangyuhan/p/14705876.html
Copyright © 2011-2022 走看看