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