Fast Responder 快捷响应服务

Fast_Responder 快捷响应服务

v1.0.0

简介

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

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

1. github: https://github.com/Silwings-git
2. gitee: https://gitee.com/silwings

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

邮箱: silwings@163.com

适用场景

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

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

*

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

使用说明

安装说明

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

1. 在数据库执行项目下src\sqls\init.sql文件
2. 修改配置文件的数据库配置
3. 运行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"}]}

字段信息
主体类型描述必填namestring应答器名称truehttpMethodstring应答请求方式(大写)truekeyUrlstring应答地址truecategoryNamestring应答器分类名称falsedelayTimelong应答器响应延迟时间(ms),默认0falsetasksarray应答器的任务集false|–namestring任务名称true|–delayTimelong延迟时间(ms),默认0false|–conditionsarray任务执行条件false|–contentobj任务内容true|–|--httpMethodstring请求方式(大写)true|–|--requestUrlstring请求地址true|–|--headersmap请求头false|–|--paramsmap请求参数(注意value为字符数组)false|–|--bodyobj请求体falseresultsarray返回值列表false|–resultNamestring返回值名称true|–bodyobj响应体false|–msgstring响应内容(只有body为null才返回msg)false|–conditionsarray返回执行条件false|–headersmap响应头false

字段简述

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

Task说明

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

Result说明

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

condition说明

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

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

ReplaceOperator替换操作符

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

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

1. 操作符介绍 1. **${}*查询替换符，可以从请求信息参数（param，path param，body）中获取指定字段的值来对符号所在位置进行替换。通过在{}之间添加文本来指定字段，支持简单Json Path语法和标准Json Path语法，如果对标准Json Path不熟悉，可以使用简单Json Path快速上手。1. 简单Json Path语法（该语法为我自定义的简单语法）1. 查找最外层key：直接填写字段名2. 查找内层key：填写多个字段名，之间使用英文字符 . 分隔3. 查找数组指定角标：填写字段名+[]，[]内填写有效角标值。例：studentList[0]，意为获取studentList的0角标对象4. 查找替换示例1： 1. 返回值msg：”你好，我叫${student.name},今年${student.age}岁“。2. 请求应答器的请求的请求体：{“code”:“200”,“student”:{“name”:“小明”,“age”:20}}3. 得到的结果msg：”你好，我叫小明,今年20岁“5. 示例2： 1. 返回值msg：”你好，我叫${name},今年${age}岁“。2. 请求应答器的请求：http://localhost:8080/getStudent?name=小明&age=203. 得到的结果msg：”你好，我叫小明,今年20岁“4. 如果指定的key对应的值是一个对象，将得到一个对象或对象的json字符串6. 示例3： 1. 返回值msg：”你好，我叫${name},今年${age}岁“。2. 配置的应答地址： http://localhost:8080/getStudent/{name}/{age}3. 请求应答器的请求：http://localhost:8080/getStudent/小明/204. 得到的结果msg：”你好，我叫小明,今年20岁“2. 标准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’]3. 简单path和标准path在使用上的区别：1. 简单版除了body，还支持从param，path param中查找，而标准版仅支持从请求体body中查找。2. 简单版仅提供简单的键值查询，标准版提供的查询更加多样性。4. 简单版和标准版共存，是否会导致取值错误？1. 设计上，简单版和标准版仅有 从集合获取指定一个角标处的值 的语法相同，所以也只有这里可能会发生简单版和标准版冲突的情况。（这段语法设计为相同是为防止对使用者学习标准Json Path造成负面影响而有意为之）2. 如果简单版和标准版均获取到了值，将优先获取标准版的结果2. **-RDBoolean()-**1. 随机一个布尔值替换掉操作符2. 示例： 1. 字符串： “这是一个随机布尔值：-RDBoolean()-”2. 结果： “这是一个随机布尔值：true”3. **-RDInt()-**1. 随机一个int数值替换掉操作符2. 可以在（）中传递参数（下列10,-5,20均为示例值，可换其他值）。 1. -RDInt()-：返回一个伪随机int值。2. -RDInt(10)-：返回0（包含）到10（不包含）直接的位随机数int值。3. -RDInt(-5，20)-：返回-5（包括）和20（不包括）之间的伪随机int值。4. **-RDLong()-**1. 随机一个long数值替换掉操作符2. 可以在（）中传递参数（下列10,-5,20均为示例值，可换其他值）。 1. -RDLong()-：返回一个伪随机long值。2. -RDLong(10)-：返回0（包括）和10（不包括）之间的伪随机long值。3. -RDLong(-5,20)-：返回-5（包括）和20（不包括）之间的伪随机long值。5. **-RDDouble()-**1. 随机一个double数值替换掉操作符2. 可以在（）中传递参数（下列10.0,-5.0,1.0均为示例值，可换其他值）。 1. -RDDouble()-：返回0（包括）和1（不包括）之间的伪随机double值。2. -RDDouble(10.0)-：返回介于 0.0（包括）和10.0（不包括）之间的伪随机double值。3. -RDDouble(-5.0,1.0)-：返回-5.0（包括）和1.0（不包括）之间的伪随机double值。6. **-UUID()-**1. 随机一个uuid替换掉操作符2. 可以在（）中传递限制长度（下列16,64均为示例值，可换其他值）。 1. -UUID()-：返回一个uuid字符2. -UUID(16)-：使用substring函数将uuid裁剪到长度163. -UUID(64)-：循环拼接生成的uuid，知道长度到达647. **-TSNow()-**1. 生成当前时间的时间戳替换掉操作符2. 可以在（）中传递参数,ms和s为固定值，只能二选一 1. -TSNow()-：时间戳，单位ms2. -TSNow(ms)-：生成毫秒值时间戳3. -TSNow(s)-：生成秒值时间戳8. **-TSFNow()-**1. 根据指定格式生成时间2. 可以在（）中传递参数（下列yyyy-MM-dd HH:mm:ss为示例值,可切换其他正确时间格式） 1. -TSFNow()-：同“-TSNow()-”2. -TSFNow(yyyy-MM-dd HH:mm:ss)-：将当前时间转换为“yyyy-MM-dd HH:mm:ss”格式返回

客户端操作与功能演示

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

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

1. 创建并启用应答器
2. 启动用于回调的测试服务,其中包含如下web接口
3. Postman测试1. 不触发任务和返回值2. 触发ResultA3. 触发ResultB4. 触发Task,ResultB
4. 查看日志​ 实际使用过程中，经常会需要确认task或项目执行情况，如果只能通过控制台查看会比较麻烦，Fast Responder客户端提供了实时日志查看功能。默认日志等级INFO，可通过配置文件（logback.xml）调整。日志接口默认各接收最多同时10个连接，有新连接进入时，最早连接的连接将被断开。1. task日志，仅打印task执行线程的日志2. 项目日志，打印项目的全部日志

tips:

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

感谢你的阅读!