针对python类中需要管理可变数量子属性（如多校区站点配置）的问题，本文提出了一种面向对象的解决方案。通过将子属性抽象为独立的类，并在主类中利用列表存储这些子属性实例，实现了灵活且可扩展的结构，避免了硬编码，提升了代码的可维护性。

在构建复杂的应用程序时，我们经常会遇到一个挑战：一个主实体（例如“站点”）可能包含多个相关联的子实体（例如“校区”），且这些子实体的数量在不同主实体之间是可变的。如果采用硬编码的方式，为主实体类预定义所有可能的子属性（如 XCampusName, XCampusApprover），不仅会导致类定义冗长且难以管理，还会限制系统的扩展性，无法适应未来可能出现的更多子实体。本文将探讨如何利用面向对象编程的原则，设计一个灵活且可扩展的Python类结构来解决这一问题。

传统方法的局限性

考虑一个“站点”类，它需要管理多个“校区”的信息。如果一个站点有多个校区，我们可能会倾向于在 Site 类中直接定义类似 campus1Name, campus1Approver, campus2Name, campus2Approver 这样的属性。

class Site:
    name = ""
    siteID = ""
    key = ""
    url = ""
    # 硬编码的校区属性，数量固定且不灵活
    campus1Name = ""
    campus1Approver = ""
    campus2Name = ""
    campus2Approver = ""
    # ... 更多校区属性
    collectionName = ""
    approvalName = ""

这种设计模式存在显著的缺陷：

1. 缺乏灵活性： 如果某个站点只有一个校区，那么 campus2Name 等属性将是多余的。反之，如果站点有三个或更多校区，则需要修改 Site 类的定义，增加新的属性。
2. 难以维护： 随着校区数量的增加，Site 类的属性列表会变得非常庞大，代码可读性和可维护性急剧下降。
3. 违反单一职责原则： Site 类不仅要管理站点自身的属性，还要直接管理所有校区的详细属性，导致职责不清。

面向对象解决方案：聚合模式

解决上述问题的核心思想是将“校区”抽象为一个独立的类，并在“站点”类中维护一个“校区”对象的集合。这种设计模式被称为聚合（Aggregation），它允许一个对象包含另一个对象的实例作为其组成部分。

1. 定义子属性类：Campus

首先，我们创建一个独立的 Campus 类来封装校区特有的属性，例如校区名称和审批人。

class Campus:
    """
    表示一个校区及其相关信息。
    """
    def __init__(self, name: str, approver: str):
        """
        初始化一个Campus实例。

        Args:
            name (str): 校区的名称。
            approver (str): 负责该校区设备退回的审批人。
        """
        self.name = name
        self.approver = approver

    def __str__(self):
        """
        返回校区的字符串表示，便于打印和调试。
        """
        return self.name

    def __repr__(self):
        """
        返回校区的官方字符串表示。
        """
        return f"Campus(name='{self.name}', approver='{self.approver}')"

通过将校区信息封装在 Campus 类中，我们创建了一个清晰、独立的实体，其内部属性可以根据需要进行扩展，而不会影响到 Site 类的核心结构。

python-flask-vue-creator

创建 Flask + Vue.js 全栈项目，采用单端口架构、uv 依赖管理、结构化日志和生产级前端设计。当用户要求以下操作时触发：创建新的 Flask+Vue 项目、搭建 Web 应用、构建全栈 Python+Vue 应用、初始化 Flask Web 项目、设置单端口 Flask 前后端项目。触发词：新建项目、创建项目、搭建项目、Flask项目、Vue项目。

下载

2. 定义主类并集成子属性：Site

接下来，我们修改 Site 类，使其包含一个 Campus 对象的列表。这样，一个 Site 实例可以拥有任意数量的 Campus 实例。

class Site:
    """
    表示一个站点及其配置信息，可以包含多个校区。
    """
    def __init__(self, name: str, site_id: str, key: str, url: str, 
                 collection_name: str, approval_name: str):
        """
        初始化一个Site实例。

        Args:
            name (str): 站点的名称。
            site_id (str): 站点的唯一标识符。
            key (str): 帮助台API密钥。
            url (str): 帮助台URL。
            collection_name (str): 帮助台中收集状态的名称。
            approval_name (str): 帮助台中审批状态的名称。
        """
        self.name = name
        self.site_id = site_id
        self.key = key
        self.url = url
        self.collection_name = collection_name
        self.approval_name = approval_name
        self.campuses = []  # 使用列表存储Campus对象

    def add_campus(self, campus: Campus):
        """
        向当前站点添加一个校区。

        Args:
            campus (Campus): 要添加的Campus实例。
        """
        if not isinstance(campus, Campus):
            raise TypeError("Expected a Campus instance.")
        self.campuses.append(campus)

    def get_campuses_count(self) -> int:
        """
        获取当前站点的校区数量。

        Returns:
            int: 校区数量。
        """
        return len(self.campuses)

    def get_campus_by_name(self, name: str) -> Campus | None:
        """
        根据名称查找并返回一个校区。

        Args:
            name (str): 要查找的校区名称。

        Returns:
            Campus | None: 匹配的Campus实例，如果未找到则返回None。
        """
        for campus in self.campuses:
            if campus.name == name:
                return campus
        return None

在 Site 类中，self.campuses 是一个列表，用于存储 Campus 类的实例。add_campus 方法提供了一个干净的接口来向站点添加校区。get_campuses_count 方法则可以方便地获取当前站点的校区数量。

使用示例

现在，我们可以创建 Site 实例，并根据需要添加任意数量的 Campus 实例。

# 1. 创建一个Site实例
site_a = Site(
    name="总部站点", 
    site_id="HQ001", 
    key="ABCDEFG123", 
    url="https://helpdesk.example.com/hq", 
    collection_name="待收集", 
    approval_name="待审批"
)

# 2. 为站点创建Campus实例
campus_a_main = Campus("主校区", "张三")
campus_a_north = Campus("北区分校", "李四")

# 3. 将Campus实例添加到Site实例中
site_a.add_campus(campus_a_main)
site_a.add_campus(campus_a_north)

# 4. 验证和访问信息
print(f"站点名称: {site_a.name}")
print(f"站点ID: {site_a.site_id}")
print(f"校区数量: {site_a.get_campuses_count()}")

# 访问第一个校区的信息
if site_a.campuses:
    print(f"第一个校区名称: {site_a.campuses[0].name}")
    print(f"第一个校区审批人: {site_a.campuses[0].approver}")

# 查找特定校区
north_campus = site_a.get_campus_by_name("北区分校")
if north_campus:
    print(f"北区分校的审批人: {north_campus.approver}")

print("-" * 30)

# 创建另一个只有一个校区的站点
site_b = Site(
    name="分部站点", 
    site_id="BR001", 
    key="HIJKLMN456", 
    url="https://helpdesk.example.com/br", 
    collection_name="待领取", 
    approval_name="待批准"
)
campus_b_only = Campus("唯一校区", "王五")
site_b.add_campus(campus_b_only)

print(f"站点名称: {site_b.name}")
print(f"校区数量: {site_b.get_campuses_count()}")
if site_b.campuses:
    print(f"分部站点校区名称: {site_b.campuses[0].name}")

通过上述示例，我们可以清晰地看到这种设计模式的灵活性。site_a 拥有两个校区，而 site_b 只有一个校区，所有这些都通过相同的 Site 类结构和 add_campus 方法来管理，无需修改类定义。

优点与注意事项

优点：

1. 高度灵活性： 站点可以拥有任意数量的校区，甚至没有校区，而无需修改 Site 类的定义。
2. 代码可读性和可维护性： 每个类职责单一，Site 负责站点级别信息和校区集合的管理，Campus 负责校区自身的属性。这使得代码结构更清晰，易于理解和维护。
3. 可扩展性： 如果未来需要为校区添加更多属性（例如，校区地址、联系电话），只需修改 Campus 类，而不会影响 Site 类。
4. 避免冗余： 没有多余的空属性，节省内存，提高效率。

注意事项：

1. 数据持久化： 原始问题提到从 .ini 文件加载设置。当采用这种聚合模式时，你需要设计一种机制来解析 .ini 文件，将站点和校区的数据分别加载到 Site 和 Campus 实例中，并在程序关闭时将它们保存回文件。这通常涉及将 .ini 文件的不同 [section] 映射到 Site 和 Campus 对象的属性。
2. 数据验证： 在 add_campus 方法中添加类型检查是一个好习惯，可以确保只添加 Campus 实例。对于从外部文件加载的数据，还需要进行更严格的数据格式和业务逻辑验证。
3. 删除与更新： 如果需要删除或更新某个校区，Site 类可以进一步添加 remove_campus 或 update_campus 等方法来管理 self.campuses 列表。
4. 性能考虑： 对于拥有海量校区（例如数千个）的极端情况，使用列表存储可能不是最高效的方式。此时，可以考虑使用字典（例如，以校区ID或名称为键）或其他更优化的数据结构来存储 Campus 对象，以便更快速地查找。

总结

通过将具有多重且可变“子属性”的复杂实体拆分为多个独立的类并使用聚合模式，我们能够构建出更加健壮、灵活且易于维护的Python应用程序。这种设计模式不仅解决了特定问题，也体现了面向对象设计中“组合优于继承”的原则，是处理复杂数据结构时的一种推荐实践。

Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！