转载：总结使用libwebsockets

最新推荐文章于 2024-09-21 16:33:21 发布
最新推荐文章于 2024-09-21 16:33:21 发布
阅读量1.7w 收藏 22
点赞数 6
分类专栏： web
  • arm板运行libwebsockets创建socket失败，解决办法，把ipv6的宏定义注释掉

  • 作者：邹祁峰
  • 邮箱：Qifeng.zou.job@hotmail.com
  • 博客：http://blog.csdn.net/qifengzou
  • 日期：2015.12.13~2015.12.14
  • 来源于祁峰"的CSDN博客:http://blog.csdn.net/qifengzou/article/details/50281545点击打开链接

1 引言

    WebSockets是HTML5支持的一种让浏览器与服务器全双工通信的协议，其以更小的开销高效的提供了Web连接。相较于经常推送实时数据到客户端甚至通过维护两个HTTP连接来模拟全双工连接的旧的轮询或长轮询来说，这将有效的减少网络流量与延迟。如果想知道更多关于WS协议的信息，请自行查找，在此不再复述。本篇的重点是讲述如何使用C语言实现的libwebsockets进行进一步的开发。
   由于之前系统上线时间紧迫，为了缩短开发时间，因此使用nginx作为WS代理，让其将接收WS连接请求，并将WS协议传输的数据BODY转发到接入层。但是使用nginx作为WS代理时，当终端与nginx建立一个WS连接，nginx就会与接入层建立一个TCP连接。因此，这将造成不管单台nginx服务器的配置多么牛逼，该服务器最多只能支持65535个并发，并且多了一个代理层，性能也会受到一定影响。
   解决以上问题的办法就是：让接入层直接支持WS协议。由于系统接入层使用的是C语言开发，因此，本人选择以开源软件libwebsockets为基础，与原系统接入层进行融合。以下是系统改造前后的架构对比图：[注：后文将libwebsockets简写为LWS]

图1 改造对比图

2 改造LWS

2.1 支持libev

   由于LWS库默认情况下使用poll机制管理ws连接，为了让系统更高效的管理更多的并发，需要开启对libev的支持。可将CMakeLists.txt中的LWS_WITH_LIBEV选项由OFF改为ON来实现，如下图所示:

图2 开启LIBEV

2.2 改造libev

   从图1中的改造后的架构图中可以看出，改造后的WS接入层需要管理与终端的ws连接，同时需要管理与路由层各服务器的TCP连接，还得负责相邻层次间数据的转发工作。而目前LWS并未支持多线程，如果采用多线程的方式改造WS接入层，将可能出现无法预估的后果。因此，本人决定使用单进程单线程的方式，并使用LWS架构接管WS接入层与路由层之间的TCP连接。而要实现让LWS架构接管WS接入层与路由层之间的TCP连接，则需要对LWS库进行如下改造：

2.2.1 函数定义

   由于LWS库的Makefile编译选项中设置了-fvisibility=hidden，因此，如果想让LWS库中实现的函数能被库外调用，则在函数实现时必须使用LWS_VISIBLE进行显示说明。在LWS库中的libev.c中添加如下函数：[注：关于libev的用法, 请自行查询]

[cpp]  view plain  copy
  1. /****************************************************************************** 
  2.  **函数名称: lws_libev_timer_start 
  3.  **功    能: 添加计时器 
  4.  **输入参数: 
  5.  **     context: lws上下文 
  6.  **     timer: 计时器 
  7.  **输出参数: NONE 
  8.  **返    回: VOID 
  9.  **实现描述: 将计时器加入到libev loop对象 
  10.  **注意事项: 
  11.  **作    者: # Qifeng.zou # 2015.12.10 # 
  12.  ******************************************************************************/  
  13. LWS_VISIBLE void lws_libev_timer_start(struct lws_context *context, ev_timer *timer)  
  14. {  
  15.     ev_timer_start(context->io_loop, timer);  
  16. }  
  17.   
  18. /****************************************************************************** 
  19.  **函数名称: lws_libev_timer_stop 
  20.  **功    能: 停止计时器 
  21.  **输入参数: 
  22.  **     context: lws上下文 
  23.  **     timer: 计时器 
  24.  **输出参数: NONE 
  25.  **返    回: VOID 
  26.  **实现描述: 将计时器从libev loop中删除 
  27.  **注意事项: 
  28.  **作    者: # Qifeng.zou # 2015.12.10 # 
  29.  ******************************************************************************/  
  30. LWS_VISIBLE void lws_libev_timer_stop(struct lws_context *context, ev_timer *timer)  
  31. {  
  32.     ev_timer_stop(context->io_loop, timer);  
  33. }  
  34.   
  35. /****************************************************************************** 
  36.  **函数名称: lws_libev_io_start 
  37.  **功    能: 开启IO帧听 
  38.  **输入参数: 
  39.  **     context: lws上下文 
  40.  **     io: IO对象 
  41.  **输出参数: NONE 
  42.  **返    回: VOID 
  43.  **实现描述: 将io对象加入到libev loop中 
  44.  **注意事项: 
  45.  **作    者: # Qifeng.zou # 2015.12.10 # 
  46.  ******************************************************************************/  
  47. LWS_VISIBLE void lws_libev_io_start(struct lws_context *context, ev_io *io)  
  48. {  
  49.     ev_io_start(context->io_loop, io);  
  50. }  
  51.   
  52. /****************************************************************************** 
  53.  **函数名称: lws_libev_io_stop 
  54.  **功    能: 停止IO帧听 
  55.  **输入参数: 
  56.  **     context: lws上下文 
  57.  **     io: IO对象 
  58.  **输出参数: NONE 
  59.  **返    回: VOID 
  60.  **实现描述: 将io对象从libev loop中删除 
  61.  **注意事项: 
  62.  **作    者: # Qifeng.zou # 2015.12.10 # 
  63.  ******************************************************************************/  
  64. LWS_VISIBLE void lws_libev_io_stop(struct lws_context *context, ev_io *io)  
  65. {  
  66.     ev_io_stop(context->io_loop, io);  
  67. }  

代码1 函数定义

2.2.2 函数声明

   完成以上函数的定义后，还需按照如下的格式在libwebsockets.h中进行函数声明。如下所示：

[cpp]  view plain  copy
  1. LWS_VISIBLE LWS_EXTERN void lws_libev_timer_start(struct lws_context *context, ev_timer *timer);  
  2. LWS_VISIBLE LWS_EXTERN void lws_libev_timer_stop(struct lws_context *context, ev_timer *timer);  
  3. LWS_VISIBLE LWS_EXTERN void lws_libev_io_start(struct lws_context *context, ev_io *io);  
  4. LWS_VISIBLE LWS_EXTERN void lws_libev_io_stop(struct lws_context *context, ev_io *io);  

代码2 函数声明

   完成对LWS库中libev的改造后，重新编译和安装LWS库，这时便可利用以上函数将外部建立的TCP连接注入到LWS框架，让LWS框架中的libev接管外部TCP连接的数据接收、数据发送、超时处理等处理。WS接入层与路由层之间的TCP连接，就是通过这种方式让LWS框架接管的。[注意：一定要按照以上格式声明函数，否则可能导致依赖此库的程序无法访问声明的函数]

3 使用LWS

3.1 注册协议回调

   终端向WS服务器发起ws连接请求时，一般会在协议头中通过Sec-WebSockets-Protocol指明协议名。而开源libwebsockets库通过对外提供注册协议回调的接口为用户自定义协议提供服务，注册协议回调的接口中将会指明协议名、以及对应的处理回调、自定义数据的大小等字段。其注册的方式如下所示：
[cpp]  view plain  copy
  1. /* 注册协议回调配置表 */  
  2. struct libwebsocket_protocols g_aws_protocols[] =  
  3. {  
  4.     {  
  5.         "chat",                                         /* 协议名：其与Sec-Websockets-Protocol字段对应 */  
  6.         aws_callback_im_hdl,                            /* 回调函数：协议对应的回调处理函数 */  
  7.         sizeof(aws_im_session_data_t),                  /* 自定义数据空间大小：每个ws连接均会分配一个自定义数据空间 */  
  8.         0,                                              /* max frame size / rx buffer */  
  9.     },  
  10.     {  
  11.         "push",                                         /* 协议名 */  
  12.         aws_callback_push_hdl,                          /* 回调函数 */  
  13.         sizeof(aws_push_session_data_t),                /* 自定义数据空间大小 */  
  14.         0,                                              /* max frame size / rx buffer */  
  15.     },  
  16.     { NULL, NULL, 0, 0 }                                /* 结束标识 */  
  17. };  
 
 
 
  代码3 注册协议回调 
 
 
    注意：如果终端向WS服务器发起的ws连接请求中并未指明Sec-WebSockets-Protocol字段，那么libwebsockets库默认使用注册协议回调配置表中的第一个配置项为该ws连接的提供服务。 
 
 3.2 回调函数参数
 
    回调函数用于处理对应协议各阶段的数据。该回调函数的各参数含义见表１所示： 
 
 
  表1 回调函数参数 
 
 
 
 
  
序号变量名类型含义
01contextstruct lws_context *含义：全局上下文
 备注：这是libwebsockets框架的上下文，负责所有ws连接的维护和管理
02wsistruct lws *含义：WS连接对象
 备注：每个ws连接均有一个wsi对象与之对应
03reasonenum lws_callback_reasons含义：调用回调的原因
 备注：一个协议只对应回调函数，但是调用回调函数的情况很多，且回调原因不同，参数in的含义也会发生变化。
04uservoid *含义：用户自定义数据
 备注：每个ws连接均会带有一个用户自定义数据，可在其中放入用户关心的信息。其大小与协议回调注册表中对应配置项中的sizeof()向对应。
05invoid *含义：输入数据
 备注：根据调用回调的原因，该输入数据的含义发生变化
06lensize_t含义：输入数据的长度
 
  
 
   
     回调函数参数中的reason指明了调用回调函数的原因，其也代表了ws连接正处于哪个处理阶段或状态。比如：在ws连接创建成功后，应该进行自定义数据的初始化；在ws连接销毁阶段，应该释放自定义数据中用户分配的空间等。因此，要正确的编写协议回调函数就必须对reason各状态值有正确的理解。以下将对服务器端开发者需要关心的reason状态值的进行解释： 
   
 
    表2 reason状态值 
     
    
序号状态值含义
01LWS_CALLBACK_WSI_CREATE含义：正在创建ws连接对象
 备注：此时表1中的wsi对象和user对象依然为空指针，因此，还不能初始化用户自定义对象。
 回调函数的参数含义：
     context: 全局上下文
     wsi: 空指针
     user: 空指针
 　in: 空指针
 　len: 0
02LWS_CALLBACK_FILTER_PROTOCOL_CONNECTION含义：使用lws库的人员可以在此过滤协议。
 备注：在此处返回非0值时，lws库将会关闭该链接；该处返回0时，表示ws连接已经建立成功。此时表1中的wsi对象和user对象已不为空，因此，此时可以对用户自定义对象user进行初始化处理。
 回调函数的参数含义：
     context: 全局上下文
     wsi: ws连接对象
     user: 用户自定义数据
 　in: 空指针
 　len: 0
 [注意：测试中发现同一个wsi可能多次由该reason调用回调，且该wsi对象的用户自定义数据的指针会发生变化，导致用户设置的数据丢失，造成严重后果。解决方案：不让lws维护对象，而是我们自己申请和维护数据！]
 
03LWS_CALLBACK_LOCK_POLL含义：添加保护ws连接状态的互斥锁
 备注：当采用的是多线程编程，则在此添加互斥锁保护ws连接相关状态，防止冲突。如果是单进程方式，则无需做任何操作。
04LWS_CALLBACK_UNLOCK_POLL含义：解除保护ws连接状态的互斥锁
 备注：当采用的是多线程编程，则在此解除互斥锁。如果是单进程方式，则无需做任何操作。
05LWS_CALLBACK_RECEIVE含义：收到一帧完整数据
 备注：表示ＷＳ服务端收到客户端发送过来的一帧完整数据，此时表1中的in表示收到的数据，len表示收到的数据长度。需要注意的是：指针in的回收、释放始终由LWS框架管理，只要出了回调函数，该空间就会被LWS框架回收。因此，开发者若想将接收的数据进行转发，则必须对该数据进行拷贝。
 回调函数的参数含义：
     context: 全局上下文
     wsi: ws连接对象
     user: 用户自定义数据
     in: 接收数据的起始地址
     len: 接收数据的长度
06LWS_CALLBACK_SERVER_WRITEABLE 
        
 
         含义：此ws连接为可写状态 
         
 
        
 备注：表示wsi对应的ws连接当前处于可写状态，即：可发送数据至客户端。
 回调函数的参数含义：
     context: 全局上下文
     wsi: ws连接对象
     user: 用户自定义数据
 　in: 空指针
 　len: 0
07LWS_CALLBACK_CLOSED含义：ws连接已经断开
 备注：不能在此释放内存空间，否则存在内存泄漏的风险！！！因为连接断开时，并不总是会回调LWS_CALLBACK_CLOSED的处理！
 LWS_CALLBACK_WSI_DESTROY含义：正在销毁ws连接对象
 备注：表示libwebsockets框架即将销毁wsi对象。此时如果用户自定义对象中存在动态分配的空间，则需要在此时进行释放。
 回调函数的参数含义：
     context: 全局上下文
     wsi: ws连接对象
     user: 用户自定义数据
 　in: 空指针
 　len: 0
 
    
 
      
     
 
 
     
 3.3 重要函数说明
 
     
    由于libwebsockets库未能对其能控制ws连接状态的函数进行重点说明，致使本人在使用过程中走了很多弯路。故，在此列出相关函数进行重点说明。
 
     
 表3 重要函数列表
 
     
 
      
序号函数名功能
01lws_get_peer_write_allowance功能：该ws连接允许发送的字节数
 备注：如果有发送字节限制，则返回正数；如果无发送字节限制，则返回-1。
02lws_send_pipe_choked功能：判断ws连接是否阻塞
 备注：如果ws连接阻塞，则返回1，否则返回0。
03lws_write功能：将数据发送给对端
 备注：函数参数说明
   wsi: ws连接对象
   buf: 需要发送数据的起始地址。
          注意：必须在指针buf前预留长度为LWS_SEND_BUFFER_PRE_PADDING的空间，同时在指针buf+len后预留长度为LWS_SEND_BUFFER_POST_PADDING的空间。
   len: 需要发送数据的长度
   protocol: 如果该连接是http连接，则该参数的值为LWS_WRITE_HTTP；如果该连接是ws连接，则该参数的值为LWS_WRITE_BINARY，但如果第一次发送的数据长度n < len，则发送后续长度为(len - n)字节的数据时，该参数值改为LWS_WRITE_HTTP。
04lws_http_transaction_completed功能：当前连接为http连接，而非ws连接时，如果当前http请求的应答数据发送完毕，则可使用该函数重置http连接的相关状态，只有收到新的http请求才能激活该http连接。
 备注：如果当前连接为ws连接，则千万不要调用此函数，其将导致服务端则无法再激活可写事件。
05lws_callback_on_writable功能：将ws连接加入可写事件监听
06lws_callback_on_writable_all_protocol功能：将某个协议的所有ws连接加入可写事件监听
 备注：在网络中存在各种情况可能导致服务端并不知道与客户端的连接已经断开，比如：客户端掉电。为了应对这种情况的存在，需要每隔一段时间执行该函数。再在该协议的回调函数的LWS_CALLBACK_SERVER_WRITEABLE事件中判断一下连接是否超时，如果超时则返回非零值。
 
     
 
    
 
   
 
    
  
 
 
 
 
 
 
 4 存在问题
 
  
 
  问题1：之前网上很多描述libwebsockets库优点包括：节省内存空间。而从实际使用的情况上分析，libwebsockets库消耗了大量的内存空间。比如：快速的建立1000个并发，将会导致消耗200MB的内存空间，且前1000个并发断开后，再此建立1000个并发时，内存还会快速的增长！之前本人还以为存在内存泄漏的情况，后经反复使用valgrind进行内存泄漏的分析，发现并不存在内存泄漏的情况，因此，本人认为libwebsockets库的内存管理策略存在严重问题。
 
 
   问题2：测试中发现同一个wsi可能多次由原因LWS_CALLBACK_FILTER_PROTOCOL_CONNECTION调用回调，且该wsi对象的用户自定义数据的指针会发生变化，导致用户设置的数据丢失，造成严重数据丢失和程序CRASH。解决方案：不让lws维护对象，而是我们自己申请和维护数据！
 


                

        

        

    

  


    

      

        

            

              
                
                  scw_zch
                
              
            

            

                关注
              
            

        

        

          
      

      

            

                专栏目录
          









                



	

		

			

				
					
使用libwebsockets搭建一个简单的websocket服务器

				
			

			

				

					北雨南萍
				

				

					08-06
					
					1909
					
				

			

		

		

			
				
libwebsocket实现的ws服务器

			
		

	



                

            
              



	

		

			

				
					
libwebsockets（三）实现简易websocket服务器

				
			

			

				

					左手倒影，右手年华
				

				

					03-08
					
					2万+
					
				

			

		

		

			
				
实现websocket服务器本身也是libwebsockets库的初衷，本篇博客将介绍如何利用libwebsockets库来实现一个简单的ws服务器。



1、添加websocket协议

这里创建服务器句柄的流程与http一致，需要修改的地方只有在创建服务器时传入的协议数组，即



    struct lws_context_creation_info info;
    struct l...

			
		

	



              


  
              

                


	

		

			

				
					
总结使用libwebsockets开发接入层

					
热门推荐

				
			

			

				

					做事先做人！
				

				

					12-14
					
					3万+
					
				

			

		

		

			
				
使用libwebsockets进行开发的注意事项

			
		

	





	

		

			

				
					
基于websocket实现本地web语音聊天

					
最新发布

				
			

			

				

					qq_30914487的博客
				

				

					09-21
					
					1596
					
				

			

		

		

			
				
基于libwebsockets库实现语音聊天1、关于libwebsocket库自行编译2、client使用html+js 代码如下3、服务端代码
1、关于libwebsocket库自行编译
2、client使用html+js 代码如下
<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>多人语音聊天</title>
</head

			
		

	



		

			
		



	

		

			

				
					
libwsclient：WebSocket客户端库使用教程

				
			

			

				

					gitblog_00675的博客
				

				

					08-10
					
					388
					
				

			

		

		

			
				
libwsclient：WebSocket客户端库使用教程
 libwsclientWebSocket client library for C项目地址:https://gitcode.com/gh_mirrors/li/libwsclient 1. 项目介绍
libwsclient 是一个用C语言编写的轻量级WebSocket客户端库，旨在简化在实时应用程序中集成WebSocket通信的过程。它...

			
		

	





	

		

			

				
					
libwebsockets

				
			

			

				

					01-16
				

			

		

		

			
				
libwebsockets是实现websocket的源代码，纯C语言，易于移植。

			
		

	





	

		

			

				
					
libwebsocket

				
			

			

				

					02-02
				

			

		

		

			
				
可以用于各个平台简易的websocket服务器的搭建和客户端的搭建

			
		

	





	

		

			

				
					
总结使用libwebsockets-2.0.2.tar

				
			

			

				

					12-20
				

			

		

		

			
				
 使用libwebsockets时，应遵循一些最佳实践，如正确处理内存分配与释放，及时关闭无效连接，以及合理设置并发连接数，以保证系统的稳定性和效率。  总的来说，libwebsockets-2.0.2是Linux环境中构建WebSockets应用的...

			
		

	





	

		

			

				
					
libwebsocket_example_server_push:示例libwebsockets库。 检查libwebsockets和服务器推送的机制

				
			

			

				

					05-18
				

			

		

		

			
				
标签"C"表明这个示例程序是用C语言编写的，这可能意味着代码将展示如何在C环境中使用libwebsockets库进行编程，包括结构体、指针、函数调用等C语言特性。  **文件名称列表解析：**  由于只给出了"libwebsocket_...

			
		

	





	

		

			

				
					
lwsxx:C libwebsockets 库的 C++ API

				
			

			

				

					06-26
				

			

		

		

			
				
5. **发送和接收数据**：使用`send`方法向客户端发送数据，`on_message`回调用于处理接收到的数据。  ### 四、使用lwsxx创建WebSocket客户端  创建WebSocket客户端的过程类似，但需要实例化`LwsClient`对象，然后...

			
		

	





	

		

			

				
					
libwebsockets test server

				
			

			

				

					12-19
				

			

		

		

			
				
libwebsockets test server

			
		

	





	

		

			

				
					
libwebsockets的交叉编译

				
			

			

				

					01-24
				

			

		

		

			
				
libwebscokets的交叉编译，从cmake开始实际操作可行。

			
		

	





	

		

			

				
					
libwebsocket的API说明文档

				
			

			

				

					07-27
				

			

		

		

			
				
这个是我根据官网提供的资料，采用doxygen生成的html格式的api说明文档。

			
		

	





	

		

			

				
					
WebSocket使用（C++环境）（二） --- libwebsockets库的安装与使用

				
			

			

				

					wangdamingll的博客
				

				

					12-05
					
					2万+
					
				

			

		

		

			
				
一、参考网址：

libwebsockets官网： https://libwebsockets.org/

libwebsockets的API：https://libwebsockets.org/lws-api-doc-master/html/modules.html

                https://libwebsockets.org/libw...

			
		

	





	

		

			

				
					
libwebsockets常用接口及客户端基本流程

				
			

			

				

					weixin_42336465的博客
				

				

					03-26
					
					1787
					
				

			

		

		

			
				
由于项目的需要，要使用libwebsockets实现客户端固件与服务端的通讯，因此整理了libwebsockets常用的一些接口。并站在客户端的角度，提供了基本流程和代码示例

			
		

	





	

		

			

				
					
使用libwebsockets库写一个http服务器

				
			

			

				

					03-24
				

			

		

		

			
				
非常感谢您的提问！我可以给您提供一些思路，使用libwebsockets库编写http服务器需要注意以下几点：

1. 需要设置监听端口和IP地址；
2. 接收客户端的连接请求，并将其加入到事件监听队列中；
3. 在新的连接建立后，需要进行HTTP协议的解析，包括请求头和请求主体；
4. 根据不同的HTTP请求方法（比如GET、POST等），进行相应的资源处理；
5. 读取相应的资源，设置响应头并发送响应主体给客户端。

关于具体的实现，您可以参考libwebsockets库的相关文档和示例代码，并根据您的需求进行适当的修改。希望这些信息能够对您有所帮助！

			
		

	



              




          




        



    





    



      

      

        
      

      





	

		
评论 1

	

	
	




  

    

      添加红包
      
    

    

      

        
        

          
          
        

        
请填写红包祝福语或标题

      

      

        
        

          
          个
        

        
红包个数最小为10个

      

      

        
        

          
          元
        

        
红包金额最低5元

      

      

        
        

          当前余额3.43元
          前往充值 >
        

      

      

        

          需支付：10.00元
        

        
        
      

    

  





  

    
    
  

  

    
    
  








  

    

      

        

          

            
            
成就一亿技术人!

          

          

        

        

          

          

            领取后你会自动成为博主和红包主的粉丝
            规则
          

        

      

      

        

          

            
              
            
            

              
hope_wisdom
 发出的红包
            

          

        

        

          

          

          

        

      

    

    

  



      
      

      
实付元

      
使用余额支付

      

        

          

            
            点击重新获取
          

        

        
扫码支付

      

      

        
          
            
          
          
        
      

      

        
        钱包余额
          0
          

            
            

              

                
抵扣说明：

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

              

            

          

      

      余额充值