C++框架内置功能在代码可读性上的影响是什么？

PHPz

发布时间：2024-08-06 09:15:04

1161人浏览过

来源于php中文网

原创

c++++ 框架的内置功能虽然便利，但可能影响代码可读性。依赖注入 (di) 引入间接性，代码生成缺乏注释，泛型编程难以理解。开发者应权衡效率与可维护性，权衡后选择合适方案，如手动注入、手写代码和明确指定类型。

C++框架内置功能在代码可读性上的影响是什么？

C++ 框架内置功能对代码可读性的影响

C++ 框架提供了一系列内置功能，旨在简化和加快开发过程。然而，这些功能有时可能会对代码的可读性产生影响。

依赖注入的影响

依赖注入 (DI) 是框架中常见的功能，它允许开发者轻松地将依赖项注入对象中。虽然 DI 可以提高代码的可维护性，但也会引入额外的层间接性，可能使跟踪对象之间的依赖关系变得困难。

// 使用 DI
class MyClass {
public:
    MyClass(Dependency1* dep1, Dependency2* dep2) {
        // ...
    }
};

// 手动注入
class MyClass {
public:
    MyClass(Dependency1& dep1, Dependency2& dep2) {
        // ...
    }
};

在手动注入的版本中，依赖关系显式指定，使代码更易于理解。

立即学习“C++免费学习笔记（深入）”；

代码生成的影响

某些框架提供代码生成功能，可以自动创建代码片段。虽然这可以节省时间，但生成的代码通常缺乏可读性，因为缺乏适当的注释和命名约定。

// 自动生成的代码
template
std::shared_ptr create(std::string name) {
    std::shared_ptr obj(new T);
    // ...
    return obj;
}

// 手写代码
template
std::shared_ptr create(const std::string& name) {
    // ...
    auto obj = std::make_shared();
    // ...
    return obj;
}

手写代码提供了更清晰的意图，易于理解和重构。

魔法映像企业网站管理系统

技术上面应用了三层结构，AJAX框架，URL重写等基础的开发。并用了动软的代码生成器及数据访问类，加进了一些自己用到的小功能，算是整理了一些自己的操作类。系统设计上面说不出用什么模式，大体设计是后台分两级分类，设置好一级之后，再设置二级并选择栏目类型，如内容，列表，上传文件，新窗口等。这样就可以生成无限多个二级分类，也就是网站栏目。对于扩展性来说，如果有新的需求可以直接加一个栏目类型并新加功能操作

下载

泛型编程的影响

框架经常使用泛型编程技术来提高可重用性。然而，泛型代码可能很难理解，因为编译器在代码生成阶段才解析类型参数。

// 泛型代码
template
void sort(std::vector& vec) {
    // ...
}

// 具体代码
void sort(std::vector& vec) {
    // ...
}

具体代码更易于理解，因为明确指定了类型。

实战案例：使用 DI 和泛型编程

考虑一个日志记录框架，它提供了一个 ILogger 接口，以及一个 createLogger 函数来创建新的日志记录器。

// 使用 DI
class MyClass {
    ILogger* logger;

public:
    MyClass(ILogger* logger) : logger(logger) {
        logger->info("Initialized");
    }
};

// 泛型编程实现
template
class MyClass {
public:
    MyClass() {
        logger()->info("Initialized");
    }

private:
    std::shared_ptr logger() {
        // ...
    }
};

泛型版本有可能导致难以跟踪 MyClass 类的实际类型和依赖关系。