C / C++ / 系统课时

拆分源码并检查程序边界

拆分源码并检查程序边界

当命令行图书管理程序开始同时处理数据、输入和文件时,继续把所有代码塞进一个 main.cpp 会让边界错误很难定位。本节把类声明、实现和入口拆开,并用可重复的命令验证非法输入、重复编号和文件失败都能被明确处理。

学习目标

  • 将图书数据与管理类声明、实现、程序入口拆分到独立源码文件
  • 为非法编号、重复编号和文件读写失败设计明确的处理路径
  • 使用编译与命令行输入验证拆分后的程序仍能正确工作

划分三个文件的职责

拆分源码不是简单“把代码分散”,而是让依赖方向清楚:头文件只描述可用接口,实现文件负责业务与文件细节,入口文件只组织交互流程。这样修改持久化格式时,通常不需要改 main.cpp。

文件 主要职责
BookManager.h 声明 Book、BookManager 及公开接口
BookManager.cpp 实现查重、加载、保存和列表逻辑
main.cpp 读取用户输入、校验格式并调用管理类

片段示例:BookManager.h 是完整程序的声明文件,需要与后面的 BookManager.cpp、main.cpp 一起编译。

cpp
#pragma once

#include <string>
#include <vector>

struct Book {
    int id;
    std::string title;
};

class BookManager {
public:
    bool load(const std::string& path);
    bool save(const std::string& path) const;
    bool addBook(int id, const std::string& title);
    const std::vector<Book>& books() const;

private:
    bool containsId(int id) const;
    std::vector<Book> books_;
};

在实现层集中处理数据边界

重复编号属于业务边界,应由 BookManager 自己保证,而不是只依赖界面层判断。文件解析也放在实现文件中,入口无需知道每一行如何切分。

片段示例:BookManager.cpp 依赖 BookManager.h,负责实现管理类。

cpp
#include "BookManager.h"

#include <fstream>
#include <sstream>

bool BookManager::containsId(int id) const {
    for (const auto& book : books_) {
        if (book.id == id) {
            return true;
        }
    }
    return false;
}

bool BookManager::addBook(int id, const std::string& title) {
    // 编号必须为正数,标题不能为空,编号还必须保持唯一。
    if (id <= 0 || title.empty() || containsId(id)) {
        return false;
    }
    books_.push_back({id, title});
    return true;
}

bool BookManager::load(const std::string& path) {
    std::ifstream in(path);
    if (!in) {
        return false;
    }

    books_.clear();
    std::string line;
    while (std::getline(in, line)) {
        const auto tab = line.find('\t');
        if (tab == std::string::npos) {
            continue;
        }

        std::istringstream idStream(line.substr(0, tab));
        int id = 0;
        char extra = '\0';
        if (!(idStream >> id) || (idStream >> extra)) {
            continue;
        }

        const std::string title = line.substr(tab + 1);
        // 坏行和重复编号不会污染当前内存数据。
        if (id > 0 && !title.empty() && !containsId(id)) {
            books_.push_back({id, title});
        }
    }
    return true;
}

bool BookManager::save(const std::string& path) const {
    std::ofstream out(path, std::ios::trunc);
    if (!out) {
        return false;
    }

    for (const auto& book : books_) {
        out << book.id << '\t' << book.title << '\n';
    }
    return static_cast<bool>(out);
}

const std::vector<Book>& BookManager::books() const {
    return books_;
}

这里的文件格式是“编号 + 制表符 + 标题”。加载时遇到缺少分隔符、非法编号或重复编号的坏行会跳过;保存时如果文件无法打开或写入失败,调用者能通过返回值决定如何提示用户。

在入口处拒绝非法输入

用户输入属于交互边界。不要直接使用 std::cin >> id 后继续执行,因为输入失败会留下流状态并影响后续读取。这里统一使用 std::getline,再把字符串解析成整数。

片段示例:main.cpp 依赖前两个文件,提供完整的命令行入口。

cpp
#include "BookManager.h"

#include <iostream>
#include <sstream>
#include <string>

bool parseInt(const std::string& text, int& value) {
    std::istringstream input(text);
    char extra = '\0';
    return (input >> value) && !(input >> extra);
}

int main() {
    const std::string dataPath = "books.txt";
    BookManager manager;

    if (!manager.load(dataPath)) {
        std::cout << "提示:未读取到 books.txt,将从空列表开始。\n";
    }

    for (;;) {
        std::cout << "1 添加  2 列出  0 退出\n> ";
        std::string choice;
        if (!std::getline(std::cin, choice)) {
            break;
        }

        if (choice == "0") {
            break;
        }

        if (choice == "2") {
            for (const auto& book : manager.books()) {
                std::cout << book.id << " " << book.title << '\n';
            }
            if (manager.books().empty()) {
                std::cout << "(暂无图书)\n";
            }
            continue;
        }

        if (choice != "1") {
            std::cout << "无效菜单选项。\n";
            continue;
        }

        std::cout << "编号: ";
        std::string idText;
        std::getline(std::cin, idText);

        int id = 0;
        if (!parseInt(idText, id) || id <= 0) {
            std::cout << "编号必须是正整数。\n";
            continue;
        }

        std::cout << "书名: ";
        std::string title;
        std::getline(std::cin, title);

        if (!manager.addBook(id, title)) {
            std::cout << "添加失败:编号重复或书名为空。\n";
            continue;
        }

        if (!manager.save(dataPath)) {
            std::cout << "添加成功,但保存文件失败。\n";
            continue;
        }

        std::cout << "添加成功。\n";
    }
}

编译并验证关键边界

先把三个文件放在同一目录,再使用支持 C++17 的编译器构建。编译成功通常不会输出任何文本;后续测试命令会删除旧数据文件,使验证结果可重复。

bash
g++ -std=c++17 -Wall -Wextra -pedantic BookManager.cpp main.cpp -o library

预期输出

text
<无输出,编译成功后生成 library 可执行文件>

接着依次测试合法添加、重复编号、非法编号和列表输出。

bash
rm -f books.txt
printf "1\n1001\nC++ Primer\n1\n1001\nDuplicate\n1\nabc\n2\n0\n" | ./library

预期输出

text
提示:未读取到 books.txt,将从空列表开始。
1 添加  2 列出  0 退出
> 编号: 书名: 添加成功。
1 添加  2 列出  0 退出
> 编号: 书名: 添加失败:编号重复或书名为空。
1 添加  2 列出  0 退出
> 编号: 编号必须是正整数。
1 添加  2 列出  0 退出
> 1001 C++ Primer
1 添加  2 列出  0 退出
>

实际终端的换行与提示符显示方式可能略有差异,但关键结果应一致:重复编号不会写入,abc 不会被当成编号,最终列表只有编号 1001 的一本书。

文件失败要能被看见

边界检查的最后一步是主动制造文件失败,而不是只验证正常路径。最简单的做法是把 dataPath 临时改成当前用户没有写权限的路径,再执行添加操作;此时程序应输出“添加成功,但保存文件失败”,而不能误报持久化成功。

完成拆分后,main.cpp 只负责输入与流程,BookManager 负责数据一致性,文件读写失败也通过返回值向上暴露。这样的边界划分能让后续增加删除、查询或更换存储格式时,不必把所有逻辑重新揉回程序入口。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

拆分源码并检查程序边界

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通