blob: 2187e877fa4a32adaa63a387fed5d4d5ba3d00cb [file] [log] [blame]
khenaidood948f772021-08-11 17:49:24 -04001// 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.
khenaidooac637102019-01-14 15:44:34 -05004
5package proto
6
7import (
khenaidood948f772021-08-11 17:49:24 -04008 "google.golang.org/protobuf/reflect/protoreflect"
khenaidooac637102019-01-14 15:44:34 -05009)
10
khenaidooac637102019-01-14 15:44:34 -050011// 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.
khenaidooac637102019-01-14 15:44:34 -050019func DiscardUnknown(m Message) {
khenaidood948f772021-08-11 17:49:24 -040020 if m != nil {
21 discardUnknown(MessageReflect(m))
khenaidooac637102019-01-14 15:44:34 -050022 }
23}
24
khenaidood948f772021-08-11 17:49:24 -040025func 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())
khenaidooac637102019-01-14 15:44:34 -050039 }
40 }
khenaidood948f772021-08-11 17:49:24 -040041 // 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 })
khenaidooac637102019-01-14 15:44:34 -050049 }
50 }
khenaidood948f772021-08-11 17:49:24 -040051 return true
52 })
khenaidooac637102019-01-14 15:44:34 -050053
khenaidood948f772021-08-11 17:49:24 -040054 // Discard unknown fields.
55 if len(m.GetUnknown()) > 0 {
56 m.SetUnknown(nil)
khenaidooac637102019-01-14 15:44:34 -050057 }
58}