Oggetti utente

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

L'applicazione può accedere all'istanza User 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 Utente con un indirizzo email che non rappresenta un Account Google al momento della creazione non corrisponderà mai a un valore Utente che rappresenta un utente reale.

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

L'oggetto User per un utente valido può fornire un valore ID univoco per l'utente che rimane invariato anche se l'utente cambia 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 dall'app.

Utilizzo dei valori utente con Datastore

L'ID utente è stabile e puoi utilizzarlo nel nome di una chiave o come proprietà stringa. Pertanto, quando utilizzi i valori utente, devi memorizzare l'ID utente (e magari l'ultimo indirizzo email per comunicare con l'utente via email). 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 valore User memorizzato con il nuovo valore User, non corrisponderanno. Valuta invece la possibilità di utilizzare il User valore dell'ID utente come identificatore univoco stabile dell'utente.