Fast Responder 快捷响应服务

v1.0.0

​ Fast_Responder是一个可以让你快速创建Http请求应答器(responder)的服务。应答器可以接收配置的任意请求路径的请求，并按照你的配置对请求参数进行判断，以返回不同的结果。除了处理请求外，应答器还可以对任意个请求地址按你配置的延迟时间，请求头和参数发起Http请求。本质上，fast_responder是一个动态mock服务。

你可以在这里获取该项目的服务端和客户端源码(客户端不是非必须的,但是建议使用)

github: https://github.com/Silwings-gitgitee: https://gitee.com/silwings

如有建议或疑问，欢迎给我发送邮件说明，感谢您的意见.

邮箱: silwings@163.com

写这个服务主要是为了应对工作中遇到的一些特殊场景，比如：

对接第三方接口时,对方提供的接口没有测试环境，或有调用次数限制。
如果三方接口有调用次数限制（如某签约服务测试环境发起合同次数有限制），可以将需要调用的接口创建为一个应答器，设置合理的返回值，就可以先调试流程代码，确认流程没问题后切换请求域名，调用实际接口，减少对三方接口的调用次数。
团队合作时，所开发的功能需要依赖同事的接口，但同事还没完成接口开发（前端-后端，后端-后端）。
这种情况下通常是自己mock一些数据进行调试，可以将这些mock数据创建到应答器中，方便重复利用，同时避免mock代码忘记删除等意外情况。
要调用的接口是发起一个操作流程，操作完成后会对我方进行回调。但发起操作流程后，该流程难以完成，或耗时很长。
通过使用应答器来响应发起操作流程的接口，并主动对预定接口进行回调，进而跳过该操作流程，使主流程和次流程拆分。

*该服务不适合数据交互需要加解密的场景

运行该服务仅需要一个Mysql服务，要求不低于8.0版本。

在数据库执行项目下srcsqlsinit.sql文件修改配置文件的数据库配置运行FastResponderApplication

{
    "name":"Demo config",
    "httpMethod":"GET",
    "keyUrl":"/demo/url",
    "categoryName":"示例配置",
    "delayTime":0,
    "tasks":[
        {
            "conditions":[
                "1 == 1",
                "${age} >= 10",
                "name =IsNotBlank="
            ],
            "content":{
                "body":{
                    "timestemp":"-TSNow(ms)-",
                    "name":"${name}",
                    "id":"-UUID()-"
                },
                "headers":{
                    "authToken":"8888888888"
                },
                "httpMethod":"POST",
                "params":{
                    "keyA":[
                        "key_Av1",
                        "keyA_v2"
                    ],
                    "keyB":[
                        "keyB_v1"
                    ]
                },
                "requestUrl":"http://localhost:8088/hello/word"
            },
            "delayTime":2000,
            "name":"My http task"
        }
    ],
    "results":[
        {
            "body":null,
            "conditions":[
                "${age} == 18"
            ],
            "headers":{
                "authToken":"-TSFNow(yyyy-MM-dd HH:mm:ss)-"
            },
            "msg":"Hello Word !",
            "resultName":"My Result A"
        },
        {
            "body":null,
            "conditions":[
                "${age} == 15"
            ],
            "headers":{

            },
            "msg":null,
            "resultName":"My Result B"
        }
    ]
}

字段信息

应答器配置主要由应答器名称，应答地址，应答请求方式，任务集，返回值集五个部分组成。应答地址和应答请求方式的组合是唯一的。如果出现冲突会在保存时提示。应答地址必须以"/"开头应答请求方式的取值范围： GET, HEAD, POST, PUT, PATCH, DELETE, OPTIONS, TRACE（使用客户端添加应答器时可以不区分大小写）。应答器响应延迟时间（delayTime）为接收到请求后，最快应该在多少ms外响应（注意是外，不是内）。应答器任务集：可配置http请求任务，task会按顺序判断条件，计算通过后创建task，在指定延迟后发起http请求。返回值集： 可配置多个返回值，按照顺序执行，当某一个返回值条件满足时立即返回。

当应答器中包含task时，在应答器对接口进行响应之前，会先遍历task集，依次判断执行条件（conditions，如果conditions 是empty，默认为true 。conditions说明见下文），如果条件判断为true，会创建task任务，等待执行。所有task任务会被缓存在一个无界延迟队列（DelayQueue）中，按照delayTime排序。如果配置的延迟时间相同，多个task可能同时执行（多线程）。task任务目前提供三个自定义配置
httptask.scheduler.thread-pool-size：设置执行task任务的线程池的核心线程数。默认5httptask.resttemplate.connect-timeout：请求连接超时时间。默认20000（ms）httptask.resttemplate.read-timeout：请求读取时间。默认20000（ms）
task任务中配置的执行条件（conditions），请求地址（requestUrl），请求头（headers），参数（params），请求体（body）均适用替换操作符,替换操作符可以对字符进行一些特定处理（见下文）。

当应答器包含result时，在请求处理的最后阶段，会按顺序遍历result集，依次判断执行条件，如果判断为true，会立即将当前result作为响应进行返回。可以配置两种类型的返回值。一是返回一个简单的字符串，二是返回一个对象，分别通过msg和body设置。但如果msg和body同时存在，会优先以body返回。例外的是如果运算结果无法转换为对象，会用无法转换的数据替换msg中原本的值。result中配置的响应条件（conditions），响应头（headers），响应内容（msg，body）均适用替换操作符（见下文）。

条件（condition）是用来确定task或result是否执行的表达式（expression）集，也就是一个集合为一个condition。配置格式为在集合中添加条件表达式。

集合中的每一个元素（表达式）之间的关系可以理解为Java中的&&，当前一个表达式结果为false时，后面的表达式不计算，整个condition直接返回false。如果条件集合为empty，该condition返回true。表达式格式：参数A+空格+条件符号+空格+参数B。其中参数A和参数B为必填。如果条件符号只需要左条件（参数A），参数B可以不写。条件表达式的三个元素之间的空格不可省略。条件符号
等值条件
==
如果参数A和参数B相等返回true。不区分数据类型，均按照字符串equals进行比较全条件符号，可以是任意数值或字符
!=
==的取反全条件符号，可以是任意数值或字符
数值条件
>>=<<=
区分数据类型，如果参数A和参数B均可以转换为数值类型，会按照比较符号逻辑进行比较，参数A或参数B有不能转换为数值的，直接返回false全条件符号
空判条件
=IsNull==IsNotNull==IsBlank==IsNotBlank=
这四种表达式运算逻辑参考org.apache.commons.lang3.StringUtils的对应方法。左条件符号，只需要参数A有值即可。
注意事项！
param参数比较特殊，因为其值是一个数组，所有在需要对url参数进行比对时，只有当param数组只有一个值时，才能正常生效。否则需要手动配置待比较的值为一个数组，并区分数组中是字符还是数值。

替换操作符可以对字符串进行特殊处理，如生成数据，引用数据，通过和condition组合可以进行动态逻辑判断。

同一个字符串中可以添加多个替换操作符，但不允许嵌套。

操作符介绍

${}

查询替换符，可以从请求信息参数（param，path param，body）中获取指定字段的值来对符号所在位置进行替换。通过在{}之间添加文本来指定字段，支持简单Json Path语法和标准Json Path语法，如果对标准Json Path不熟悉，可以使用简单Json Path快速上手。

简单Json Path语法（该语法为我自定义的简单语法）

查找最外层key：直接填写字段名查找内层key：填写多个字段名，之间使用英文字符 . 分隔查找数组指定角标：填写字段名+[]，[]内填写有效角标值。例：studentList[0]，意为获取studentList的0角标对象查找替换示例1：
返回值msg：”你好，我叫${student.name},今年${student.age}岁“。请求应答器的请求的请求体：{“code”:“200”,“student”:{“name”:“小明”,“age”:20}}得到的结果msg：”你好，我叫小明,今年20岁“
示例2：
返回值msg：”你好，我叫${name},今年${age}岁“。请求应答器的请求：http://localhost:8080/getStudent?name=小明&age=20得到的结果msg：”你好，我叫小明,今年20岁“如果指定的key对应的值是一个对象，将得到一个对象或对象的json字符串
示例3：
返回值msg：”你好，我叫${name},今年${age}岁“。配置的应答地址： http://localhost:8080/getStudent/{name}/{age}请求应答器的请求：http://localhost:8080/getStudent/小明/20得到的结果msg：”你好，我叫小明,今年20岁“

标准Json Path

标准Json Path指由Fast Json提供的Json Path语法规则，该语法可被JSONPath类解析。语法规则如下（想要了解更多信息请阅读fast json相关文档）：

JSONPATH	描述
$	根对象，例如$.name
[num]	数组访问，其中num是数字，可以是负数。例如$[0].leader.departments[-1].name
[num0,num1,num2…]	数组多个元素访问，其中num是数字，可以是负数，返回数组中的多个元素。例如$[0,3,-2,5]
[start:end]	数组范围访问，其中start和end是开始小表和结束下标，可以是负数，返回数组中的多个元素。例如$[0:5]
[start:end :step]	数组范围访问，其中start和end是开始小表和结束下标，可以是负数；step是步长，返回数组中的多个元素。例如$[0:5:2]
[?(key)]	对象属性非空过滤，例如$.departs[?(name)]
[key > 123]	数值类型对象属性比较过滤，例如$.departs[id >= 123]，比较操作符支持=,!=,>,>=,<,<=
[key = ‘123’]	字符串类型对象属性比较过滤，例如$.departs[name = ‘123’]，比较操作符支持=,!=,>,>=,<,<=
[key like ‘aa%’]	字符串类型like过滤， 例如$.departs[name like ‘sz*’]，通配符只支持% 支持not like
[key rlike ‘regexpr’]	字符串类型正则匹配过滤， 例如departs[name like ‘aa(.)*’]， 正则语法为jdk的正则语法，支持not rlike
[key in (‘v0’, ‘v1’)]	IN过滤, 支持字符串和数值类型 例如: $.departs[name in (‘wenshao’,‘Yako’)] $.departs[id not in (101,102)]
[key between 234 and 456]	BETWEEN过滤, 支持数值类型，支持not between 例如: $.departs[id between 101 and 201] $.departs[id not between 101 and 201]
length() 或者 size()	数组长度。例如$.values.size() 支持类型java.util.Map和java.util.Collection和数组
.	属性访问，例如$.name
…	deepScan属性访问，例如$…name
*	对象的所有属性，例如$.leader.*
[‘key’]	属性访问。例如$[‘name’]
[‘key0’,‘key1’]	多个属性访问。例如$[‘id’,‘name’]

简单path和标准path在使用上的区别：

简单版除了body，还支持从param，path param中查找，而标准版仅支持从请求体body中查找。简单版仅提供简单的键值查询，标准版提供的查询更加多样性。

简单版和标准版共存，是否会导致取值错误？

设计上，简单版和标准版仅有 从集合获取指定一个角标处的值 的语法相同，所以也只有这里可能会发生简单版和标准版冲突的情况。（这段语法设计为相同是为防止对使用者学习标准Json Path造成负面影响而有意为之）如果简单版和标准版均获取到了值，将优先获取标准版的结果

-RDBoolean()-

随机一个布尔值替换掉操作符示例：
字符串： “这是一个随机布尔值：-RDBoolean()-”结果： “这是一个随机布尔值：true”

-RDInt()-

随机一个int数值替换掉操作符可以在（）中传递参数（下列10,-5,20均为示例值，可换其他值）。
-RDInt()-：返回一个伪随机int值。-RDInt(10)-：返回0（包含）到10（不包含）直接的位随机数int值。-RDInt(-5，20)-：返回-5（包括）和20（不包括）之间的伪随机int值。

-RDLong()-

随机一个long数值替换掉操作符可以在（）中传递参数（下列10,-5,20均为示例值，可换其他值）。
-RDLong()-：返回一个伪随机long值。-RDLong(10)-：返回0（包括）和10（不包括）之间的伪随机long值。-RDLong(-5,20)-：返回-5（包括）和20（不包括）之间的伪随机long值。

-RDDouble()-

随机一个double数值替换掉操作符可以在（）中传递参数（下列10.0,-5.0,1.0均为示例值，可换其他值）。
-RDDouble()-：返回0（包括）和1（不包括）之间的伪随机double值。-RDDouble(10.0)-：返回介于 0.0（包括）和10.0（不包括）之间的伪随机double值。-RDDouble(-5.0,1.0)-：返回-5.0（包括）和1.0（不包括）之间的伪随机double值。

-UUID()-

随机一个uuid替换掉操作符可以在（）中传递限制长度（下列16,64均为示例值，可换其他值）。
-UUID()-：返回一个uuid字符-UUID(16)-：使用substring函数将uuid裁剪到长度16-UUID(64)-：循环拼接生成的uuid，知道长度到达64

-TSNow()-

生成当前时间的时间戳替换掉操作符可以在（）中传递参数,ms和s为固定值，只能二选一
-TSNow()-：时间戳，单位ms-TSNow(ms)-：生成毫秒值时间戳-TSNow(s)-：生成秒值时间戳

-TSFNow()-

根据指定格式生成时间可以在（）中传递参数（下列yyyy-MM-dd HH:mm:ss为示例值,可切换其他正确时间格式）
-TSFNow()-：同“-TSNow()-”-TSFNow(yyyy-MM-dd HH:mm:ss)-：将当前时间转换为“yyyy-MM-dd HH:mm:ss”格式返回

强烈推荐使用Web客户端对应答器进行维护。你可以在我的仓库中找到它。

使用配置示例中的应答器进行演示。

创建并启用应答器

启动用于回调的测试服务,其中包含如下web接口

Postman测试

不触发任务和返回值

触发ResultA

触发ResultB

触发Task,ResultB

查看日志

​ 实际使用过程中，经常会需要确认task或项目执行情况，如果只能通过控制台查看会比较麻烦，Fast Responder客户端提供了实时日志查看功能。默认日志等级INFO，可通过配置文件（logback.xml）调整。日志接口默认各接收最多同时10个连接，有新连接进入时，最早连接的连接将被断开。

task日志，仅打印task执行线程的日志

项目日志，打印项目的全部日志

tips:

进行过编辑后，会自动禁用，需要重新启用。keyUrl和httpMethod的组合应该是唯一的，但数据库并没有做限制，所有如果出现重复并同时启用的情况，将按照数据库默认排序获取第一个结果。

感谢你的阅读!