Classi Facet

La classe Facet è una classe base astratta che rappresenta una sfaccettatura di un documento. Questa classe non deve essere istanziata direttamente.

Facet è definito nel modulo google.appengine.api.search.

Proprietà

Un'istanza della classe Facet ha le seguenti proprietà:

name

Il nome della sfaccettatura. I nomi delle sfaccettature devono avere una lunghezza massima di MAXIMUM_FIELD_NAME_LENGTH e corrispondere al pattern "[A-Za-z][A-Za- z0-9_]*".

valore

Il valore della sfaccettatura, che può essere una stringa, un codice Unicode o un numero.

Sottoclassi

La classe Facet ha le seguenti sottoclassi:

class AtomFacet

Un facet con contenuti da trattare come un singolo token per l'indicizzazione.

Il valore della sfaccettatura è un oggetto str o unicode da trattare come un valore di testo indivisibile. L'esempio seguente mostra un facet atomico 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.

class 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.