路由能手为Fizz网关插件，提供流量过滤、分派、复制功能，可灵活用于多种场景。
-
本插件功能从类型上可分为流量过滤、分派、复制，原理如下图所示
- 流量过滤：满足匹配规则的请求会被继续执行。可用于访问安全、请求方限制、请求过滤等场景。
- 流量分派：满足匹配规则的请求会被转到目标路由执行，不满足的请求在当前路由继续执行。可用于服务分线/业务级别负载均衡、灰度验证、ABTest等场景。
- 流量复制：原请求在当前路由正常执行，满足匹配规则的请求则复制一份到目标路由执行。可用于请求复制/流量回放、旁路分析等场景。
配置时不依赖外部系统，随时可用。
-
支持是否启用某条路由规则，启用后选择分派或复制其中一种路由方式。
-
支持根据接口路径、来源IP、Header、Cookie、请求参数等多种条件筛选请求，每种条件支持多个参数项，参数值支持单个或多个固定值、或任意非空值。
-
分派或复制时可设置请求接收方为其它Fizz路由，巧妙复用。基于Fizz当前设计和支持，本插件分派为函数调用（不产生新请求），复制则为异步线程请求当前服务实例。
-
目前提供三条可配置规则，可修改插件表单定义自行扩展数量。分派规则如果设置了多条，将依次检测，如果有一条匹配则不再继续，如果都不匹配，流量过滤（即不配置目标路由）模式下返回失败，流量分派（配置了目标路由）模式下由当前路由继续执行。 复制规则可以有多条且各自独立，被复制的请求其执行结果不影响原请求。
-
配置接口路径、来源IP、Header、Cookie、请求参数时请按配置界面提示的格式，这几项匹配条件为并的关系。
-
目标路由填写时需输入多项值（格式按提示），注意不可以是当前路由。如果填写了目标路由但填写错误（例如路由不存在或填值不规范）那么将请求转到目标路由时会失败。ps:未来Fizz支持使用路由唯一ID时本插件再升级此处填值方式的友好性。
详细的表单定义请查阅“表单定义.md”，插件配置示例请查看“配置示例.PNG”。
基于fizz社区版，使用2.4.0-SNAPSHOT版本的fizz-spring-boot-starter ，没有依赖其它外部包。
gateway项目pom文件中引入以下依赖
<dependency>
<groupId>com.fizzgate</groupId>
<artifactId>fizz-route-expert-plugin</artifactId>
<version>2.3.3-beta6</version>
</dependency>
管理后台导入以下SQL
INSERT INTO `tb_plugin` (
`fixed_config`,
`eng_name`,
`chn_name`,
`config`,
`order`,
`instruction`,
`type`,
`create_user`,
`create_dept`,
`create_time`,
`update_user`,
`update_time`,
`status`,
`is_deleted`
)
VALUES
(
'',
'RouteExpert',
'路由能手',
'[{"field":"pr1_status","label":"规则一：是否启用","component":"radio","dataType":"boolean","default":true,"options":[{"label":"是","value":true},{"label":"否","value":false}],"rules":[]},{"field":"pr1_routeType","label":"规则一：路由方式","component":"radio","dataType":"short","default":1,"options":[{"label":"分派","value":1},{"label":"复制","value":2}],"rules":[]},{"field":"pr1_targetParam","label":"规则一：目标路由","component":"input","dataType":"string","desc":"填写接收匹配上述条件的请求的Fizz路由信息，不填则使用本路由（复制方式下必填）。路由由服务名（必填）+前端路径（必填）+请求方法（必填）+AppID（选填）一起确定，填写格式：targetService=xxx, targetPath=xxx, targetMethod=xxx, appId=xxx","default":"","rules":[]},{"field":"pr1_path","label":"规则一：匹配条件-接口路径","component":"input","dataType":"string","desc":"当前路由子路径，可以是某一层路径或是具体接口，不填或/**为当前路由下所有路径。选填","default":"","rules":[]},{"field":"pr1_ip","label":"规则一：匹配条件-来源IP","component":"input","dataType":"string","desc":"填写单个IP、多个IP或IP段，逗号隔开。选填","default":"","rules":[]},{"field":"pr1_header","label":"规则一：匹配条件-header","component":"input","dataType":"string","desc":"填写header字段名及其值（若多个值可用竖线隔开），多个header可逗号隔开（为并的关系），例如填 \\"version=2.0|3.0，os=andriod\\", 表示header里name为version的字段为2.0或3.0且os为andriod时匹配条件，若值填*表示任意非空值（此时其它值无效）。选填","default":"","rules":[]},{"field":"pr1_cookie","label":"规则一：匹配条件-cookie","component":"input","dataType":"string","desc":"填法同header。选填","default":"","rules":[]},{"field":"pr1_param","label":"规则一：匹配条件-请求参数","component":"input","dataType":"string","desc":"填法同header。选填","default":"","rules":[]},{"field":"pr2_status","label":"规则二：是否启用","component":"radio","dataType":"boolean","default":true,"options":[{"label":"是","value":true},{"label":"否","value":false}],"rules":[]},{"field":"pr2_routeType","label":"规则二：路由方式","component":"radio","dataType":"short","default":1,"options":[{"label":"分派","value":1},{"label":"复制","value":2}],"rules":[]},{"field":"pr2_path","label":"规则二：匹配条件-接口路径","component":"input","dataType":"string","desc":"当前路由子路径，可以是某一层路径或是具体接口，不填或/**为当前路由下所有路径。选填","default":"","rules":[]},{"field":"pr2_ip","label":"规则二：匹配条件-来源IP","component":"input","dataType":"string","desc":"填写单个IP、多个IP或IP段，逗号隔开。选填","default":"","rules":[]},{"field":"pr2_header","label":"规则二：匹配条件-header","component":"input","dataType":"string","desc":"填写header字段名及其值（若多个值可用竖线隔开），多个header可逗号隔开（为并的关系），例如填 \\"version=2.0|3.0，os=andriod\\", 表示header里name为version的字段为2.0或3.0且os为andriod时匹配条件，若值填*表示任意非空值（此时其它值无效）。选填","default":"","rules":[]},{"field":"pr2_cookie","label":"规则二：匹配条件-cookie","component":"input","dataType":"string","desc":"填法同header。选填","default":"","rules":[]},{"field":"pr2_param","label":"规则二：匹配条件-请求参数","component":"input","dataType":"string","desc":"填法同header。选填","default":"","rules":[]},{"field":"pr2_targetParam","label":"规则二：目标路由","component":"input","dataType":"string","desc":"填写接收匹配上述条件的请求的Fizz路由信息，不填则使用本路由（复制方式下必填）。路由由服务名（必填）+前端路径（必填）+请求方法（必填）+AppID（选填）一起确定，填写格式：targetService=xxx, targetPath=xxx, targetMethod=xxx, appId=xxx","default":"","rules":[]},{"field":"pr3_status","label":"规则三：是否启用","component":"radio","dataType":"boolean","default":true,"options":[{"label":"是","value":true},{"label":"否","value":false}],"rules":[]},{"field":"pr3_routeType","label":"规则三：路由方式","component":"radio","dataType":"short","default":1,"options":[{"label":"分派","value":1},{"label":"复制","value":2}],"rules":[]},{"field":"pr3_path","label":"规则三：匹配条件-接口路径","component":"input","dataType":"string","desc":"当前路由子路径，可以是某一层路径或是具体接口，不填或/**为当前路由下所有路径。选填","default":"","rules":[]},{"field":"pr3_ip","label":"规则三：匹配条件-来源IP","component":"input","dataType":"string","desc":"填写单个IP、多个IP或IP段，逗号隔开。选填","default":"","rules":[]},{"field":"pr3_header","label":"规则三：匹配条件-header","component":"input","dataType":"string","desc":"填写header字段名及其值（若多个值可用竖线隔开），多个header可逗号隔开（为并的关系），例如填 \\"version=2.0|3.0，os=andriod\\", 表示header里name为version的字段为2.0或3.0且os为andriod时匹配条件，若值填*表示任意非空值（此时其它值无效）。选填","default":"","rules":[]},{"field":"pr3_cookie","label":"规则三：匹配条件-cookie","component":"input","dataType":"string","desc":"填法同header。选填","default":"","rules":[]},{"field":"pr3_param","label":"规则三：匹配条件-请求参数","component":"input","dataType":"string","desc":"填法同header。选填","default":"","rules":[]},{"field":"pr3_targetParam","label":"规则三：目标路由","component":"input","dataType":"string","desc":"填写接收匹配上述条件的请求的Fizz路由信息，不填则使用本路由（复制方式下必填）。路由由服务名（必填）+前端路径（必填）+请求方法（必填）+AppID（选填）一起确定，填写格式：targetService=xxx, targetPath=xxx, targetMethod=xxx, appId=xxx","default":"","rules":[]}]',
100,
'1. 目前提供三条可配置规则。分派规则如果设置了多条，将依次检测，如果有一条匹配则不再继续，如果都不匹配，流量过滤（即不配置目标路由）模式下返回失败，流量分派（配置了目标路由）模式下由当前路由继续执行。\n 复制规则可以有多条且各自独立，被复制的请求其执行结果不影响原请求。 \n 2. 配置接口路径、来源IP、Header、Cookie、请求参数时请按配置界面提示的格式，这几项匹配条件为并的关系。\n 3. 目标路由填写时需输入多项值（格式按提示），注意不可以是当前路由。如果填写了目标路由但填写错误（例如路由不存在或填值不规范）那么将请求转到目标路由时会失败。\n\n更多信息请阅读：http://gzgit.bestwehotel.com/we-code/fizz-route-expert-plugin/-/blob/master/README.md',
2,
NULL,
NULL,
NULL,
NULL,
NULL,
1,
0
);