C / C++ / 系统课时
拆分源码并检查程序边界
拆分源码并检查程序边界
当命令行图书管理程序开始同时处理数据、输入和文件时,继续把所有代码塞进一个 main.cpp 会让边界错误很难定位。本节把类声明、实现和入口拆开,并用可重复的命令验证非法输入、重复编号和文件失败都能被明确处理。
学习目标
- 将图书数据与管理类声明、实现、程序入口拆分到独立源码文件
- 为非法编号、重复编号和文件读写失败设计明确的处理路径
- 使用编译与命令行输入验证拆分后的程序仍能正确工作
划分三个文件的职责
拆分源码不是简单“把代码分散”,而是让依赖方向清楚:头文件只描述可用接口,实现文件负责业务与文件细节,入口文件只组织交互流程。这样修改持久化格式时,通常不需要改 main.cpp。
| 文件 | 主要职责 |
|---|---|
BookManager.h |
声明 Book、BookManager 及公开接口 |
BookManager.cpp |
实现查重、加载、保存和列表逻辑 |
main.cpp |
读取用户输入、校验格式并调用管理类 |
片段示例:BookManager.h 是完整程序的声明文件,需要与后面的 BookManager.cpp、main.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,负责实现管理类。
#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 依赖前两个文件,提供完整的命令行入口。
#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 的编译器构建。编译成功通常不会输出任何文本;后续测试命令会删除旧数据文件,使验证结果可重复。
g++ -std=c++17 -Wall -Wextra -pedantic BookManager.cpp main.cpp -o library预期输出
<无输出,编译成功后生成 library 可执行文件>接着依次测试合法添加、重复编号、非法编号和列表输出。
rm -f books.txt
printf "1\n1001\nC++ Primer\n1\n1001\nDuplicate\n1\nabc\n2\n0\n" | ./library预期输出
提示:未读取到 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 负责数据一致性,文件读写失败也通过返回值向上暴露。这样的边界划分能让后续增加删除、查询或更换存储格式时,不必把所有逻辑重新揉回程序入口。