Paket appengine

import "google.golang.org/appengine"

Pengantar

Paket appengine menyediakan fungsi dasar untuk Google App Engine.

Untuk informasi selengkapnya tentang cara menulis aplikasi Go untuk Google App Engine, lihat: https://cloud.google.com/appengine/docs/standard/go/

Indeks

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 menghasilkan token akses OAuth2 untuk cakupan yang ditentukan atas nama akun layanan aplikasi ini. Masa berlaku token ini akan berakhir setelah waktu yang ditampilkan.

func AppID

func AppID(c context.Context) string

AppID menampilkan ID aplikasi untuk aplikasi saat ini. String akan berupa ID aplikasi biasa (misalnya "appid"), dengan awalan domain untuk deployment domain kustom (misalnya "example.com:appid").

func Datacenter

func Datacenter(c context.Context) string

Datacenter menampilkan ID untuk pusat data tempat instance berjalan.

func DefaultVersionHostname

func DefaultVersionHostname(c context.Context) string

DefaultVersionHostname menampilkan nama host standar dari versi default aplikasi saat ini (misalnya "my-app.appspot.com"). Ini cocok untuk digunakan dalam membuat URL.

func InstanceID

func InstanceID() string

InstanceID menampilkan ID yang sebagian besar unik untuk instance ini.

func IsDevAppServer

func IsDevAppServer() bool

IsDevAppServer melaporkan apakah aplikasi App Engine berjalan di Server Aplikasi pengembangan.

func IsOverQuota

func IsOverQuota(err error) bool

IsOverQuota melaporkan apakah error menampilkan kegagalan panggilan API karena kuota yang tersedia tidak mencukupi.

func IsTimeoutError

func IsTimeoutError(err error) bool

IsTimeoutError melaporkan apakah error adalah error waktu tunggu.

func ModuleHostname

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

ModuleHostname menampilkan nama host instance modul. Jika modul adalah string kosong, fungsi ini akan mengacu pada modul instance saat ini. Jika versi kosong, fungsi ini akan mengacu pada versi instance saat ini jika valid, atau versi default modul instance saat ini. Jika instance kosong, ModuleHostname akan menampilkan nama host load balancing.

func ModuleName

func ModuleName(c context.Context) string

ModuleName menampilkan nama modul instance saat ini.

func Namespace

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

Namespace menampilkan konteks pengganti yang beroperasi dalam namespace yang diberikan.

func NewContext

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

NewContext menampilkan konteks untuk permintaan HTTP yang sedang berlangsung. Fungsi ini murah.

func PublicCertificates

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

PublicCertificate mengambil sertifikat publik untuk aplikasi. Sertifikat ini dapat digunakan untuk memverifikasi tanda tangan yang ditampilkan oleh SignBytes.

func RequestID

func RequestID(c context.Context) string

RequestID menampilkan string yang mengidentifikasi permintaan secara unik.

func ServerSoftware

func ServerSoftware() string

ServerSoftware menampilkan versi rilis App Engine. Dalam produksi, tulisannya akan terlihat seperti "Google App Engine/X.Y.Z". Di appserver pengembangan, tulisannya akan terlihat seperti "Development/X.Y".

func ServiceAccount

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

ServiceAccount menampilkan string yang mewakili nama akun layanan, dalam bentuk alamat email (biasanya app_id@appspot.gserviceaccount.com).

func SignBytes

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

SignBytes menandatangani byte menggunakan kunci pribadi yang unik untuk aplikasi Anda.

func VersionID

func VersionID(c context.Context) string

VersionID menampilkan ID versi untuk aplikasi saat ini. Nilainya akan berupa "X.Y", dengan X ditentukan dalam app.yaml, dan Y adalah angka yang dihasilkan saat setiap versi aplikasi diupload. Versi tidak menyertakan nama modul.

func WithContext

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

WithContext menampilkan salinan konteks induk dan mengaitkannya dengan permintaan HTTP yang sedang berlangsung. Fungsi ini murah.

type BlobKey

type BlobKey string

BlobKey adalah kunci untuk blob blobstore.

Secara konseptual, jenis ini termasuk dalam paket blobstore, tetapi berada dalam paket appengine untuk menghindari dependensi melingkar: blobstore bergantung pada datastore dan datastore harus merujuk ke jenis BlobKey.

type Certificate

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

Certificate mewakili sertifikat publik untuk aplikasi.

type GeoPoint

type GeoPoint struct {
    Lat, Lng float64
}

GeoPoint mewakili lokasi sebagai garis lintang/bujur dalam derajat.

func (GeoPoint) Valid

func (g GeoPoint) Valid() bool

Valid menampilkan apakah GeoPoint berada dalam lintang [-90, 90] dan garis bujur [-180, 180].

type MultiError

type MultiError []error

MultiError ditampilkan oleh operasi batch jika terjadi error pada elemen tertentu. Error akan terjadi dalam korespondensi one-to-one dengan elemen input; elemen yang berhasil akan memiliki entri nil.

func (MultiError) Error

func (m MultiError) Error() string