如何使用CZMQ-4.0.2新zsock API创建发布/订阅架构?

时间:2017-07-10 07:00:30

标签: c++ c zeromq

我想使用CZMQ-4.0.2创建发布/订阅架构,但我无法理解如何使用新的 zsock API。

有人能指出一些使用新API的例子吗?

1 个答案:

答案 0 :(得分:6)

tldr;

Examples are on the bottom of the site

小解释

我假设您要求CZMQ具体使用,而不是如何使用ZeroMQ套接字,以及PUB / SUB模式的怪癖。

使用CZMQ时,您无需担心上下文,而是在内部完成。 zsock_new函数family返回指向zsock_t的指针,这是socket的不透明标识符。你需要记得在完成后调用zsock_destroy(&socket),以避免内存泄漏。

在大多数常见用法中,您无需担心连接和绑定,因为zsock_new_XXX负责处理。要了解采取了哪些措施,您可以查看manual

//  Create a PUB socket. Default action is bind.
CZMQ_EXPORT zsock_t *
    zsock_new_pub (const char *endpoint);
//  Create a SUB socket, and optionally subscribe to some prefix string. Default
//  action is connect.
CZMQ_EXPORT zsock_t *
    zsock_new_sub (const char *endpoint, const char *subscribe);

如果您计划进行一些不寻常的绑定/连接,可以在endpoint添加前缀。 @表示绑定,>连接。

zsock_t *sock = zsock_new_push("@ipc://test");

现在,要发送消息,您可以使用大量方法(zsock_sendzmsg_sendzstr_sendzstr_sendxzstr_sendfzframe_send ),最通用的是zsock_send。它有像原型一样的printf,你需要传递消息的图片。此字符串中的每个字符表示消息中的单个帧(或更多帧,因为您还可以传递另一个消息)。它在here中描述:

//  Send a 'picture' message to the socket (or actor). The picture is a
//  string that defines the type of each frame. This makes it easy to send
//  a complex multiframe message in one call. The picture can contain any
//  of these characters, each corresponding to one or two arguments:
//
//      i = int (signed)
//      1 = uint8_t
//      2 = uint16_t
//      4 = uint32_t
//      8 = uint64_t
//      s = char *
//      b = byte *, size_t (2 arguments)
//      c = zchunk_t *
//      f = zframe_t *
//      h = zhashx_t *
//      U = zuuid_t *
//      p = void * (sends the pointer value, only meaningful over inproc)
//      m = zmsg_t * (sends all frames in the zmsg)
//      z = sends zero-sized frame (0 arguments)
//      u = uint (deprecated)
//
//  Note that s, b, c, and f are encoded the same way and the choice is
//  offered as a convenience to the sender, which may or may not already
//  have data in a zchunk or zframe. Does not change or take ownership of
//  any arguments. Returns 0 if successful, -1 if sending failed for any
//  reason.
CZMQ_EXPORT int
zsock_send (void *self, const char *picture, ...);

可能不清楚的是void *self,它实际上是我们从zsock_new返回的zsock_t *。在原型中,它被声明为void *,因为此函数也接受zactor_t *

重要提示:Does not change or take ownership of any arguments.。您需要在发送后释放/销毁数据。

接收看起来非常相似。它就像sscanf,zsock_recv创建了对象,所以你需要处理内存。

ZeroMQ和CZMQ之间的行为差​​异很大,是LINGER套接字选项。对于ZeroMQ,它是无限的(-1),其中CZMQ的默认值为0(无阻塞)。因此,只要您zsock_send后跟zsock_destroy,您的消息就可能无法发送。可以使用zsock_set_linger或全局zsys_set_linger为套接字单独设置Linger值。

发布商示例

#include <czmq.h>

int main(int argc, char ** argv) {
  zsock_t *socket = zsock_new_pub("ipc://example.sock");
  assert(socket);

  while(!zsys_interrupted) {
    zsys_info("Publishing");
    zsock_send(socket, "sss", "TOPIC", "MESSAGE PART", "ANOTHER");
    zclock_sleep(1000);
  }

  zsock_destroy(&socket);
  return 0;
}

订阅者示例

#include <czmq.h>

int main(int argc, char ** argv) {
  zsock_t *socket = zsock_new_sub("ipc://example.sock", "TOPIC");
  assert(socket);

  char *topic;
  char *frame;
  zmsg_t *msg;
  int rc = zsock_recv(socket, "sm", &topic, &msg);
  assert(rc == 0);

  zsys_info("Recv on %s", topic);
  while(frame = zmsg_popstr(msg)) {
    zsys_info("> %s", frame);
    free(frame);
  }
  free(topic);
  zmsg_destroy(&msg);

  zsock_destroy(&socket);
  return 0;
}