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, vedi: https://cloud.google.com/appengine/docs/standard/go/

Indice

func AccessToken(c contesto.Contesto, ambiti ...stringa) (stringa del token, data di scadenza.Tempo, errore err)
stringa func AppID(c context.Context)
stringa func Datacenter(c context.Context)
func DefaultVersionHostname(c context.Context) string
stringa func InstanceID()
func IsDevAppServer() bool
func IsOverQuota(errore di errore) bool
func IsTimeoutError(errore errore) bool
func ModuleHostname(c context.Context, module, version, istanza stringa) (stringa, errore)
stringa func ModuleName(c context.Context)
Spazio dei nomi func(c context.Context, spazio dei nomi stringa) (context.Context, error)
func NewContext(req *http.Request) context.Context
func PublicCertificates(c context.Context) ([]Certificato, errore)
func RequestID(c context.Context) string
stringa Func ServerSoftware()
func ServiceAccount(c context.Context) (stringa, errore)
func SignBytes(c context.Context, bytes []byte) (stringa keyName, firma []byte, errore err)
stringa Func VersionID(c context.Context)
func WithContext(parent context.Context, req *http.Request) context.Context
digita BlobKey
certificato di tipo
digita GeoPoint
    func (g GeoPoint) Valid() bool
digita un errore multiplo
    stringa Func (m MultiError) Error()

funzione 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 su per conto dell'account di servizio di questa applicazione. Questo token scadrà dopo il giorno l'ora restituita.

ID app func

func AppID(c context.Context) string

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

Datacenter func

func Datacenter(c context.Context) string

Datacenter 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 per essere utilizzato nella costruzione degli URL.

func InstanceID

func InstanceID() string

InstanceID restituisce un identificatore prevalentemente univoco per questa istanza.

func IsDevAppServer

func IsDevAppServer() bool

IsDevAppServer segnala se l'app App Engine è in esecuzione di sviluppo di applicazioni.

funzione IsOverQuota

func IsOverQuota(err error) bool

IsOverQuota segnala se l'errore rappresenta un errore di chiamata API a causa di una quota disponibile insufficiente.

func IsTimeoutError

func IsTimeoutError(err error) bool

IsTimeoutError segnala se l'errore è un errore di timeout.

func ModuleHostname

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

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

func ModuleName

func ModuleName(c context.Context) string

ModuleName restituisce il nome del modulo dell'istanza attuale.

spazio dei nomi func

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

Namespace restituisce un contesto di sostituzione 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 PublicCertificati

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.

ID richiesta funzione

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, è simile a "Google App Engine/X.Y.Z". Nell'appserver di sviluppo, è simile a "Development/X.Y".

func ServiceAccount

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

ServiceAccount restituisce una stringa che rappresenta il nome dell'account di servizio, nel formato di un 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 al momento del caricamento di ogni versione dell'app. Non include il nome di un modulo.

func WithContext

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

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

digita chiave BLOB

type BlobKey string

BlobKey è una chiave per un blob dell'archivio di blob.

Concettualmente, questo tipo appartiene al pacchetto BLOBstore, ma risiede in il pacchetto appengine per evitare una dipendenza circolare: blobstore dipende datastore e datastore devono fare riferimento al tipo BlobKey.

tipo di certificato

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

Il certificato rappresenta un certificato pubblico per l'app.

tipo GeoPoint

type GeoPoint struct {
    Lat, Lng float64
}

GeoPoint rappresenta una posizione come latitudine/longitudine in gradi.

funzione (GeoPoint) Valida

func (g GeoPoint) Valid() bool

Valid restituisce se un GeoPoint rientra nei valori [-90, 90] di latitudine e [-180, 180] di longitudine.

digita MultiError

type MultiError []error

L'errore MultiError viene restituito dalle operazioni batch quando si verificano errori con elementi specifici. Gli errori saranno in una corrispondenza uno a uno con gli elementi di input; gli elementi completati avranno una voce null.

Errore func (errore multiplo)

func (m MultiError) Error() string