项目结构:
SwaggerDocumentaion配置,ConfigureService类代码:
services.AddSwaggerGen(options =>
{
options.DescribeAllEnumsAsStrings();
options.SwaggerDoc("v1", new Swashbuckle.AspNetCore.Swagger.Info
{
Title = "TestAPI",
Version = "v1",
Description = "TestApplication API for modular monolith .NET application.",
});
var baseDirectory = AppDomain.CurrentDomain.BaseDirectory;
var commentsFileName = "Test.Modules.UserAccess.Facade.XML";//Assembly.GetExecutingAssembly().GetName().Name + ".XML";
var commentsFile = Path.Combine(baseDirectory, commentsFileName);
options.IncludeXmlComments(commentsFile);
var securityToken = new Dictionary<string, IEnumerable<string>>
{
{"Bearer", new string[] { }},
};
options.AddSecurityDefinition("Bearer", new ApiKeyScheme
{
Description = "JWT Authorization header using the Bearer scheme. Example: \"Authorization: Bearer {token}\"",
Name = "Authorization",
In = "header",
Type = "apiKey"
});
options.AddSecurityRequirement(securityToken);
});
配置类别:
public void Configure(IApplicationBuilder app, IHostingEnvironment env, IServiceProvider
serviceProvider)
{
app.UseSwagger();
app.UseSwaggerUI(c =>
{
c.SwaggerEndpoint("/swagger/v1/swagger.json", "TestAPI");
c.RoutePrefix = string.Empty;
});
}
我已经生成XML文件并复制到输出目录。
问题:
我收到错误“无法加载API定义”。帮助我解决此问题。
您可以仔细检查Controller方法吗?例如,Swagger需要明确的[HttpPost]
和[HttpGet]
如果具有Get(int id)
或Post(..)
,则将返回“无法加载API定义”>