chaocai

构客网首页  博客  论坛

 
  SOA我有话说
  本文的标签
其他 (收录19559篇)技术 (收录2478篇)生活 (收录2163篇)
  用户信息
 
帐号:  新手必读
密码: 保存密码
 
  分类列表
全部类别(6 篇)
我的文章(6 篇)
  按月归档
2008年-0月(6 篇)
  SOA2007 - SOA实践
我们何时迈向SOA
——SOA在中国的整体发展现状究竟如何?
我们如何迈向SOA
——中国企业如何迈出实施SOA的第一步?
我们应采用何种技术
——SOA国际标准SCA/SDO的具体内涵?
我们还需要何种技能
——SOA将如何改变系统架构设计以及项目管理过程?

多视图架构文档编写的要点

发布时间:2007年12月05日 作者:chaocai

阅读次数:208次 类别:我的文章 永久链接 Trackback 
参加SOA我有话说
采用多视图来描述系统架构目前已经成为广大架构师的共识,这样便于满足不同涉众的不同需求,也便于控制文档在复杂度。其实,架构设计文档最重要的就是简单易懂,可以把复杂度控制在不同层面,以下是个人写架构文档的一些经验和大家分享。

用例视图
在架构文档中的用例视图,仅列出架构用例(即那些重要性高,实现风险高影响架构设计的用例)
用例图也应该表示出系统工作的上下文和系统的边界(系统和那些外部人员及系统相关)
通常包括:UML的用例图及各种自由图(非UML标准的图)

架构因素
列出系统关注的非功能性需求(如:可靠性,安全性等)。

逻辑视图:
逻辑视图中包含的元素应该来自问题域。
逻辑视图应该与实现技术无关(如:采用.Net或J2EE实现等)
逻辑视图用于表示功能性需求的支持,和功能性需求的分解(包括按功能实现划分的子系统)
逻辑视图可以包含关键业务流程的建模
本人认为把分析后的BDM防置在逻辑视图中也十分有必要,这样可以便于读者理解文档
通常包括:UML的类图,序列图及各种自由图

开发视图
开发视图是与实现技术相关的
开发视图中还应该写入技术决策及决策的动机
架构用例实现是开发视图中必不可少的部分,即表明各组件在实现交互时的关系
考虑非功能性架构因素的实现
通常包括:UML的类图,组件图,序列图及各种自由图

部署视图
是系统与其运行环境的映射
部署视图表明了模块间的连接协议(如:JDBC,JMS)
部署视图同样体现了非功能性架构因素的实现

编写一份好的设计文档是一件十分困难的事,有时并不亚于设计本身。

 

蔡超
软件架构师,架构支持顾问
SCEA, IBM Certified OOA&D Solution Designer

 评论 查看全部评论