1. Arch类的定义

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26


#define ARCH (Arch::getInstance())  // 提供一个宏，用于单例的全局访问

class Arch : public ARCH_DAEMON,
             public ARCH_LOG,
             public ARCH_MULTITHREAD,
             public ARCH_NETWORK,
             public ARCH_SLEEP,
             public ArchString,
             public ARCH_TIME
{
public:
    Arch();  // 构造使用了assert强制保证只能创建的唯一实例。
    explicit Arch(Arch *arch);   // 支持外部注入
    ~Arch() override = default;

    // 可以禁用拷贝构造、赋值操作符等等。

    // 创建单例后调用
    void init() override;  // 初始化需要的接口

    static Arch *getInstance(); 

private:
    // 静态私有实例，由该类自行实例化，并向系统提供这个实例。
    static Arch *s_instance; 
};

单例模式好像是有什么饿汉、懒汉的说法，但是该项目实现应该是属于一种懒汉模式，但不是在get时初始化，而是在main函数中通过构造函数手动创建，其实这也符合该项目自身的需求，这个项目设计该单例主要为了给业务层提供无关平台的系统调用接口，整个程序共享该单例，在进入main后马上就创建并初始化单例对象，并且通过assert确保只有一个静态实例。

2. Arch类的实现

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30


#include "arch/Arch.h"

#if SYSAPI_WIN32
#include "arch/win32/ArchMiscWindows.h"
#endif

Arch *Arch::s_instance = nullptr;

// 虽然构造函数在定义中没有私有，但是这里使用了assert(s_instance == nullptr)也能保证只有一个实例存在。
Arch::Arch()
{
  assert(s_instance == nullptr);
  s_instance = this;
}

// 初始化Arch中的模块，这里只初始化了网络模块，根据实际需求初始化对应的模块。
void Arch::init()
{
  ARCH_NETWORK::init();
#if SYSAPI_WIN32
  ArchMiscWindows::init();
#endif
}

// 访问单例
Arch *Arch::getInstance()
{
  assert(s_instance != nullptr);
  return s_instance;
}

3. 跨平台实现

上面的Arch类继承了多个基类（如ARCH_DAEMON、ARCH_LOG等等），这些也都是抽象基类，它们分别提供了不同的功能模块（如守护进程、日志记录、多线程支持等）。每一个宏就是一个模块类型，定义在特定头文件中，在编译时，根据平台的不同来包含不同的头文件，并进行宏替换：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20


#if SYSAPI_WIN32   // Win平台实现代码
#include "arch/win32/ArchDaemonWindows.h"
#include "arch/win32/ArchLogWindows.h"
#include "arch/win32/ArchMultithreadWindows.h"
#include "arch/win32/ArchNetworkWinsock.h"
#include "arch/win32/ArchSleepWindows.h"
#include "arch/win32/ArchTimeWindows.h"

#elif SYSAPI_UNIX  // Unix平台实现
#include "arch/unix/ArchDaemonUnix.h"
#include "arch/unix/ArchLogUnix.h"
#include "arch/unix/ArchNetworkBSD.h"
#include "arch/unix/ArchSleepUnix.h"
#include "arch/unix/ArchTimeUnix.h"


#if HAVE_PTHREAD  // Posix
#include "arch/unix/ArchMultithreadPosix.h"
#endif
#endif

就拿ARCH_NetWork来说，在Windows平台下构建，预处理后ArchNetworkWinsock.h头文件被包含到：

1

#define ARCH_NETWORK ArchNetworkWinsock  // 此时Arch类实际继承了ArchNetworkWinsock，也就是继承了Win平台的实现

在Unix系统下构建，预处理后ArchNetWorkBSD.h头文件被包含：

1

#define ARCH_NETWORK ArchNetworkBSD      // 此时Arch类实际继承了ArchNetworkBSD，也就是继承了Unix平台的实现

对于每一个功能模块，后续会以单独的章节介绍。

4. 使用

这个单例封装了系统调用，在程序启动时就要创建，以便于程序使用。

1
2
3
4
5
6
7


int main(int argc, char **argv)
{
    // ...
    Arch arch;  
    arch.init(); 
    // ...
}

在程序中，使用ARCH宏访问单例对象。