配置swaggerx显示驼峰命名,显示枚举类型:
services.AddControllers().AddJsonOptions(config => { config.JsonSerializerOptions.PropertyNamingPolicy = null; //config.JsonSerializerOptions.Converters.Add(new JsonStringEnumConverter());//swagger显示枚举类型而不是枚举值 });
包含xml文档,显示枚举类型描述:
services.AddSwaggerGen(c => { c.SwaggerDoc("v1", new OpenApiInfo { Title = "RainTool.WebAPI", Version = "v1" }); foreach (var item in XmlCommentsFilePath) { c.IncludeXmlComments(item); } c.DocumentFilter<SwaggerEnumFilter>();//显示枚举类型的描述 });
static List<string> XmlCommentsFilePath { get { var basePath = PlatformServices.Default.Application.ApplicationBasePath; DirectoryInfo d = new DirectoryInfo(basePath); FileInfo[] files = d.GetFiles("*.xml"); var xmls = files.Select(a => Path.Combine(basePath, a.FullName)).ToList(); return xmls; } }
配置json显示样式:
services.AddMvc(option => { option.Filters.Add<BaseActionFilterAttribute>(); //全局注册 }).AddNewtonsoftJson(options => { //忽略循环引用 options.SerializerSettings.ReferenceLoopHandling = ReferenceLoopHandling.Ignore; //不使用驼峰样式的key options.SerializerSettings.ContractResolver = new DefaultContractResolver(); //设置时间格式 options.SerializerSettings.DateFormatString = "yyyy-MM-dd HH:mm:ss"; });