internal

Documentation

Overview

Package internal provides support for package appengine.

Programs should not use this package directly. Its API is not stable. Use packages appengine and appengine/* instead.

Index

• Variables
• func AppID(fqai string) string
• func ApplyTransaction(pb proto.Message, t *pb.Transaction)
• func BackgroundContext() *context
• func ContextForTesting(req *http.Request) *context
• func Datacenter(req interface{}) string
• func DefaultVersionHostname(req interface{}) string
• func InstanceID() string
• func Main()
• func ModuleName() string
• func NewContext(req *http.Request) *context
• func RegisterErrorCodeMap(service string, m map[int32]string)
• func RegisterTimeoutErrorCode(service string, code int32)
• func RegisterTransactionSetter(f interface{})
• func RequestID(req interface{}) string
• func ServerSoftware() string
• func VersionID() string
• func VirtAPI(c caller, method string) string
• type APIError
  • func (e *APIError) Error() string
  • func (e *APIError) IsTimeout() bool
• type CallError
  • func (e *CallError) Error() string
  • func (e *CallError) IsTimeout() bool
• type CallOptions

Variables

var NamespaceMods = make(map[string]func(m proto.Message, namespace string))

NamespaceMods is a map from API service to a function that will mutate an RPC request to attach a namespace. The function should be prepared to be called on the same message more than once; it should only modify the RPC request the first time.

Functions

func AppID

func AppID(fqai string) string

func ApplyTransaction

func ApplyTransaction(pb proto.Message, t *pb.Transaction)

ApplyTransaction applies the transaction t to message pb by using the relevant setter passed to RegisterTransactionSetter.

func BackgroundContext

func BackgroundContext() *context

func ContextForTesting

func ContextForTesting(req *http.Request) *context

func Datacenter

func Datacenter(req interface{}) string

func DefaultVersionHostname

func DefaultVersionHostname(req interface{}) string

func InstanceID

func InstanceID() string

func Main

func Main()

Main is designed so that the complete generated main package is:

package main

import (
        "google.golang.org/appengine/internal"

        _ "myapp/package0"
        _ "myapp/package1"
)

func main() {
        internal.Main()
}

The "myapp/packageX" packages are expected to register HTTP handlers in their init functions.

func ModuleName

func ModuleName() string

func NewContext

func NewContext(req *http.Request) *context

func RegisterErrorCodeMap

func RegisterErrorCodeMap(service string, m map[int32]string)

RegisterErrorCodeMap is called from API implementations to register their error code map. This should only be called from init functions.

func RegisterTimeoutErrorCode

func RegisterTimeoutErrorCode(service string, code int32)

func RegisterTransactionSetter

func RegisterTransactionSetter(f interface{})

RegisterTransactionSetter registers a function that sets transaction information in a protocol buffer message. f should be a function with two arguments, the first being a protocol buffer type, and the second being *datastore.Transaction.

func RequestID

func RequestID(req interface{}) string

func ServerSoftware

func ServerSoftware() string

func VersionID

func VersionID() string

func VirtAPI

func VirtAPI(c caller, method string) string

VirtAPI invokes a virtual API call for the __go__ service. It is for methods that accept a VoidProto and return a StringProto. It returns an empty string if the call fails.

Types

type APIError

type APIError struct {
	Service string
	Detail  string
	Code    int32 // API-specific error code
}

APIError is the type returned by appengine.Context's Call method when an API call fails in an API-specific way. This may be, for instance, a taskqueue API call failing with TaskQueueServiceError::UNKNOWN_QUEUE.

func (*APIError) Error

func (e *APIError) Error() string

func (*APIError) IsTimeout

func (e *APIError) IsTimeout() bool

type CallError

type CallError struct {
	Detail string
	Code   int32
	// TODO: Remove this if we get a distinguishable error code.
	Timeout bool
}

CallError is the type returned by appengine.Context's Call method when an API call fails in a generic way, such as RpcError::CAPABILITY_DISABLED.

func (*CallError) Error

func (e *CallError) Error() string

func (*CallError) IsTimeout

func (e *CallError) IsTimeout() bool

type CallOptions

type CallOptions struct {
	Timeout time.Duration // if non-zero, overrides RPC default
}