O pacote appengine

import "google.golang.org/appengine"

Introdução

No pacote appengine, estão disponíveis funcionalidades básicas para o Google App Engine.

Para mais informações sobre como escrever aplicativos Go para o Google App Engine, acesse: https://cloud.google.com/appengine/docs/standard/go/

Índice

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)

Um token de acesso OAuth2 é gerado pela função AccessToken para os escopos especificados em nome da conta de serviço deste aplicativo. Este token expirará após o tempo retornado.

func AppID

func AppID(c context.Context) string

Função usada para retornar a ID do aplicativo atual. A string será uma ID de aplicativo simples (por exemplo, "appid"), com um prefixo de domínio para implantações de domínio personalizado (por exemplo, "example.com:appid").

func Datacenter

func Datacenter(c context.Context) string

Função usada para retornar um identificador para o data center em que a instância está sendo executada.

func DefaultVersionHostname

func DefaultVersionHostname(c context.Context) string

Função usada para retornar o nome do host padrão da versão padrão do aplicativo atual (por exemplo, "my-app.appspot.com"). Adequada para uso na construção de URLs.

func InstanceID

func InstanceID() string

Função usada para retornar um identificador essencialmente exclusivo para esta instância.

func IsDevAppServer

func IsDevAppServer() bool

Função usada para informar se o aplicativo do App Engine está sendo executado no servidor de aplicativos de desenvolvimento.

func IsOverQuota

func IsOverQuota(err error) bool

Função usada para relatar se err representa uma falha de chamada de API devido à insuficiência da cota disponível.

func IsTimeoutError

func IsTimeoutError(err error) bool

Função usada para relatar se err é um erro de tempo limite.

func ModuleHostname

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

Função usada para retornar um nome de host de uma instância de módulo. Se o módulo for uma string vazia, ele se refere ao módulo da instância atual. Se a versão estiver vazia, ela se refere à versão da instância atual se esta for válida, ou à versão padrão do módulo da instância atual. Se a instância estiver vazia, o nome do host de balanceamento de carga é retornado pelo ModuleHostname.

func ModuleName

func ModuleName(c context.Context) string

Função usada para retornar o nome do módulo da instância atual.

func Namespace

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

Função usada para retornar um contexto de substituição que opera dentro do namespace fornecido.

func NewContext

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

Função usada para retornar um contexto para uma solicitação HTTP em trânsito. Esta é uma função simples.

func PublicCertificates

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

PublicCertificates recupera os certificados públicos do aplicativo. Eles podem ser usados para verificar uma assinatura retornada por SignBytes.

func RequestID

func RequestID(c context.Context) string

Função usada para retornar uma string que identifica a solicitação de forma exclusiva.

func ServerSoftware

func ServerSoftware() string

Função usada para retornar a versão do App Engine. Na produção, o formato da versão é "Google App Engine/X.Y.Z". No servidor de desenvolvimento, o formato é: "Desenvolvimento/X.Y".

func ServiceAccount

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

Função usada para retornar uma string que representa o nome da conta de serviço na forma de um endereço de e-mail (geralmente app_id@appspot.gserviceaccount.com).

func SignBytes

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

Função usada para assinar bytes usando uma chave particular exclusiva para o aplicativo.

func VersionID

func VersionID(c context.Context) string

Função usada para retornar o código da versão do aplicativo atual. Esse código estará no formato "X.Y", em que X é especificado em app.yaml, e Y é um número gerado quando cada versão do aplicativo é carregada. Não inclui um nome de módulo.

func WithContext

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

Função usada para retornar uma cópia do contexto pai e associá-lo a uma solicitação HTTP em trânsito. Esta é uma função simples.

type BlobKey

type BlobKey string

BlobKey é uma chave de um blob do blobstore.

Conceitualmente, esse tipo pertence ao pacote blobstore, mas fica no pacote appengine para evitar uma dependência circular: o blobstore depende do armazenamento de dados, e o tipo BlobKey é consultado pelo armazenamento de dados.

type Certificate

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

Representa um certificado público do aplicativo.

type GeoPoint

type GeoPoint struct {
    Lat, Lng float64
}

Representa um local no formato latitude/longitude em graus.

func (GeoPoint) Valid

func (g GeoPoint) Valid() bool

A função Valid é usada para informar se um GeoPoint está dentro da latitude [-90, 90] e longitude [-180, 180].

type MultiError

type MultiError []error

O tipo MultiError é retornado por operações em lote quando há erros em elementos específicos. Os erros estarão em correspondência um para um com os elementos de entrada, e os elementos bem-sucedidos terão uma entrada nula.

func (MultiError) Error

func (m MultiError) Error() string