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 ValidateKey(key string) 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 ValidateKey

func ValidateKey(key string) error

ValidateKey validates a key with the following rules (pseudo-headers are skipped): - the key must contain one or more characters. - the characters in the key must be in [0-9 a-z _ - .].

func ValidatePair

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

ValidatePair validates a key-value pair with the following rules (pseudo-header are skipped):

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