`__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` 處理預期之外的情況:
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}")
將條件分支轉為字典查找,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)
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
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__` 內,工廠只負責「類別選擇」,單一職責原則完美體現。
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)