In questa pagina viene descritto come utilizzare l'API Deferred, uno dei servizi in bundle legacy, con il runtime Python 3 per dell'ambiente standard. La tua app può accedere ai servizi in bundle tramite l'SDK dei servizi App Engine per Python 3.
Panoramica
In precedenza, il pacchetto Differito google.appengine.ext.deferred
dipendeva dal webapp framework in Python 2. Poiché il webapp framework
nell'SDK dei servizi App Engine per Python 3, devi
apporta alcune modifiche quando esegui l'upgrade dell'app Python 2 a Python 3.
Abilitazione dell'API Deferred
Per attivare l'API Deferred per Python 3, non è più necessario impostare
builtins.deferred
su on
nel file app.yaml
. Per attivare l'API, devi invece passare use_deferred=True
nella chiamata a wrap_wsgi_app()
.
Analogie e differenze
Per impostazione predefinita, l'API Deferred per Python 3 utilizza lo stesso URL /_ah/queue/deferred
e la stessa coda predefinita
come in Python 2. Tieni presente che per le app che eseguono la migrazione a Cloud Tasks, la coda predefinita è
non vengono creati automaticamente
mentre la libreria delle attività differite non è disponibile.
Se la tua app utilizza l'endpoint /_ah/queue/deferred
predefinito, utilizzando
deferred.defer()
in Python 3
rimane uguale a
Python 2.
Se la tua app utilizza un URL personalizzato per l'esecuzione di attività differite, devi apportare alcune modifiche poiché la classe TaskHandler
nel modulo deferred
per Python 2 è stata rimossa nella versione Python 3 di questa API.
Per impostare un URL personalizzato per l'esecuzione di attività differite, l'app può sostituire
il metodo post
o run_from_request
nella
deferred.Handler
corso
(in precedenza deferred.TaskHandler
in Python 2) e passare il parametro environ
che rappresenta un dizionario contenente i parametri di richiesta WSGI. Il metodo post
può quindi essere chiamato dall'endpoint personalizzato (come mostrato negli esempi di Python 3).
L'utilizzo end-to-end dell'API Python 3 Deferred, ad esempio il routing delle richieste
accedendo al dizionario environ
,
dipende dal framework web a cui viene eseguita la migrazione dell'app. Confronta le modifiche al codice apportate
dall'esempio Python 2 agli esempi Python 3 nelle sezioni seguenti.
Esempi di Python 3
L'esempio seguente mostra come eseguire un'attività differita utilizzando un endpoint predefinito e un endpoint personalizzato in un'app Flask e in un'app Django.
Flask
Django
Senza alcun framework
Esempi di codice
Per visualizzare gli esempi di codice completi di questa guida, consulta GitHub.