UML方案图规范和操作手册

UML方案图规范和操作手册一、概述

UML（统一建模语言）方案图是一种用于描述系统架构、组件交互和设计思路的可视化工具。本手册旨在提供UML方案图的规范和操作指南，帮助用户规范地创建和使用UML图，以提升系统设计的清晰度和可维护性。

二、UML方案图规范

（一）基本规范

1.统一命名：图中的所有元素（如类、接口、关系）应使用清晰、简洁的名称，避免歧义。

2.图例一致性：同一文档中应保持图例（如线条样式、颜色）的一致性，必要时提供图例说明。

3.版本管理：对UML图进行版本控制，记录每次修改的内容和时间。

（二）常用UML图类型规范

1.类图：

(1)类名使用大写字母开头，接口名使用斜体。

(2)属性和方法的命名需符合设计规范，如私有属性以"_"开头。

(3)关系线使用标准样式（如实线、虚线）表示继承、关联和依赖。

2.用例图：

(1)参与者（Actor）名称需明确，如"用户""管理员"。

(2)用例（UseCase）用椭圆形表示，并与参与者用关联线连接。

3.状态机图：

(1)状态名称使用动词或动词短语，如"初始化""处理完成"。

(2)转换条件（如"收到请求"）标注在转换箭头上。

三、UML方案图操作手册

（一）创建UML图的基本步骤

1.选择工具：

(1)安装UML建模软件（如StarUML、Visio）。

(2)选择合适的图类型（如类图、时序图）。

2.绘制框架：

(1)添加核心元素（如类、接口）。

(2)定义元素间的初步关系。

3.细化内容：

(1)填充属性和方法（如类图中的私有/公有属性）。

(2)添加注释和标签，说明关键逻辑。

（二）高级操作技巧

1.动态交互图（时序图）：

(1)按时间顺序排列对象生命线。

(2)使用消息箭头表示方法调用（如同步/异步调用）。

2.图形优化：

(1)调整布局（如使用网格对齐）。

(2)添加颜色区分不同层级元素（如用例图中的主要/次要用例）。

（三）常见问题及解决方法

1.图形混乱：

(1)删除冗余线条，简化关系。

(2)使用分组功能（如Visio中的"SmartArt"）。

2.版本冲突：

(1)使用版本控制插件（如Git的图形化界面）。

(2)定期备份历史版本。

四、附录

（一）术语表

类（Class）：系统中的实体，包含属性和方法。

关联（Association）：对象间的双向关系。

继承（Inheritance）：子类继承父类的特性。

（二）推荐工具

1.StarUML：适合复杂系统设计，支持多种图类型。

2.Lucidchart：在线协作平台，易于团队共享。

（三）示例数据

假设一个电商系统类图包含：

-类：用户（属性：ID、姓名；方法：登录、下单）

-关联：用户与订单（1:N关系）

-接口：支付（方法：支付订单、退款）

二、UML方案图规范（续）

（一）基本规范（续）

1.统一命名：

(1)类名：应使用名词或名词短语，清晰表示其代表的实体或概念。遵循驼峰命名法（CamelCase），首字母大写，如`UserAccount`、`ProductInventory`。避免使用缩写，除非广泛通用且无歧义（如`DateRange`）。

(2)接口名：使用动词或动词短语，表示系统提供的服务能力。同样遵循驼峰命名法，首字母大写，如`ICalculateFee`、`IPayProcessor`。

(3)属性名：描述类的特征。私有（受保护）属性可使用下划线前缀（如`_userId`），公有属性遵循驼峰命名法（如`userName`）。布尔型属性名通常表示状态，如`isActive`。

(4)方法名：描述类的行为。遵循小写字母开头、单词间用下划线分隔的蛇形命名法（snake_case），或驼峰命名法（如`calculateTotalPrice`、`saveOrderDetails`）。主方法名（如类名相同的方法）通常命名为`initialize`或省略。

(5)参与者（Actor）名：代表与系统交互的外部实体（如用户、设备）。应使用名词，指明其身份或角色，如`Customer`、`Administrator`、`PaymentGateway`。

(6)用例（UseCase）名：描述参与者能请求系统执行的操作，是动词短语，如`PlaceOrder`、`ManageInventory`。

2.图例一致性：

(1)标准符号：优先使用UML标准定义的符号。例如，类用矩形（分为三个部分：类名、属性、方法），接口用矩形加斜体（分为两部分：接口名、方法），用例用椭圆形，参与者用矩形加小人图标。

(2)线条样式：明确不同关系线的含义和样式。

关联（Association）：实线，可能带箭头（表示方向）或不带箭头（表示双向）。

依赖（Dependency）：虚线，带箭头，表示一方依赖另一方（如使用接口）。

泛化（Generalization）：实线，带空心三角形箭头，表示继承或实现关系（子类指向父类）。

组合（Composition）：实线，带黑色箭头，表示“拥有”关系，整体生命周期控制部分生命周期（如容器与内容项）。

聚合（Aggregation）：实线，带空心箭头，表示“整体”与“部分”关系，部分可独立于整体存在（如汽车与轮胎）。

(3)颜色与字体：在复杂图中，可使用不同颜色区分不同类型的元素（如类用蓝色，接口用绿色），但需在图旁注明图例。字体保持统一、清晰。

(4)布局风格：保持一致的布局方向（如关联线箭头总是指向依赖方）和排列逻辑（如类图按依赖或泛化关系组织）。

3.版本管理：

(1)工具：使用版本控制软件（如Git）管理UML图文件。为UML图创建专门的分支或提交策略。

(2)注释：在每次修改时添加清晰的提交信息，说明变更内容（如“添加用户登录模块类图”、“更新订单状态机”）。

(3)比较：定期使用工具比较不同版本之间的差异，确保变更符合预期。

(4)备份：除了版本控制，还应定期对重要版本的UML图进行外部备份。

（二）常用UML图类型规范（续）

1.类图：

(1)结构部分：

类名：置于矩形顶部中央，加粗。

属性：置于矩形中部，列出属性名、类型（如`int`、`String`）、访问修饰符（`+`公有，``受保护，`-`私有）。可按访问修饰符分组。

方法：置于矩形底部，列出方法名、返回类型、参数列表、访问修饰符。特殊方法（如构造函数）也应列出。可按访问修饰符分组。

接口：矩形顶部加斜体标题，列出公有方法（返回类型、方法名、参数）。

(2)关系部分：

关联：明确端点（如类名或角色名）和基数（如`1`、``、`0..1`、`1..5`）。例如，`Customer1---0..Order`表示一个客户可以下零个或多个订单。

依赖：用虚线箭头连接，箭头指向被依赖的类或接口。通常标注依赖原因（如`uses`、`implements`）。

泛化：用实线加空心三角形箭头连接，箭头指向父类。子类自动继承父类属性和方法。

组合/聚合：用带箭头的实线（组合）或空心箭头的实线（聚合）连接。明确组合（整体拥有部分，生命周期相关）和聚合（整体拥有部分，生命周期独立）的语义。

(3)命名规范：避免使用泛型类型名称（除非必要且清晰，如`Customer<Gender>`通常不推荐，可改为`Customermale/female`或在代码中体现），使用具体类型（如`java.util.Date`而不是`Date`）。

2.用例图：

(1)参与者：椭圆形表示，包含参与者名称。可进一步分类（如“外部用户”、“内部系统”）。

(2)用例：椭圆形表示，包含用例名称。用例应具有明确的价值和边界。

(3)关系：

关联（Association）：实线连接参与者和用例，表示参与者可以执行该用例。

包含（Include）：虚线加空心箭头连接，表示一个用例（被包含者）隐式地使用另一个用例（包含者）的部分或全部行为。例如，`PlaceOrder`包含`VerifyPayment`。应在被包含用例中明确标注。

扩展（Extend）：虚线加实心箭头连接，表示在特定条件下，一个用例（扩展者）会添加到另一个用例（基用例）的行为。基用例的核心行为必须先执行。在扩展点处标注触发条件。适用于增加可选或条件性功能。

泛化（Generalization）：实线加空心三角形箭头连接，表示多个用例共享相同的行为。例如，`Search`、`Browse`、`Filter`都可以泛化自`ViewItems`。

(4)系统边界：在图外围绘制一个矩形，框住所有用例，表示系统（System）的边界。

3.状态机图：

(1)状态：圆角矩形表示，包含状态名称。初始状态用空心圆圈加箭头表示，最终状态用实心圆圈表示。

(2)转换：带箭头的实线表示状态之间的转换。箭头旁标注触发事件（如`clickButton`）和可选的动作（如`setActive=true`）。

(3)子状态与复合状态：使用嵌套的圆角矩形表示子状态（如`active`状态内可以有`processing`、`waiting`子状态）。简单并发行为可用分叉（横向箭头）和汇合（纵向箭头）表示。可选状态（可选执行的动作）用虚线框和内部文字表示。

(4)伪状态：特定关键字表示特殊状态，如`initial`（隐式初始状态，也可显式画）、`shallowHistory`（浅历史状态，用于恢复）、`deepHistory`（深历史状态，保存所有状态信息）。

(5)命名规范：状态名称应为动词或动词短语，描述系统在该状态下的行为或条件（如`idle`、`processingPayment`、`orderCompleted`）。

4.时序图：

(1)对象：矩形框表示参与交互的对象，按时间顺序垂直排列。顶部显示对象名（如`orderProcessor`）。

(2)生命线：垂直的虚线表示对象在时间段内存在。

(3)消息：垂直的实线箭头表示对象间的交互。

同步消息：实线箭头，发送方等待接收方响应。箭头旁标注消息名称（如`sendPaymentRequest`）。

异步消息：虚线箭头，发送方不等待接收方响应。

自消息：箭头从对象生命线出发，指向自身，表示对象调用自己的方法。

(4)激活条：在生命线内显示的矩形条，表示对象正在执行操作或处理消息。

(5)时间轴：顶部水平线表示时间流逝，事件按时间顺序排列。可使用粗线或分隔线表示关键时间点或阶段。

(6)命名规范：对象名遵循类命名规范。消息名应为动词短语，描述交互内容。

三、UML方案图操作手册（续）

（一）创建UML图的基本步骤（续）

1.选择工具（续）：

(1)选择依据：考虑团队规模、项目需求（简单/复杂）、预算、易用性。免费工具（如PlantUML在线编辑器、Eclipse的UML插件）适合小型项目或学习。商业软件（如StarUML、MagicDraw）功能更全，支持高级特性和团队协作。

(2)安装与设置：根据所选软件的指引完成安装。熟悉软件界面布局、工具栏、属性编辑器。

(3)模板使用：利用软件提供的UML图模板快速启动，避免从零开始配置。

2.绘制框架（续）：

(1)识别核心元素：根据系统需求，列出需要建模的主要类、接口、参与者、用例。可先从用例图或类图入手。

(2)添加元素：在画布上绘制相应图形（矩形表示类/接口，椭圆表示用例/参与者等）。

(3)命名核心元素：为每个图形分配初步但符合规范的名称。

(4)定义基本关系：使用工具栏的连接线工具，绘制核心元素间的主要关系（如类间的关联、用例与参与者的关联）。

3.细化内容（续）：

(1)填充属性和方法：

选中类或接口图形，在属性编辑器中添加属性，指定名称、类型、访问修饰符。

添加方法，指定名称、返回类型、参数列表、访问修饰符。注意实现接口方法。

(2)添加注释和标签：

使用注释工具（如矩形框加斜体文字`<<note>>`）解释复杂关系、约束条件或设计决策。

在图形上或关系线上添加标签，说明具体的参数、条件或含义（如`1..`、`read-only`）。

(3)调整布局与样式：

使用对齐、分布工具使图形排列整齐。

调整字体、颜色、线型，增强可读性，但保持一致性。

（二）高级操作技巧（续）

1.动态交互图（时序图）（续）：

(1)识别交互场景：选择需要详细描述交互流程的用例或操作，如数据库访问、复杂计算、多对象协作。

(2)创建时序图：新建时序图，添加相关对象作为参与者。

(3)设计交互流程：按时间顺序，绘制对象间的消息传递，注意区分同步、异步消息。

(4)使用组合块（CombineFragment）：对于复杂的交互，使用组合块（矩形加“<<combine>>”标签）将一组消息序列化或并行化，并添加条件或循环控制（如`<<if>>`、`<<for>>`）。

(5)细化消息内容：在消息箭头旁，不仅写事件名，还可写简短的参数说明或预期结果，增强理解。

2.图形优化（续）：

(1)层次化布局：将图中元素按逻辑关系（如父类-子类、主要-次要）进行分层排列，使用户能快速把握整体结构。

(2)颜色与高亮：适度使用颜色突出关键元素（如核心类、主要流程）或区分不同模块，但避免过度使用导致视觉混乱。确保色盲用户也能区分（如用粗细、形状配合）。

(3)交互式导航（针对软件工具）：利用软件的交互功能，如点击类图中的类，跳转到对应的时序图或状态机图，展示其详细行为。

(4)使用包（Package）：将大型图分解为多个包，每个包包含相关联的元素，通过包间关系（如依赖）连接。使用包可提高复杂图的组织性和可管理性。

（三）常见问题及解决方法（续）

1.图形混乱（续）：

(1)减少连接线：检查是否所有关系都是必要的，移除冗余或隐含的关系。使用泛化、包含、扩展等UML机制替代显式连接。

(2)使用分组：将紧密相关的元素（如一个类及其关联的辅助类）用矩形框（包）包围，并命名包名。

(3)交叉引用：对于跨越画布的复杂关系，可使用指向线（ReferenceLine，细虚线带箭头）引向另一侧的详细图或同一画布的另一部分。

(4)视图分离：对于非常复杂的类图，可将其拆分为多个视图，如接口视图、实体视图、控制视图，并通过包关系连接。

2.版本冲突（续）：

(1)分支策略：为不同功能的UML图或版本创建独立分支（如`feature-a`、`refactor-diagram`），完成后再合并。避免在同一分支上同时修改多个相互依赖的图。

(2)代码驱动建模（若适用）：如果项目使用代码生成UML图，保持代码与UML图的双向同步。使用模型驱动开发（MDD）工具，变更代码自动更新UML，或变更UML自动更新代码。

(3)定期评审与集成：设定固定时间（如每周）进行代码和UML图的集成检查和评审，及早发现并解决冲突。

(4)清晰的变更日志：强制要求每次提交都附带详细的日志，说明变更内容、原因和影响，便于追踪和解决冲突。

四、附录（续）

（一）术语表（续）

依赖（Dependency）：一种单向的、较弱的关系，表示一个元素（依赖方）依赖于另一个元素（被依赖方）的变化。通常用于实现接口、使用变量或方法。用虚线箭头表示。

关联（Association）：表示两个或多个对象之间的结构化关系，强调对象间的连接或聚合。可以是双向的。用实线表示。基数（Cardinality）描述参与关系的对象数量（如`1`、``、`0..1`）。

聚合（Aggregation）：一种特殊的关联，表示“整体-部分”关系，其中部分可以独立于整体存在，但整体拥有部分。强调部分与整体的“拥有”语义，但生命周期相对独立。用带空心箭头的实线表示。

组合（Composition）：一种更强烈的聚合，表示“整体-部分”关系，其中整体控制部分的生命周期，部分不能独立于整体存在。强调整体对部分的“拥有”和生命周期管理。用带黑色箭头的实线表示。

接口（Interface）：定义了一组操作的规范，表示系统提供的服务能力。没有状态（属性），只有方法。类可以实现一个或多个接口。用矩形加斜体标题表示。

泛化（Generalization）：表示特殊化或继承关系，子类（特殊化方）继承父类（一般化方）的属性和方法。允许多重继承（从一个父类继承到多个子类）。用实线加空心三角形箭头表示。

用例（UseCase）：描述了系统为其用户提供的一个价值主张，是一个由参与者执行的、可被观察到的、独立的功能性单元。用椭圆形表示。

参与者（Actor）：与系统交互的外部实体，可以是人、其他系统或设备。用矩形加小人图标表示。

状态（State）：对象在其生命周期中经历的一个特定条件或行为模式。状态机图中的核心元素。用圆角矩形表示。

转换（Transition）：状态机中，从一个状态到另一个状态的变迁。由事件触发。用带箭头的实线表示，通常标注触发事件和可选的动作。

（二）推荐工具（续）

PlantUML：纯文本描述UML图的在线编辑器和库。优点是易于集成到文档（如Markdown、Wiki）、版本控制（文本文件）、跨平台。缺点是界面基本无，学习曲线较陡。适合技术文档作者。

Draw.io()：功能强大的在线绘图工具，支持UML及其他多种图形类型。免费，界面友好，插件丰富。适合快速创建和分享。缺点是高级UML特性可能不如专业软件完善。

StarUML：商业UML建模工具，提供全面的UML图类型、丰富的模型元素、代码生成/逆向工程、团队协作功能。适合中大型项目和团队。有免费版（功能受限）和付费版。

EclipseUML2Tools：基于Eclipse平台的免费UML建模插件。功能较全，适合Java开发团队集成。缺点是安装和配置相对复杂，生态系统不如商业软件成熟。

MicrosoftVisio：专业的图表绘制软件，包含UML图模板。功能强大，易于绘制复杂图形。缺点是价格昂贵，且UML模板可能需要单独购买或更新。

（三）示例数据（续）

假设一个在线图书馆系统，其核心类图可能包含以下元素和关系：

类：

`Book`

属性：`_isbn(String)`、`_title(String)`、`_author(String)`、`_status(String)`（如"Available","Borrowed"）

方法：`getIsbn()`,`getTitle()`,`setStatus(status)`

`User`

属性：`_userId(int)`、`_name(String)`、`_borrowedBooks(List<Book>)`、`_isActive(boolean)`

方法：`getUserId()`,`borrowBook(book)`,`returnBook(book)`,`isActive()`

`Loan`(关联`Book`和`User`)

属性：`_loanId(int)`、`_loanDate(Date)`、`_dueDate(Date)`、`_returnDate(Date)`

方法：`getLoanId()`,`getDueDate()`,`setReturnDate(returnDate)`

关系：

`User`1---`Loan`（一个用户可以有多个借阅记录）

`Loan`---1`Book`（一个借阅记录对应一本特定的书）

`User`1---0..`BorrowedBooks`（用户拥有一个借阅书籍的列表，可以有零本）

`Book`--`Loan`（可选，表示书籍的当前借阅状态，如果存在）

接口：

`IReservation`(方法：`reserveBook(userId,bookId)`,`cancelReservation(reservationId)`)

`INotificationService`(方法：`sendEmail(user,message)`,`sendSMS(user,message)`)

参与者：

`Librarian`(可以执行`CheckinBook`、`ProcessLoanReturn`、`ManageUserAccount`等用例)

`Patron`(可以执行`SearchBooks`、`BorrowBook`、`ReturnBook`、`ReserveBook`等用例)

一、概述

UML（统一建模语言）方案图是一种用于描述系统架构、组件交互和设计思路的可视化工具。本手册旨在提供UML方案图的规范和操作指南，帮助用户规范地创建和使用UML图，以提升系统设计的清晰度和可维护性。

二、UML方案图规范

（一）基本规范

1.统一命名：图中的所有元素（如类、接口、关系）应使用清晰、简洁的名称，避免歧义。

2.图例一致性：同一文档中应保持图例（如线条样式、颜色）的一致性，必要时提供图例说明。

3.版本管理：对UML图进行版本控制，记录每次修改的内容和时间。

（二）常用UML图类型规范

1.类图：

(1)类名使用大写字母开头，接口名使用斜体。

(2)属性和方法的命名需符合设计规范，如私有属性以"_"开头。

(3)关系线使用标准样式（如实线、虚线）表示继承、关联和依赖。

2.用例图：

(1)参与者（Actor）名称需明确，如"用户""管理员"。

(2)用例（UseCase）用椭圆形表示，并与参与者用关联线连接。

3.状态机图：

(1)状态名称使用动词或动词短语，如"初始化""处理完成"。

(2)转换条件（如"收到请求"）标注在转换箭头上。

三、UML方案图操作手册

（一）创建UML图的基本步骤

1.选择工具：

(1)安装UML建模软件（如StarUML、Visio）。

(2)选择合适的图类型（如类图、时序图）。

2.绘制框架：

(1)添加核心元素（如类、接口）。

(2)定义元素间的初步关系。

3.细化内容：

(1)填充属性和方法（如类图中的私有/公有属性）。

(2)添加注释和标签，说明关键逻辑。

（二）高级操作技巧

1.动态交互图（时序图）：

(1)按时间顺序排列对象生命线。

(2)使用消息箭头表示方法调用（如同步/异步调用）。

2.图形优化：

(1)调整布局（如使用网格对齐）。

(2)添加颜色区分不同层级元素（如用例图中的主要/次要用例）。

（三）常见问题及解决方法

1.图形混乱：

(1)删除冗余线条，简化关系。

(2)使用分组功能（如Visio中的"SmartArt"）。

2.版本冲突：

(1)使用版本控制插件（如Git的图形化界面）。

(2)定期备份历史版本。

四、附录

（一）术语表

类（Class）：系统中的实体，包含属性和方法。

关联（Association）：对象间的双向关系。

继承（Inheritance）：子类继承父类的特性。

（二）推荐工具

1.StarUML：适合复杂系统设计，支持多种图类型。

2.Lucidchart：在线协作平台，易于团队共享。

（三）示例数据

假设一个电商系统类图包含：

-类：用户（属性：ID、姓名；方法：登录、下单）

-关联：用户与订单（1:N关系）

-接口：支付（方法：支付订单、退款）

二、UML方案图规范（续）

（一）基本规范（续）

1.统一命名：

(1)类名：应使用名词或名词短语，清晰表示其代表的实体或概念。遵循驼峰命名法（CamelCase），首字母大写，如`UserAccount`、`ProductInventory`。避免使用缩写，除非广泛通用且无歧义（如`DateRange`）。

(2)接口名：使用动词或动词短语，表示系统提供的服务能力。同样遵循驼峰命名法，首字母大写，如`ICalculateFee`、`IPayProcessor`。

(3)属性名：描述类的特征。私有（受保护）属性可使用下划线前缀（如`_userId`），公有属性遵循驼峰命名法（如`userName`）。布尔型属性名通常表示状态，如`isActive`。

(4)方法名：描述类的行为。遵循小写字母开头、单词间用下划线分隔的蛇形命名法（snake_case），或驼峰命名法（如`calculateTotalPrice`、`saveOrderDetails`）。主方法名（如类名相同的方法）通常命名为`initialize`或省略。

(5)参与者（Actor）名：代表与系统交互的外部实体（如用户、设备）。应使用名词，指明其身份或角色，如`Customer`、`Administrator`、`PaymentGateway`。

(6)用例（UseCase）名：描述参与者能请求系统执行的操作，是动词短语，如`PlaceOrder`、`ManageInventory`。

2.图例一致性：

(1)标准符号：优先使用UML标准定义的符号。例如，类用矩形（分为三个部分：类名、属性、方法），接口用矩形加斜体（分为两部分：接口名、方法），用例用椭圆形，参与者用矩形加小人图标。

(2)线条样式：明确不同关系线的含义和样式。

关联（Association）：实线，可能带箭头（表示方向）或不带箭头（表示双向）。

依赖（Dependency）：虚线，带箭头，表示一方依赖另一方（如使用接口）。

泛化（Generalization）：实线，带空心三角形箭头，表示继承或实现关系（子类指向父类）。

组合（Composition）：实线，带黑色箭头，表示“拥有”关系，整体生命周期控制部分生命周期（如容器与内容项）。

聚合（Aggregation）：实线，带空心箭头，表示“整体”与“部分”关系，部分可独立于整体存在（如汽车与轮胎）。

(3)颜色与字体：在复杂图中，可使用不同颜色区分不同类型的元素（如类用蓝色，接口用绿色），但需在图旁注明图例。字体保持统一、清晰。

(4)布局风格：保持一致的布局方向（如关联线箭头总是指向依赖方）和排列逻辑（如类图按依赖或泛化关系组织）。

3.版本管理：

(1)工具：使用版本控制软件（如Git）管理UML图文件。为UML图创建专门的分支或提交策略。

(2)注释：在每次修改时添加清晰的提交信息，说明变更内容（如“添加用户登录模块类图”、“更新订单状态机”）。

(3)比较：定期使用工具比较不同版本之间的差异，确保变更符合预期。

(4)备份：除了版本控制，还应定期对重要版本的UML图进行外部备份。

（二）常用UML图类型规范（续）

1.类图：

(1)结构部分：

类名：置于矩形顶部中央，加粗。

属性：置于矩形中部，列出属性名、类型（如`int`、`String`）、访问修饰符（`+`公有，``受保护，`-`私有）。可按访问修饰符分组。

方法：置于矩形底部，列出方法名、返回类型、参数列表、访问修饰符。特殊方法（如构造函数）也应列出。可按访问修饰符分组。

接口：矩形顶部加斜体标题，列出公有方法（返回类型、方法名、参数）。

(2)关系部分：

关联：明确端点（如类名或角色名）和基数（如`1`、``、`0..1`、`1..5`）。例如，`Customer1---0..Order`表示一个客户可以下零个或多个订单。

依赖：用虚线箭头连接，箭头指向被依赖的类或接口。通常标注依赖原因（如`uses`、`implements`）。

泛化：用实线加空心三角形箭头连接，箭头指向父类。子类自动继承父类属性和方法。

组合/聚合：用带箭头的实线（组合）或空心箭头的实线（聚合）连接。明确组合（整体拥有部分，生命周期相关）和聚合（整体拥有部分，生命周期独立）的语义。

(3)命名规范：避免使用泛型类型名称（除非必要且清晰，如`Customer<Gender>`通常不推荐，可改为`Customermale/female`或在代码中体现），使用具体类型（如`java.util.Date`而不是`Date`）。

2.用例图：

(1)参与者：椭圆形表示，包含参与者名称。可进一步分类（如“外部用户”、“内部系统”）。

(2)用例：椭圆形表示，包含用例名称。用例应具有明确的价值和边界。

(3)关系：

关联（Association）：实线连接参与者和用例，表示参与者可以执行该用例。

包含（Include）：虚线加空心箭头连接，表示一个用例（被包含者）隐式地使用另一个用例（包含者）的部分或全部行为。例如，`PlaceOrder`包含`VerifyPayment`。应在被包含用例中明确标注。

扩展（Extend）：虚线加实心箭头连接，表示在特定条件下，一个用例（扩展者）会添加到另一个用例（基用例）的行为。基用例的核心行为必须先执行。在扩展点处标注触发条件。适用于增加可选或条件性功能。

泛化（Generalization）：实线加空心三角形箭头连接，表示多个用例共享相同的行为。例如，`Search`、`Browse`、`Filter`都可以泛化自`ViewItems`。

(4)系统边界：在图外围绘制一个矩形，框住所有用例，表示系统（System）的边界。

3.状态机图：

(1)状态：圆角矩形表示，包含状态名称。初始状态用空心圆圈加箭头表示，最终状态用实心圆圈表示。

(2)转换：带箭头的实线表示状态之间的转换。箭头旁标注触发事件（如`clickButton`）和可选的动作（如`setActive=true`）。

(3)子状态与复合状态：使用嵌套的圆角矩形表示子状态（如`active`状态内可以有`processing`、`waiting`子状态）。简单并发行为可用分叉（横向箭头）和汇合（纵向箭头）表示。可选状态（可选执行的动作）用虚线框和内部文字表示。

(4)伪状态：特定关键字表示特殊状态，如`initial`（隐式初始状态，也可显式画）、`shallowHistory`（浅历史状态，用于恢复）、`deepHistory`（深历史状态，保存所有状态信息）。

(5)命名规范：状态名称应为动词或动词短语，描述系统在该状态下的行为或条件（如`idle`、`processingPayment`、`orderCompleted`）。

4.时序图：

(1)对象：矩形框表示参与交互的对象，按时间顺序垂直排列。顶部显示对象名（如`orderProcessor`）。

(2)生命线：垂直的虚线表示对象在时间段内存在。

(3)消息：垂直的实线箭头表示对象间的交互。

同步消息：实线箭头，发送方等待接收方响应。箭头旁标注消息名称（如`sendPaymentRequest`）。

异步消息：虚线箭头，发送方不等待接收方响应。

自消息：箭头从对象生命线出发，指向自身，表示对象调用自己的方法。

(4)激活条：在生命线内显示的矩形条，表示对象正在执行操作或处理消息。

(5)时间轴：顶部水平线表示时间流逝，事件按时间顺序排列。可使用粗线或分隔线表示关键时间点或阶段。

(6)命名规范：对象名遵循类命名规范。消息名应为动词短语，描述交互内容。

三、UML方案图操作手册（续）

（一）创建UML图的基本步骤（续）

1.选择工具（续）：

(1)选择依据：考虑团队规模、项目需求（简单/复杂）、预算、易用性。免费工具（如PlantUML在线编辑器、Eclipse的UML插件）适合小型项目或学习。商业软件（如StarUML、MagicDraw）功能更全，支持高级特性和团队协作。

(2)安装与设置：根据所选软件的指引完成安装。熟悉软件界面布局、工具栏、属性编辑器。

(3)模板使用：利用软件提供的UML图模板快速启动，避免从零开始配置。

2.绘制框架（续）：

(1)识别核心元素：根据系统需求，列出需要建模的主要类、接口、参与者、用例。可先从用例图或类图入手。

(2)添加元素：在画布上绘制相应图形（矩形表示类/接口，椭圆表示用例/参与者等）。

(3)命名核心元素：为每个图形分配初步但符合规范的名称。

(4)定义基本关系：使用工具栏的连接线工具，绘制核心元素间的主要关系（如类间的关联、用例与参与者的关联）。

3.细化内容（续）：

(1)填充属性和方法：

选中类或接口图形，在属性编辑器中添加属性，指定名称、类型、访问修饰符。

添加方法，指定名称、返回类型、参数列表、访问修饰符。注意实现接口方法。

(2)添加注释和标签：

使用注释工具（如矩形框加斜体文字`<<note>>`）解释复杂关系、约束条件或设计决策。

在图形上或关系线上添加标签，说明具体的参数、条件或含义（如`1..`、`read-only`）。

(3)调整布局与样式：

使用对齐、分布工具使图形排列整齐。

调整字体、颜色、线型，增强可读性，但保持一致性。

（二）高级操作技巧（续）

1.动态交互图（时序图）（续）：

(1)识别交互场景：选择需要详细描述交互流程的用例或操作，如数据库访问、复杂计算、多对象协作。

(2)创建时序图：新建时序图，添加相关对象作为参与者。

(3)设计交互流程：按时间顺序，绘制对象间的消息传递，注意区分同步、异步消息。

(4)使用组合块（CombineFragment）：对于复杂的交互，使用组合块（矩形加“<<combine>>”标签）将一组消息序列化或并行化，并添加条件或循环控制（如`<<if>>`、`<<for>>`）。

(5)细化消息内容：在消息箭头旁，不仅写事件名，还可写简短的参数说明或预期结果，增强理解。

2.图形优化（续）：

(1)层次化布局：将图中元素按逻辑关系（如父类-子类、主要-次要）进行分层排列，使用户能快速把握整体结构。

(2)颜色与高亮：适度使用颜色突出关键元素（如核心类、主要流程）或区分不同模块，但避免过度使用导致视觉混乱。确保色盲用户也能区分（如用粗细、形状配合）。

(3)交互式导航（针对软件工具）：利用软件的交互功能，如点击类图中的类，跳转到对应的时序图或状态机图，展示其详细行为。

(4)使用包（Package）：将大型图分解为多个包，每个包包含相关联的元素，通过包间关系（如依赖）连接。使用包可提高复杂图的组织性和可管理性。

（三）常见问题及解决方法（续）

1.图形混乱（续）：

(1)减少连接线：检查是否所有关系都是必要的，移除冗余或隐含的关系。使用泛化、包含、扩展等UML机制替代显式连接。

(2)使用分组：将紧密相关的元素（如一个类及其关联的辅助类）用矩形框（包）包围，并命名包名。

(3)交叉引用：对于跨越画布的复杂关系，可使用指向线（ReferenceLine，细虚线带箭头）引向另一侧的详细图或同一画布的另一部分。

(4)视图分离：对于非常复杂的类图，可将其拆分为多个视图，如接口视图、实体视图、控制视图，并通过包关系连接。

2.版本冲突（续）：

(1)分支策略：为不同功能的UML图或版本创建独立分支（如`feature-a`、`refactor-diagram`），完成后再合并。避免在同一分支上同时修改多个相互依赖的图。

(2)代码驱动建模（若适用）：如果项目使用代码生成UML图，保持代码与UML图的双向同步。使用模型驱动开发（MDD）工具，变更代码自动更新UML，或变更UML自动更新代码。

(3)定期评审与集成：设定固定时间（如每周）进行代码和UML图的集成检查和评审，及早发现并解决冲突。

(4)清晰的变更日志：强制要求每次提交都附带详细的日志，说明变更内容、原因和影响，便于追踪和解决冲突。

四、附录（续）

（一）术语表（续）

依赖（Dependency）：一种单向的、较弱的关系，表示一个元素（依赖方）依赖于另一个元素（被依赖方）的变化。通常用于实现接口、使用变量或方法。用虚线箭头表示。

关联（Association）：表示两个或多个对象之间的结构化关系，强调对象间的连接或聚合。可以是双向的。用实线表示。基数（Cardinality）描述参与关系的对象数量（如`1`、``、`0..1`）。

聚合（Aggregation）：一种特殊的关联，表示“整体-部分”关系，其中部分可以独立于整体存在，但整体拥有部分。强调部分与整体的“拥有”语义，但生命周期相对独立。用带空心箭头的实线表示。

组合（Composition）：一种更强烈的聚合，表示“整体-部分”关系，其中整体控制部分的生命周期，部分不能独立于整体存在。强调整体对部分的“拥有”和生命周期管理。用带黑色箭头的实线表示。

接口（Interface）：定义了一组操作的规范，表示系统提供的服务能力。没有状态（属性），只有方法。类可以实现一个或多个接口。用矩形加斜体标题表示。

泛化（Generalization）：表示特殊化或继承关系，子类（特殊化方）继承父类（一般化方）的属性和方法。允许多重继承（从一个父类继承到多个子类）。用实线加空心三角形箭头表示。

用例（UseCase）：描述了系统为其用户提供的一个价值主张，是一个由参与者执行的、可被观察到的、独立的功能性单元。用椭圆形表示。

参与者（Actor）：与系统交互的外部实体，可以是人、其他系统或设备。用矩形加小人图标表示。

状态（State）：对象在其生命周期中经历的一个特定条件或行为模式。状态机图中的核心元素。用圆角矩形表示。

转换（Transition）：状态机中，从一个状态到另一个状态的变迁。由事件触发。用带箭头的实线表示，通常标注触发事件和可选的动作。

（二）推荐工具（续）

PlantUML：纯文本描述UML图的在线编辑器和库。优点是易于集成到文档（如Markdown、Wiki）、版本控制（文本文件）、跨平台。缺点是界面基本无，学习曲线较陡。适合技术文档作者。

Draw.io()：功能强大的在线绘图工具，支持UML及其他多种图形类型。免费，界面友好，插件丰富。适合快速创建和分享。缺点是高级UML特性可能不如专业软件完善。

StarUML：商业UML建模工具，提供全面的UML图类型、丰富的模型元素、代码生成/逆向工程、团队协作功能。适合中大型项目和团队。有免费版（功能受限）和付费版。

EclipseUML2Tools：基于Eclipse平台的免费UML建模插件。功能较全，适合Java开发团队集成。缺点是安装和配置相对复杂，生态系统不如商业软件成熟。

MicrosoftVisio：专业的图表绘制软件，包含UML图模板。功能强大，易于绘制复杂图形。缺点是价格昂贵，且UML模板可能需要单独购买或更新。

（三）示例数据（续）

假设一个在线图书馆系统，其核心类图可能包含以下元素和关系：

类：

`Book`

属性：`_isbn(String)`、`_title(String)`、`_author(String)`、`_status(String)`（如"Available","Borrowed"）

方法：`getIsbn()`,`getTitle()`,`setStatus(status)`

`User`

属性：`_userId(int)`、`_name(String)`、`_borrowedBooks(List<Book>)`、`_isActive(boolean)`

方法：`getUserId()`,`borrowBook(book)`,`returnBook(book)`,`isActive()`

`Loan`(关联`Book`和`User`)

属性：`_loanId(int)`、`_loanDate(Date)`、`_dueDate(Date)`、`_returnDate(Date)`

方法：`getLoanId()`,`getDueDate()`,`setReturnDate(returnDate)`

关系：

`User`1---`Loan`（一个用户可以有多个借阅记录）

`Loan`---1`Book`（一个借阅记录对应一本特定的书）

`User`1---0..`BorrowedBooks`（用户拥有一个借阅书籍的列表，可以有零本）

`Book`--`Loan`（可选，表示书籍的当前借阅状态，如果存在）

接口：

`IReservation`(方法：`reserveBook(userId,bookId)`,`cancelReservation(reservationId)`)

`INotificationService`(方法：`sendEmail(user,message)`,`sendSMS(user,message)`)

参与者：

`Librarian`(可以执行`CheckinBook`、`ProcessLoanReturn`、`ManageUserAccount`等用例)

`Patron`(可以执行`SearchBooks`、`BorrowBook`、`ReturnBook`、`ReserveBook`等用例)

一、概述

UML（统一建模语言）方案图是一种用于描述系统架构、组件交互和设计思路的可视化工具。本手册旨在提供UML方案图的规范和操作指南，帮助用户规范地创建和使用UML图，以提升系统设计的清晰度和可维护性。

二、UML方案图规范

（一）基本规范

1.统一命名：图中的所有元素（如类、接口、关系）应使用清晰、简洁的名称，避免歧义。

2.图例一致性：同一文档中应保持图例（如线条样式、颜色）的一致性，必要时提供图例说明。

3.版本管理：对UML图进行版本控制，记录每次修改的内容和时间。

（二）常用UML图类型规范

1.类图：

(1)类名使用大写字母开头，接口名使用斜体。

(2)属性和方法的命名需符合设计规范，如私有属性以"_"开头。

(3)关系线使用标准样式（如实线、虚线）表示继承、关联和依赖。

2.用例图：

(1)参与者（Actor）名称需明确，如"用户""管理员"。

(2)用例（UseCase）用椭圆形表示，并与参与者用关联线连接。

3.状态机图：

(1)状态名称使用动词或动词短语，如"初始化""处理完成"。

(2)转换条件（如"收到请求"）标注在转换箭头上。

三、UML方案图操作手册

（一）创建UML图的基本步骤

1.选择工具：

(1)安装UML建模软件（如StarUML、Visio）。

(2)选择合适的图类型（如类图、时序图）。

2.绘制框架：

(1)添加核心元素（如类、接口）。

(2)定义元素间的初步关系。

3.细化内容：

(1)填充属性和方法（如类图中的私有/公有属性）。

(2)添加注释和标签，说明关键逻辑。

（二）高级操作技巧

1.动态交互图（时序图）：

(1)按时间顺序排列对象生命线。

(2)使用消息箭头表示方法调用（如同步/异步调用）。

2.图形优化：

(1)调整布局（如使用网格对齐）。

(2)添加颜色区分不同层级元素（如用例图中的主要/次要用例）。

（三）常见问题及解决方法

1.图形混乱：

(1)删除冗余线条，简化关系。

(2)使用分组功能（如Visio中的"SmartArt"）。

2.版本冲突：

(1)使用版本控制插件（如Git的图形化界面）。

(2)定期备份历史版本。

四、附录

（一）术语表

类（Class）：系统中的实体，包含属性和方法。

关联（Association）：对象间的双向关系。

继承（Inheritance）：子类继承父类的特性。

（二）推荐工具

1.StarUML：适合复杂系统设计，支持多种图类型。

2.Lucidchart：在线协作平台，易于团队共享。

（三）示例数据

假设一个电商系统类图包含：

-类：用户（属性：ID、姓名；方法：登录、下单）

-关联：用户与订单（1:N关系）

-接口：支付（方法：支付订单、退款）

二、UML方案图规范（续）

（一）基本规范（续）

1.统一命名：

(1)类名：应使用名词或名词短语，清晰表示其代表的实体或概念。遵循驼峰命名法（CamelCase），首字母大写，如`UserAccount`、`ProductInventory`。避免使用缩写，除非广泛通用且无歧义（如`DateRange`）。

(2)接口名：使用动词或动词短语，表示系统提供的服务能力。同样遵循驼峰命名法，首字母大写，如`ICalculateFee`、`IPayProcessor`。

(3)属性名：描述类的特征。私有（受保护）属性可使用下划线前缀（如`_userId`），公有属性遵循驼峰命名法（如`userName`）。布尔型属性名通常表示状态，如`isActive`。

(4)方法名：描述类的行为。遵循小写字母开头、单词间用下划线分隔的蛇形命名法（snake_case），或驼峰命名法（如`calculateTotalPrice`、`saveOrderDetails`）。主方法名（如类名相同的方法）通常命名为`initialize`或省略。

(5)参与者（Actor）名：代表与系统交互的外部实体（如用户、设备）。应使用名词，指明其身份或角色，如`Customer`、`Administrator`、`PaymentGateway`。

(6)用例（UseCase）名：描述参与者能请求系统执行的操作，是动词短语，如`PlaceOrder`、`ManageInventory`。

2.图例一致性：

(1)标准符号：优先使用UML标准定义的符号。例如，类用矩形（分为三个部分：类名、属性、方法），接口用矩形加斜体（分为两部分：接口名、方法），用例用椭圆形，参与者用矩形加小人图标。

(2)线条样式：明确不同关系线的含义和样式。

关联（Association）：实线，可能带箭头（表示方向）或不带箭头（表示双向）。

依赖（Dependency）：虚线，带箭头，表示一方依赖另一方（如使用接口）。

泛化（Generalization）：实线，带空心三角形箭头，表示继承或实现关系（子类指向父类）。

组合（Composition）：实线，带黑色箭头，表示“拥有”关系，整体生命周期控制部分生命周期（如容器与内容项）。

聚合（Aggregation）：实线，带空心箭头，表示“整体”与“部分”关系，部分可独立于整体存在（如汽车与轮胎）。

(3)颜色与字体：在复杂图中，可使用不同颜色区分不同类型的元素（如类用蓝色，接口用绿色），但需在图旁注明图例。字体保持统一、清晰。

(4)布局风格：保持一致的布局方向（如关联线箭头总是指向依赖方）和排列逻辑（如类图按依赖或泛化关系组织）。

3.版本管理：

(1)工具：使用版本控制软件（如Git）管理UML图文件。为UML图创建专门的分支或提交策略。

(2)注释：在每次修改时添加清晰的提交信息，说明变更内容（如“添加用户登录模块类图”、“更新订单状态机”）。

(3)比较：定期使用工具比较不同版本之间的差异，确保变更符合预期。

(4)备份：除了版本控制，还应定期对重要版本的UML图进行外部备份。

（二）常用UML图类型规范（续）

1.类图：

(1)结构部分：

类名：置于矩形顶部中央，加粗。

属性：置于矩形中部，列出属性名、类型（如`int`、`String`）、访问修饰符（`+`公有，``受保护，`-`私有）。可按访问修饰符分组。

方法：置于矩形底部，列出方法名、返回类型、参数列表、访问修饰符。特殊方法（如构造函数）也应列出。可按访问修饰符分组。

接口：矩形顶部加斜体标题，列出公有方法（返回类型、方法名、参数）。

(2)关系部分：

关联：明确端点（如类名或角色名）和基数（如`1`、``、`0..1`、`1..5`）。例如，`Customer1---0..Order`表示一个客户可以下零个或多个订单。

依赖：用虚线箭头连接，箭头指向被依赖的类或接口。通常标注依赖原因（如`uses`、`implements`）。

泛化：用实线加空心三角形箭头连接，箭头指向父类。子类自动继承父类属性和方法。

组合/聚合：用带箭头的实线（组合）或空心箭头的实线（聚合）连接。明确组合（整体拥有部分，生命周期相关）和聚合（整体拥有部分，生命周期独立）的语义。

(3)命名规范：避免使用泛型类型名称（除非必要且清晰，如`Customer<Gender>`通常不推荐，可改为`Customermale/female`或在代码中体现），使用具体类型（如`java.util.Date`而不是`Date`）。

2.用例图：

(1)参与者：椭圆形表示，包含参与者名称。可进一步分类（如“外部用户”、“内部系统”）。

(2)用例：椭圆形表示，包含用例名称。用例应具有明确的价值和边界。

(3)关系：

关联（Association）：实线连接参与者和用例，表示参与者可以执行该用例。

包含（Include）：虚线加空心箭头连接，表示一个用例（被包含者）隐式地使用另一个用例（包含者）的部分或全部行为。例如，`PlaceOrder`包含`VerifyPayment`。应在被包含用例中明确标注。

扩展（Extend）：虚线加实心箭头连接，表示在特定条件下，一个用例（扩展者）会添加到另一个用例（基用例）的行为。基用例的核心行为必须先执行。在扩展点处标注触发条件。适用于增加可选或条件性功能。

泛化（Generalization）：实线加空心三角形箭头连接，表示多个用例共享相同的行为。例如，`Search`、`Browse`、`Filter`都可以泛化自`ViewItems`。

(4)系统边界：在图外围绘制一个矩形，框住所有用例，表示系统（System）的边界。

3.状态机图：

(1)状态：圆角矩形表示，包含状态名称。初始状态用空心圆圈加箭头表示，最终状态用实心圆圈表示。

(2)转换：带箭头的实线表示状态之间的转换。箭头旁标注触发事件（如`clickButton`）和可选的动作（如`setActive=true`）。

(3)子状态与复合状态：使用嵌套的圆角矩形表示子状态（如`active`状态内可以有`processing`、`waiting`子状态）。简单并发行为可用分叉（横向箭头）和汇合（纵向箭头）表示。可选状态（可选执行的动作）用虚线框和内部文字表示。

(4)伪状态：特定关键字表示特殊状态，如`initial`（隐式初始状态，也可显式画）、`shallowHistory`（浅历史状态，用于恢复）、`deepHistory`（深历史状态，保存所有状态信息）。

(5)命名规范：状态名称应为动词或动词短语，描述系统在该状态下的行为或条件（如`idle`、`processingPayment`、`orderCompleted`）。

4.时序图：

(1)对象：矩形框表示参与交互的对象，按时间顺序垂直排列。顶部显示对象名（如`orderProcessor`）。

(2)生命线：垂直的虚线表示对象在时间段内存在。

(3)消息：垂直的实线箭头表示对象间的交互。

同步消息：实线箭头，发送方等待接收方响应。箭头旁标注消息名称（如`sendPaymentRequest`）。

异步消息：虚线箭头，发送方不等待接收方响应。

自消息：箭头从对象生命线出发，指向自身，表示对象调用自己的方法。

(4)激活条：在生命线内显示的矩形条，表示对象正在执行操作或处理消息。

(5)时间轴：顶部水平线表示时间流逝，事件按时间顺序排列。可使用粗线或分隔线表示关键时间点或阶段。

(6)命名规范：对象名遵循类命名规范。消息名应为动词短语，描述交互内容。

三、UML方案图操作手册（续）

（一）创建UML图的基本步骤（续）

1.选择工具（续）：

(1)选择依据：考虑团队规模、项目需求（简单/复杂）、预算、易用性。免费工具（如PlantUML在线编辑器、Eclipse的UML插件）适合小型项目或学习。商业软件（如StarUML、MagicDraw）功能更全，支持高级特性和团队协作。

(2)安装与设置：根据所选软件的指引完成安装。熟悉软件界面布局、工具栏、属性编辑器。

(3)模板使用：利用软件提供的UML图模板快速启动，避免从零开始配置。

2.绘制框架（续）：

(1)识别核心元素：根据系统需求，列出需要建模的主要类、接口、参与者、用例。可先从用例图或类图入手。

(2)添加元素：在画布上绘制相应图形（矩形表示类/接口，椭圆表示用例/参与者等）。

(3)命名核心元素：为每个图形分配初步但符合规范的名称。

(4)定义基本关系：使用工具栏的连接线工具，绘制核心元素间的主要关系（如类间的关联、用例与参与者的关联）。

3.细化内容（续）：

(1)填充属性和方法：

选中类或接口图形，在属性编辑器中添加属性，指定名称、类型、访问修饰符。

添加方法，指定名称、返回类型、参数列表、访问修饰符。注意实现接口方法。

(2)添加注释和标签：

使用注释工具（如矩形框加斜体文字`<<note>>`）解释复杂关系、约束条件或设计决策。

在图形上或关系线上添加标签，说明具体的参数、条件或含义（如`1..`、`read-only`）。

(3)调整布局与样式：

使用对齐、分布工具使图形排列整齐。

调整字体、颜色、线型，增强可读性，但保持一致性。

（二）高级操作技巧（续）

1.动态交互图（时序图）（续）：

(1)识别交互场景：选择需要详细描述交互流程的用例或操作，如数据库访问、复杂计算、多对象协作。

(2)创建时序图：新建时序图，添加相关对象作为参与者。

(3)设计交互流程：按时间顺序，绘制对象间的消息传递，注意区分同步、异步消息。

(4)使用组合块（CombineFragment）：对于复杂的交互，使用组合块（矩形加“<<combine>>”标签）将一组消息序列化或并行化，并添加条件或循环控制（如`<<if>>`、`<<for>>`）。

(5)细化消息内容：在消息箭头旁，不仅写事件名，还可写简短的参数说明或预期结果，增强理解。

2.图形优化（续）：

(1)层次化布局：将图中元素按逻辑关系（如父类-子类、主要-次要）进行分层排列，使用户能快速把握整体结构。

(2)颜色与高亮：适度使用颜色突出关键元素（如核心类、主要流程）或区分不同模块，但避免过度使用导致视觉混乱。确保色盲用户也能区分（如用粗细、形状配合）。

(3)交互式导航（针对软件工具）：利用软件的交互功能，如点击类图中的类，跳转到对应的时序图或状态机图，展示其详细行为。

(4)使用包（Package）：将大型图分解为多个包，每个包包含相关联的元素，通过包间关系（如依赖）连接。使用包可提高复杂图的组织性和可管理性。

（三）常见问题及解决方法（续）

1.图形混乱（续）：

(1)减少连接线：检查是否所有关系都是必要的，移除冗余或隐含的关系。使用泛化、包含、扩展等UML机制替代显式连接。

(2)使用分组：将紧密相关的元素（如一个类及其关联的辅助类）用矩形框（包）包围，并命名包名。

(3)交叉引用：对于跨越画布的复杂关系，可使用指向线（ReferenceLine，细虚线带箭头）引向另一侧的详细图或同一画布的另一部分。

(4)视图分离：对于非常复杂的类图，可将其拆分为多个视图，如接口视图、实体视图、控制视图，并通过包关系连接。

2.版本冲突（续）：

(1)分支策略：为不同功能的UML图或版本创建独立分支（如`feature-a`、`refactor-diagram`），完成后再合并。避免在同一分支上同时修改多个相互依赖的图。

(2)代码驱动建模（若适用）：如果项目使用代码生成UML图，保持代码与UML图的双向同步。使用模型驱动开发（MDD）工具，变更代码自动更新UML，或变更UML自动更新代码。

(3)定期评审与集成：设定固定时间（如每周）进行代码和UML图的集成检查和评审，及早发现并解决冲突。

(4)清晰的变更日志：强制要求每次提交都附带详细的日志，说明变更内容、原因和影响，便于追踪和解决冲突。

四、附录（续）

（一）术语表（续）

依赖（Dependency）：一种单向的、较弱的关系，表示一个元素（依赖方）依赖于另一个元素（被依赖方）的变化。通常用于实现接口、使用变量或方法。用虚线箭头表示。

关联（Association）：表示两个或多个对象之间的结构化关系，强调对象间的连接或聚合。可以是双向的。用实线表示。基数（Cardinality）描述参与关系的对象数量（如`1`、``、`0..1`）。

聚合（Aggregation）：一种特殊的关联，表示“整体-部分”关系，其中部分可以独立于整体存在，但整体拥有部分。强调部分与整体的“拥有”语义，但生命周期相对独立。用带空心箭头的实线表示。

组合（Composition）：一种更强烈的聚合，表示“整体-部分”关系，其中整体控制部分的生命周期，部分不能独立于整体存在。强调整体对部分的“拥有”和生命周期管理。用带黑色箭头的实线表示。

接口（Interface）：定义了一组操作的规范，表示系统提供的服务能力。没有状态（属性），只有方法。类可以实现一个或多个接口。用矩形加斜体标题表示。

泛化（Generalization）：表示特殊化或继承关系，子类（特殊化方）继承父类（一般化方）的属性和方法。允许多重继承（从一个父类继承到多个子类）。用实线加空心三角形箭头表示。

用例（UseCase）：描述了系统为其用户提供的一个价值主张，是一个由参与者执行的、可被观察到的、独立的功能性单元。用椭圆形表示。

参与者（Actor）：与系统交互的外部实体，可以是人、其他系统或设备。用矩形加小人图标表示。

状态（State）：对象在其生命周期中经历的一个特定条件或行为模式。状态机图中的核心元素。用圆角矩形表示。

转换（Transition）：状态机中，从一个状态到另一个状态的变迁。由事件触发。用带箭头的实线表示，通常标注触发事件和可选的动作。

（二）推荐工具（续）

PlantUML：纯文本描述UML图的在线编辑器和库。优点是易于集成到文档（如Markdown、Wiki）、版本控制（文本文件）、跨平台。缺点是界面基本无，学习曲线较陡。适合技术文档作者。

Draw.io()：功能强大的在线绘图工具，支持UML及其他多种图形类型。免费，界面友好，插件丰富。适合快速创建和分享。缺点是高级UML特性可能不如专业软件完善。

StarUML：商业UML建模工具，提供全面的UML图类型、丰富的模型元素、代码生成/逆向工程、团队协作功能。适合中大型项目和团队。有免费版（功能受限）和付费版。

EclipseUML2Tools：基于Eclipse平台的免费UML建模插件。功能较全，适合Java开发团队集成。缺点是安装和配置相对复杂，生态系统不如商业软件成熟。

MicrosoftVisio：专业的图表绘制软件，包含UML图模板。功能强大，易于绘制复杂图形。缺点是价格昂贵，且UML模板可能需要单独购买或更新。

（三）示例数据（续）

假设一个在线图书馆系统，其核心类图可能包含以下元素和关系：

类：

`Book`

属性：`_isbn(String)`、`_title(String)`、`_author(String)`、`_status(String)`（如"Available","Borrowed"）

方法：`getIsbn()`,`getTitle()`,`setStatus(status)`

`User`

属性：`_userId(int)`、`_name(String)`、`_borrowedBooks(List<Book>)`、`_isActive(boolean)`

方法：`getUserId()`,`borrowBook(book)`,`returnBook(book)`,`isActive()`

`Loan`(关联`Book`和`User`)

属性：`_loanId(int)`、`_loanDate(Date)`、`_dueDate(Date)`、`_returnDate(Date)`

方法：`getLoanId()`,`getDueDate()`,`setReturnDate(returnDate)`

关系：

`User`1---`Loan`（一个用户可以有多个借阅记录）

`Loan`---1`Book`（一个借阅记录对应一本特定的书）

`User`1---0..`BorrowedBooks`（用户拥有一个借阅书籍的列表，可以有零本）

`Book`--`Loan`（可选，表示书籍的当前借阅状态，如果存在）

接口：

`IReservation`(方法：`reserveBook(userId,bookId)`,`cancelReservation(reservationId)`)

`INotificationService`(方法：`sendEmail(user,message)`,`sendSMS(user,message)`)

参与者：

`Librarian`(可以执行`CheckinBook`、`ProcessLoanReturn`、`ManageUserAccount`等用例)

`Patron`(可以执行`SearchBooks`、`BorrowBook`、`ReturnBook`、`ReserveBook`等用例)

一、概述

UML（统一建模语言）方案图是一种用于描述系统架构、组件交互和设计思路的可视化工具。本手册旨在提供UML方案图的规范和操作指南，帮助用户规范地创建和使用UML图，以提升系统设计的清晰度和可维护性。

二、UML方案图规范

（一）基本规范

1.统一命名：图中的所有元素（如类、接口、关系）应使用清晰、简洁的名称，避免歧义。

2.图例一致性：同一文档中应保持图例（如线条样式、颜色）的一致性，必要时提供图例说明。

3.版本管理：对UML图进行版本控制，记录每次修改的内容和时间。

（二）常用UML图类型规范

1.类图：

(1)类名使用大写字母开头，接口名使用斜体。

(2)属性和方法的命名需符合设计规范，如私有属性以"_"开头。

(3)关系线使用标准样式（如实线、虚线）表示继承、关联和依赖。

2.用例图：

(1)参与者（Actor）名称需明确，如"用户""管理员"。

(2)用例（UseCase）用椭圆形表示，并与参与者用关联线连接。

3.状态机图：

(1)状态名称使用动词或动词短语，如"初始化""处理完成"。

(2)转换条件（如"收到请求"）标注在转换箭头上。

三、UML方案图操作手册

（一）创建UML图的基本步骤

1.选择工具：

(1)安装UML建模软件（如StarUML、Visio）。

(2)选择合适的图类型（如类图、时序图）。

2.绘制框架：

(1)添加核心元素（如类、接口）。

(2)定义元素间的初步关系。

3.细化内容：

(1)填充属性和方法（如类图中的私有/公有属性）。

(2)添加注释和标签，说明关键逻辑。

（二）高级操作技巧

1.动态交互图（时序图）：

(1)按时间顺序排列对象生命线。