WebSocketpp

WebSocketpp

WebSocketpp 简介

WebSocket是 HTML5 开始提供的一种在单个 TCP 连接上进行全双工通讯的协议。WebSocket 使得 CS 之间的数据交换变得更加简单，允许 S 主动向 C 推送数据。WebSocket 和 HTTP 一样都是应用层的一种协议，可以使用各种编程语言实现之。

WebSocketpp 是一个仅仅由头文件构成的 C++库，它实现了 WebSocket 协议(rfc 6455)，可以在项目中方便简洁地实现客户端和服务器。WebSocketpp 底层使用了 C++ 的 iostream 库和基于 Boost 的 Asio 库。

下载安装

如前所述，WebSocketpp 基于 Boost 的 Asio 库，并且如果要在项目中实现wss，则还需要 libssl-dev 库的支持。

• 安装 Boost 库。
• 安装 libssl-dev 库。
• 安装 WebSocketpp 库。
  • 去官网下载源码，WebSocketpp
  • 创建build目录，用来存放cmake生成的中间文件。
  • cd build && cmake ..，执行MakeList.txt。
  • make && sudo make install，安装 WebSocket 库，默认放在/usr/local/include中。

当前，WebSocketpp 0.8.1 最高兼容的 Boost 版本是 1.69.0，WebSocketpp 的兼容性问题

编译执行样例

# 编译服务器
cd websocketpp/examples/echo_server
g++ echo_server.cpp -o echo_server -lboost_system -lpthread
./echo_server

# 编译客户端
cd websocketpp/examples/echo_client
g++ echo_client.cpp -o echo_client -lboost_system -lpthread
./echo_client

WebSocket 基本概念

如果要在项目中利用 WebSocketpp 实现 WebSocket 客户端或服务器，基本要include两种头文件，一种是决定编程角色的头文件(Role)，另一种是配置编程角色的配置头文件(Config)。

Role

Role 有两种，分别是 Server 和 Client，很好理解。

• 如果开发的是客户端(Client)，则要include <websocketpp/client.hpp>，后面就可以使用websocketpp::client<>模板类来创建不同配置的客户端。
• 如果开发的是服务器(Server)，则要include <websocketpp/server.hpp>，后面就可以使用websocketpp::server<>模板类来创建不同配置的服务器。

Config

Config 主要用来配置 client 或者 server 的属性，WebSocketpp 主要提供了 3 种配置：

• config::core，有限功能的配置，基于 C++11 的功能，不需要 Boost 库支持。
• config::asio，使用 Boost 的 Asio 库，提供完整的 ws 功能。
• config::asio_tls，使用 Boost 的 Asio 库，提供完整的 wss 功能。

这样，根据不同的 Role 和 Config 组合，可以实现各种各类的 Client 和 Server，如下：

Server_config	Server	Client	Client_config
core	core.hpp	core_client.hpp	core_client
asio	asio_no_tls.hpp	asio_no_tls_client.hpp	asio_client
asio_tls	asio.hpp	asio_client.hpp	asio_tls_client

如需要开发一个基于 Boost Asio，使用 ws 的服务器的话，要包含的头文件如下：

#include <websocketpp/server.hpp>
#include <websocketpp/config/asio_no_tls.hpp>

EndPoint

EndPoint 看成是最后需要实现的具体的物件，即哪种配置的服务器或者客户端。

如需要开发一个基于 Boost Asio，使用 ws 的服务器的话，完整的开头应该如下：

#include <websocketpp/server.hpp>
#include <websocketpp/config/asio_no_tls.hpp>

typedef websocketpp::server<websocketpp::config::asio> server;

WebSocketpp 框架的基本步骤

相关基础介绍

• websocketpp::connection_hdl，用来识别当前连接用的，可以通过endpoint.get_con_formhdl获取连接信息。
• websocketpp::server<>::message_ptr，保存了收到的数据，msg.get_payload()返回的是具体的数据，get_opcode()返回的是数据的编码格式。
• endpoint.send(hdl, data_str, data_code)，用于发送数据，需要指明发送的内容和编码格式。
• 主动关闭连接：conn->close(cvValue, strReason)
• 绑定的事件列表，详细可查看事件列表

open([endpint *,] connection_hdl);
fail([endpint *,] connection_hdl);
close([endpint *,] connection_hdl);
message([endpint *,] connection_hdl, message_ptr);
tls_context_ptr tls_init(connection_hdl);

endpoint.set_open_handler(std::bind(&on_open, &endpoint, ::_1 ));
endpoint.set_fail_handler(std::bind(&on_fail, &endpoint, ::_1 ));
endpoint.set_message_handler(std::bind(&on_message, &endpoint,