使用命名空间代替类

Question

我正在设计一个接口来抽象管理 Direct3D、Direct2D、DXGI 和相关 Win32API 调用的任务。

将所有内容保存在命名空间中或重构以使用类？

WindowsApp.h

#pragma once
#include <Windows.h>

namespace WindowsApp
{
    bool Initialize(HINSTANCE instanceHandle);
}

WindowsApp.cpp

#include "WindowsApp.h"

namespace WindowsApp
{
    namespace
    {
        HWND ghMainWnd = 0;
    }

    LRESULT CALLBACK WndProc(HWND hWnd, UINT msg, WPARAM wParam, LPARAM lParam)
    {
        switch (msg)
        {
        case WM_DESTROY:
        {
            PostQuitMessage(0);
            return 0;
        }
        break;

        default:
        {
            return DefWindowProc(hWnd, msg, wParam, lParam);
        }
        }
    }

    bool Initialize(HINSTANCE instanceHandle)
    {
        WNDCLASS wc;
        wc.style = CS_HREDRAW | CS_VREDRAW;
        wc.lpfnWndProc = WndProc;
        wc.cbClsExtra = 0;
        wc.cbWndExtra = 0;
        wc.hInstance = instanceHandle;
        wc.hIcon = LoadIcon(0, IDI_APPLICATION);
        wc.hCursor = LoadCursor(0, IDC_ARROW);
        wc.hbrBackground = (HBRUSH)GetStockObject(WHITE_BRUSH);
        wc.lpszMenuName = 0;
        wc.lpszClassName = L"BasicWndClass";

        if (!RegisterClass(&wc))
        {
            MessageBox(0, L"RegisterClass FAILED", 0, 0);
            return false;
        }

        ghMainWnd = CreateWindow(
            L"BasicWndClass",
            L"Win32Basic",
            WS_OVERLAPPEDWINDOW,
            CW_USEDEFAULT,
            CW_USEDEFAULT,
            CW_USEDEFAULT,
            CW_USEDEFAULT,
            0,
            0,
            instanceHandle,
            0);

        if (ghMainWnd == 0)
        {
            MessageBox(0, L"CreateWindow FAILED", 0, 0);
        }

        ShowWindow(ghMainWnd, 1);
        UpdateWindow(ghMainWnd);

        return true;
    }
}

Main.cpp

#include "WindowsApp.h"

int Run()
{
    MSG msg = { 0 };

    BOOL bRet = 1;
    while ((bRet = GetMessage(&msg, 0, 0, 0)) != 0)
    {
        if (bRet == -1)
        {
            MessageBox(0, L"GetMessage FAILED", L"Error", MB_OK);
            break;
        }
        else
        {
            TranslateMessage(&msg);
            DispatchMessage(&msg);
        }
    }
    // Deinitialize Here
    return (int)msg.wParam;
}

int WINAPI WinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance, PSTR pCmdLine, int nShowCmd)
{
    if (!WindowsApp::Initialize(hInstance)) { return 0; }
    return Run();
}

使用命名空间允许我在嵌套的未命名命名空间内隐藏实现细节。 一个类不会让我隐藏东西，但我可以让它们在私有部分中无法访问，我想这已经足够了。

使用类存在用户尝试实例化多个对象的风险，这会导致应用程序因两次初始化 DirectX 或其他原因而崩溃。 命名空间避免了这个问题，但是它们会降低性能，我必须在每个函数调用期间检查 Initialized 变量。我真的不喜欢这个。

最后，使用类要求用户在整个应用程序中需要底层方法的地方传递实例化对象。这真是令人失望，因为每当我在一个文件中时，命名空间方法让我可以访问，该文件有一个 #include 到命名空间头文件。我真的很喜欢这个。

命名空间方法似乎是最好的方法，但在嵌套的未命名命名空间内处理变量的方式中，有些东西并不适合我。 这样可以吗？我的直觉告诉我不行！不！不！

所以我想我的问题是：这是命名空间的合适用例吗？

澄清： 我在 WindowsApp.cpp 中定义了未命名的命名空间以及函数定义——所有函数的前向声明都在 WindowsApp.h 中——通过调用这些函数来操纵未命名命名空间内的变量。这是对命名空间的不当使用还是应该以不同的方式完成？只需将头文件包含在任何其他 .cpp 中，您就可以访问函数，进而访问基础数据。这是非常吸引人的。我的直觉告诉我，这样的结构会导致某种性能损失。

Answer 1

[编辑：删除关于未命名命名空间的内容开始是 TU 独有的，现在问题中的代码已得到澄清。]

在 C++ 中，我们倾向于将 class 视为一些保持不变量的数据的包装器（与 struct 相对，后者倾向于用于一堆没有不变量的数据）。构造函数建立不变量，析构函数将其拆除，成员函数小心维护它。在这里，如果我理解正确，您的不变量似乎是 Initialized() 必须在使用任何其他 API 函数之前调用。

还有另一种选择，即使用所谓的“魔术静力学”，也称为“Meyers 单例”。执行以下操作：

// In WindowsApp.cpp

namespace {

class WindowsAppImpl {
public:
    WindowsAppImpl()
    {
        // Do initialization stuff here
    }

    ~WindowsAppImpl()
    { 
        // Do teardown stuff if necessary
    }

    // Example function
    int getMagicNumber()
    {
        return 3;
    }
};

WindowsAppImpl& GetInstance() {
    static WindowsAppImpl instance{};
    return instance;
}

} // end private namespace

// Public function declared in WindowApp.h
int GetMagicNumber() {
    // Get the singleton instance
    WindowsAppImpl& instance = GetInstance();

    // Call member function
    return instance.getMagicNumber();
}

这种方法添加了一个函数，该函数返回对单例WindowsAppImpl 实例的引用。编译器保证这个实例只构造一次，第一次调用GetInstance()。 （它还将在main() 完成后运行WindowsAppImpl 的析构函数，这在这种情况下可能并不重要，但在某些情况下可能很有用。）这种方法的优点是在GetMagicNumber() 内部你可以确定初始化例程已运行，无需用户传递某种自己的 WindowsAppContext 实例。