核心概念¶
WeEvent
是一个基于区块链实现的事件中间件,面向用户提供事件发布订阅Publish/Subscribe
功能。发布到WeEvent
上的事件永久存储,不可篡改,支持事后跟踪和审计。
生产者Producer
通过WeEvent
服务发布事件,事件内容会被记录到区块链FISCO-BCOS
上,消费者Consumer
从WeEvent
服务订阅事件。订阅成功后,只要生产者发布事件,消费者都会及时得到通知。
生产者Producer
和消费者Consumer
是多对多N:M
的关系(N>=1,M>=1
)。
多机构之间的合作,一般每个机构都会部署自己的WeEvent
服务。例如:机构A通过属于A的WeEvent
服务发布事件,机构B通过自己的WeEvent
服务订阅事件。如果生产者和发布者属于同一机构,可以使用同一套WeEvent
服务。
事件(Event)¶
事件Event
可以简单理解成业务层面的一个消息。一般是终端用户或设备触发。
一个事件分为三部分,关联的主题、事件内容、事件IDEventID
。Java
映射类参见WeEvent.java。
事件内容是一个字节数组byte[]
,对WeEvent
是透明的。业务可以存放任何数据,例如字符型的Json
、XML
,或者二进制的Protocol Buffer
等。
发布事件(Publish)¶
生产者Producer
往某个主题发布事件,WeEvent
会将事件永久存储在区块链FISCO-BCOS
上,不可篡改,支持事后审核。
事件发布成功后WeEvent
会返回一个事件IDEventID
,事件ID代表该事件且具有唯一性。
订阅事件(Subscribe)¶
消费者Consumer
订阅某个主题后,当有生产者往该主题发布事件,消费者会及时收到事件通知。
订阅成功时WeEvent
会返回一个的订阅IDSubscriptionID
,代表完成一次订阅,订阅ID具有唯一性。
除了实时订阅最新的事件,WeEvent
也支持从某个历史事件EventID
之后开始订阅。
取消订阅(Unsubscribe)¶
消费者通过订阅IDSubscriptionID
取消一个订阅后,不会再收到该主题的事件通知。