核心概念

WeEvent是一个基于区块链实现的事件中间件，面向用户提供事件发布订阅Publish/Subscribe功能。发布到WeEvent上的事件永久存储，不可篡改，支持事后跟踪和审计。生产者Producer通过WeEvent服务发布事件，事件内容会被记录到区块链FISCO-BCOS上，消费者Consumer从WeEvent服务订阅事件。订阅成功后，只要生产者发布事件，消费者都会及时得到通知。

多机构之间的合作，一般每个机构都会部署自己的WeEvent服务。例如：

机构A通过属于A的WeEvent服务发布事件，机构B通过自己的WeEvent服务订阅事件。如果生产者和发布者属于同一机构，可以使用同一套WeEvent服务。

事件（Event）

事件Event可以简单理解成业务层面的一个消息。一般是终端用户或设备触发。

一个事件分为四部分，关联的主题、事件内容、事件IDEventID和可选的自定义属性。Java映射类参见WeEvent.java。

事件内容是一个字节数组byte[]，对WeEvent是透明的。业务可以存放任何数据，例如字符型的Json、XML ，或者二进制的Protocol Buffer等。

主题（Topic）

业务上一般把数据结构相同，属于同类型的事件归属于同一主题Topic。

每个主题Topic逻辑上都有彼此独立的队列。主题之间是完全隔离的，存储、通知都不会互相影响。

发布事件（Publish）

生产者Producer往某个主题发布事件，WeEvent会将事件永久存储在区块链FISCO-BCOS上，不可篡改，支持事后审核。

事件发布成功后WeEvent会返回一个事件IDEventID ，事件ID代表该事件且具有唯一性。

订阅事件（Subscribe）

消费者Consumer订阅某个主题后，当有生产者往该主题发布事件，消费者会及时收到事件通知。

订阅成功时WeEvent会返回一个的订阅IDSubscriptionID，代表完成一次订阅，订阅ID具有唯一性。

除了实时订阅最新的事件，WeEvent也支持从某个历史事件EventID之后开始订阅。

取消订阅（Unsubscribe）

消费者通过订阅IDSubscriptionID 取消一个订阅后，不会再收到该主题的事件通知。