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 context.Context, scopes ...string) (token string, expiry time.Time, err error)
func AppID(c context.Context) string
func Datacenter(c context.Context) string
func DefaultVersionHostname(c context.Context) string
func InstanceID() string
func IsDevAppServer() bool
func IsOverQuota(err error) bool
func IsTimeoutError(err error) bool
func ModuleHostname(c context.Context, module, version, instance string) (string, error)
func ModuleName(c context.Context) string
func Namespace(c context.Context, namespace string) (context.Context, error)
func NewContext(req *http.Request) context.Context
func PublicCertificates(c context.Context) ([]Certificate, error)
func RequestID(c context.Context) string
func ServerSoftware() string
func ServiceAccount(c context.Context) (string, error)
func SignBytes(c context.Context, bytes []byte) (keyName string, signature []byte, err error)
func VersionID(c context.Context) string
func WithContext(parent context.Context, req *http.Request) context.Context
type BlobKey
type Certificate
type GeoPoint
    func (g GeoPoint) Valid() bool
type MultiError
    func (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 la data e l'ora restituite.

func AppID

func AppID(c context.Context) string

AppID restituisce l'ID applicazione dell'applicazione corrente. La stringa sarà un ID applicazione normale (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

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 quasi univoco per questa istanza.

func IsDevAppServer

func IsDevAppServer() bool

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

func IsOverQuota

func IsOverQuota(err error) bool

IsOverQuota indica se err rappresenta un errore di chiamata API dovuto a una disponibilità insufficiente di quota.

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 il nome host di un'istanza del modulo. Se il modulo è una 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 del bilanciamento del carico.

func ModuleName

func ModuleName(c context.Context) string

ModuleName restituisce il nome del modulo dell'istanza corrente.

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 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 della release di App Engine. In produzione, è simile a "Google App Engine/X.Y.Z". Nell'appserver di sviluppo, ha il formato "Sviluppo/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 la tua applicazione.

func VersionID

func VersionID(c context.Context) string

VersionID restituisce l'ID versione dell'applicazione corrente. Sarà del tipo "X.Y", dove X è specificato in app.yaml e Y è un numero generato al 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

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

tipo BlobKey

type BlobKey string

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

A livello concettuale, questo tipo appartiene al pacchetto blobstore, ma si trova nel pacchetto appengine per evitare una dipendenza circolare: blobstore dipende da datastore e datastore deve 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.

func (GeoPoint) Valid

func (g GeoPoint) Valid() bool

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

tipo MultiError

type MultiError []error

MultiError viene restituito dalle operazioni collettive quando si verificano errori con elementi specifici. Gli errori saranno in corrispondenza uno a uno con gli elementi di input. Gli elementi corretti avranno una voce nulla.

Errore func (MultiError)

func (m MultiError) Error() string