如何利用最常用继承写法优雅封装一套跨平台的本地数据存储基类

夜杰同学_1557

夜杰同学_1557

2026-05-24

700人浏览

原创

用public继承封装跨平台本地数据存储基类,核心是抽象共性、隔离差异、保持接口一致:基类定义纯虚接口和保护工具方法,子类仅实现平台相关io,通过工厂按编译宏创建对应实例。

如何利用最常用继承写法优雅封装一套跨平台的本地数据存储基类

用 public 继承封装跨平台本地数据存储基类,核心是抽象共性、隔离差异、保持接口一致。不是堆功能,而是搭骨架——让后续 iOS/Android/Windows/macOS 等平台子类只专注实现底层读写,不重复处理序列化、错误包装、线程安全等通用逻辑。

一、定义清晰的基类接口(纯虚+保护成员)

基类不负责具体存哪、怎么存,只约定“能做什么”和“该注意什么”:

class DataStorageBase {
protected:
    // 存储路径由子类在构造时传入并管理(平台相关)
    std::string m_storagePath;

    // 可选:统一的日志/错误回调,供子类触发
    std::function<void std::string> m_errorHandler;

    // 保护方法:供子类调用的通用工具(如 JSON 序列化/反序列化)
    bool serializeToJson(const nlohmann::json& data, std::string& outStr);
    bool deserializeFromJson(const std::string& inStr, nlohmann::json& outData);

public:
    explicit DataStorageBase(const std::string& path) : m_storagePath(path) {}
    virtual ~DataStorageBase() = default;

    // 核心能力:读、写、删、查存在
    virtual bool write(const std::string& key, const nlohmann::json& value) = 0;
    virtual bool read(const std::string& key, nlohmann::json& outValue) = 0;
    virtual bool remove(const std::string& key) = 0;
    virtual bool exists(const std::string& key) = 0;

    // 可选:批量操作、清空、统计等(也可留空或默认实现)
    virtual size_t count() { return 0; }
    virtual void clear() = 0;
};</void>

✅ 关键点:

  • 所有 public 接口为虚函数,强制子类实现;
  • protected 工具方法(如 JSON 处理)避免重复造轮子;
  • 不暴露文件句柄、数据库连接等平台细节;
  • 错误通过回调或返回值传递,不抛异常(便于跨平台异常模型兼容)。

二、用 public 继承派生各平台实现类

public 继承确保“is-a”语义成立:FileStorageLinux 是一个 DataStorageBase,可安全向上转型,支持多态调用。

// Linux/macOS:基于文件系统 + JSON 文件
class FileStoragePOSIX : public DataStorageBase {
private:
    std::mutex m_mutex; // 保护文件读写并发

protected:
    std::string getKeyFilePath(const std::string& key) const {
        return m_storagePath + "/" + key + ".json";
    }

public:
    explicit FileStoragePOSIX(const std::string& path) : DataStorageBase(path) {
        // 确保目录存在
        std::filesystem::create_directories(m_storagePath);
    }

    bool write(const std::string& key, const nlohmann::json& value) override {
        std::lock_guard<:mutex> lock(m_mutex);
        std::string jsonStr;
        if (!serializeToJson(value, jsonStr)) return false;

        std::ofstream f(getKeyFilePath(key));
        if (!f.is_open()) return false;
        f  lock(m_mutex);
        std::ifstream f(getKeyFilePath(key));
        if (!f.is_open()) return false;

        std::string content((std::istreambuf_iterator<char>(f)),
                             std::istreambuf_iterator<char>());
        return deserializeFromJson(content, outValue);
    }

    // ... 其他方法实现
};</char></char></:mutex>
// Windows:可用 WinRT `ApplicationData` 或 `std::filesystem`
class FileStorageWinRT : public DataStorageBase {
    // 同样继承 public,复用基类工具,只重写底层 IO
};

✅ 关键点:

  • 每个子类只写真正平台相关的代码(路径规则、API 调用、权限检查);
  • 自动获得基类的 JSON 工具、错误处理框架、线程保护骨架;
  • 外部代码只需依赖 DataStorageBase*,完全解耦平台细节。

三、配合工厂或配置实现运行时切换

避免硬编码平台分支,用简单工厂统一创建:

std::unique_ptr<datastoragebase> createStorage(const std::string& basePath) {
#if defined(_WIN32)
    return std::make_unique<filestoragewinrt>(basePath);
#elif defined(__linux__) || defined(__APPLE__)
    return std::make_unique<filestorageposix>(basePath);
#else
    static_assert(false, "Unsupported platform");
#endif
}

// 使用示例
auto storage = createStorage("/data/local");
storage->write("user_prefs", {{"theme", "dark"}, {"lang", "zh"}});</filestorageposix></filestoragewinrt></datastoragebase>

✅ 关键点:

  • 编译期分发,零运行时开销;
  • 新增平台只需加一个 #elif 分支和对应子类;
  • 基类不变,所有扩展不破坏原有逻辑。

不复杂但容易忽略:基类里不写一行平台 API,子类里不重复处理 JSON 或加锁逻辑——这才是 public 继承在跨平台封装中最优雅的落点。

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
Kratos框架Protobuf接口定义与代码生成合集
Kratos框架Protobuf接口定义与代码生成合集

本专题讲解Kratos框架接口定义体系,涵盖proto编写规范、proto add/client/server生成命令、http注解路由、validate校验、OpenAPI文档生成、跨服务proto复用与兼容性设计。

2026.10.10

0

15

C++虚函数怎么定义和调用
C++虚函数怎么定义和调用

C++虚函数是实现运行时多态的重要机制。本专题从virtual关键字的基本用法入手,介绍基类与派生类之间的函数重写、基类指针调用派生类方法,以及动态绑定的执行过程,帮助初学者掌握虚函数的核心语法。

2026.10.10

0

26

C++类与对象的封装方法教程
C++类与对象的封装方法教程

C++封装是面向对象编程的核心特性之一,通过类将数据与操作数据的函数组织在一起,并利用访问权限控制外部访问。本专题介绍类的定义、成员变量、成员函数以及public、private和protected的使用方法,帮助初学者掌握封装的基本原理。

2026.10.10

0

32

C++构造函数定义与调用方法
C++构造函数定义与调用方法

C++构造函数用于初始化类对象,是面向对象编程的重要基础。本专题从构造函数的定义、声明和调用入手,介绍默认构造函数、带参数构造函数、拷贝构造函数及成员初始化列表,帮助初学者掌握对象创建与初始化的基本方法。

2026.10.10

0

16

Kratos框架零基础入门教程
Kratos框架零基础入门教程

本专题整理Kratos框架入门内容,涵盖Go环境准备、kratos CLI安装升级、new命令创建项目、目录结构分层说明、服务启动与双协议端口、依赖下载报错排查,帮助开发者快速跑通第一个Kratos框架微服务应用。

2026.10.10

0

15

C++条件判断语句怎么写
C++条件判断语句怎么写

C++条件判断是控制程序执行流程的重要基础。本专题介绍if、if-else、else if和switch等常见分支语句,结合条件表达式、比较运算符与代码示例,帮助初学者掌握不同场景下的判断逻辑。

2026.10.10

0

13

C++变量怎么声明和赋值
C++变量怎么声明和赋值

C++变量是编写程序和存储数据的基础。本专题围绕变量声明、定义、初始化、赋值和类型选择等内容展开,帮助初学者理解不同变量的用法,并掌握在实际代码中定义和使用变量的方法。

2026.10.10

0

20

C++运算符基础入门
C++运算符基础入门

本专题详细讲解了C++运算符的类型、语法与使用方法,涵盖算术运算符、关系运算符、逻辑运算符、位运算符、赋值运算符、条件运算符及其他特殊运算符,并通过代码示例解析优先级与结合性。

2026.10.09

0

11

PixPix官网入口合集
PixPix官网入口合集

本专题汇总了PixPix官网在线使用入口及平台功能详解,涵盖文生图、图生图、AI图片编辑、AI视频创作等核心能力,并整理了AI爆款图片复刻、商品套图、详情页生成、视频变清晰与去水印等电商专项工具的使用教程。同时收录了PixPix MCP接入Codex、Claude Code等主流Agent的操作指南,助您一站式完成AI图片与视频创作。

2026.10.09

0

11

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
phpStudy极速入门视频教程
phpStudy极速入门视频教程

共6课时 | 54.6万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时 | 133.4万人学习