当前位置：首页 > news >正文

C++中单例模式详解

news 来源：原创 2025/6/1 10:46:33

在C++中，单例模式 (Singleton Pattern) 确保一个类只有一个实例，并提供一个全局访问点来获取这个实例。这在需要一个全局对象来协调整个系统行为的场景中非常有用。

为什么要有单例模式？

在许多项目中，某些类从逻辑上讲只需要一个实例。例如：

全局配置管理器：应用程序的配置信息通常是全局唯一的。
日志记录器：整个应用程序通常共享一个日志记录器。
数据库连接池：管理数据库连接，通常只需要一个实例来控制连接数和分配。
硬件接口访问：如果一个类直接与某个硬件设备通信，通常也只需要一个实例来避免冲突。
线程池：管理一组工作线程，通常也是全局唯一的。

如果允许多个这样的实例存在，可能会导致：

资源冲突：多个实例可能争抢同一资源。
状态不一致：不同的实例可能持有不同的状态，导致行为不可预测。
资源浪费：创建多个不必要的对象会占用内存和CPU资源。

单例模式通过限制类的实例化来解决这些问题。

单例模式的作用

单例模式主要有以下几个作用：

保证唯一实例：这是单例模式的核心。它确保在程序的整个生命周期中，特定类只有一个对象存在。
提供全局访问点：通过一个静态方法，如 GetInstance()，可以从程序的任何地方访问这个唯一的实例，而无需传递对象的引用。
延迟初始化：实例可以在第一次被请求时才创建，而不是在程序启动时就创建，这可以节省资源，特别是在实例创建开销较大或不一定会被使用时。
集中控制：将相关的资源和行为集中到一个对象中管理，方便协调和维护。

结合项目`ClientCtrl`的单例模式分析

在我最近在复盘的一个远程控制项目中，将客户端的某一个功能设计为单例模式是非常合适的。让我们看看为什么以及它是如何工作的。本项目的设计模式也是MVC模式，其中的C就是本节里的例子。

项目背景：

ClientCtrl 类作为控制层核心，负责：

管理对话框实例：WatchDialog, StatusDialog, RemoteDialog等，这些是我MVC模式中V里的一些功能。
管理一个后台工作线程，处理自定义消息（发送数据、更新状态），这些是我MVC模式中M里的一些功能。
提供初始化 (InitControl())、启动 (Invoke())、释放资源 (Release()) 等接口，这就是C的职责。

为什么`ClientCtrl`需要是单例？（可以结合如下所示的图去理解）

全局协调者：ClientCtrl 扮演着应用程序中用户界面（对话框）和后台通信/逻辑处理（线程）之间的核心协调者角色。整个应用程序只需要一个这样的协调中心。如果存在多个 ClientCtrl 实例，就会出现：
- 多个线程：每个 ClientCtrl 实例都会创建自己的线程，导致资源浪费和潜在的逻辑冲突。
- 对话框管理混乱：哪个 ClientCtrl 实例应该管理哪些对话框？这会导致界面状态不一致。
- 消息处理冲突：自定义消息应该由哪个实例的线程来处理？
资源集中管理：
- 对话框实例：WatchDialog、StatusDialog、RemoteDialog 这些界面元素通常是全局唯一的，由一个统一的控制器来管理其生命周期和交互是合理的。
- 线程句柄和ID (m_hThread, m_nThreadID): 这些资源与核心控制逻辑紧密相关，应由唯一的控制器实例拥有。
全局访问需求：

应用程序的不同部分可能需要与控制层交互，例如触发数据发送或更新界面状态。通过单例的 GetInstance() 方法，任何模块都可以方便地获取到 ClientCtrl 的唯一实例并调用其公有方法。这避免了在各个模块之间传递 ClientCtrl 对象引用的复杂性。

`ClientCtrl` 单例模式实现分析

class ClientCtrl {
private:// 1. 静态私有成员变量，用于保存类的唯一实例static ClientCtrl* m_instance;// 2. 私有构造函数，防止外部直接通过 new 创建实例ClientCtrl() {// 构造函数中创建线程// 例如: m_hThread = (HANDLE)_beginthreadex(nullptr, 0, &ClientCtrl::ThreadEntry, this, 0, &m_nThreadID);// 初始化对话框实例等// m_pWatchDialog = new WatchDialog();// ...// 注册消息映射// RegisterMsgHandler(WM_USER + 1, &ClientCtrl::HandleSendData);// ...std::cout << "ClientCtrl instance created. Thread started." << std::endl;}// 3. 私有析构函数，确保实例只能通过定义的 Release 方法释放 (如果需要的话)//    或者在程序结束时由操作系统自动回收（如果m_instance是静态对象而非指针）//    在这个例子中，通过 Release() 主动释放。~ClientCtrl() {// 析构函数中等待线程结束，释放资源if (m_hThread != INVALID_HANDLE_VALUE) {// PostThreadMessage(m_nThreadID, WM_QUIT, 0, 0); // 通知线程退出消息循环// WaitForSingleObject(m_hThread, INFINITE);// CloseHandle(m_hThread);// m_hThread = INVALID_HANDLE_VALUE;}// delete m_pWatchDialog;// ...std::cout << "ClientCtrl instance destroyed. Resources released." << std::endl;}// (可选) 私有拷贝构造函数和赋值运算符，防止复制实例ClientCtrl(const ClientCtrl&) = delete;ClientCtrl& operator=(const ClientCtrl&) = delete;public:// 4. 静态公有方法，用于获取类的唯一实例static ClientCtrl* GetInstance() {if (m_instance == nullptr) { // 第一次调用时创建实例 (延迟初始化)m_instance = new ClientCtrl();}return m_instance;}// 5. (可选) 静态公有方法，用于显式释放单例实例//    在某些情况下需要手动控制单例的销毁时机static void ReleaseInstance() { // Renamed from 'Release' to avoid conflict if ClientCtrl has other Release methodsif (m_instance != nullptr) {delete m_instance;m_instance = nullptr;}}// 公有成员方法void InitControl() { std::cout << "ClientCtrl InitControl called." << std::endl; /* ... */ }void Invoke()      { std::cout << "ClientCtrl Invoke called." << std::endl; /* ... */ }void ReleaseResources() { std::cout << "ClientCtrl Release (logic) called." << std::endl; /* ... */ } // Renamed for clarity// 线程入口函数 (必须是静态的，或者使用lambda捕获this)static unsigned __stdcall ThreadEntry(void* pParam) {// ClientCtrl* pThis = static_cast<ClientCtrl*>(pParam);// MSG msg;// PeekMessage(&msg, NULL, WM_USER, WM_USER, PM_NOREMOVE); // 创建消息队列// while (GetMessage(&msg, nullptr, 0, 0)) {//     if (msg.message == WM_QUIT) {//         break;//     }//     // 通过映射表查找并调用处理函数//     // pThis->DispatchMsg(&msg);//     TranslateMessage(&msg);//     DispatchMessage(&msg);// }std::cout << "ClientCtrl thread exiting." << std::endl;return 0;}private:// WatchDialog* m_pWatchDialog;// StatusDialog* m_pStatusDialog;// RemoteDialog* m_pRemoteDialog;// HANDLE m_hThread = INVALID_HANDLE_VALUE;// unsigned m_nThreadID = 0;// std::map<UINT, std::function<void(WPARAM, LPARAM)>> m_messageMap;// void RegisterMsgHandler(UINT msg, std::function<void(WPARAM, LPARAM)> handler) {//     m_messageMap[msg] = handler;// }// void DispatchMsg(MSG* pMsg) {//     auto it = m_messageMap.find(pMsg->message);//     if (it != m_messageMap.end()) {//         it->second(pMsg->wParam, pMsg->lParam);//     } else {//         // Default handling or log unknown message//     }// }// void HandleSendData(WPARAM wParam, LPARAM lParam) { /* ... */ }// void HandleUpdateStatus(WPARAM wParam, LPARAM lParam) { /* ... */ }// void HandleRemoteMonitor(WPARAM wParam, LPARAM lParam) { /* ... */ }
};// 6. 在类外初始化静态成员变量
ClientCtrl* ClientCtrl::m_instance = nullptr;

使用示例：

// 在 App 类或其他任何地方使用 ClientCtrl
// #include "ClientCtrl.h" // 假设在头文件中int main() {// 获取 ClientCtrl 的唯一实例ClientCtrl* controller1 = ClientCtrl::GetInstance();controller1->InitControl();controller1->Invoke();ClientCtrl* controller2 = ClientCtrl::GetInstance(); // controller2 与 controller1 指向同一个实例if (controller1 == controller2) {std::cout << "controller1 and controller2 are the same instance." << std::endl;}// 模拟发送消息 (实际应在线程中处理)// PostThreadMessage(controller1->GetThreadId(), WM_USER + 1, 0, 0);controller1->ReleaseResources(); // 调用业务逻辑上的释放// 程序结束前释放单例资源ClientCtrl::ReleaseInstance();std::cout << "ClientCtrl instance explicitly released." << std::endl;return 0;
}

关键点解释：

static ClientCtrl* m_instance;: 这是一个静态成员指针，它将在类的所有对象之间共享。由于它是静态的，它在程序启动时（或第一次使用前，取决于具体实现和编译器）被初始化为 nullptr。
private ClientCtrl(): 构造函数是私有的。这意味着不能在类的外部使用 new ClientCtrl() 来创建对象。这是强制执行单例的关键。
static ClientCtrl* GetInstance(): 这是全局访问点。
- 它首先检查 m_instance 是否为 nullptr。
- 如果是，说明这是第一次请求实例，于是它 new ClientCtrl() 来创建唯一的实例，并将其地址赋给 m_instance。
- 如果不是 nullptr，说明实例已经存在，直接返回 m_instance。
static void ReleaseInstance(): 提供了一个释放单例占用的内存的方法。这在程序退出前或者明确不再需要该单例时调用，以避免内存泄漏。注意：在多线程环境中，GetInstance() 中的 if (m_instance == nullptr) 判断和 m_instance = new ClientCtrl(); 的赋值操作之间存在线程安全问题（竞态条件）。如果多个线程同时调用 GetInstance() 并且 m_instance 恰好是 nullptr，可能会创建多个实例。更健壮的实现通常需要使用互斥锁 (mutex) 或其他同步机制（如C++11的 std::call_once 或双重检查锁定模式 (Double-Checked Locking Pattern)）来确保线程安全。
ClientCtrl* ClientCtrl::m_instance = nullptr;: 这是静态成员变量的定义和初始化，必须在类的外部（通常在 .cpp 文件中）进行。