Python面向对象设计：利用组合模式构建灵活的多层级数据结构

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}')"

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): 站点的唯一ID。
            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("只能添加Campus类的实例。")
        self.campuses.append(campus)
        print(f"校区 '{campus.name}' 已添加到站点 '{self.name}'。")

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

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

    def __str__(self):
        """
        返回站点的字符串表示。
        """
        return f"Site(Name: {self.name}, ID: {self.site_id}, Campuses: {self.get_campuses_count()})"

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

# 实例化校区
campus_east = Campus("东校区", "张三")
campus_west = Campus("西校区", "李四")

# 将校区添加到站点
site1.add_campus(campus_east)
site1.add_campus(campus_west)

# 打印站点信息和校区数量
print(site1)
print(f"站点 '{site1.name}' 共有 {site1.get_campuses_count()} 个校区。")

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

# 实例化一个没有校区的站点
site2 = Site(
    name="分公司站点A", 
    site_id="BR001", 
    key="APIKEY_BR1", 
    url="https://helpdesk.example.com/br1", 
    collection_name="已收集", 
    approval_name="已批准"
)
print(site2)
print(f"站点 '{site2.name}' 共有 {site2.get_campuses_count()} 个校区。") # 输出 0