blob: 2187e877fa4a32adaa63a387fed5d4d5ba3d00cb [file] [log] [blame]
mpagenkoaf801632020-07-03 10:00:42 +00001// Copyright 2019 The Go Authors. All rights reserved.
2// Use of this source code is governed by a BSD-style
3// license that can be found in the LICENSE file.
Holger Hildebrandtfa074992020-03-27 15:42:06 +00004
5package proto
6
7import (
mpagenkoaf801632020-07-03 10:00:42 +00008 "google.golang.org/protobuf/reflect/protoreflect"
Holger Hildebrandtfa074992020-03-27 15:42:06 +00009)
10
Holger Hildebrandtfa074992020-03-27 15:42:06 +000011// DiscardUnknown recursively discards all unknown fields from this message
12// and all embedded messages.
13//
14// When unmarshaling a message with unrecognized fields, the tags and values
15// of such fields are preserved in the Message. This allows a later call to
16// marshal to be able to produce a message that continues to have those
17// unrecognized fields. To avoid this, DiscardUnknown is used to
18// explicitly clear the unknown fields after unmarshaling.
Holger Hildebrandtfa074992020-03-27 15:42:06 +000019func DiscardUnknown(m Message) {
mpagenkoaf801632020-07-03 10:00:42 +000020 if m != nil {
21 discardUnknown(MessageReflect(m))
Holger Hildebrandtfa074992020-03-27 15:42:06 +000022 }
23}
24
mpagenkoaf801632020-07-03 10:00:42 +000025func discardUnknown(m protoreflect.Message) {
26 m.Range(func(fd protoreflect.FieldDescriptor, val protoreflect.Value) bool {
27 switch {
28 // Handle singular message.
29 case fd.Cardinality() != protoreflect.Repeated:
30 if fd.Message() != nil {
31 discardUnknown(m.Get(fd).Message())
32 }
33 // Handle list of messages.
34 case fd.IsList():
35 if fd.Message() != nil {
36 ls := m.Get(fd).List()
37 for i := 0; i < ls.Len(); i++ {
38 discardUnknown(ls.Get(i).Message())
Holger Hildebrandtfa074992020-03-27 15:42:06 +000039 }
40 }
mpagenkoaf801632020-07-03 10:00:42 +000041 // Handle map of messages.
42 case fd.IsMap():
43 if fd.MapValue().Message() != nil {
44 ms := m.Get(fd).Map()
45 ms.Range(func(_ protoreflect.MapKey, v protoreflect.Value) bool {
46 discardUnknown(v.Message())
47 return true
48 })
Holger Hildebrandtfa074992020-03-27 15:42:06 +000049 }
50 }
mpagenkoaf801632020-07-03 10:00:42 +000051 return true
52 })
Holger Hildebrandtfa074992020-03-27 15:42:06 +000053
mpagenkoaf801632020-07-03 10:00:42 +000054 // Discard unknown fields.
55 if len(m.GetUnknown()) > 0 {
56 m.SetUnknown(nil)
Holger Hildebrandtfa074992020-03-27 15:42:06 +000057 }
58}