class NewId(object):
新記錄的偽識別碼,封裝一個可選的來源識別碼(實際
記錄 ID)以及一個選填的參照(任意值)。
翻譯片段:
__slots__ = ['origin', 'ref']
def __init__(self, origin=None, ref=None):
self.origin = origin
self.ref = ref
def __bool__(self):
回傳 False
def __eq__(self, other):
return isinstance(other, NewId) and (
(self.origin and other.origin and self.origin == other.origin)
or (self.ref and other.ref and self.ref == other.ref)
)
def __hash__(self):
return hash(self.origin or self.ref or id(self))
def __repr__(self):
return (
"<NewId origin=%r>" % self.origin if self.origin else
"<NewId ref=%r>" % self.ref if self.ref else
"<NewId 0x%x>" % id(self)
)
def __str__(self):
if self.origin or self.ref:
id_part = repr(self.origin or self.ref)
else:
id_part = hex(id(self))
return "NewId_%s" % id_part
這段程式碼定義了一個名為 `NewId` 的類別,用來表示新記錄的偽識別碼。讓我簡單說明一下:
- `__init__(self, origin=None, ref=None)` 方法用於初始化物件,接受兩個可選參數 `origin` 和 `ref`,分別代表原始記錄的識別碼與參考值。
- `__bool__(self)` 方法會回傳 `False`,表示該物件的布林值為 false。
- `__eq__(self, other)` 方法用於比較兩個 `NewId` 物件是否相等。它會先檢查另一個物件是否也是 `NewId` 類別的實例,然後比較它們的 `origin` 或 `ref` 屬性是否相等。
- `__hash__(self)` 方法會傳回物件的雜湊值,用於集合中以雜湊為基礎的查找。
- `__repr__(self)` 方法會回傳物件的字串表示,並依據 `origin` 或 `ref` 屬性是否存在,回傳不同格式的字串。
- `__str__(self)` 方法會回傳物件的字串表示,並根據 `origin` 或 `ref` 屬性是否存在,回傳對應的識別字串。
總而言之,此類別用於建立代表新記錄的偽識別碼物件,這些物件可包含原始記錄的識別碼或任何參考值。
