Ocelot中文文档不支持

Ocelot不支持一下几点...

• 分块编码 - Ocelot将始终获取body大小并返回Content-Length头。 如果这不适合你的场景&＃xff0c;只能表示抱歉&＃xff01;
• 转发host头 - 您发给Ocelot的host头不会转发给下游服务。显然这会打破一切 :(
• Swagger - 我已经多次看过从Ocelot的ocelot.json构建swagger.json&＃xff0c;但它看起来不适合

我有Ocelot就够了。如果您想在Ocelot中使用Swagger&＃xff0c;那么您必须生成自己的swagger.json&＃xff0c;并在Startup.cs或Program.cs中执行以下操作。 下面的代码示例注册了一个加载您手动生成的swagger.json并将其返回到/swagger/v1/swagger.json的中间件。 然后使用Swashbuckle.AspNetCore注册SwaggerUI中间件。

app.Map("/swagger/v1/swagger.json", b &＃61;>
{b.Run(async x &＃61;> {var json &＃61; File.ReadAllText("swagger.json");await x.Response.WriteAsync(json);});
});
app.UseSwaggerUI(c &＃61;>
{c.SwaggerEndpoint("/swagger/v1/swagger.json", "Ocelot");
});app.UseOcelot().Wait();

我认为Swagger没意义的主要原因是我们已经在ocelot.json中手动编写了我们的定义。如果我们希望针对Ocelot开发的人员能够查看可用的路由&＃xff0c;那么可以与他们共享ocelot.json&＃xff08;这应该与访问仓库一样简单&＃xff09;或者使用Ocelot管理API&＃xff0c;以便他们可以查询Ocelot的配置。

除此之外&＃xff0c;许多人还会配置Ocelot将所有流量例如/products/{everything}代理到产品服务&＃xff0c;如果您解析并将其转换为Swagger路径&＃xff0c;则不会描述实际可用的内容。另外Ocelot没有有关下游服务可以返回模型的概念&＃xff0c;并且连接到上述一个端口可以返回多个模型的问题。Ocelot不知道哪些模块需要使用POST还是PUT&＃xff0c;所以会变得混乱&＃xff0c;最后当swagger.json在运行时发生变化是&＃xff0c;Swashbuckle 包不会重新加载它。Ocelot的配置可以在运行时更改&＃xff0c;这样导致Swagger和Ocelot的信息不匹配。除非我推出我自己的Swagger实现。

如果有人想要对Ocelot API 进行简单的测试&＃xff0c;我建议使用Postman。甚至可以写一些将ocelot.json映射到postman json规范的东西。但是我不打算这样做。