metadata

Documentation

Overview

Package metadata contains functions to set and get metadata from addresses.

This package is experimental.

Index

• func Get(addr resolver.Address) metadata.MD
• func Set(addr resolver.Address, md metadata.MD) resolver.Address
• func Validate(md metadata.MD) error
• func ValidatePair(key string, vals ...string) error

Functions

func Get

func Get(addr resolver.Address) metadata.MD

Get returns the metadata of addr.

func Set

func Set(addr resolver.Address, md metadata.MD) resolver.Address

Set sets (overrides) the metadata in addr.

When a SubConn is created with this address, the RPCs sent on it will all have this metadata.

func Validate

func Validate(md metadata.MD) error

Validate validates every pair in md with ValidatePair.

func ValidatePair

func ValidatePair(key string, vals ...string) error

ValidatePair validate a key-value pair with the following rules (the pseudo-header will be skipped) :

- key must contain one or more characters. - the characters in the key must be contained in [0-9 a-z _ - .]. - if the key ends with a "-bin" suffix, no validation of the corresponding value is performed. - the characters in the every value must be printable (in [%x20-%x7E]).