La classe Facet
è una classe base astratta che rappresenta un facet di un documento. Non è necessario creare un'istanza diretta di questa classe.
Facet
è definito nel modulo google.appengine.api.search
.
Proprietà
Un'istanza della classe Facet
ha le seguenti proprietà:
- nome
Il nome del facet. I nomi dei facet devono avere una lunghezza massima di MAXIMUM_FIELD_NAME_LENGTH e corrispondere al pattern "[A-Za-z][A-Za- z0-9_]*".
- valore
Il valore del facet, che può essere str, Unicode o numero.
Sottoclassi
La classe Facet
ha le seguenti sottoclassi:
- classe AtomFacet
Un facet con contenuti da trattare come un singolo token per l'indicizzazione.
Il valore del facet è un oggetto str o Unicode da trattare come un valore di testo indivisibile. L'esempio seguente mostra un facet atom denominato wine_type:
AtomFacet(name='wine_type', value='Red')
-
Eccezioni
- TypeError
Il valore fornito non è una stringa di testo.
- ValueError
Il valore supera la lunghezza massima consentita.
- classe NumberFacet
Un facet con un valore numerico.
L'esempio seguente mostra un facet numerico denominato wine_vintage:
NumberFacet(name='wine_vintage', value=2000)
-
Eccezioni
- TypeError
Il valore fornito non è numerico.
- ValueError
Il valore non rientra nell'intervallo consentito.