Oggetti utente

Un'istanza della classe User rappresenta un utente. Le istanze utente sono univoche e paragonabili. Se due istanze sono uguali, rappresentano lo stesso utente.

L'applicazione può accedere all'istanza Utente per l'utente corrente chiamando la funzione users.get_current_user().

user = users.get_current_user()

Puoi utilizzare la funzione users.get_current_user() indipendentemente dall'opzione di autenticazione utilizzata dalla tua app.

Un'istanza User può essere creata anche da un indirizzo email:

user = users.User("Albert.Johnson@example.com")

In alternativa, se hai un federated_identity, puoi utilizzarlo per creare un'istanza User:

user = users.User(federated_identity="http://example.com/id/ajohnson")

Se il costruttore User viene chiamato con un indirizzo email che non corrisponde a un Account Google valido, l'oggetto verrà creato, ma non corrisponderà a un Account Google reale. Ciò avverrà anche se qualcuno crea un Account Google con l'indirizzo email specificato dopo la memorizzazione dell'oggetto. Un valore User con un indirizzo email che non rappresenta un Account Google al momento della creazione non corrisponderà mai a un valore User che rappresenta un utente reale.

Quando viene eseguito nel server web di sviluppo, si presume che tutti gli oggetti User rappresentino account Google validi quando vengono archiviati nel datastore (simulato).

L'oggetto Utente per un utente valido può fornire un valore ID univoco per l'utente che rimane invariato anche se l'utente modifica il proprio indirizzo email. Il metodo user_id() restituisce questo ID, un valore str.

L'oggetto User ha la stessa forma indipendentemente dal metodo di autenticazione utilizzato dalla tua app.

Utilizzare i valori utente con Datastore

L'ID utente è stabile; puoi utilizzarlo in un nome chiave o come proprietà di stringa. Pertanto, quando utilizzi i valori utente, devi memorizzare l'ID utente (e forse l'indirizzo email visualizzato per ultimo per comunicare con l'utente via posta). L'esempio seguente mostra come confrontare l'utente corrente con un ID utente: 

class ModelWithUser(ndb.Model):
    user_id = ndb.StringProperty()
    color = ndb.StringProperty()

    @classmethod
    def get_by_user(cls, user):
        return cls.query().filter(cls.user_id == user.user_id()).get()

Ti consigliamo vivamente di non memorizzare un UserProperty, perché include l'indirizzo email insieme all'ID univoco dell'utente. Se un utente cambia il proprio indirizzo email e confronti il vecchio User memorizzato con il nuovo valore User, i valori non corrisponderanno. Valuta invece la possibilità di utilizzare il User valore dell'ID utente come identificatore univoco stabile dell'utente.