websocket_session类 参考

WebSocket会话类 更多...

#include <websocket.hpp>

类 websocket_session 继承关系图:

Public 类型
using	message_handler = function<void(const string&, websocket_opcode)>
	消息处理器类型
using	close_handler = function<void(websocket_status, const string&)>
	关闭处理器类型
using	error_handler = function<void(const exception&)>
	错误处理器类型

Public 成员函数
	websocket_session (unique_ptr< tcp_socket > sock, websocket_server *server=nullptr)
	构造函数
	~websocket_session ()
	析构函数
void	start ()
	启动会话
void	close (websocket_status status=websocket_status::NORMAL_CLOSURE, const string &reason="")
	关闭连接
void	stop ()
	停止会话
bool	send (const string &data, websocket_opcode opcode=websocket_opcode::TEXT)
	发送文本/二进制消息
bool	send_binary (const string &data)
	发送二进制消息
bool	is_open () const noexcept
	检查连接是否开启
void	set_message_handler (message_handler handler)
	设置消息处理器
void	set_close_handler (close_handler handler)
	设置关闭处理器
void	set_error_handler (error_handler handler)
	设置错误处理器
tcp_socket &	socket () noexcept
	获取底层socket引用
const tcp_socket &	socket () const noexcept
	获取底层socket常量引用
ssl_socket *	ssl_socket_ptr () noexcept
	获取SSL socket指针
const ssl_socket *	ssl_socket_ptr () const noexcept
	获取SSL socket常量指针

额外继承的成员函数
Protected 成员函数 继承自 enable_shared_from_this< websocket_session >
	enable_shared_from_this () noexcept
	构造函数
shared_ptr< websocket_session >	shared_from_this ()
	获取指向自身的共享指针

详细描述

WebSocket会话类

表示单个WebSocket连接，负责帧的解析、发送、心跳和生命周期管理。

使用示例：

auto session = make_shared<websocket_session>(move(sock));
session->set_message_handler([](const string& msg, websocket_opcode opcode) {
    if (opcode == websocket_opcode::TEXT) {
        println("Text: ", msg);
    } else {
        // 处理二进制消息
    }
});
session->set_close_handler([](websocket_status status, const string& reason) {
    println("Closed: ", static_cast<int>(status), " - ", reason);
});
session->start();

在文件 websocket.hpp 第 211 行定义.

构造及析构函数说明

websocket_session()

websocket_session::websocket_session ( unique_ptr< tcp_socket > sock, websocket_server * server = nullptr )

explicit

构造函数

参数

sock	TCP/SSL socket
server	所属服务器

引用了 websocket_session().

被这些函数引用 websocket_session() , 以及 ~websocket_session().

成员函数说明

close()

void websocket_session::close	(	websocket_status	status = websocket_status::NORMAL_CLOSURE,
		const string &	reason = "" )

关闭连接

参数

status	关闭状态码（默认NORMAL_CLOSURE）
reason	关闭原因

引用了 close().

被这些函数引用 close().

is_open()

bool websocket_session::is_open ( ) const

inlinenoexcept

检查连接是否开启

返回

开启返回true

在文件 websocket.hpp 第 314 行定义.

send()

bool websocket_session::send	(	const string &	data,
		websocket_opcode	opcode = websocket_opcode::TEXT )

发送文本/二进制消息

参数

data	消息数据
opcode	操作码（默认TEXT）

返回

发送成功返回true

引用了 data() , 以及 send().

被这些函数引用 send() , 以及 send_binary().

send_binary()

bool websocket_session::send_binary ( const string & data )

inline

发送二进制消息

参数

data

消息数据

返回

发送成功返回true

在文件 websocket.hpp 第 308 行定义.

引用了 BINARY, data(), send() , 以及 send_binary().

被这些函数引用 send_binary().

set_close_handler()

void websocket_session::set_close_handler ( close_handler handler )

inline

设置关闭处理器

参数

handler

处理函数

在文件 websocket.hpp 第 326 行定义.

引用了 move().

set_error_handler()

void websocket_session::set_error_handler ( error_handler handler )

inline

设置错误处理器

参数

handler

处理函数

在文件 websocket.hpp 第 332 行定义.

引用了 move().

set_message_handler()

void websocket_session::set_message_handler ( message_handler handler )

inline

设置消息处理器

参数

handler

处理函数

在文件 websocket.hpp 第 320 行定义.

引用了 move().

socket() [1/2]

const tcp_socket & websocket_session::socket ( ) const

inlinenoexcept

获取底层socket常量引用

返回

socket常量引用

在文件 websocket.hpp 第 344 行定义.

socket() [2/2]

tcp_socket & websocket_session::socket ( )

inlinenoexcept

获取底层socket引用

返回

socket引用

在文件 websocket.hpp 第 338 行定义.

ssl_socket_ptr() [1/2]

const ssl_socket * websocket_session::ssl_socket_ptr ( ) const

inlinenoexcept

获取SSL socket常量指针

返回

SSL socket常量指针，若非SSL连接返回nullptr

在文件 websocket.hpp 第 356 行定义.

ssl_socket_ptr() [2/2]

ssl_socket * websocket_session::ssl_socket_ptr ( )

inlinenoexcept

获取SSL socket指针

返回

SSL socket指针，若非SSL连接返回nullptr

在文件 websocket.hpp 第 350 行定义.

start()

void websocket_session::start

(

)

启动会话

启动读、写、心跳三个线程。

引用了 start().

被这些函数引用 start().

---

该类的文档由以下文件生成:

• websocket.hpp