README.md

kappak(伪内网穿透组件)

适用场景

1. 微信小程序发布后无法联调后端本地服务.
2. 服务部署在局域网内(能连到外网), 从外网无法直连到服务进行一些操作.
3. 前后端联调时不在同一个局域网.

运行模式

1. 通过client服务内部转发MockReq达到DispatcherServlet的目的.
2. client通过RestTemplate调用本地服务, 在client端的配置文件中设置端口号, methodType = 1, 并且client端需独立运行.
3. 通过url反射调用目标方法, 相当于模拟了SpringMVC, 不够健壮, 但有利于学习SpringMVC. 设置methodType = 2 即可, 并且 clinet端需和本地服务在同一个服务中.

几种可自定义的组件

• 组件的定义方式完全和WebMvcConfigurer的使用方式一样.

1. 自定义地址映射器, 继承IUriSelector函数式接口, 并将映射器注册到client端的KappakConfigurer.addUrISelector()中.
2. 自定义方法参数解析器, 继承IParamResolver函数式接口, 并将解析器注册到client端的KappakConfigurer.addMethodParameterResolver()中.
3. 自定义重试机制. 使用Guava提供的retryer类, 参数自定义后注册到server端的KappakConfigurer.addReTryEr()中.这个单词的驼峰命名真难.

演示

1. Request URL, server端地址 + client端方法相对路径.
2. 请求头 :

      Request-Method: POST
      Content-Type: application/json || application/x-www-form-urlencoded
      ClientName: youngsapling
      

3. 支持url路径中包含 通配符 和 ${id} 的方式.

                                                                                                        -- 我变强了, 也变秃了.