WeEvent

关于WeEvent使用的一些常见问题和答案都会整理归档到这里。

简单的接口调用异常一般从错误码中就可以得到答案WeEvent错误码 。有任何意见和建议，欢迎你参与WeEvent项目讨论Issues 。

  • 怎么部署WeEvent和FISCO-BCOS？

建议将WeEvent和FISCO-BCOS节点部署在同一网段/逻辑区，比如DMZ区。

  • WeEvent的服务访问授权机制是怎么样的？

WeEvent访问权限控制基于HTTPS + IP白名单，STOMP和MQTT协议还支持协议定义的账号/密码机制。

  • 如何选择各种接入协议，JsonRPC、RESTful、STOMP还是MQTT？

    • Java程序
      • 如果是Spring服务，有内置的org.springframework.boot:spring-boot-starter-websocket支持，推荐使用STOMP。
      • 如果是其他Java程序，建议使用WeEvent提供的Java SDK。
    • 其他语言
      • 生产者Producer建议使用RESTful/JsonRPC ，简单方便。
      • 消费者Consumer因为涉及到事件的持续Push，建议使用STOMP协议接入。
    • MQTT主要面向物联网IoT设备的接入。
  • WeEvent服务的高可用性方案是怎么样的？

WeEvent除了订阅之外的功能，都是无状态的请求，通过多实例的负载均衡来保证高可用性。订阅功能按是否为长连接分成两类：

  • 使用长连接的协议，比如STOMP这部分功能基于长连接，订阅上下文以连接为中心，连接关闭则订阅会自动关闭。这种属于集群Cluster方案。WeEvent通过Nginx的负载均衡Load balance实现。
  • 使用短链接的协议，比如JsonRPC/RESTful/MQTT这部分功能基于短连接，事件订阅的上下文不依赖于连接，连接关闭后订阅仍然存在。这种属于主备Replication方案。WeEvent通过Zookeeper实现，如果没有为WeEvent服务配置Zookeeper服务，则无法使用这部分功能。
    • WeEvent怎么处理发布事件的去重？

WeEvent不处理发布事件的去重。

当服务超时或者机器宕机时，一般的逻辑是重试，这种策略很容易出现重复请求。但是整个业务系统内，不只在WeEevnt服务的边界会出现这种情况，任何一个服务边界都会出现。 建议业务统一处理，比如在事件内容里带一个唯一IDUUID，消费的时候使用UUID字段来判断该事件是否已经处理过。

注意：EventID不是用来去重的，同一事件每成功发布一次，都会生成不同的EventID。

  • 服务状态检查脚本check-service.sh出现"deploy contract failed"

    • 检查WeEvent到FISCO-BCOS的连接及其配置。
    • 检查FISCO-BCOS节点是否正常出块。
  • WeEvent事件内容支持的最大长度是多少？

事件内容最大长度为10 K字节 Byte， 字符集编码为UTF8。

  • WeEvent到区块链FISCO-BCOS节点之间的网络故障怎么处理？

建议为WeEvent配置2个属于不同网段的FISCO-BCOS节点。这样WeEvent服务会随机选用一个可用的节点使用，做到一定程度的网络容灾。

  • 怎么使用通配符进行订阅WeEvent支持通配符按层次订阅，和MQTT的定义完全一致。包括层次分隔符”/”，单层通配符”+”，多层通配符”#”。例如，“#”可以订阅到系统内所有的主题。“com/+”可以订阅到主题“com/weevent”和“com/webank“，但是无法订阅到“com/weevent/abc”。“com/#”则可以订阅到上述三个主题。详情请参见MQTT协议。

  • 服务启动时为什么会出现Failed to initialize the client-side SSLContext错误？

  1. javax.net.ssl.SSLException: Failed to initialize the client-side SSLContext: Input stream not contain valid certificates

这个问题涉及到JDK加密算法的实现。Oracle JDK里带了这个算法实现，Open JDK直到 1.9版本才有。所以在CentOS系统中，如果使用 Open JDK 1.9以下版本，WeEvent启动时会出现以下异常。请升级Open JDK版本到1.9或者使用Oracle JDK。

  • TODO