我想使用CZMQ-4.0.2创建发布/订阅架构,但我无法理解如何使用新的 zsock
API。
有人能指出一些使用新API的例子吗?
答案 0 :(得分:6)
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_send
,zmsg_send
,zstr_send
,zstr_sendx
,zstr_sendf
,zframe_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;
}