Il pacchetto AppEngine

import "google.golang.org/appengine"

Introduzione

Il pacchetto appengine fornisce funzionalità di base per Google App Engine.

Per ulteriori informazioni su come scrivere app Go per Google App Engine, consulta: https://cloud.google.com/appengine/docs/standard/go/

Indice

func AccessToken(c contesto.Context, dispositore.Context.Context.Context.Context.Context.Context. String.Context.Context String.Context.Context.String [Nome di contesto efunc4f5.Context.Context Stringa String.Context.... string[Nome di contesto, .
func AppID(c context.Context) stringfunc Datacenter(c context.Context) stringfunc DefaultVersionHostname(c context.Context) stringfunc InstanceID() stringfunc IsDevAppServer() boolfunc IsOverQuota(err error) boolfunc IsTimeoutError(err error) boolfunc ModuleHostname(c context.Context, module, version, instance string) (string, error)func ModuleName(c context.Context) stringfunc Namespace(c context.Context, namespace string) (context.Context, error)func NewContext(req *http.Request) context.Contextfunc PublicCertificates(c context.Context) ([]Certificate, error)func RequestID(c context.Context) stringfunc ServerSoftware() stringfunc ServiceAccount(c context.Context) (string, error)func SignBytes(c context.Context, bytes []byte) (keyName string, signature []byte, err error)func VersionID(c context.Context) stringfunc WithContext(parent context.Context, req *http.Request) context.Contextfunc (g GeoPoint) Valid() boolfunc (m MultiError) Error() string

func AccessToken

func AccessToken(c context.Context, scopes ...string) (token string, expiry time.Time, err error)

AccessToken genera un token di accesso OAuth2 per gli ambiti specificati per conto dell'account di servizio di questa applicazione. Questo token scadrà dopo il periodo di tempo restituito.

func AppID

func AppID(c context.Context) string

AppID restituisce l'ID applicazione dell'applicazione corrente. La stringa sarà un ID applicazione semplice (ad es. "appid"), con un prefisso di dominio per i deployment di domini personalizzati (ad es. "example.com:appid").

func Datacenter

func Datacenter(c context.Context) string

Il data center restituisce un identificatore per il data center in cui è in esecuzione l'istanza.

func DefaultVersionHostname

func DefaultVersionHostname(c context.Context) string

defaultVersionHostname restituisce il nome host standard della versione predefinita dell'applicazione corrente (ad es. "my-app.appspot.com"). È adatto alla creazione degli URL.

func InstanceID

func InstanceID() string

InstanceID restituisce un identificatore prevalentemente univoco per questa istanza.

func IsDevAppServer

func IsDevAppServer() bool

IsDevAppServer indica se l'app App Engine è in esecuzione in App Server di sviluppo.

func IsOverQuota

func IsOverQuota(err error) bool

IsOverQuota segnala se un errore rappresenta un errore di chiamata API dovuto a una quota disponibile insufficiente.

func IsTimeoutError

func IsTimeoutError(err error) bool

IsTimeoutError indica se "err" è un errore di timeout.

func ModuleHostname

func ModuleHostname(c context.Context, module, version, instance string) (string, error)

ModuleHostname restituisce un nome host di un'istanza di modulo. Se il modulo è la stringa vuota, si riferisce al modulo dell'istanza corrente. Se la versione è vuota, si riferisce alla versione dell'istanza corrente, se valida, o alla versione predefinita del modulo dell'istanza corrente. Se l'istanza è vuota, ModuleHostname restituisce il nome host di bilanciamento del carico.

func ModuleName

func ModuleName(c context.Context) string

ModuleName restituisce il nome del modulo dell'istanza corrente.

func Namespace

func Namespace(c context.Context, namespace string) (context.Context, error)

Lo spazio dei nomi restituisce un contesto sostitutivo che opera all'interno dello spazio dei nomi specificato.

func NewContext

func NewContext(req *http.Request) context.Context

NewContext restituisce un contesto per una richiesta HTTP in corso. Questa funzione è economica.

func PublicCertificates

func PublicCertificates(c context.Context) ([]Certificate, error)

PublicCertificates recupera i certificati pubblici per l'app. Possono essere utilizzati per verificare una firma restituita da SignBytes.

func RequestID

func RequestID(c context.Context) string

RequestID restituisce una stringa che identifica in modo univoco la richiesta.

func ServerSoftware

func ServerSoftware() string

ServerSoftware restituisce la versione di release di App Engine. In produzione, si presenta come "Google App Engine/X.Y.Z". Nell'appserver di sviluppo, l'URL è "Development/X.Y".

func ServiceAccount

func ServiceAccount(c context.Context) (string, error)

ServiceAccount restituisce una stringa che rappresenta il nome dell'account di servizio sotto forma di indirizzo email (in genere app_id@appspot.gserviceaccount.com).

func SignBytes

func SignBytes(c context.Context, bytes []byte) (keyName string, signature []byte, err error)

SignBytes firma i byte utilizzando una chiave privata univoca per l'applicazione.

func VersionID

func VersionID(c context.Context) string

VersionID restituisce l'ID versione per l'applicazione corrente. Sarà nel formato "X.Y", dove X è specificato in app.yaml, mentre Y è un numero generato quando viene caricata ogni versione dell'app. Non include il nome di un modulo.

func WithContext

func WithContext(parent context.Context, req *http.Request) context.Context

WithContext restituisce una copia del contesto padre e la associa a una richiesta HTTP in corso. Questa funzione è economica.

digita BlobKey

type BlobKey string

BlobKey è la chiave di un BLOB dell'archivio.

Concettualmente, questo tipo appartiene al pacchetto dell'archivio blob, ma si trova nel pacchetto appengine per evitare una dipendenza circolare: il blobstore dipende dal datastore e il datastore deve fare riferimento al tipo BlobKey.

tipo certificato

type Certificate struct {
    KeyName string
    Data    []byte // PEM-encoded X.509 certificate
}

Il certificato rappresenta un certificato pubblico per l'app.

digita GeoPoint

type GeoPoint struct {
    Lat, Lng float64
}

GeoPoint rappresenta una posizione come latitudine/longitudine in gradi.

func (GeoPoint) Valid

func (g GeoPoint) Valid() bool

Restituisce un valore valido se un GeoPoint è compreso tra [-90, 90] e [-180, 180] longitudine.

tipo MultiError

type MultiError []error

MultiError viene restituito dalle operazioni batch quando si verificano errori con determinati elementi. Gli errori saranno in una corrispondenza one-to-one con gli elementi di input; gli elementi con esito positivo avranno una voce null.

func (MultiError) Error

func (m MultiError) Error() string