blob: 2187e877fa4a32adaa63a387fed5d4d5ba3d00cb [file] [log] [blame]
David K. Bainbridgee05cf0c2021-08-19 03:16:50 +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.
Don Newton98fd8812019-09-23 15:15:02 -04004
5package proto
6
7import (
David K. Bainbridgee05cf0c2021-08-19 03:16:50 +00008 "google.golang.org/protobuf/reflect/protoreflect"
Don Newton98fd8812019-09-23 15:15:02 -04009)
10
Don Newton98fd8812019-09-23 15:15:02 -040011// 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.
Don Newton98fd8812019-09-23 15:15:02 -040019func DiscardUnknown(m Message) {
David K. Bainbridgee05cf0c2021-08-19 03:16:50 +000020 if m != nil {
21 discardUnknown(MessageReflect(m))
Don Newton98fd8812019-09-23 15:15:02 -040022 }
23}
24
David K. Bainbridgee05cf0c2021-08-19 03:16:50 +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())
Don Newton98fd8812019-09-23 15:15:02 -040039 }
40 }
David K. Bainbridgee05cf0c2021-08-19 03:16:50 +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 })
Don Newton98fd8812019-09-23 15:15:02 -040049 }
50 }
David K. Bainbridgee05cf0c2021-08-19 03:16:50 +000051 return true
52 })
Don Newton98fd8812019-09-23 15:15:02 -040053
David K. Bainbridgee05cf0c2021-08-19 03:16:50 +000054 // Discard unknown fields.
55 if len(m.GetUnknown()) > 0 {
56 m.SetUnknown(nil)
Don Newton98fd8812019-09-23 15:15:02 -040057 }
58}