...
▽

Package callctx

import "github.com/googleapis/gax-go/v2/callctx"
Overview
Index
Examples

Overview ▾

Package callctx provides helpers for storing and retrieving values out of context.Context. These values are used by our client libraries in various ways across the stack.

Constants

const (
    // XGoogFieldMaskHeader is the canonical header key for the [System Parameter]
    // that specifies the response read mask. The value(s) for this header
    // must adhere to format described in [fieldmaskpb].
    //
    // [System Parameter]: https://cloud.google.com/apis/docs/system-parameters
    // [fieldmaskpb]: https://google.golang.org/protobuf/types/known/fieldmaskpb
    XGoogFieldMaskHeader = "x-goog-fieldmask"
)

func HeadersFromContext 

func HeadersFromContext(ctx context.Context) map[string][]string

HeadersFromContext retrieves headers set from SetHeaders. These headers can then be cast to http.Header or metadata.MD to send along on requests.

func SetHeaders 

func SetHeaders(ctx context.Context, keyvals ...string) context.Context

SetHeaders stores key value pairs in the returned context that can later be retrieved by HeadersFromContext. Values stored in this manner will automatically be retrieved by client libraries and sent as outgoing headers on all requests. keyvals should have a corresponding value for every key provided. If there is an odd number of keyvals this method will panic.

▾ Example

Code:

ctx := context.Background()
ctx = callctx.SetHeaders(ctx, "key", "value")

// Send the returned context to the request you are making. Later on these
// values will be retrieved and set on outgoing requests.

headers := callctx.HeadersFromContext(ctx)
fmt.Println(headers["key"][0])

Output:

value