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 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 Utente può essere creata anche da un indirizzo email:

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

In alternativa, se hai un'istanza federated_identity, puoi utilizzarla per creare un'istanza utente:

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. Questo vale anche se qualcuno crea un Account Google con l'indirizzo email specificato dopo che l'oggetto è stato archiviato. 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 vengono eseguiti nel server web di sviluppo, si presume che tutti gli oggetti utente rappresentino Account Google validi quando sono 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: puoi utilizzarlo in un nome di chiave o come proprietà di stringa. Di conseguenza, quando utilizzi i valori utente, vorrai archiviare l'ID utente (e forse l'ultimo indirizzo email visualizzato per comunicare con l'utente tramite 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 archiviare un UserProperty, perché include l'indirizzo email e l'ID univoco dell'utente. Se un utente cambia il proprio indirizzo email e confronti il valore User precedente e archiviato con il nuovo valore User, non corrisponderanno. In alternativa, valuta di utilizzare il valore ID utente User come identificatore univoco stabile dell'utente.