Das Paket "appengine"

import "google.golang.org/appengine"

Einführung

Das appengine-Paket bietet grundlegende Funktionen für Google App Engine.

Weitere Informationen zum Schreiben von Go-Anwendungen für Google App Engine finden Sie unter https://cloud.google.com/appengine/docs/standard/go/

Index

Funktion AccessToken(c Kontext.Context, Bereiche ...String) (Tokenstring, Ablaufzeit.Time, Fehlerfehler)
Funktion AppID-String(c context.Context)
Funktion Datacenter-String(c context.Context)
func DefaultVersionHostname(c context.Context) string
Funktion InstanceID()
func IsDevAppServer() bool
Funktion IsOverQuota(err error) bool
Funktion IsTimeoutError(err error) bool
Funktion ModuleHostname(c Kontext.Context, Modul, Version, Instanzstring) (String, Fehler)
Funktion ModuleName-String(c context.Context)
Funktion Namespace(c Kontext.Context, Namespace-String) (Kontext.Context, Fehler)
func NewContext(req *http.Request) context.Context
Funktion PublicCertust(context.Context) ([]Zertifikat, Fehler)
func RequestID(c context.Context) string
Funktion ServerSoftware()
Funktion ServiceAccount(c context.Context) (string, error)
Funktion SignBytes(c Kontext.Context, Byte []Byte) (keyName Zeichenfolge, Signatur []Byte, Fehlerfehler)
Funktion VersionID-String(c context.Context)
func WithContext(parent context.Context, req *http.Request) context.Context
Geben Sie BlobKey ein
Geben Sie "Zertifikat" ein
Geben Sie GeoPoint ein
    Funktion (g GeoPoint) Valid() bool
Typ MultiError
    Funktion (m MultiError) Error() - String

func AccessToken

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

AccessToken generiert ein OAuth2-Zugriffstoken für die angegebenen Bereiche im Auftrag des Dienstkontos dieser Anwendung. Dieses Token läuft nach der gemeldeten Zeit ab.

func AppID

func AppID(c context.Context) string

AppID liefert die Anwendungs-ID für die aktuelle Anwendung. Der String ist eine einfache Anwendungs-ID (z. B. "appid") mit einem Domainpräfix für benutzerdefinierte Domainbereitstellungen (z. B. "example.com:appid").

func Datacenter

func Datacenter(c context.Context) string

Datacenter liefert eine Kennung für das Rechenzentrum, in dem die Instanz ausgeführt wird.

func DefaultVersionHostname

func DefaultVersionHostname(c context.Context) string

DefaultVersionHostname liefert den Standardhostnamen der Standardversion der aktuellen Anwendung (z. B. "my-app.appspot.com"). Dieser eignet sich zum Erstellen von URLs.

func InstanceID

func InstanceID() string

InstanceID liefert eine vorwiegend eindeutige Kennung für diese Instanz.

func IsDevAppServer

func IsDevAppServer() bool

IsDevAppServer meldet, ob die App Engine-Anwendung auf dem Entwicklungs-Anwendungsserver ausgeführt wird.

func IsOverQuota

func IsOverQuota(err error) bool

IsOverQuota meldet, ob err einen API-Aufruffehler aufgrund von nicht ausreichend verfügbarem Kontingent darstellt.

func IsTimeoutError

func IsTimeoutError(err error) bool

IsTimeoutError meldet, ob err ein Zeitüberschreitungsfehler ist.

func ModuleHostname

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

ModuleHostname liefert einen Hostnamen einer Modulinstanz. Wenn das Modul der leere String ist, bezieht er sich auf das Modul der aktuellen Instanz. Wenn die Version leer ist, bezieht er sich auf die Version der aktuellen Instanz, falls diese gültig ist, oder auf die Standardversion des Moduls der aktuellen Instanz. Wenn die Instanz leer ist, liefert ModuleHostname den Hostnamen für den Lastenausgleich.

func ModuleName

func ModuleName(c context.Context) string

ModuleName liefert den Modulnamen der aktuellen Instanz.

func Namespace

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

Namespace liefert einen Ersetzungskontext, der innerhalb des angegebenen Namespace funktioniert.

func NewContext

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

NewContext liefert einen Kontext für einen derzeit ausgeführten HTTP-Request. Diese Funktion ist kostengünstig.

func PublicCertificates

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

PublicCertificates ruft die öffentlichen Zertifikate für die Anwendung ab. Damit kann eine von SignBytes zurückgegebene Signatur geprüft werden.

func RequestID

func RequestID(c context.Context) string

RequestID liefert einen String, der den Request eindeutig identifiziert.

func ServerSoftware

func ServerSoftware() string

ServerSoftware liefert die App Engine-Releaseversion. In der Produktion sieht sie aus wie "Google App Engine/X.Y.Z". Im Entwicklungs-Anwendungsserver sieht sie aus wie "Development/X.Y".

func ServiceAccount

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

ServiceAccount liefert einen String, der den Namen des Dienstkontos in Form einer E-Mail-Adresse darstellt (normalerweise app_id@appspot.gserviceaccount.com).

func SignBytes

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

SignBytes signiert Byte mit einem privaten Schlüssel, der für Ihre Anwendung einzigartig ist.

func VersionID

func VersionID(c context.Context) string

VersionID liefert die Versions-ID für die aktuelle Anwendung. Sie hat die Form "X.Y", wobei X in app.yaml angegeben ist und Y eine Zahl ist, die generiert wird, wenn die jeweilige Version der Anwendung hochgeladen wird. Sie enthält keinen Modulnamen.

func WithContext

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

WithContext liefert eine Kopie des übergeordneten Kontexts und ordnet sie einem derzeit laufenden HTTP-Request zu. Diese Funktion ist kostengünstig.

type BlobKey

type BlobKey string

BlobKey ist ein Schlüssel für ein Blobstore-Blob.

Konzeptuell gehört dieser Typ ins blobstore-Paket. Er befindet sich jedoch im appengine-Paket, um eine zirkuläre Abhängigkeit zu verhindern: Blobstore hängt vom Datenspeicher ab und der Datenspeicher muss auf den BlobKey-Typ verweisen.

type Certificate

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

Das Zertifikat stellt ein öffentliches Zertifikat für die Anwendung dar.

type GeoPoint

type GeoPoint struct {
    Lat, Lng float64
}

GeoPoint stellt einen Standort in der Form Breitengrad/Längengrad in Grad dar.

func (GeoPoint) Valid

func (g GeoPoint) Valid() bool

Valid gibt an, ob ein GeoPoint innerhalb von [-90, 90] Breitengrad und [-180, 180] Längengrad liegt.

type MultiError

type MultiError []error

MultiError wird von Batchvorgängen zurückgegeben, wenn Fehler bei bestimmten Elementen vorliegen. Fehler stehen in einer 1:1-Beziehung zu den Eingabeelementen; erfolgreiche Elemente haben einen Nulleintrag.

func (MultiError) Error

func (m MultiError) Error() string