博客
关于我
强烈建议你试试无所不能的chatGPT,快点击我
Ocelot中文文档-路由
阅读量:4608 次
发布时间:2019-06-09

本文共 3409 字,大约阅读时间需要 11 分钟。

原文:

Ocelot的主要功能是接管进入的http请求并把它们转发给下游服务。目前是以另一个http请求的形式(将来可能是任何传输机制)。

Ocelot将路由一个请求到另一个请求描述为ReRoute。为了在Ocelot做任何工作,都需要在配置中设置一个ReRoute。

{    "ReRoutes": [    ]}

为了设置ReRoute,你需要如下所示添加一个ReRoute到ReRoutes的json数组。

{    "DownstreamPathTemplate": "/api/posts/{postId}",    "DownstreamScheme": "https",    "DownstreamHostAndPorts": [            {                "Host": "localhost",                "Port": 80,            }        ],    "UpstreamPathTemplate": "/posts/{postId}",    "UpstreamHttpMethod": [ "Put", "Delete" ]}

DownstreamPathTemplate、DownstreamScheme和DownstreamHostAndPorts 确定请求的转发。

DownstreamHostAndPorts是一个数组,包含请求要转发的主机和端口。通常这只包含一个条目,但有时您可能需要将请求负载平衡到您的下游服务,这是Ocelot允许我们添加多个条目,然后选择一个负载均衡器。

UpstreamPathTemplate是Ocelot用来标识哪个DownstreamPathTemplate用于给定的请求URL。 最后,UpstreamHttpMethod的使用,可以让Ocelot区分对同一个URL的请求,并且显然这是需要的工作。

你可以指定一个Http请求方法列表,或者一个空的列表以允许任务Http请求方法。在Ocelot中,你可以使用{something}的方式在模板中添加变量占位符。占位符需要在DownstreamPathTemplate 和UpstreamPathTemplate中都添加。如果是这样,当请求到达时Ocelot将试图使用上游url中的正确的变量值来替换占位符。

你也可以想这样使用一个ReRoute处理所有请求:

{    "DownstreamPathTemplate": "/api/{everything}",    "DownstreamScheme": "https",    "DownstreamHostAndPorts": [            {                "Host": "localhost",                "Port": 80,            }        ],    "UpstreamPathTemplate": "/{everything}",    "UpstreamHttpMethod": [ "Get", "Post" ]}

这将转发所有请求到下游服务路径/api。

目前在没有任何配置的请求下,Ocelot将默认所有ReRoutes不区分大小写。 为了改变这种情况,您可以在每个ReRoute中指定以下设置:

"ReRouteIsCaseSensitive": true

这意味着,当Ocelot尝试将上行url与上游模板匹配时将区分大小写。 此设置默认为false,这也是我的建议。因此只有在您希望ReRoute区分大小写时才用设置它。

捕获所有

Ocelot的路由还支持捕获所有样式的路由,用户可以指定他们想要匹配所有流量。如果你像下面那样设置你的配置,请求将被直接代理(它不一定叫url,任何占位符名称都可以)。

{    "DownstreamPathTemplate": "/{url}",    "DownstreamScheme": "https",    "DownstreamHostAndPorts": [            {                "Host": "localhost",                "Port": 80,            }        ],    "UpstreamPathTemplate": "/{url}",    "UpstreamHttpMethod": [ "Get" ]}

该捕获所有的优先级低于其他任何ReRoute。 如果你的配置中还有下面的ReRoute,那么Ocelot会在捕获所有配置之前先匹配它。

{    "DownstreamPathTemplate": "/",    "DownstreamScheme": "https",    "DownstreamHostAndPorts": [            {                "Host": "10.0.10.1",                "Port": 80,            }        ],    "UpstreamPathTemplate": "/",    "UpstreamHttpMethod": [ "Get" ]}

上游主机

此功能允许您基于上游主机进行ReRoutes。 这是通过查看客户端使用的主机头来工作,然后将其用作识别ReRoute的信息的一部分。

为了使用这个功能,在你的配置中加上如下配置。

{    "DownstreamPathTemplate": "/",    "DownstreamScheme": "https",    "DownstreamHostAndPorts": [            {                "Host": "10.0.10.1",                "Port": 80,            }        ],    "UpstreamPathTemplate": "/",    "UpstreamHttpMethod": [ "Get" ],    "UpstreamHost": "somedomain.com"}

上面的ReRoute只会匹配主机头是somedomain.com的请求。

如果您没有在ReRoue上设置UpstreamHost,则任何主机头都可以匹配它。 这基本上是一个捕获所有功能并保留构建功能时的现有功能。这意味着如果您有两个相同的ReRoute,其中一个与UpstreamHost是null,另一个有值。 Ocelot会倾向于设定值的那个。

这个功能在提出要求。

优先级

在中,我最终决定在ocelot.json中公开ReRoute的优先级。这意味着您可以决定上游HttpRequest与你的ReRoutes的匹配顺序。

为了是其起作用,将以下内容添加到ocelot.json的ReRoute中,0仅仅是一个示例值,将在下面解释。

{    "Priority": 0}

0是最低优先级,Ocelot将始终使用0作为/{catchAll}路由条目,并且可以硬编码。之后,你可以自由设置你想要的任何优先级。

例如你可以这样:

{    "UpstreamPathTemplate": "/goods/{catchAll}",    "Priority": 0}

还可以:

{    "UpstreamPathTemplate": "/goods/delete",    "Priority": 1}

在上面的例子中,如果您向Ocelot请求/goods/delete,Ocelot将匹配/goods/delete这个ReRoute。不过在不设置优先级以前它会匹配/goods/{catchAll}(因为这是列表中的第一个ReRoute!)。

posted on
2019-01-09 11:25 阅读(
...) 评论(
...)

转载于:https://www.cnblogs.com/lonelyxmas/p/10243284.html

你可能感兴趣的文章
[编写高质量代码:改善java程序的151个建议]建议67 不同的列表选择不同的遍历方法...
查看>>
整合SSM遇到的错误,数据库连接失败问题集合
查看>>
对象的比较与排序:IComparable和IComparer接口
查看>>
回望之二:游园10首
查看>>
智慧解析第08课:《战国策》中的心理学
查看>>
[C#] Helper 的封装 -- RandomHelper
查看>>
原型和原型链
查看>>
数据的增量更新之EXISTS
查看>>
【BIRT】交叉报表中出现空值设置为默认值
查看>>
Log4js 工作原理及代码简析
查看>>
windows phone 设置image 的source
查看>>
Personalized serious capabilities from the
查看>>
在ubuntu上部署Django
查看>>
android分享软件功能的实现
查看>>
数据库表设计工具
查看>>
E - The Blocks Problem ( UVA - 101)
查看>>
28个你不知道的HTML5的新技巧
查看>>
Oracle文档
查看>>
iOS开发中获取WiFi相关信息
查看>>
Ionic2:创建App启动页滑动欢迎界面
查看>>