56 lines
1.4 KiB
C
56 lines
1.4 KiB
C
|
// 文件名: src/web/web_server.h
|
|||
|
|
#ifndef WEB_SERVER_H
|
|||
|
|
#define WEB_SERVER_H
|
|||
|
|
|
|||
|
|
#include "crow.h" // 引入 Crow 库的头文件
|
|||
|
|
#include "systemMonitor/system_monitor.h"
|
|||
|
|
#include <thread>
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* @brief Web服务器模块
|
|||
|
|
* * 负责启动一个后台HTTP服务器，为前端提供RESTful API接口。
|
|||
|
|
* 它在自己的线程中运行，以避免阻塞主程序的io_context事件循环。
|
|||
|
|
*/
|
|||
|
|
class WebServer {
|
|||
|
|
public:
|
|||
|
|
/**
|
|||
|
|
* @brief 构造函数
|
|||
|
|
* @param monitor SystemMonitor的引用，用于获取系统状态数据
|
|||
|
|
* @param port Web服务器监听的端口号，默认为8080
|
|||
|
|
*/
|
|||
|
|
WebServer(SystemMonitor::SystemMonitor& monitor, uint16_t port = 8080);
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* @brief 析构函数
|
|||
|
|
* * 确保在程序退出时，Web服务线程能够被安全地停止和清理。
|
|||
|
|
*/
|
|||
|
|
~WebServer();
|
|||
|
|
|
|||
|
|
// 禁止拷贝和赋值，因为该类管理着一个线程资源
|
|||
|
|
WebServer(const WebServer&) = delete;
|
|||
|
|
WebServer& operator=(const WebServer&) = delete;
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* @brief 在后台线程中启动Web服务
|
|||
|
|
*/
|
|||
|
|
void start();
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* @brief 停止Web服务并等待线程退出
|
|||
|
|
*/
|
|||
|
|
void stop();
|
|||
|
|
|
|||
|
|
private:
|
|||
|
|
/**
|
|||
|
|
* @brief 设置所有的API路由（URL路径）
|
|||
|
|
*/
|
|||
|
|
void setup_routes();
|
|||
|
|
|
|||
|
|
crow::SimpleApp m_app; // Crow 应用实例
|
|||
|
|
SystemMonitor::SystemMonitor& m_monitor;
|
|||
|
|
uint16_t m_port;
|
|||
|
|
|
|||
|
|
std::thread m_thread; // 运行Web服务的后台线程
|
|||
|
|
};
|
|||
|
|
|
|||
|
|
#endif // WEB_SERVER_H
|