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) -> str:
        """
        返回校区的字符串表示，便于打印和调试。
        """
        return f"校区名称: {self.name}, 审批人: {self.approver}"

    def __repr__(self) -> str:
        """
        返回校区的官方字符串表示，便于开发人员调试。
        """
        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: list[Campus] = []  # 存储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 get_campus_by_name(self, campus_name: str) -> Campus | None:
        """
        根据名称查找并返回一个校区。

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

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

    def __str__(self) -> str:
        """
        返回站点的字符串表示。
        """
        campus_names = ", ".join([c.name for c in self.campuses]) if self.campuses else "无"
        return (f"站点名称: {self.name}, ID: {self.site_id}, "
                f"校区数量: {self.get_campuses_count()}, 校区: [{campus_names}]")

# 1. 创建一个没有校区的站点
site_a = Site("总部站点", "HQ001", "APIKEY_HQ", "https://helpdesk.hq.com", 
              "Collected", "Approved")
print(site_a) # 输出：站点名称: 总部站点, ID: HQ001, 校区数量: 0, 校区: [无]

# 2. 创建校区实例
campus_main = Campus("主校区", "张三")
campus_north = Campus("北区校区", "李四")

# 3. 创建一个有多个校区的站点
site_b = Site("区域分部", "REG002", "APIKEY_REG", "https://helpdesk.reg.com",
              "ReadyForPickup", "ApprovedForReturn")

# 向站点B添加校区
site_b.add_campus(campus_main)
site_b.add_campus(campus_north)

print("\n--- 站点B信息 ---")
print(site_b) # 输出：站点名称: 区域分部, ID: REG002, 校区数量: 2, 校区: [主校区, 北区校区]
print(f"站点B的校区数量: {site_b.get_campuses_count()}")

# 访问特定校区的信息
if site_b.campuses:
    first_campus = site_b.campuses[0]
    print(f"站点B的第一个校区: {first_campus.name}, 审批人: {first_campus.approver}")

# 通过名称查找校区
found_campus = site_b.get_campus_by_name("北区校区")
if found_campus:
    print(f"找到校区: {found_campus.name}, 审批人: {found_campus.approver}")
else:
    print("未找到指定校区。")

# 尝试添加非Campus实例
try:
    site_b.add_campus("这是一个字符串，不是校区")
except TypeError as e:
    print(f"\n错误捕获: {e}")