使用websocketpp实现c++ websocket通讯

1. boost安装

Websocketpp是基于boost::asio开发的一个C++协议库,你的电脑上需要首先安装boost::asio,我选择的是完整安装boost(主要怕万一还得用到其他库,一次性装完方便些)。boost版本我选择的是1.67.0。

1.1 boost下载

大家可以在以下网址处,找到1.67.0的Windows和Linux下载链接。

http://www.boost.org/users/history/version_1_67_0.html

下载完毕后,就要对boost进行编译和安装

1.2 Windows

a. 解压缩下载好的文件,进入源码目录,执行bootstrap.bat批处理文件,结束后会在源码根目录下生成b2.exe和bjam.exe两个文件。

b. 通过命令行执行

bjam.exe stage –toolset=msvc-10.0 architecture=x86 address-model=64 link=static –build-type=complete –with-system –with-thread –with-date_time –with-filesystem –with-serialization

–stagedir=库文件路径

参数解释:

stage 表示仅生成库文件,因为源码下的boost目录已经包含了完整的头文件

–toolset 表示使用哪个版本的vs编译器来编译boost,具体vs版本与这里填写的数字对应关系,请自行搜索

architecture 表示编译时基于的处理器平台,需按照自己的电脑真实配置填写,但通常都是x86

address-model 表示编译为64位还是32位库

link 表示链接为静态库(库文件较大),如果填shared则表示链接为动态库(库文件较小)

–build-type 表示编译类型,填complete则是完整编译

–stagedir 表示生成库文件的保存路径

c. 等待编译结束后(大概需要几分钟),可以在库文件保存路径下看到很多名字很长的lib文件(共享库的话,是lib和dll),具体boost库文件的命名规范

可以自行搜索学习。

接下来在需要使用到Websocketpp库的vs工程里,把boost的头文件目录和库文件目录配置进来即可。

1.3 Linux

a. 同样是解压缩下载好的源码包,进入源码目录,执行

./bootstrap.sh –prefix=/usr/local/boost –with-libraries=all –with-toolset=gcc

执行结束后会生成b2和bjam,上面参数中prefix表示编译后库文件和头文件的安装目录,with-libraries表示需要编译哪些库(all表示所有库),with-toolset表示使用的编译器

这里boost-1.67在哪些gcc版本下测试通过可运行,需要自己到官网上进行查询。我的Linux为CentOS6.6,gcc版本是4.9.4,如果gcc版本不符合的话,建议对gcc进行升级。下面是官网上查到的1.67.0测试通过的一些编译器以及对应的版本 

b. 执行 ./b2 toolset=gcc进行编译,完了之后再执行 ./b2 install进行安装即可。

c. boost安装完毕后,需要将boost的头文件目录和库文件目录添加到环境变量中,头文件是CPLUS_INCLUDE_PATH和C_INCLUDE_PATH,库文件是LIBRARY_PATH和LD_LIBRARY_PATH,具体如何添加这里就不赘述。不过有个地方需要注意,就是boost的头文件目录一定要放在系统的头文件目录之后,Websocketpp头文件目录之前,且不能将boost的头文件目录放到系统头文件目录之下,可能会导致你的程序在make时报一些对象未定义。

2. Websocketpp安装

2.1 下载

可以在Github上找到该项目,我下载的是master版本,如果该项目有更新那么master对应的版本号可能会有出入。

https://github.com/zaphoyd/websocketpp

2.2 Windows

解压缩文件后,源码目录中的websocketpp下就是我们需要的所有头文件,不需要额外的编译,将其放到合适的位置并引入到vs的工程中即可。

2.3 Linux

解压缩文件后,将websocketpp放到合适的位置,并添加到两个头文件的环境变量中,注意要放在boost的头文件目录之后。

3. Websocketpp使用

3.1 整体使用流程

从Websocketpp的例子中,拷贝需要用到的头文件包含和一些类型重定义

#include

 #include

using websocketpp::connection_hdl;

using websocketpp::lib::placeholders::_1;

using websocketpp::lib::placeholders::_2;

using websocketpp::lib::bind;

typedef websocketpp::server server;

typedef server::message_ptr message_ptr;

生成server对象

server m_server;

初始化m_server

m_server.set_access_channels(websocketpp::log::alevel::none); // 设置打印的日志等级

m_server.init_asio(); // 初始化asio

m_server.set_open_handler(bind(&XXXClass::on_open_func_ptr, this, ::_1)); // 绑定websocket连接到来时的回调函数

m_server.set_close_handler(bind(&XXXClass::on_close_func_ptr, this, ::_1)); // 绑定websocket连接断开时的回调函数

m_server.set_message_handler(bind(&XXXClass::on_message_func_ptr, this, ::_1, ::_2)); // 绑定websocket连接有消息到来时的回调函数

上面三个回调函数的原型如下,我是将server对象直接封装到一个类里面使用的,因此这里绑定的回调函数可以直接使用类的方法。Websocketpp也提供了其他很多环节上的回调函数设定,可自行查看其源代码进行了解。

 class XXXClass

{

public :

     void on_open_func_ptr(connection_hdl hdl);

     void on_close_func_ptr(connection_hdl hdl);

     void on_message_func_ptr(connection_hdl hdl, message_ptr msg);

 }

回调参数中的connection_hdl是一个weak_ptr,如果需要将连接存到容器中以便管理,则不能使用传入的hdl,需要使用

server::connection_ptr con = m_server.get_con_from_hdl(hdl);

获得的con是个shared_ptr,再调用

void *con_ptr = con->get();

可以得到这个连接的实际对象的地址,但websocketpp对我们隐藏了其对象的结构,只给了我们一个void*,不过用于在每次回调时区分不同的客户端足够了。

当websocket有新消息到来时,我们可以通过

 std::string msg_str = msg->get_payload();

直接获取到传输的内容。

以上,就是websocketpp集成后的简单使用流程,server对象其实还提供了很多的使用方法以及回调绑定功能,等有时间我再详细研究,现在这几个已经能满足我的需求了。

你可能感兴趣的:(使用websocketpp实现c++ websocket通讯)