micro/metadata/metadata.go

105 lines
2.2 KiB
Go
Raw Normal View History

2016-12-14 15:41:48 +00:00
// Package metadata is a way of defining message headers
2016-01-28 17:55:28 +00:00
package metadata
import (
2018-03-03 11:53:52 +00:00
"context"
2019-12-31 13:37:29 +00:00
"strings"
2016-01-28 17:55:28 +00:00
)
type MetadataKey struct{}
2016-01-28 17:55:28 +00:00
2016-01-30 21:17:44 +00:00
// Metadata is our way of representing request headers internally.
// They're used at the RPC level and translate back and forth
// from Transport headers.
2016-01-28 17:55:28 +00:00
type Metadata map[string]string
2020-03-26 18:50:00 +00:00
func (md Metadata) Get(key string) (string, bool) {
// attempt to get as is
val, ok := md[key]
if ok {
return val, ok
}
// attempt to get lower case
val, ok = md[strings.Title(key)]
return val, ok
}
2019-10-25 23:27:59 +01:00
// Copy makes a copy of the metadata
2019-01-17 09:40:49 +00:00
func Copy(md Metadata) Metadata {
cmd := make(Metadata)
for k, v := range md {
cmd[k] = v
}
return cmd
}
// Set add key with val to metadata
func Set(ctx context.Context, k, v string) context.Context {
md, ok := FromContext(ctx)
if !ok {
md = make(Metadata)
}
md[k] = v
return context.WithValue(ctx, MetadataKey{}, md)
}
// Get returns a single value from metadata in the context
func Get(ctx context.Context, key string) (string, bool) {
md, ok := FromContext(ctx)
if !ok {
return "", ok
}
2019-12-31 13:37:29 +00:00
// attempt to get as is
val, ok := md[key]
2019-12-31 13:37:29 +00:00
if ok {
return val, ok
}
// attempt to get lower case
val, ok = md[strings.Title(key)]
return val, ok
}
2019-10-25 23:27:59 +01:00
// FromContext returns metadata from the given context
2016-01-28 17:55:28 +00:00
func FromContext(ctx context.Context) (Metadata, bool) {
md, ok := ctx.Value(MetadataKey{}).(Metadata)
2019-12-31 13:37:29 +00:00
if !ok {
return nil, ok
}
// capitalise all values
newMD := make(map[string]string, len(md))
2019-12-31 13:37:29 +00:00
for k, v := range md {
newMD[strings.Title(k)] = v
}
return newMD, ok
2016-01-28 17:55:28 +00:00
}
2019-10-25 23:27:59 +01:00
// NewContext creates a new context with the given metadata
2016-01-28 17:55:28 +00:00
func NewContext(ctx context.Context, md Metadata) context.Context {
return context.WithValue(ctx, MetadataKey{}, md)
2016-01-28 17:55:28 +00:00
}
2019-10-25 23:27:59 +01:00
// MergeContext merges metadata to existing metadata, overwriting if specified
func MergeContext(ctx context.Context, patchMd Metadata, overwrite bool) context.Context {
if ctx == nil {
ctx = context.Background()
}
md, _ := ctx.Value(MetadataKey{}).(Metadata)
cmd := make(Metadata)
for k, v := range md {
cmd[k] = v
}
for k, v := range patchMd {
2019-10-25 08:27:28 -07:00
if _, ok := cmd[k]; ok && !overwrite {
// skip
} else {
cmd[k] = v
}
}
return context.WithValue(ctx, MetadataKey{}, cmd)
}