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, veja: https://cloud.google.com/appengine/docs/go/
Variáveis.
Middleware
O middleware une um gerenciador HTTP para que ele possa fazer chamadas da API GAE
Funções
função APICall
A função APICall executa uma chamada de API.
Ela não se destina ao uso geral e é exportada para uso com a função WithAPICallFunc.
func AccessToken
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
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").
função BackgroundContext (descontinuado)
BackgroundContext retorna um contexto não associado a uma solicitação.
Obsoleto: o App Engine não tem mais um contexto especial em segundo plano. Basta usar context.Background().
func Datacenter
Função usada para retornar um identificador para o data center em que a instância está sendo executada.
func DefaultVersionHostname
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() stringFunção usada para retornar um identificador essencialmente exclusivo para esta instância.
função IsAppEngine
func IsAppEngine() boolO IsAppEngine informa se o aplicativo do App Engine está em execução no App Engine, no ambiente padrão ou flexível.
func IsDevAppServer
func IsDevAppServer() boolFunção usada para informar se o aplicativo do App Engine está sendo executado no servidor de aplicativos de desenvolvimento.
função IsFlex
func IsFlex() boolA função IsFlex informa se o App Engine está em execução no ambiente flexível.
func IsOverQuota
Função usada para relatar se err representa uma falha de chamada de API devido à insuficiência da cota disponível.
função IsSegundoGen
func IsSecondGen() boolA função IsSegundoGen informa se o App Engine está em execução nos ambientes de execução de segunda geração (>= Go 1.11).
função IsStandard
func IsStandard() boolA função IsStandard informa se o App Engine está em execução no ambiente padrão. Isso inclui os ambientes de execução de primeira geração (<= Go 1.9) e os de segunda geração (>= Go 1.11).
func IsTimeoutError
Função usada para relatar se err é um erro de tempo limite.
função Main
func Main()A função Main é o ponto de entrada principal de um aplicativo em execução no App Engine.
No App Engine Flexible, ele instala um verificador de integridade trivial se ainda não está registrado e começa a detectar na porta 8080 (substituído pela variável de ambiente $PORT).
Consulte https://cloud.google.com/appengine/docs/flexible/custom-runtimes#health_check_requests para ver detalhes sobre como fazer sua própria verificação de integridade.
No App Engine Standard, ele garante que o servidor tenha sido iniciado e esteja preparado para receber solicitações.
A função Main nunca retorna.
A função Main foi projetada de modo que o pacote principal do app tenha esta aparência:
package main
import (
"google.golang.org/appengine"
_ "myapp/package0"
_ "myapp/package1"
)
func main() {
appengine.Main()
}
Os pacotes "myapp/packageX" precisam registrar gerenciadores HTTP nas funções init.
func ModuleHostname
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
Função usada para retornar o nome do módulo da instância atual.
func Namespace
Função usada para retornar um contexto de substituição que opera dentro do namespace fornecido.
func NewContext
Função usada para retornar um contexto para uma solicitação HTTP em trânsito. Esta é uma função simples.
func RequestID
Função usada para retornar uma string que identifica a solicitação de forma exclusiva.
func ServerSoftware
func ServerSoftware() stringFunçã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
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
Função usada para assinar bytes usando uma chave particular exclusiva para o aplicativo.
func VersionID
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.
função WithAPICallFunc
func WithAPICallFunc(ctx context.Context, f APICallFunc) context.ContextA função WithAPICallFunc retorna uma cópia do contexto pai que fará com que as chamadas de API invoquem f em vez da operação normal.
Ela é destinada apenas a usuários avançados.
func WithContext
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.
APICallFunc
APICallFunc define um tipo de função para processar uma chamada de API. Consulte WithCallOverride
BlobKey
type BlobKey stringBlobKey é 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.
Certificado
Representa um certificado público do aplicativo.
func PublicCertificates
func PublicCertificates(c context.Context) ([]Certificate, error)PublicCertificates recupera os certificados públicos do app. Eles podem ser usados para verificar uma assinatura retornada por SignBytes.
GeoPoint
type GeoPoint struct {
Lat, Lng float64
}Representa um local no formato latitude/longitude em graus.
func (GeoPoint) Valid
A função Valid é usada para informar se um GeoPoint está dentro da latitude [-90, 90] e longitude [-180, 180].
MultiError
type MultiError []errorO 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