Modulo google.appengine.api.datastore_types

Riepilogo

Tipi di dati semantici di livello superiore per il datastore. Questi tipi devono essere impostati come attributi delle entità. Consulta la sezione "Tipi di dati supportati" nella Guida dell'API.

La maggior parte di questi tipi si basa su elementi XML da elementi Atom e GData provenienti dagli spazi dei nomi atom e gd. Per ulteriori informazioni, vedi:

http://www.atomenabled.org/developers/syndication/ https://developers.google.com/gdata/docs/1.0/elements

Gli schemi dello spazio dei nomi sono:

http://www.w3.org/2005/Atom http://schemas.google.com/g/2005

Contenuti

class google.appengine.api.datastore_types.Blob(*args, **kwargs)fonte

Basi: google.appengine.api.datastore_types._BaseByteType

Un tipo di blob, appropriato per l'archiviazione di dati binari di qualsiasi lunghezza.

Il comportamento è identico a quello del tipo str Python, ad eccezione del costruttore, che accetta soltanto gli argomenti str.

URI_significato
classgoogle.appengine.api.datastore_types.BlobKey(blob_key)origine

Basi: oggetto

Chiave utilizzata per identificare un blob in Blobstore.

Questo oggetto esegue il wrapping di una stringa utilizzata internamente dall'API Blobstore per identificare i blob dell'applicazione. La BlobKey corrisponde al nome dell'entità Blob Reference sottostante.

Questa classe è esposta nell'API sia in google.appengine.ext.db che google.appengine.ext.blobstore.

Origine ToXml()
classgoogle.appengine.api.datastore_types.ByteStringsource

Basi: google.appengine.api.datastore_types._BaseByteType

Un tipo di stringa di byte, appropriato per l'archiviazione di brevi quantità di dati indicizzati.

Questo comportamento è identico a quello di Blob, tranne per il fatto che viene utilizzato solo per le stringhe di byte brevi e indicizzate.

classgoogle.appengine.api.datastore_types.Category(tag)Fonte

Basi: Unicode

Un tag, ad esempio una parola o una frase descrittiva. Le entità possono essere taggate dagli utenti e successivamente restituite da una query per tale tag. I tag possono essere utilizzati anche per i risultati di ranking (frequenza), didascalie delle foto, clustering, attività ecc.

Ecco una descrizione più dettagliata: http://www.zeldman.com/Daily/0405d.shtml

Questo è l'elemento "category" di Atom. Nell'output XML, il tag viene fornito come attributo termino. Visita la pagina http://www.atomenabled.org/developers/syndication/#category

Aumenta BadValueError se il tag non è una stringa o un sottotipo.

TERMINE = 'tag-utente'
Origine ToXml()
google.appengine.api.datastore_types.DatetimeToTimestamp(value)origine

Converte una data/ora: data/ora in microsecondi dal periodo, come in virgola mobile. :param value: dataora.timestamp

Restituisce: valore lungo

google.appengine.api.datastore_types.DecodeAppIdNamespace(app_namespace_str)source

Decodifica app_namespace_str in una coppia (app_id, namespace).

Questo metodo è l'inverso di EncodeAppIdNamespace ed è necessario per datastore_file_stub.

Parametri

app_namespace_str: una coppia app_id e spazio dei nomi codificata creata da EncodeAppIdNamespace

Restituisce

Coppia (app_id, spazio dei nomi) codificata in app_namespace_str

classgoogle.appengine.api.datastore_types.Email(email)origine

Basi: Unicode

Un indirizzo email RFC2822. Non fa alcun tentativo di convalida; oltre a controllare i record MX, la convalida dell'indirizzo email è un rathole.

Questo è l'elemento gd:email. Nell'output XML, l'indirizzo email viene fornito come attributo dell'indirizzo. Vedi: https://developers.google.com/gdata/docs/1.0/elements#gdEmail

Aumenta BadValueError se l'indirizzo email non è un indirizzo email valido.

Origine ToXml()
classgoogle.appengine.api.datastore_types.EmbeddedEntitysource

Basi: google.appengine.api.datastore_types._BaseByteType

Un protocollo EntityProto con codifica proto.

Il comportamento è identico a quello di Blob, ad eccezione del costruttore, che accetta un argomento str o EntityProto.

Può essere decodificato utilizzando datastore.Entity.FromProto(), db.model_from_protobuf() o ndb.LocalStructuredProperty.

google.appengine.api.datastore_types.EncodeAppIdNamespace(app_id, namespace)source

Concatena l'ID e lo spazio dei nomi dell'app in una singola stringa.

Questo metodo è necessario per xml e datastore_file_stub.

Parametri

  • app_id: l'ID applicazione da codificare

  • Spazio dei nomi – Lo spazio dei nomi da codificare

Restituisce

La codifica della stringa per la coppia spazio dei nomi app_id.

google.appengine.api.datastore_types.FromPropertyPb(pb)fonte

Converte una proprietà PB in un valore Python.

Parametri

pb - entità_pb.Property

Restituisce

# tipo di ritorno è determinato dal tipo di stringa dell'argomento, int, bool, doppio, utenti.Utente o uno dei tipi atom o gd

google.appengine.api.datastore_types.FromPropertyTypeName(type_name)fonte

Restituisce il tipo Python dato un nome di tipo.

Parametri

type_name: una rappresentazione stringa di un nome di tipo datastore.

Restituisce

Un tipo di Python.

google.appengine.api.datastore_types.FromreferenceProperty(value)origine

Converte un PropertyValue di riferimento in una chiave.

Parametri

value - entità_pb.PropertyValue

Restituisce

Chiave

Aumenta

BadValueError se il valore non è un PropertyValue.

class google.appengine.api.datastore_types.GeoPt(lat, lon=None)source

Basi: oggetto

Un punto geografico, specificato da coordinate di latitudine e longitudine in virgola mobile. Spesso utilizzato per l'integrazione con siti di mappatura come Google Maps. Può essere utilizzato anche come coordinata ICBM.

Questo è l'elemento georss:point. Nell'output XML, le coordinate vengono fornite come attributi lat e lon. Vedi: http://georss.org/

Serializza su '<lat>,<lon>'. Aumenta BadValueError se ha superato una stringa serializzata non valida oppure se lat e lon non sono punti mobili validi rispettivamente negli intervalli [-90, 90] e [-180, 180].

Origine ToXml()
lat = Nessuna
lon = Nessuno
google.appengine.api.datastore_types.GetPropertyValueTag(value_pb)

Restituisce la costante di tag associata all'entità_pb.PropertyValue specificato.

class google.appengine.api.datastore_types.IM(protocol, address=None)source

Basi: oggetto

Un handle di messaggistica immediata. Include sia un indirizzo che il relativo protocollo. Il valore del protocollo è uno schema IM standard o un URL che identifica la rete IM per il protocollo. I valori possibili sono:

Valore Descrizione sip SIP/SIMPLE sconosciuto Sconosciuto o non specificato xmpp XMPP/Jabber http://aim.com/ AIM http://icq.com/ ICQ http://talk.google.com/ Google Talk http://messenger.msn.com/ SMB Messenger http://messenger.yahoo.com/ Yahoo

Questo è l'elemento gd:im. Nell'output XML, l'indirizzo e il protocollo vengono forniti rispettivamente come attributi indirizzo e protocollo. Vedi: https://developers.google.com/gdata/docs/1.0/elements#gdIm

Serializza in "<protocol> <address>". Aumenta il valore BadValueError se il tag non è uno schema IM standard o un URL.

PROTOCOLLI = ['sip', 'unknown', 'xmpp']
Origine ToXml()
indirizzo = Nessuno
protocollo = Nessuno
class google.appengine.api.datastore_types.Key(encoded=None)source

Basi: oggetto

La chiave primaria per un'entità datastore.

Un GUID datastore. Un'istanza chiave identifica in modo univoco un'entità in tutte le app e include tutte le informazioni necessarie per recuperare l'entità dal datastore con Get().

Le chiavi implementano __hash__ e le istanze delle chiavi sono immutabili, pertanto le chiavi possono essere utilizzate negli insiemi e come chiavi del dizionario.

Origine TagTagUri()

Restituisce un tag: URI per questa entità da utilizzare nell'output XML.

Le chiavi straniere per le entità possono essere rappresentate nell'output XML come URI di tag. RFC 4151 descrive lo schema dell'URI del tag. Da http://taguri.org/:

L'algoritmo dei tag consente agli utenti di creare nuovi identificatori che nessun altro che utilizza lo stesso algoritmo potrà mai creare. L'operazione è abbastanza semplice da eseguire nella tua mente e gli identificatori risultanti possono essere facili da leggere, scrivere e ricordare. Gli identificatori sono conformi alla sintassi URI (URL).

Gli URI dei tag per le entità utilizzano il dominio di autenticazione dell'app e la data in cui

sia generato. La parte specifica dello spazio dei nomi è <kind>[<key>].

Ad esempio, ecco l'URI del tag per un gattino con la chiave "Fluffy" nell'app catsinsink:

tag:catsinsinks.googleapps.com,2006-08-29:Kitten[Fluffy]

Genera un errore BadKeyError se la chiave di questa entità è incompleta.

Origine ToXml()

Restituisce un tag: URI per questa entità da utilizzare nell'output XML.

Le chiavi straniere per le entità possono essere rappresentate nell'output XML come URI di tag. RFC 4151 descrive lo schema dell'URI del tag. Da http://taguri.org/:

L'algoritmo dei tag consente agli utenti di creare nuovi identificatori che nessun altro che utilizza lo stesso algoritmo potrà mai creare. L'operazione è abbastanza semplice da eseguire nella tua mente e gli identificatori risultanti possono essere facili da leggere, scrivere e ricordare. Gli identificatori sono conformi alla sintassi URI (URL).

Gli URI dei tag per le entità utilizzano il dominio di autenticazione dell'app e la data in cui

sia generato. La parte specifica dello spazio dei nomi è <kind>[<key>].

Ad esempio, ecco l'URI del tag per un gattino con la chiave "Fluffy" nell'app catsinsink:

tag:catsinsinks.googleapps.com,2006-08-29:Kitten[Fluffy]

Genera un errore BadKeyError se la chiave di questa entità è incompleta.

App()source

Restituisce l'ID app di questa entità, una stringa.

entità_group()origine

Restituisce il gruppo di entità di questa chiave come chiave.

Tieni presente che la chiave restituita sarà incompleta se questa è per un'entità root e è incompleta.

statica from_path(*args, **kwds)source

Metodo statico per creare una chiave da un "percorso" (tipo, ID o nome...).

Ciò è utile quando un'applicazione vuole utilizzare solo l'ID o la parte del nome di una chiave, ad esempio un URL, dove il resto dell'URL fornisce un contesto sufficiente per compilare il resto, ovvero l'ID app (sempre implicito), il tipo di entità e possibilmente una chiave predecessore. Poiché gli ID e i nomi sono di solito piccoli, sono più interessanti da utilizzare negli URL visibili all'utente finale rispetto alla rappresentazione stringa completa di una chiave.

Parametri

  • type: il tipo di entità (un'istanza str o Unicode).

  • id_or_name: l'ID (un int o lungo) o il nome (un'istanza str o Unicode)

  • principale: chiave principale facoltativa; l'impostazione predefinita è Nessuna.

  • Spazio dei nomi - facoltativo per utilizzare lo spazio dei nomi altrimenti spazio_dei_gestori utilizzato.

Restituisce

Una nuova istanza di chiave i cui metodi .kind() e .id() o .name() restituiscono l'ultimo tipo di argomento e gli argomenti posizionali del nome passati.

Aumenta

  • BadArgumentError per argomenti non validi.

  • BadKeyError se la chiave padre è incompleta.

has_id_or_name() source

Restituisce True se questa entità ha un ID o un nome, False in caso contrario.

id() source

Restituisce l'ID di questa entità oppure None se non ne ha uno.

id_or_name()source

Restituisce l'ID o il nome di questa entità, a seconda di quale sia il valore presente o Nessuno.

() di tipo

Restituisce il tipo di questa entità, come stringa.

nome()origine

Restituisce il nome di questa entità oppure Nessuno se non ne ha uno.

()

Restituisce lo spazio dei nomi di questa entità, una stringa.

padre()source

Restituisce la risorsa padre di questa entità, come chiave. Se questa entità non ha un elemento padre, restituisce Nessuno.

to_path(_default_id=Nessuno, _decode=True, _fail=True)origine

Crea il "percorso" di questa chiave come elenco.

Restituisce

Un elenco [kind_1, id_or_name_1, ...,kind_n, id_or_name_n] del percorso della chiave.

Aumenta

datastore_errors.BadKeyError se questa chiave non ha un percorso valido.

google.appengine.api.datastore_types.PackBlob(name, value, pbvalue)origine

Pacchettizza una proprietà Blob in un'entità_pb.PropertyValue.

Parametri

  • name: il nome della proprietà come stringa.

  • value: un'istanza BLOB.

  • pbvalue - L'entità_pb.PropertyValue in cui includere questo valore.

google.appengine.api.datastore_types.PackBool(nome, valore, pbvalue)origine

Pacchettizza una proprietà booleana in un entità_pb.PropertyValue.

Parametri

  • name: il nome della proprietà come stringa.

  • value: un'istanza booleana.

  • pbvalue - L'entità_pb.PropertyValue in cui includere questo valore.

google.appengine.api.datastore_types.PackDatetime(nome, valore, pbvalue)origine

Pacchettizza una proprietà di tipo data-ora in un'entità_pb.PropertyValue.

Parametri

  • name: il nome della proprietà come stringa.

  • value: un'istanza timestamp.timestamp.

  • pbvalue - L'entità_pb.PropertyValue in cui includere questo valore.

google.appengine.api.datastore_types.PackFloat(name, value, pbvalue)origine

Pacchettizza una proprietà floating in un entità_pb.PropertyValue.

Parametri

  • name: il nome della proprietà come stringa.

  • value: un'istanza mobile.

  • pbvalue - L'entità_pb.PropertyValue in cui includere questo valore.

google.appengine.api.datastore_types.PackGeoPt(nome, valore, pbvalue)origine

Pacchettizza una proprietà GeoPt in un entità_pb.PropertyValue.

Parametri

  • name: il nome della proprietà come stringa.

  • value: un'istanza GeoPt.

  • pbvalue - L'entità_pb.PropertyValue in cui includere questo valore.

google.appengine.api.datastore_types.PackInteger(name, value, pbvalue)origine

Pacchettizza una proprietà intera in un'entità_pb.PropertyValue.

Parametri

  • name: il nome della proprietà come stringa.

  • value: un'istanza int o long.

  • pbvalue - L'entità_pb.PropertyValue in cui includere questo valore.

google.appengine.api.datastore_types.PackKey(name, value, pbvalue)origine

Pacchettizza una proprietà di riferimento in un entità_pb.PropertyValue.

Parametri

  • name: il nome della proprietà come stringa.

  • value: un'istanza della chiave.

  • pbvalue - L'entità_pb.PropertyValue in cui includere questo valore.

google.appengine.api.datastore_types.PackString(name, value, pbvalue)origine

Pacchettizza una proprietà di tipo stringa in un entità_pb.PropertyValue.

Parametri

  • name: il nome della proprietà come stringa.

  • value: una stringa, un unicode o un'istanza di tipo stringa.

  • pbvalue - L'entità_pb.PropertyValue in cui includere questo valore.

google.appengine.api.datastore_types.PackUser(name, value, pbvalue)origine

Include una proprietà utente in un'entità_pb.PropertyValue.

Parametri

  • name: il nome della proprietà come stringa.

  • value – Un'istanza users.User.

  • pbvalue - L'entità_pb.PropertyValue in cui includere questo valore.

google.appengine.api.datastore_types.PartitionString(valore, separatore)origine
Equivalente a python2.5 str.partition()

TODO utilizza str.partition() quando python 2.5 è adottato.

Parametri

  • value - Stringa da partizionare

  • separatore - stringa separatore

classgoogle.appengine.api.datastore_types.PhoneNumber(phone)fonte

Basi: Unicode

Un numero di telefono o un indirizzo leggibile.

Non viene eseguita alcuna convalida. I numeri di telefono sono di vari formati: locali, interurbane, nazionali, internazionali, interni, TTY, VOIP, SMS e reti alternative come Skype, XFire e Roger Wilco. Hanno tutti i propri formati di numerazione e indirizzo.

Questo è l'elemento gd:phoneNumber. Nell'output XML, il numero di telefono viene fornito come testo dell'elemento. Vedi: https://developers.google.com/gdata/docs/1.0/elements#gdPhoneNumber

Aumenta BadValueError se il telefono non è una stringa o un sottotipo.

Origine ToXml()
class google.appengine.api.datastore_types.postalAddress(address)source

Basi: Unicode

Un indirizzo postale leggibile. Anche in questo caso, i formati degli indirizzi postali variano notevolmente, quindi non viene eseguita alcuna convalida.

Questo è l'elemento gd:postalAddress. Nell'output XML, l'indirizzo viene fornito come testo dell'elemento. Vedi: https://developers.google.com/gdata/docs/1.0/elements#gdpostalAddress

Aumenta BadValueError se l'indirizzo non è una stringa o un sottotipo.

Origine ToXml()
google.appengine.api.datastore_types.PropertyTypeName(value)origine

Restituisce il nome del tipo del valore della proprietà specificato, come stringa.

Aumenta BadValueError se il valore non è un tipo di proprietà valido.

Parametri

value: qualsiasi valore della proprietà valido

Restituisce

string

google.appengine.api.datastore_types.PropertyValueFromString(type_, value_string, _auth_domain=None)origine

Restituisce un'istanza di un valore di proprietà in base a un valore di tipo e stringa.

L'inverso di questo metodo è solo str() e type() del valore python.

Tieni presente che questo non supporta gli offset non UTC nelle stringhe di data e ora in formato ISO 8601, ad esempio il suffisso -08:00 in "2002-12-25 00:00:00-08:00". Supporta solo i suffissi -00:00 e +00:00, che sono UTC.

Parametri

  • type - Una classe Python.

  • value_string: rappresentazione stringa del valore della proprietà.

Restituisce

Un'istanza di "type".

Aumenta

ValueError se type_ è timestamp e value_string ha un offset di fuso orario.

google.appengine.api.datastore_types.PropertyValueToKeyValue(prop_value)

Converte un'entità_pb.PropertyValue in un valore "chiave" paragonabile di tipo hash.

I valori generati da questa funzione imitano l'ordini nativo del datastore e identificano in modo univoco il determinato valore ValueValue.

Parametri

prop_value - L'entità_pb.PropertyValue da cui creare il valore chiave.

Restituisce

Una rappresentazione comparabile e hash del valore della proprietà specificata.

classgoogle.appengine.api.datastore_types.Rating(rating)source

Basi: lunghe

Una valutazione intera fornita dall'utente per un contenuto. Normalizzata su una scala da 0 a 100.

Questo è l'elemento gd:rating. Nell'output XML, l'indirizzo viene fornito come testo dell'elemento. Vedi: https://developers.google.com/gdata/docs/1.0/elements#gdRating

Serializza alla rappresentazione in formato decimale della stringa della valutazione. Aumenta BadValueError se la valutazione non è un numero intero compreso nell'intervallo [0, 100].

MAX = 100
MIN = 0
Origine ToXml()
google.appengine.api.datastore_types.RiferimentiToKeyValue(key, id_resolver=None)source

Converte una chiave in un valore "chiave" paragonabile.

Parametri

  • chiave: entità_pb.Reference o googledatastore.Key, da cui creare il valore della chiave.

  • id_resolver - Un datastore_pbs.IdSolver facoltativo. Obbligatorio solo per i valori googledatastore.Key.

Restituisce

Una rappresentazione comparabile e hash della chiave specificata compatibile con una derivata da un valore di proprietà chiave.

google.appengine.api.datastore_types.SolveAppId(app)

Convalida l'ID dell'app, fornendo un valore predefinito.

Se l'argomento è Nessuno, $APPLICATION_ID viene sostituito.

Parametri

app: il valore dell'argomento ID app da convalidare.

Restituisce

Il valore dell'app o il valore predefinito sostituito. Deve sempre essere una stringa non vuota.

Aumenta

BadArgumentError se il valore è vuoto o non è una stringa.

google.appengine.api.datastore_types.SolveNamespace(namespace)

Convalida lo spazio dei nomi dell'app, fornendo un valore predefinito.

Se l'argomento è Nessuno, il valore namespace_manager.get_namespace() viene sostituito.

Parametri

namespace: il valore dell'argomento dello spazio dei nomi da convalidare.

Restituisce

Il valore dello spazio dei nomi o il valore predefinito sostituito. La stringa vuota viene utilizzata per indicare lo spazio dei nomi vuoto.

Aumenta

BadArgumentError se il valore non è una stringa.

google.appengine.api.datastore_types.RestoreFromIndexValue(index_value, data_type)Origine

Consente di ripristinare un valore di indice del tipo di datastore corretto.

Le query di proiezione restituiscono valori delle proprietà direttamente da un indice del datastore. Questi valori sono i valori nativi del datastore, uno dei seguenti: str, bool, long, fluttua, GeoPt, Key o User. Questa funzione ripristina il valore originale quando il tipo originale è noto.

Questa funzione restituisce il tipo di valore restituito durante la decodifica di un'entità normale, non necessariamente di tipo data_type. Ad esempio, data_type=int restituisce una lunga istanza.

Parametri

  • index_value - Il valore restituito da FromPropertyPb per la proprietà prevista.

  • data_type - Il tipo del valore originariamente assegnato a ToPropertyPb

Restituisce

Il valore della proprietà ripristinata.

Aumenta

datastore_errors.BadValueError se il valore non può essere ripristinato.

google.appengine.api.datastore_types.SetNamespace(proto, namespace)source

Imposta lo spazio dei nomi per un buffer di protocollo o cancella il campo.

Parametri

  • proto: il buffer di protocollo da aggiornare

  • spazio dei nomi: il nuovo spazio dei nomi (Nessuno o una stringa vuota cancellerà il campo).

classgoogle.appengine.api.datastore_types.Textorigine

Basi: Unicode

Un tipo di stringa lungo.

Le stringhe di qualsiasi lunghezza possono essere archiviate nel datastore utilizzando questo tipo. Si comporta in modo identico al tipo Unicode Python, ad eccezione del costruttore, che accetta solo argomenti str e Unicode.

google.appengine.api.datastore_types.ToPropertyPb(nome, valori)origine

Crea entità_pb.PropertyValues specifiche per tipo.

Determina il tipo e il significato di PropertyValue in base al tipo di Python dei valori di input.

NOTA: questa funzione non convalida nulla.

Parametri

  • name: stringa o Unicode; il nome della proprietà

  • value: i valori di questa proprietà, una singola o un elenco di queste. Tutti i valori devono essere di un tipo supportato. Gli elenchi di valori devono essere tutti dello stesso tipo.

Restituisce

Un elenco di istanze di entità_pb.Property

classgoogle.appengine.api.datastore_types.UtcTzinfosource

Basi: timestamp.tzinfo

dst(dt)origine
tzname(dt)origine
Sorgente utcoffset(dt)
google.appengine.api.datastore_types.ValidateInteger(value, name='unused', except=google.appengine.api.datastore_errors.BadValueError, empty_ok=False, zero_ok=False, negative_ok=False)origine

Imposta un'eccezione se il valore non è un numero intero valido.

Un numero intero è valido se non è negativo o è vuoto e corrisponde a un numero intero (int o lungo). Il tipo di eccezione sollevato può essere specificato con l'argomento eccezione; il valore predefinito è BadValueError.

Parametri

  • value: il valore da convalidare.

  • name: il nome di questo valore; utilizzato nel messaggio di eccezione.

  • eccezione: il tipo di eccezione da sollevare.

  • empty_ok - non consentire alcun valore.

  • zero_ok: non consentire alcun valore.

  • negative_ok - consenti un valore negativo.

google.appengine.api.datastore_types.ValidateProperty(name, valori, read_only=False)origine

Funzione di supporto per la convalida dei valori delle proprietà.

Parametri

  • name - Nome della proprietà per cui viene utilizzata.

  • value - Valore della proprietà come tipo nativo di Python.

  • read_only – deprecato

Risalto

  • BadPropertyError se il nome della proprietà non è valido. BadValueError se l'elemento

  • non è stato convalidato correttamente o il valore era un elenco vuoto. Altro

  • Tipi di eccezioni (come OverflowError) se il valore della proprietà non soddisfa

  • criteri specifici per tipo.

google.appengine.api.datastore_types.ValidatePropertyInteger(nome, valore)source

Imposta un'eccezione se il numero intero fornito non è valido.

Parametri

  • name - Nome della proprietà per cui viene utilizzata.

  • value: valore intero.

Rialzi

OverflowError se il valore non rientra in un valore int64 firmato.

google.appengine.api.datastore_types.ValidatePropertyKey(name, value)origine

Genera un'eccezione se l'istanza datastore.key fornita non è valida.

Parametri

  • name - Nome della proprietà per cui viene utilizzata.

  • value: un'istanza datastore.Key.

Rialzi

datastore_errors.BadValueError se il valore non è valido.

google.appengine.api.datastore_types.ValidatePropertyNothing(nome, valore)source

Funzione di convalida automatica.

Parametri

  • name - Nome della proprietà per cui viene utilizzata.

  • value - Non utilizzato.

google.appengine.api.datastore_types.ValidatePropertyString(name, value)origine

Convalida la lunghezza di una proprietà stringa indicizzata.

Parametri

  • name - Nome della proprietà per cui viene utilizzata.

  • value: valore stringa.

google.appengine.api.datastore_types.ValidateReadProperty(nome, valori, read_only=False)origine

Funzione di supporto per la convalida dei valori delle proprietà.

Parametri

  • name - Nome della proprietà per cui viene utilizzata.

  • value - Valore della proprietà come tipo nativo di Python.

  • read_only – deprecato

Risalto

  • BadPropertyError se il nome della proprietà non è valido. BadValueError se l'elemento

  • non è stato convalidato correttamente o il valore era un elenco vuoto. Altro

  • Tipi di eccezioni (come OverflowError) se il valore della proprietà non soddisfa

  • criteri specifici per tipo.

google.appengine.api.datastore_types.ValidateString(value, name='unused', except=google.appengine.api.datastore_errors.BadValueError, max_len=1500, empty_ok=False)origine

Imposta un'eccezione se il valore non è una stringa valida o una sottoclasse correlata.

Una stringa è valida se non è vuota, non più di _MAX_STRING_LENGTH byte e non un BLOB. Il tipo di eccezione può essere specificato con l'argomento eccezione; il valore predefinito è BadValueError.

Parametri

  • value: il valore da convalidare.

  • name: il nome di questo valore; utilizzato nel messaggio di eccezione.

  • eccezione: il tipo di eccezione da sollevare.

  • max_len – la lunghezza massima consentita, in byte.

  • empty_ok - consente un valore vuoto.

google.appengine.api.datastore_types.ValidateStringLength(nome, valore, max_len)origine

Imposta un'eccezione se la stringa fornita è troppo lunga.

Parametri

  • name - Nome della proprietà per cui viene utilizzata.

  • value: valore stringa.

  • max_len - La lunghezza massima della stringa.

Rialzi

OverflowError se il valore supera la lunghezza massima.

google.appengine.api.datastore_types.typename(obj)origine

Restituisce il tipo di obj come stringa. Più descrittivo e specifico del tipo(obj) e sicuro per qualsiasi oggetto, a differenza di __class__.