← 返回刚才阅读的位置

知识卡片

普通读书笔记卡 · 2295.j

基本架构设计与架构文档

理解等级:中级

从零开始的基本架构设计三步: 1. 从功能需求列表中抽取架构需求列表和类功能列表,目标是得到一个包含所有类功能的候选子系统列表; 2. 选择要开发的子系统(每个可选开发子系统对应一个实际子系统),把设计子系统记录到基于功能的架构结构中; 3. 由基于功能的结构完成并发架构结构设计——设计系统内部线程结构和同步,确定并行的基本单位;再根据并行单位的分布确定物理架构结构。 这也是迭代过程,决策要反复推理、验证乃至重构。架构师先用多个视图描述架构需求——不同于按开发顺序的视图,因为单个视图显示部分信息也会隐藏其他信息;虽然耗时,但架构需求数量有限,更周全的方法能设计出更完善的架构。

ISARCS(智能软件架构原理捕获系统):设计问题来自一组需求和现有架构元素,可以有多种方案,但各方案对现有架构的影响和对需求的满足程度不同。利益相关者在系统中讨论每种方案的利弊;系统捕获设计问题与相关需求、可能受影响的现有架构元素之间的映射,并维护架构知识以便重新访问。智能分析包括:识别群体在不同观点上的集体意见和被重视的观点;建立可追溯性矩阵把架构元素关联到需求(有助于维护和变更管理);对观点做文本分析找出讨论最多的主题。

架构文档化:大多数架构是抽象的(没有编程语言定义“层”),架构的主要用途之一是利益相关者之间的交流媒介,所以软件架构唯一的体现方式就是它的文档,文档的质量和完整性是成功的关键。建议: - 完整且可追溯——有领域知识但没有架构经验的工程师也能轻松读懂; - 有显著的起点,所有子系统连成完整集合,每个子系统有清晰反映职责的名称,并有指针指向其详细设计文档; - 要受通信、数据分配的资源管理、时间管理等基础设施条件约束,预先规定约束框架,使系统在性能、容错、可维护性、安全性上表现良好; - 向所有利益相关者公开。

架构评估:由外部第三方审查者进行,目的是识别潜在风险、验证质量需求已被满足,也能加强文档、改进架构;设计、文档化、评估三者循环迭代,直到架构完全符合要求才进入编码。

这张卡片看不懂?

已有反馈 · 0 条

    还没有人提交反馈。

    在整书笔记中的位置

    原书出处 · 1 处

    • · 查看原书依据

      第一步的目标是开发一个候选的子系统列表,这个列表需要包括所有类的功能。

    参考来源

    - 位置:《软件架构理论与实践》第07章《第7章 架构驱动的软件开发》7.3.1 架构设计、文档化和评估是一个迭代过程(基本架构设计、架构文档化、架构评估)(源文件:extracted/软件架构理论与实践/_epub-src/OEBPS/text00058.html,来源项目 book-sources) - 结论依据:第7章给出从零开始的基本架构设计三步(抽取架构需求与类功能列表形成候选子系统、记录到功能结构、再推出并发结构与物理结构),介绍捕获设计问题与需求映射并建立可追溯矩阵的ISARCS,强调架构唯一的体现是文档并提出四条文档建议,以及由第三方进行的迭代式评估。 - 原始内容:第一步的目标是开发一个候选的子系统列表,这个列表需要包括所有类的功能。