remote_api

Documentation

Overview

Package remote_api implements the /_ah/remote_api endpoint. This endpoint is used by offline tools such as the bulk loader.

Index

• func NewRemoteContext(host string, client *http.Client) (context.Context, error)
• type Client
  • func NewClient(host string, client *http.Client) (*Client, error)
  • func (c *Client) NewContext(parent context.Context) context.Context

Examples

• Client

Functions

func NewRemoteContext

func NewRemoteContext(host string, client *http.Client) (context.Context, error)

NewRemoteContext returns a context that gives access to the production APIs for the application at the given host. All communication will be performed over SSL unless the host is localhost.

Types

type Client

type Client struct {
	// contains filtered or unexported fields
}

Client is a connection to the production APIs for an application.

Example

c, err := NewClient("example.appspot.com", http.DefaultClient)
if err != nil {
	log.Fatal(err)
}

ctx := context.Background() // or from a request
ctx = c.NewContext(ctx)
_, err = datastore.Put(ctx, datastore.NewIncompleteKey(ctx, "Foo", nil), struct{ Bar int }{42})
if err != nil {
	log.Fatal(err)
}

func NewClient

func NewClient(host string, client *http.Client) (*Client, error)

NewClient returns a client for the given host. All communication will be performed over SSL unless the host is localhost.

func (*Client) NewContext

func (c *Client) NewContext(parent context.Context) context.Context

NewContext returns a copy of parent that will cause App Engine API calls to be sent to the client's remote host.