WeEvent¶

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

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

怎么部署WeEvent和FISCO-BCOS？

建议将WeEvent和FISCO-BCOS节点部署在同一网段/逻辑区，比如DMZ区。
WeEvent的服务访问授权机制是怎么样的？

WeEvent访问权限控制基于HTTPS + IP白名单，STOMP和MQTT协议还支持协议定义的账号/密码机制。
如何选择各种接入协议，RESTful、JsonRPC、STOMP还是MQTT？
- 协议之间的区别
  
  STOMP协议是WeEvent推荐协议，关于订阅发布的所有特性，以及未来的扩展功能都会支持。
  
  JsonRPC协议是对STOMP协议标准功能集的一个补充。
RESTful主要是给Web开发使用，内置的Governance模块就有大量使用。

MQTT主要面向物联网IoT设备的接入。
- Java程序
  - 如果是Spring服务，有内置的org.springframework.boot:spring-boot-starter-websocket支持，推荐使用STOMP。
  - 如果是其他Java程序，建议使用WeEvent提供的Java SDK。
- 其他语言
  - 生产者Producer建议使用RESTful/JsonRPC ，简单方便。
  - 消费者Consumer因为涉及到事件的持续Push，建议使用STOMP协议接入。
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错误？
```
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。
如果用户使用区块链FISCO-BCOS 1.3 ，则需要注意以下问题。在安装governance模块，需要安装WeBase 1.0.4。具体安装步骤，请参见WeBase安装。

以下两点需要特别注意：
- 由于WeBase和WeEvent端口冲突，需修改WeBase一键部署源码包中的common.properties文件，配置已有的区块链和服务端口。具体如下:
```
mgr.port=8182
front.port=8181
node.p2pPort=30300
node.channelPort=20200
node.rpcPort=8545
if.exist.fisco=yes
```
- 需要修改webase-node-mgr服务中的conf/application.yml文件。将isUseSecurity和isDeleteInfo都改成false。