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, 
  • 6
    点赞
  • 26
    收藏
    觉得还不错? 一键收藏
  • 4
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论 4
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值