萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> 程式語言綜合

Python __init__ 進階應用:工廠函數、elif 鏈、映射表與 defaultdict 重構

`__init__` 是 Python 物件初始化的核心鉤子。本文透過撲克牌工廠案例,深入探討如何利用工廠函數封裝建構邏輯、避免模糊 `else` 陷阱、用 `elif` 鏈提高可讀性、用映射表 (Dictionary Dispatch) 替代條件分支、以及 `functools.partial` 與 `defaultdict` 的進階重構技巧。

工廠函數封裝建構邏輯

不直接實例化具體類別,而是透過工廠函數根據參數決定建立哪種子類別:


class Card: ...
class AceCard(Card): ...
class NumberCard(Card): ...
class FaceCard(Card): ...

def card(rank, suit):
    if rank == 1:
        return AceCard('A', suit)
    elif 2 <= rank < 11:
        return NumberCard(str(rank), suit)
    elif 11 <= rank < 14:
        name = {11: 'J', 12: 'Q', 13: 'K'}[rank]
        return FaceCard(name, suit)
    else:
        raise ValueError("Rank out of range")

# 建立一副牌
deck = [card(rank, suit) for rank in range(1, 14) for suit in (Club, Diamond, Heart, Spade)]

避免模糊的 else 子句

壞習慣:用「包羅萬象」的 `else` 處理預期之外的情況:


def card2(rank, suit):
    if rank == 1:
        return AceCard('A', suit)
    elif 2 <= rank < 11:
        return NumberCard(str(rank), suit)
    else:  # 隱含假設 rank 在 11..13,但若傳入 14 會錯誤建立 FaceCard
        name = {11: 'J', 12: 'Q', 13: 'K'}[rank]
        return FaceCard(name, suit)

呼叫 `card2(0, suit)` 會拋 `KeyError`,錯誤訊息誤導。`card2(14, suit)` 同理。

好習慣:顯式列出所有合法分支,非預期輸入拋出明確異常:


def card3(rank, suit):
    if rank == 1:
        return AceCard('A', suit)
    elif 2 <= rank < 11:
        return NumberCard(str(rank), suit)
    elif rank == 11:
        return FaceCard('J', suit)
    elif rank == 12:
        return FaceCard('Q', suit)
    elif rank == 13:
        return FaceCard('K', suit)
    else:
        raise ValueError(f"Invalid rank: {rank}")

映射表替代 elif 鏈 (Dictionary Dispatch)

將條件分支轉為字典查找,O(1) 查找、易擴展、關注點分離:


def card4(rank, suit):
    class_map = {
        1: AceCard,
        11: FaceCard,
        12: FaceCard,
        13: FaceCard,
    }
    # 缺失鍵預設為 NumberCard
    cls = class_map.get(rank, NumberCard)
    return cls(rank, suit)  # 傳入 rank, suit 由各類別自行處理

但此版本缺少 rank→字串轉換 (1→'A', 11→'J'...)。

進階映射策略

策略一:並行映射 (不推薦)


class_map = {1: AceCard, 11: FaceCard, 12: FaceCard, 13: FaceCard}
rank_str_map = {1: 'A', 11: 'J', 12: 'Q', 13: 'K'}
cls = class_map.get(rank, NumberCard)
rstr = rank_str_map.get(rank, str(rank))
return cls(rstr, suit)

缺點:兩字典易不同步、維護負擔重。

策略二:映射到元組 (類別, 字串)


factory_map = {
    1: (AceCard, 'A'),
    11: (FaceCard, 'J'),
    12: (FaceCard, 'Q'),
    13: (FaceCard, 'K'),
}
cls, rstr = factory_map.get(rank, (NumberCard, str(rank)))
return cls(rstr, suit)

策略三:映射到 functools.partial (預綁參數)


from functools import partial

factory_map = {
    1: partial(AceCard, 'A'),
    11: partial(FaceCard, 'J'),
    12: partial(FaceCard, 'Q'),
    13: partial(FaceCard, 'K'),
}
constructor = factory_map.get(rank, partial(NumberCard, str(rank)))
return constructor(suit)  # 只需傳 suit

策略四:修改類別定義,讓 __init__ 內部處理轉換 (推薦)


class FaceCard(Card):
    _RANK_MAP = {11: 'J', 12: 'Q', 13: 'K'}
    def __init__(self, rank, suit):
        self.rank = self._RANK_MAP[rank]
        self.suit = suit

class NumberCard(Card):
    def __init__(self, rank, suit):
        self.rank = str(rank)
        self.suit = suit

class AceCard(Card):
    def __init__(self, rank, suit):
        self.rank = 'A'
        self.suit = suit

# 工廠極度簡化
def card(rank, suit):
    class_map = {1: AceCard, 11: FaceCard, 12: FaceCard, 13: FaceCard}
    return class_map.get(rank, NumberCard)(rank, suit)

將「資料轉換邏輯」封裝在各子類別 `__init__` 內,工廠只負責「類別選擇」,單一職責原則完美體現。

defaultdict 進階用法


from collections import defaultdict

# 預設工廠必須是零參數可呼叫物
factory = defaultdict(
    lambda: partial(NumberCard, str(rank)),  # ❌ 錯誤:rank 非預先綁定
    {1: partial(AceCard, 'A'), 11: partial(FaceCard, 'J'), ...}
)

正確寫法:預設工廠返回**可呼叫物**,再由呼叫者提供參數:


def make_number_card(rank):
    return partial(NumberCard, str(rank))

factory = defaultdict(make_number_card, {
    1: partial(AceCard, 'A'),
    11: partial(FaceCard, 'J'),
    12: partial(FaceCard, 'Q'),
    13: partial(FaceCard, 'K'),
})
return factory[rank](suit)

總結:工廠模式演進路徑

  1. if/elif/else:直觀但難維護,易產生模糊 else。
  2. 顯式 elif 鏈:清晰、無歧義、易除錯。
  3. 映射表 + 並行字典:分離資料與邏輯,但同步風險。
  4. 映射到元組/partial:封裝建構參數,工廠純粹派發。
  5. 子類別 __init__ 內部化轉換:最佳,符合開放封閉原則,新增卡片類型只需新增類別與映射項,不修改工廠邏輯。

設計原則

  • **顯式優於隱式**:條件分支要清楚列舉,避免掉進 `else` 陷阱。
  • **資料驅動**:將業務規則 (rank→類別、rank→字串) 表達為資料結構,而非控制流。
  • **單一職責**:工廠只做「選類別」,類別自己做「初始化」。
  • **開放封閉**:新增功能擴展映射表,不修改核心邏輯。
copyright © 萬盛學電腦網 all rights reserved