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)
- Funktion "DefaultVersionHostname(c context.Context)"
- Funktion InstanceID()
- Funktion 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)
- Funktion NewContext(req *http.Request) context.Context
- Funktion PublicCertust(context.Context) ([]Zertifikat, Fehler)
- Funktion RequestID-String(c context.Context)
- 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)
- Funktion Mitskontext(übergeordneter Kontext.Kontext, req *http.Request) Kontext.Kontext
- 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