在软件开发和系统架构设计中，面向对象编程 (OOP) 是构建稳健系统的基石。而 UML (统一建模语言) 则是我们描绘这些对象的蓝图。在众多UML图表中，类图 (Class Diagram) 最为核心，它展示了系统的静态结构。
本文将结合 PlantUML 语法与可视化概念，为您拆解类结构 (Class Structure) 的核心要素，帮助您从零开始掌握如何定义类、属性与方法，并正确设置它们的可见性。
1. 类的解剖学：它由什么组成？
在面向对象的世界中，类 (Class) 是创建对象的蓝图或模板。一个标准的类结构通常包含三个主要部分，它们在类图中通过横线进行分隔：
- 类名 (Class Name)：位于顶部，通常使用大写字母开头（例如：
User或Employee）。 - 属性 (Attributes)：也称为字段 (Fields) 或成员变量。它们描述了对象的状态或数据。例如，一个
User类可能包含username或email。 - 方法 (Methods)：也称为操作 (Operations) 或行为。它们定义了对象能做什么。例如，
login()或updateProfile()。
正如示意图所示，这些元素不仅仅是文本，它们还带有特定的可见性修饰符 (Visibility Markers)，这些符号决定了在代码中哪些部分可以被外部访问，哪些是内部私有的。
2. 可见性修饰符：类图的“红绿灯”
在 PlantUML 和 UML 标准中，我们使用特定的符号来标识属性的访问级别。理解这些符号对于编写安全、模块化的代码至关重要：
+(Public / 公共)：这是最开放的级别。任何外部代码都可以访问该属性或方法。在示意图中，它通常与绿色的加号图标相关联。例如，+login()是一个公开的操作，任何人都可以调用它。-(Private / 私有)：这是最严格的级别。只有类内部的方法才能访问这些数据。在示意图中，它通常与红色的减号或锁图标相关联。例如，-passwordHash必须是私有的，以防止外部直接篡改用户的密码。#(Protected / 受保护)：这是一种中间级别。它允许类本身以及其子类（继承者）访问。在示意图中，它通常与黄色的锁或盾牌图标相关联。这在继承体系结构中非常有用。~(Package / 包级私有)：这表示该元素仅对同一个包（Package）或命名空间内的类可见。在示意图中，它通常与波浪号或文件夹图标相关联。这提供了比私有更宽松，但比公共更严格的控制。
3. 实战演练：定义一个 User 类
让我们通过一个具体的例子来整合上述概念。假设我们需要为一个应用程序定义一个 User 类。这个类需要存储用户的基本信息，并提供登录和更新资料的功能。
3.1 属性定义
我们需要以下属性：
username：这是公开的，因为系统可能需要读取它来显示用户头像。passwordHash：这必须是私有的，安全起见。email：我们可以将其设为受保护的，因为我们需要在子类（如AdminUser）中访问它，但不应对外公开。lastLoginTimestamp：这通常是包级私有的，仅内部模块需要更新。
3.2 方法定义
接下来定义行为：
login()：公开方法，允许用户尝试登录。hashPassword()：私有方法，内部用于处理密码加密，用户不应直接调用。updateProfile()：公开方法，允许用户修改自己的资料。
4. 使用 PlantUML 编写类图代码
现在，让我们将上述设计转化为 PlantUML 代码。PlantUML 使用一种简洁的文本描述语言来生成图表。以下是完整的代码示例：
- 开始定义：使用
@startuml告诉解析器我们要开始绘制 UML 图。 - 声明类：使用
class ClassName语法。 - 添加内容：在花括号
{ ... }内部逐行列出属性和方法。 - 结束定义：使用
@enduml结束代码块。
以下是完整的 PlantUML 代码块：
@startuml class User { +String username -String passwordHash #Email email ~Int lastLoginTimestamp
+login(): Boolean -hashPassword(raw: String): String +updateProfile(data: Map): void } @enduml
在这个代码片段中：
+String username定义了一个类型为String的公共属性。-hashPassword(raw: String): String定义了一个私有方法，它接受一个String参数并返回一个String。Map和void是常见的数据类型，分别表示键值对集合和无返回值。
5. 总结
掌握 PlantUML 中的类结构不仅仅是学会写代码，更是培养系统设计思维的过程。通过明确指定每个属性的可见性（Public, Private, Protected, Package），您可以有效地管理代码的复杂度，保护敏感数据，并确保系统的可维护性。
无论是使用 PlantUML、Mermaid 还是 D2 等工具，理解这些基础的 UML 符号都是绘制高质量架构图的第一步。希望这篇教程能帮助您更好地在 VPasCode 或其他绘图工具中构建您的系统模型。