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 (
|
2020-09-30 16:14:54 +03:00
|
|
|
"net/textproto"
|
2021-01-21 18:35:31 +03:00
|
|
|
"sort"
|
2016-01-28 17:55:28 +00:00
|
|
|
)
|
|
|
|
|
2021-01-29 13:17:32 +03:00
|
|
|
var (
|
|
|
|
// HeaderPrefix for all headers passed
|
|
|
|
HeaderPrefix = "Micro-"
|
|
|
|
)
|
|
|
|
|
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
|
|
|
|
|
2021-02-09 12:46:14 +03:00
|
|
|
type rawMetadata struct {
|
|
|
|
md Metadata
|
|
|
|
}
|
|
|
|
|
2020-10-12 17:17:59 +03:00
|
|
|
var (
|
2021-02-09 01:08:45 +03:00
|
|
|
// defaultMetadataSize used when need to init new Metadata
|
|
|
|
defaultMetadataSize = 2
|
2020-10-12 17:17:59 +03:00
|
|
|
)
|
|
|
|
|
2021-02-14 11:28:50 +03:00
|
|
|
// Iterator used to iterate over metadata with order
|
2021-01-21 18:35:31 +03:00
|
|
|
type Iterator struct {
|
|
|
|
cur int
|
|
|
|
cnt int
|
|
|
|
keys []string
|
|
|
|
md Metadata
|
|
|
|
}
|
|
|
|
|
2021-02-14 11:28:50 +03:00
|
|
|
// Next advance iterator to next element
|
2021-01-21 18:35:31 +03:00
|
|
|
func (iter *Iterator) Next(k, v *string) bool {
|
|
|
|
if iter.cur+1 > iter.cnt {
|
|
|
|
return false
|
|
|
|
}
|
|
|
|
|
|
|
|
*k = iter.keys[iter.cur]
|
|
|
|
*v = iter.md[*k]
|
|
|
|
iter.cur++
|
|
|
|
return true
|
|
|
|
}
|
|
|
|
|
2021-02-14 11:28:50 +03:00
|
|
|
// Iterator returns the itarator for metadata in sorted order
|
2021-01-21 18:35:31 +03:00
|
|
|
func (md Metadata) Iterator() *Iterator {
|
|
|
|
iter := &Iterator{md: md, cnt: len(md)}
|
|
|
|
iter.keys = make([]string, 0, iter.cnt)
|
|
|
|
for k := range md {
|
|
|
|
iter.keys = append(iter.keys, k)
|
|
|
|
}
|
|
|
|
sort.Strings(iter.keys)
|
|
|
|
return iter
|
|
|
|
}
|
|
|
|
|
2020-11-03 01:08:23 +03:00
|
|
|
// Get returns value from metadata by key
|
2020-03-26 18:50:00 +00:00
|
|
|
func (md Metadata) Get(key string) (string, bool) {
|
2020-09-30 16:14:54 +03:00
|
|
|
// fast path
|
2020-03-26 18:50:00 +00:00
|
|
|
val, ok := md[key]
|
2020-09-30 16:14:54 +03:00
|
|
|
if !ok {
|
|
|
|
// slow path
|
|
|
|
val, ok = md[textproto.CanonicalMIMEHeaderKey(key)]
|
2020-03-26 18:50:00 +00:00
|
|
|
}
|
|
|
|
return val, ok
|
|
|
|
}
|
|
|
|
|
2020-11-03 01:08:23 +03:00
|
|
|
// Set is used to store value in metadata
|
2020-04-12 11:17:23 +01:00
|
|
|
func (md Metadata) Set(key, val string) {
|
2020-09-30 16:14:54 +03:00
|
|
|
md[textproto.CanonicalMIMEHeaderKey(key)] = val
|
2020-04-12 11:17:23 +01:00
|
|
|
}
|
|
|
|
|
2020-11-03 01:08:23 +03:00
|
|
|
// Del is used to remove value from metadata
|
2020-09-30 16:14:54 +03:00
|
|
|
func (md Metadata) Del(key string) {
|
2020-09-30 16:21:47 +03:00
|
|
|
// fast path
|
2021-02-09 01:08:45 +03:00
|
|
|
delete(md, key)
|
|
|
|
// slow path
|
|
|
|
delete(md, textproto.CanonicalMIMEHeaderKey(key))
|
2020-03-31 22:55:33 +03:00
|
|
|
}
|
|
|
|
|
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 {
|
2020-10-12 17:20:52 +03:00
|
|
|
nmd := New(len(md))
|
2020-10-01 16:00:01 +03:00
|
|
|
for key, val := range md {
|
|
|
|
nmd.Set(key, val)
|
2019-01-17 09:40:49 +00:00
|
|
|
}
|
2020-09-30 16:14:54 +03:00
|
|
|
return nmd
|
2019-01-17 09:40:49 +00:00
|
|
|
}
|
|
|
|
|
2020-10-12 17:17:59 +03:00
|
|
|
// New return new sized metadata
|
|
|
|
func New(size int) Metadata {
|
|
|
|
if size == 0 {
|
2021-02-09 01:08:45 +03:00
|
|
|
size = defaultMetadataSize
|
2020-10-12 17:17:59 +03:00
|
|
|
}
|
|
|
|
return make(Metadata, size)
|
|
|
|
}
|
2021-01-23 00:09:07 +03:00
|
|
|
|
|
|
|
// Merge merges metadata to existing metadata, overwriting if specified
|
|
|
|
func Merge(omd Metadata, mmd Metadata, overwrite bool) Metadata {
|
|
|
|
nmd := Copy(omd)
|
|
|
|
for key, val := range mmd {
|
|
|
|
if _, ok := nmd[key]; ok && !overwrite {
|
|
|
|
// skip
|
|
|
|
} else if val != "" {
|
|
|
|
nmd.Set(key, val)
|
|
|
|
} else {
|
|
|
|
nmd.Del(key)
|
|
|
|
}
|
|
|
|
}
|
|
|
|
return nmd
|
|
|
|
}
|
2021-02-22 00:08:05 +03:00
|
|
|
|
|
|
|
func Pairs(kv ...string) (Metadata, bool) {
|
|
|
|
if len(kv)%2 == 1 {
|
|
|
|
return nil, false
|
|
|
|
}
|
|
|
|
md := New(len(kv) / 2)
|
|
|
|
var k string
|
|
|
|
for i, v := range kv {
|
|
|
|
if i%2 == 0 {
|
|
|
|
k = v
|
|
|
|
continue
|
|
|
|
}
|
|
|
|
md.Set(k, v)
|
|
|
|
}
|
|
|
|
return md, true
|
|
|
|
}
|