Facet 類別

Facet 類別是代表文件 Facet 的抽象基本類別。這個類別不應直接實例化。

Facet 定義於 google.appengine.api.search 模組。

屬性

Facet 類別的例項具有下列屬性:

name

Facet 的名稱。Facet 名稱必須有長度上限 MAXIMUM_FIELD_NAME_LENGTH,且格式必須符合「[A-Za-z][A-Za-z0-9_]*」。

value

Facet 的值,可為 Str、Unicode 或數字。

子類別

Facet 類別具有下列子類別:

AtomFacet 類別

所含內容要當做單一符記編入索引的 Facet。

Facet 的值為要當做不可分割文字值的 Str 或 Unicode 物件。以下是名為 wine_type 的完整 Facet 範例:

AtomFacet(name='wine_type', value='Red')

例外狀況

TypeError

提供的值並非文字字串。

ValueError

值超過允許長度上限。

NumberFacet 類別

包含數字值的 Facet。

以下是名為 wine_vintage 的數字 Facet 範例:

NumberFacet(name='wine_vintage', value=2000)

例外狀況

TypeError

提供的值並非數字。

ValueError

值超出範圍。