GATEWAY-WormHole 正在参加 2020 年度 OSC 中国开源项目评选,请投票支持!
GATEWAY-WormHole 在 2020 年度 OSC 中国开源项目评选 中已获得 {{ projectVoteCount }} 票,请投票支持!
投票让它出道
已投票
授权协议: MIT
开发语言: Java JavaScript
操作系统: 跨平台
收录时间: 2019-03-21
提 交 者: deathearth

    WormHole是“虫洞”意思。物理界解释为连接黑洞和白洞的时空隧道。它的结构和计算机网络中的网关类似,作为连接两个世界的枢纽。各管各,不用关心中间做了什么。如下:

    WormHole是一个简单、易用的api管理平台。目的是为了降低后端服务开发与前端调用的耦合性。通过WormHole这一层使整个项目的开发协作更加完善。客户端开发人员从管理平台查找需要的接口信息进行调用,服务端开发人员定义好接口后同步到管理平台中,管理平台可以统一对接口的访问设置等。

WormHole有两个版本,一个是基于SpringMVC框架、一个是基于原版改造为SpringBoot版本的。

平台特性

      
  • 网关支持Dubbo服务
  •   
  • 完善的授权管理(接口权限、web操作权限等)
  •   
  • 安全机制(验签、IP名单设置)
  •   
  • 流控机制(sentinel限流、熔断、隔离)
  •   
  • 处理流程、可插拔机制(组件化配置)
  •   
  • 支持mock功能,设定预期结果加快联调进度
  •   
  • 支持接口的快速录入测试功能
  •   
  • 有完善的用户、角色管理,使用shiro框架
  •   
  • 接口的有效管理,跨环境策略
  •   
  • 平台的扩展性,可按需调整

平台技术结构

注:server层是指具体的dubbo服务提供方,框架、插件根据实际需求处理

WormHole的SpringBoot版本是 将SpringMVC、Shiro、JSP、Velocity、Servlet等组件与SpringBoot进行整合。部分配置还有优化空间,可按需调整

平台组件逻辑

      
  • contextProcessor 存储上下文信息
  •   
  • ipProcessor IP黑白名单设置
  •   
  • userAgentProcessor 浏览器用户代理
  •   
  • paramProcessor 参数检查验证
  •   
  • callbackParamProcessor 回调接口参数检查验证
  •   
  • loginProcessor token信息检查
  •   
  • flowControlProcessor 流控限制
  •   
  • signProcessor 签名验证
  •   
  • authProcessor 权限验证
  •   
  • mockProcessor mock逻辑处理
  •   
  • dubboProcessor 泛化调用dubbo服务


## 平台项目结构

1、maven项目结构

wormehole

    / — wormehole-api         【管理台接口、实体类、传输对象、异常等的定义】

    / — wormehole-domain      【客户端信息、用户token、result对象等的定义】

    / — wormehole-web         【管理台的页面实现、接口实现业务逻辑】

2、项目目录结构

wormehole-api

/ — com.kaistart.gateway

  / — api.service         【网关逻辑相关的所有接口定义】

  / — domain              【网关逻辑相关的实体对象】

  / — dto                 【业务传输对象】

  / — exception           【自定义异常类、返回码】

  / — support             【自定义公共应对象】

    / — json            【自定义公共响应对象】

    / — page            【自定义公共分页对象】

    / — proto           【自定义公共接口】

  / — tool                【日期转换工具类】

wormehole-domain

| — com.kaistart.gateway.domain

  | — pojo                【网关的客户端对象、token信息】

  | — response            【网关层的异常、结构定义】

wormehole-web 【JAVA类、配置部分】

src/main/java

| — com.kaistart            【主包名】

  | — auth                【管理台核心包】

    | — controller      【管理台用户、角色、权限、资源等控制层】

    | — domain          【管理台相关实体类】

    | — interceptor     【管理台拦截器,url、权限等处理】

    | — mapper          【管理台相关的mapper对象】

    | — service         【管理台相关的service对象与实现】

  | — gateway             【网关核心包】

    | — common          【网关业务公共包】

      | — cache       【缓存工具类】

      | — exception   【网关异常类】  

      | — http        【http请求工具类,支持get请求传body】

      | — util        【工具类,zk,md5,executor】

    | — controller      【网关业务控制层】

    | — config          【网关的必要配置】

    | — dubbo           【网关的签名算法及对外服务】

    | — mgr             【网关的管理台处理】

      | — mapper      【网关相关的mapper对象】

      | — service     【网关相关的service定义及实现】

    | — processor       【网关逻辑的核心组件】

    | — servlet         【网关接口请求的servlet地址】

src/main/resources

| — mybatis                 【mybatis相关xml文件】

  | — auth                【控制台核心功能相关】

  | — mgr                 【网关功能相关】

| — spring                  【核心配置文件】

| — velocity                【velocity编码配置】

| — log4j.xml               【日志文件】



webapp

| — common                  【公共页面】

| — velocity                【velocity核心资源】

  | — config              【配置】

  | — image               【图片资源】

  | — js                  【核心js相关】

  | — components          【公用js组件】

  | — pages               【对应页面的js引用文件】

  | — utils               【分页等工具类】

  | — xxx.js              【框架相关js】

| — lib                     【引用的三方插件资源】

| — style                   【引用的css样式表】

| — WEB-INF         

  | — templates           【页面结构】

    | — demo            【样例】

    | — layout          【页面框架布局】  

    | — pages           【管理台页面包】

      | — auth        【用户、角色、权限相关】

      | — gateway     【网关相关页面】

      | — system      【系统查看页面】

      | — zookeeper   【zk相关页面】

  | — web.xml             【核心web.xml配置页面】

| — 401.jsp                 【过渡页面】

| — index.jsp               【主页】

| — login.jsp               【登录页面】

SpringBoot版本的配置文件会少一点。 约定大于配置,应该还有较多优化空间。

平台环境要求

      
  1. JDK1.8
  2.   
  3. Disconf配套环境【已移除配置】
  4.   
  5. Zookeeper
  6.   
  7. Tomcat容器等
  8.   
  9. Mysql数据库

SpringBoot版本不需要tomcat,

平台运行说明

      
  •   

    下载项目

      
  •   
  •   

    处理以下几个核心配置

      
          
    • /gateway.sql 【初始化数据库信息】
    •     
    • /resources/config.properties 【修改zk、redis、mysql等的连接】
    •     
    • /com/kaistart/gateway/config/MgrConfig.java 【修改不同环境的ip信息,这里这样写主要为了简化使用,可按需迁移到配置中心去】
    •     
    • gateway-web的 Context root 为 “/”
    •   
      
  •   
  •   

    部署到tomcat容器进行启动, 记得将webcontext-root 改为 '/'

      

运行的时候,DEBUG模式查看日志,比较容易处理问题。

展开阅读全文

代码

的 Gitee 指数为
超过 的项目

GATEWAY-WormHole 的相关资讯

还没有任何资讯

GATEWAY-WormHole 的相关博客

通过Docker容器连接代理Wormhole

Wormhole 是一个能识别命名空间的由 Socket 激活的隧道代理。可以让你安全的连接在不同物理机器上的 Docker 容器。可以用来完...

Wormhole大数据流式处理平台五大功能

导读:在上一篇文章「Wormhole 大数据流式处理平台之设计思想」中,我们介绍了Wormhole的设计思想,并给出了Stream、UMS、Flo...

Gateway

概念 Route: Route the basic building block of the gateway. It is defined by an ID, a destination URI, a collection of...

gateway

https://blog.csdn.net/forezp/article/details/83792388 官方推出的第二代网关框架,取代Zuul网关 https://blog.csdn.net/fo...

Wormhole 大数据流式处理平台之设计思想

导读:互联网的迅猛发展使得数据不再昂贵,而如何从数据中更快速获取价值变得日益重要,因此,数据实时化成为了一个大趋势。越...

#Wormhole# 流式处理平台设计思想

本文分享自微信公众号 - 宜信技术学院(CE_TECH)。 如有侵权,请联系 support@oschina.cn 删除。 本文参与“OSC源创计划”,...

APP SDK漏洞WormHole虫洞漏洞分析报告

漏洞原理: 这个漏洞是基于客户端端口接收任意ip的连接,这个端口是java层nanohttp实现的,并且这个http服务是不死服务,百度...

gateway欺人太甚!

需求: 通过gateway来转义请求参数中的html标签的“<”、“>”等,来防止xss攻击 版本: springbootVersion:2.1.6RELASE spri...

504 Gateway Timeout Error 502 Bad Gateway

总结 1、 502没有收到相应,或者收到了但不及时? cannot get a response in time 540收到了无效的响应 received an invalid ...

GATEWAY-WormHole 的相关问答

还没有任何问答,马上提问

评论 (1)

加载中
不知性能如何?网关还是需要高可用的
03/07 08:44
回复
举报
更多评论
1 评论
32 收藏
分享
返回顶部
顶部