ZeroMQ概述
相关链接:
官网API:http://api.zeromq.org/
GitHub: https://github.com/zeromq
操作指南:http://zguide.zeromq.org/page:all
ZMQ 指南: https://github.com/anjuke/zguide-cn
官网指南示例GitHub: https://github.com/booksbyus/zguide
涉及API:
zmq_ctx_new
zmq_ctx_new - 创建新的0MQ上下文
void *zmq_ctx_new();
ZMQ上下文是线程安全的,可以根据需要在多个应用程序线程之间共享,而不需要调用方进行任何额外的锁定。
如果成功,zmq_ctx_new()函数将返回新创建的上下文。否则,它将返回NULL。
zmq_socket
zmq_socket - 创建0MQ套接字
void *zmq_socket (void *context, int type);
zmq_socket()函数将在指定的上下文中创建一个0MQ套接字,并返回新创建的套接字
type套接字类型 , 详见链接中文档
zmq_bind
zmq_bind - 绑定套接字接受套接字上的传入连接
int zmq_bind (void *socket, const char *endpoint);
zmq_bind()函数将套接字绑定到endpoint,然后接受该endpoint上的传入连接。
endpoint是一个字符串,包含一个传输://,后面跟着一个地址。
zmq_connect
zmq_connect - 从套接字创建传出连接
int zmq_connect (void *socket, const char *endpoint);
zmq_connect()函数将套接字连接到endpoint,然后接受该endpoint上的传入连接。
endpoint是一个字符串,包含一个传输://,后面跟着一个地址。
如果成功,则zmq_connect()函数返回0;否则,它返回-1
zmq_recv
zmq_recv - 从套接字接收消息部件
int zmq_recv (void *socket, void *buf, size_t len, int flags);
zmq_recv()函数将从socket接收len长度的消息,并将其存储在buf中。如果超过len长度的字节会被截取,如果指定的socket上没有可用的消息,则zmq_recv()函数将阻塞,直到满足请求为止。
如果成功,zmq_recv()函数将返回消息中的字节数。如果失败返回-1,并设置errno 的值。
zmq_send
zmq_send - 在套接字上发送消息
int zmq_send (void *socket, void *buf, size_t len, int flags);
zmq_send()函数将buf中数据通过socket发送出去,len数据长度,flags 可以为 ZMQ_DONTWAIT、ZMQ_SNDMORE。
如果成功,zmq_send()函数将返回消息中的字节数。如果失败返回-1,并设置errno 的值。
zmq_close
zmq_close - 关闭0MQ套接字
int zmq_close (void *socket);
zmq_close()函数将销毁socket套接字。
如果成功,zmq_close()函数将返回零。否则,它将返回-1并设置errno。
zmq_ctx_destroy
zmq_ctx_destroy - 终止一个0MQ上下文
int zmq_ctx_destroy (void *context);
zmq_ctx_destroy()函数将销毁0MQ上下文context。在上下文中打开的套接字上,正在进行的任何阻塞操作都立即返回,带有ETERM的错误代码。
如果成功,zmq_ctx_destroy()函数将返回零。否则,它将返回-1并设置errno。
一、一问一答模式
服务端代码:
// server.cpp
#include "./include/zmq.h"
#pragma comment(lib, "libzmq.lib")
int _tmain(int argc, _TCHAR* argv[])
{
void *context = zmq_ctx_new();
void *responder = zmq_socket(context, ZMQ_REP);
int rc = zmq_bind(responder, "tcp://*:5555");
assert(rc == 0);
while (1) {
char buffer[11] = { 0 };
zmq_recv(responder, buffer, 10, 0);
printf("Received: %s\n", buffer);
zmq_send(responder, "World", 5, 0);
}
return 0;
}
客户端代码:
// client.cpp
#include "include/zmq.h"
#pragma comment(lib, "libzmq.lib")
int _tmain(int argc, _TCHAR* argv[])
{
printf("Connecting to hello world server…\n");
void *context = zmq_ctx_new();
void *requester = zmq_socket(context, ZMQ_REQ);
zmq_connect(requester, "tcp://localhost:5555");
zmq_send(requester, "Hello", 5, 0);
char buffer[11] = { 0 };
zmq_recv(requester, buffer, 10, 0);
printf("Received: %s\n", buffer);
zmq_close(requester);
zmq_ctx_destroy(context);
return 0;
}
二、 消息订阅模式
消息发布者代码:
// Publisher.cpp
int _tmain(int argc, _TCHAR* argv[])
{
void *context = zmq_ctx_new();
void *publisher = zmq_socket(context, ZMQ_PUB);
int rc = zmq_bind(publisher, "tcp://*:5556");
assert(rc == 0);
while (1) {
// Send timestamp to all subscribers
char timestamp[31] = { 0 };
sprintf(timestamp, "timestamp %ld", time(NULL));
int size = zmq_send(publisher, timestamp, 30, 0);
Sleep(5000);
}
zmq_close(publisher);
zmq_ctx_destroy(context);
return 0;
}
消息订阅者代码:
// Subscribe.cpp
int _tmain(int argc, _TCHAR* argv[])
{
void *context = zmq_ctx_new ();
void *subscriber = zmq_socket (context, ZMQ_SUB);
int rc = zmq_connect (subscriber, "tcp://localhost:5556");
assert (rc == 0);
char *filter = "timestamp ";
rc = zmq_setsockopt (subscriber, ZMQ_SUBSCRIBE, filter, strlen (filter));
assert (rc == 0);
char buffer[256] = {0};
int size = zmq_recv (subscriber, buffer, 255, 0);
printf("Timestamp: %s\n", buffer);
zmq_close (subscriber);
zmq_ctx_destroy (context);
return 0;
}