Die Klasse Facet ist eine abstrakte Basisklasse, die ein Attribut eines Dokuments darstellt. Diese Klasse sollte nicht direkt instanziiert werden.
Facet ist im Modul google.appengine.api.search definiert.
Attribute
Eine Instanz der Klasse Facet hat die folgenden Attribute:
- name
Der Name des Attributs. Attributnamen müssen die maximale Länge MAXIMUM_FIELD_NAME_LENGTH und das Übereinstimmungsmuster "[A-Za-z] [A-Za-z0-9_]*" haben.
- Wert
Der Attributwert; kann ein String, Unicode oder eine Zahl sein.
Abgeleitete Klassen
Die Klasse Facet hat die folgenden abgeleiteten Klassen:
- Klasse AtomFacet
Ein Attribut, dessen Inhalt für Indexierungszwecke als einzelner Token behandelt werden soll.
Der Attributwert ist ein String- oder Unicode-Objekt, das als nicht teilbarer Textwert behandelt wird. Das folgende Beispiel zeigt ein Atomattribut mit dem Namen wine_type:
AtomFacet(name='wine_type', value='Red')
-
Ausnahmen
- TypeError
Der angegebene Wert ist kein Textstring.
- ValueError
Der Wert überschreitet die maximal zulässige Länge.
- Klasse NumberFacet
Ein Attribut, das einen numerischen Wert enthält.
Das folgende Beispiel zeigt ein Zahlenattribut namens wine_vintage:
NumberFacet(name='wine_vintage', value=2000)
-
Ausnahmen
- TypeError
Der angegebene Wert ist nicht numerisch.
- ValueError
Der Wert liegt außerhalb des zulässigen Bereichs.