Skip to main content
版本:v1.7.0

运行 eventmesh-sdk-java demo

Maven Central

EventMesh-sdk-java作为客户端,与eventmesh-runtime通信,用于完成消息的发送和接收。

EventMesh-sdk-java支持异步消息和广播消息。异步消息表示生产者只发送消息,不关心回复消息。广播消息表示生产者发送一次消息,所有订阅广播主题的消费者都将收到消息

EventMesh-sdk-java支持HTTP,TCP 和 GRPC 协议。

TCP, HTTP 和 GRPC 示例都在eventmesh-examples模块下

1. TCP DEMO

异步消息

  • 创建主题TEST-TOPIC-TCP-ASYNC,可以通过 rocketmq-console 或者 rocketmq tools 命令

  • 启动消费者,订阅上一步骤已经创建的Topic

运行 org.apache.eventmesh.tcp.demo.sub.eventmeshmessage.AsyncSubscribe 的main方法
  • 启动发送端,发送消息
运行 org.apache.eventmesh.tcp.demo.pub.eventmeshmessage.AsyncPublish 的main方法

广播消息

  • 创建主题TEST-TOPIC-TCP-BROADCAST,可以通过 rocketmq-console 或者 rocketmq tools 命令

  • 启动消费端,订阅上一步骤已经创建的Topic

运行 org.apache.eventmesh.tcp.demo.sub.eventmeshmessage.AsyncSubscribeBroadcast 的main方法
  • 启动发送端,发送广播消息
运行 org.apache.eventmesh.tcp.demo.pub.eventmeshmessage.AsyncPublishBroadcast 的main方法

更多关于TCP部分的内容,请参考 EventMesh TCP

2. HTTP演示

对于HTTP,eventmesh-sdk-java对对于异步事件实现了发送与订阅

在演示中,Java类LiteMessagecontent字段表示一个特殊的协议,因此,如果您要使用eventmesh-sdk-java的http-client,则只需设计协议的内容并在同一时间提供消费者的应用程序。

异步事件

生产者将事件发送给下游即可,无需等待响应

  • 创建主题TEST-TOPIC-HTTP-ASYNC,可以通过rocketmq-console或者rocketmq tools 命令

  • 启动消费端,订阅Topic

    异步事件消费端为spring boot demo,运行demo即可启动服务并完成Topic订阅

运行 org.apache.eventmesh.http.demo.sub.SpringBootDemoApplication 的main方法
  • 启动发送端,发送消息
运行 org.apache.eventmesh.http.demo.pub.eventmeshmessage.AsyncPublishInstance 的main方法

更多关于HTTP部分的内容,请参考 EventMesh HTTP

3. GRPC 演示

eventmesh-sdk-java 实现了 gRPC 协议. 它能异步和同步发送事件到 eventmesh-runtime. 它可以通过webhook和事件流方式订阅消费事件, 同时也支持 CNCF CloudEvents 协议.

异步事件发送 和 webhook订阅

Async生产者 异步发送事件到 eventmesh-runtime, 不需要等待事件储存到 event-store 在webhook 消费者, 事件推送到消费者的http endpoint url。这个URL在消费者的 Subscription 模型定于. 这方法跟前面的Http eventmsh client类似。

  • 在rocketmq 创建主题 TEST-TOPIC-GRPC-ASYNC
  • 启动 publisher 发送事件
运行 org.apache.eventmesh.grpc.pub.eventmeshmessage.AsyncPublishInstance 的main方法
  • 启动 webhook 消费者
运行 org.apache.eventmesh.grpc.sub.app.SpringBootDemoApplication 的main方法

同步事件发送和事件流订阅

同步生产者 发送事件到 eventmesh-runtime, 同时等待事件储存到 event-store 在事件流消费者,事件以流的形式推送到 ReceiveMsgHook 客户端。 这方法类似 eventmesh client.

  • 在rocketmq 创建主题 TEST-TOPIC-GRPC-RR
  • 启动 Request-Reply publisher 发送事件
运行 org.apache.eventmesh.grpc.pub.eventmeshmessage.RequestReplyInstance 的main方法
  • 启动 stream subscriber
运行 org.apache.eventmesh.grpc.sub.EventmeshAsyncSubscribe 的main方法

批量事件发布

批量发布多个事件到 eventmesh-runtime. 这是异步操作

  • 在rocketmq 创建主题 TEST-TOPIC-GRPC-ASYNC
  • 启动 publisher 来批量发布事件
运行 org.apache.eventmesh.grpc.pub.eventmeshmessage.BatchPublishInstance 的main方法

更多关于 gRPC 部分的内容,请参考 EventMesh gRPC

3.4 测试

请参考EventMesh StoreEventMesh Runtime 完成运行环境的部署

完成 store 和 runtime 的部署后,就可以在 eventmesh-examples 模块下运行我们的 demo 来体验 eventmesh 了:

TCP Sub

cd bin
sh tcp_eventmeshmessage_sub.sh

TCP Pub

cd bin
sh tcp_pub_eventmeshmessage.sh

TCP Sub Broadcast

cd bin
sh tcp_sub_eventmeshmessage_broadcast.sh

TCP Pub Broadcast

cd bin
sh tcp_pub_eventmeshmessage_broadcast.sh

HTTP Sub

cd bin
sh http_sub.sh

HTTP Pub

cd bin
sh http_pub_eventmeshmessage.sh

之后, 你可以在 /logs 目录下面看到不同模式的运行日志