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文档的输出路径-右击项目-生成标志

     

     

     

     

  • 相关阅读:
    sicp-py
    Ubuntu下找不到ttyUSB*问题解决
    Mysql基本命令及数据库存储位置
    open-vm-tools与VMware Tools
    64位ubuntu安装交叉编译工具链,显示找不到命令
    VMware Tools 继续运行脚本未能在虚拟机中成功运行。
    VMware Workstation 14安装VMware Tools
    VMware Workstation14 安装Ubuntu18.04
    Linux安装Sqlite
    mysql中文乱码
  • 原文地址:https://www.cnblogs.com/ABC-wangyuhan/p/14705876.html
Copyright © 2011-2022 走看看