翼度科技»论坛 编程开发 .net 查看内容

.net core8 knife4 web api文档

5

主题

5

帖子

15

积分

新手上路

Rank: 1

积分
15
knife4官网:https://github.com/luoyunchong/IGeekFan.AspNetCore.Knife4jUI
1.创建.net core8 web api项目
2.nuget包管理添加如下包:
  1. Swashbuckle.AspNetCore.Swagger
  2. Swashbuckle.AspNetCore.SwaggerGen
  3. IGeekFan.AspNetCore.Knife4jUI
复制代码
  
 

 
3.在项目右键-属性-生成-输出 勾选 文档文件如图:

 保持,关闭。
项目右键,重新生产,再打开可以看到xml路径,可以复制填入API文档路径。
4.修改Program.cs文件如图:

 相关代码:
  1. using IGeekFan.AspNetCore.Knife4jUI;
  2. using Microsoft.AspNetCore.Mvc.Controllers;
  3. using Microsoft.OpenApi.Models;
  4. using System.IO;
  5. using System.Reflection;
  6. var builder = WebApplication.CreateBuilder(args);
  7. // Add services to the container.
  8. builder.Services.AddSwaggerGen(c =>
  9. {
  10.     // 配置 Swagger 文档相关信息
  11.     c.SwaggerDoc("v1", new OpenApiInfo
  12.     {
  13.         Title = "Knife4 Api文档测试项目",
  14.         Version = "v2.0",
  15.         Description = "Knife4测试"
  16.     });
  17.     // 配置 Swagger 生成的 XML 文档 【这样可是接口的注释展示出来】
  18.     // 在项目属性中启用 XML 文档生成。右键点击项目,选择 "属性",在 "生成" 选项卡中勾选 "启用生成 XML 文档文件",
  19.     // 并指定生成的 XML 文件的路径。请注意确保该 XML 文件存在,并与程序集名称一致。
  20.     var xmlFile = $"{Assembly.GetExecutingAssembly().GetName().Name}.xml";//获取xml名称
  21.     var xmlPath = Path.Combine(AppContext.BaseDirectory, xmlFile);//转换xml路径
  22.     c.IncludeXmlComments(xmlPath, true);//true显示控制器的注释,否则不显示
  23.     c.OrderActionsBy(o => o.RelativePath); // 对action的名称进行排序,如果有多个,就可以看见效果了。
  24. });
  25. builder.Services.AddControllers();
  26. var app = builder.Build();
  27. if (app.Environment.IsDevelopment())
  28. {
  29.     app.UseSwagger();
  30.     // app.UseSwaggerUI();
  31.     app.UseKnife4UI(c =>
  32.     {
  33.         c.RoutePrefix = string.Empty;
  34.         c.SwaggerEndpoint("/swagger/v1/swagger.json", "接口版本");
  35.     });
  36. }
  37. app.UseAuthorization();
  38. app.MapControllers();
  39. app.Run();
复制代码
  
 5.控制器相关注释添加

 
6.运行看效果

 

 

 
到此,测试完成,其他的见官方文档进一步深入。谢谢。

如果你感觉写的有价值,请打赏,谢谢。
 

来源:https://www.cnblogs.com/mrer/p/17991795
免责声明:由于采集信息均来自互联网,如果侵犯了您的权益,请联系我们【E-Mail:cb@itdo.tech】 我们会及时删除侵权内容,谢谢合作!

本帖子中包含更多资源

您需要 登录 才可以下载或查看,没有账号?立即注册

x

举报 回复 使用道具