.Netcore 2.0 Ocelot Api网关教程(3)- 路由聚合

在实际的应用当中,经常会遇到同一个操作要请求多个api来执行。这里先假设一个应用场景:通过姓名获取一个人的个人信息(性别、年龄),而获取每种个人信息都要调用不同的api,难道要依次调用吗?在Ocelot中为我们提供了很好的解决方法。

路由聚合

继续使用前边的文章建立的项目,在WebApiA项目中添加一个新的WebApi控制器命名为UserController,代码如下:

[Produces("application/json")]
[Route("api/[controller]/[action]")]
public class UserController : Controller
{
    [HttpGet]
    public string GetSex(string name)
    {
        if (name == "Jonathan")
            return "Man";
        return null;
    }

    [HttpGet]
    public int? GetAge(string name)
    {
        if (name == "Jonathan")
                return 24;
        return null;
    }
}

启动WebApiA,然后使用Postman分别访问
http://localhost:5001/api/User/GetSex?name=Jonathan
http://localhost:5001/api/User/GetAge?name=Jonathan
结果如下:

GetSex.png

GetAge.png

修改configuration.json文件,向ReRoutes节点中添加如下配置:

{
    "DownstreamPathTemplate": "/api/User/GetSex",
    "DownstreamScheme": "http",
    "DownstreamHostAndPorts": [
    {
        "Host": "localhost",
        "Port": 5001
    }],
    "UpstreamPathTemplate": "/Sex",
    "UpstreamHttpMethod": [ "Get" ],
    "Key": "Sex"
},
{
    "DownstreamPathTemplate": "/api/User/GetAge",
    "DownstreamScheme": "http",
    "DownstreamHostAndPorts": [
    {
        "Host": "localhost",
        "Port": 5001
    }],
    "UpstreamPathTemplate": "/Age",
    "UpstreamHttpMethod": [ "Get" ],
    "Key": "Age"
}

在与ReRoutes同级的位置添加如下配置:

"Aggregates": [
{
    "ReRouteKeys": [
    "Sex",
    "Age"
    ],
    "UpstreamPathTemplate": "/GetUserInfo"
}]

请求聚合执行的操作为:当请求GetUserInfo时,自动到Reoutes中查找ReRouteKeys下Key值相同的路由,并全部请求,然后将请求结果拼成Json格式返回。
Postman访问http://localhost:5000/GetUserInfo,结果如下:

GetUserInfo_1.png

Ocelot请求聚合现在只支持get方法,点击https://github.com/ThreeMammals/Ocelot/blob/master/src/Ocelot/Configuration/File/FileAggregateReRoute.cs查看源码及注释说明。

请求聚合的页面404

请求聚合下不会对404的页面返回任何结果,我们现在在configuration.json文件中的ReRoutes节点下添加如下内容:

{
    "DownstreamPathTemplate": "/api/User/GetID",
    "DownstreamScheme": "http",
    "DownstreamHostAndPorts": [
    {
        "Host": "localhost",
        "Port": 5001
    }],
    "UpstreamPathTemplate": "/ID",
    "UpstreamHttpMethod": [ "Get" ],
    "Key": "ID"
}

向Aggregates节点下的ReRoutesKeys节点下添加一个ID
注意:在WebApiA项目中是没有/api/User/GetID方法的,所以会返回404
然后我们启动项目访问http://localhost:5000/api/GetUserInfo,结果如下:

GetUserInfo_2.png

可以看到返回的数据中ID为空。
源码下载

完,下一篇介绍服务发现

你可能感兴趣的:(.Netcore 2.0 Ocelot Api网关教程(3)- 路由聚合)