1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338
|
// Copyright (c) 2021 PlanetScale Inc. All rights reserved.
// Copyright (c) 2013, The GoGo Authors. All rights reserved.
// Use of this source code is governed by a BSD-style
// license that can be found in the LICENSE file.
package clone
import (
"google.golang.org/protobuf/compiler/protogen"
"google.golang.org/protobuf/reflect/protoreflect"
"github.com/planetscale/vtprotobuf/generator"
)
const (
cloneName = "CloneVT"
cloneMessageName = "CloneMessageVT"
)
var (
protoPkg = protogen.GoImportPath("google.golang.org/protobuf/proto")
)
func init() {
generator.RegisterFeature("clone", func(gen *generator.GeneratedFile) generator.FeatureGenerator {
return &clone{GeneratedFile: gen}
})
}
type clone struct {
*generator.GeneratedFile
once bool
}
var _ generator.FeatureGenerator = (*clone)(nil)
func (p *clone) Name() string {
return "clone"
}
func (p *clone) GenerateFile(file *protogen.File) bool {
proto3 := file.Desc.Syntax() == protoreflect.Proto3
for _, message := range file.Messages {
p.processMessage(proto3, message)
}
return p.once
}
// cloneOneofField generates the statements for cloning a oneof field
func (p *clone) cloneOneofField(lhsBase, rhsBase string, oneof *protogen.Oneof) {
fieldname := oneof.GoName
ccInterfaceName := "is" + oneof.GoIdent.GoName
lhs := lhsBase + "." + fieldname
rhs := rhsBase + "." + fieldname
p.P(`if `, rhs, ` != nil {`)
if p.IsWellKnownType(oneof.Parent) {
p.P(`switch c := `, rhs, `.(type) {`)
for _, f := range oneof.Fields {
p.P(`case *`, f.GoIdent, `:`)
p.P(lhs, `= (*`, f.GoIdent, `)((*`, p.WellKnownFieldMap(f), `)(c).`, cloneName, `())`)
}
p.P(`}`)
} else {
p.P(lhs, ` = `, rhs, `.(interface{ `, cloneName, `() `, ccInterfaceName, ` }).`, cloneName, `()`)
}
p.P(`}`)
}
// cloneFieldSingular generates the code for cloning a singular, non-oneof field.
func (p *clone) cloneFieldSingular(lhs, rhs string, kind protoreflect.Kind, message *protogen.Message) {
switch {
case kind == protoreflect.MessageKind, kind == protoreflect.GroupKind:
switch {
case p.IsWellKnownType(message):
p.P(lhs, ` = (*`, message.GoIdent, `)((*`, p.WellKnownTypeMap(message), `)(`, rhs, `).`, cloneName, `())`)
case p.IsLocalMessage(message):
p.P(lhs, ` = `, rhs, `.`, cloneName, `()`)
default:
// rhs is a concrete type, we need to first convert it to an interface in order to use an interface
// type assertion.
p.P(`if vtpb, ok := interface{}(`, rhs, `).(interface{ `, cloneName, `() *`, message.GoIdent, ` }); ok {`)
p.P(lhs, ` = vtpb.`, cloneName, `()`)
p.P(`} else {`)
p.P(lhs, ` = `, protoPkg.Ident("Clone"), `(`, rhs, `).(*`, message.GoIdent, `)`)
p.P(`}`)
}
case kind == protoreflect.BytesKind:
p.P(`tmpBytes := make([]byte, len(`, rhs, `))`)
p.P(`copy(tmpBytes, `, rhs, `)`)
p.P(lhs, ` = tmpBytes`)
case isScalar(kind):
p.P(lhs, ` = `, rhs)
default:
panic("unexpected")
}
}
// cloneField generates the code for cloning a field in a protobuf.
func (p *clone) cloneField(lhsBase, rhsBase string, allFieldsNullable bool, field *protogen.Field) {
// At this point, if we encounter a non-synthetic oneof, we assume it to be the representative
// field for that oneof.
if field.Oneof != nil && !field.Oneof.Desc.IsSynthetic() {
p.cloneOneofField(lhsBase, rhsBase, field.Oneof)
return
}
if !isReference(allFieldsNullable, field) {
panic("method should not be invoked for non-reference fields")
}
fieldname := field.GoName
lhs := lhsBase + "." + fieldname
rhs := rhsBase + "." + fieldname
// At this point, we are only looking at reference types (pointers, maps, slices, interfaces), which can all
// be nil.
p.P(`if rhs := `, rhs, `; rhs != nil {`)
rhs = "rhs"
fieldKind := field.Desc.Kind()
msg := field.Message // possibly nil
if field.Desc.Cardinality() == protoreflect.Repeated { // maps and slices
goType, _ := p.FieldGoType(field)
p.P(`tmpContainer := make(`, goType, `, len(`, rhs, `))`)
if isScalar(fieldKind) && field.Desc.IsList() {
// Generated code optimization: instead of iterating over all (key/index, value) pairs,
// do a single copy(dst, src) invocation for slices whose elements aren't reference types.
p.P(`copy(tmpContainer, `, rhs, `)`)
} else {
if field.Desc.IsMap() {
// For maps, the type of the value field determines what code is generated for cloning
// an entry.
valueField := field.Message.Fields[1]
fieldKind = valueField.Desc.Kind()
msg = valueField.Message
}
p.P(`for k, v := range `, rhs, ` {`)
p.cloneFieldSingular("tmpContainer[k]", "v", fieldKind, msg)
p.P(`}`)
}
p.P(lhs, ` = tmpContainer`)
} else if isScalar(fieldKind) {
p.P(`tmpVal := *`, rhs)
p.P(lhs, ` = &tmpVal`)
} else {
p.cloneFieldSingular(lhs, rhs, fieldKind, msg)
}
p.P(`}`)
}
func (p *clone) generateCloneMethodsForMessage(proto3 bool, message *protogen.Message) {
ccTypeName := message.GoIdent.GoName
p.P(`func (m *`, ccTypeName, `) `, cloneName, `() *`, ccTypeName, ` {`)
p.body(!proto3, ccTypeName, message, true)
p.P(`}`)
p.P()
if !p.Wrapper() {
p.P(`func (m *`, ccTypeName, `) `, cloneMessageName, `() `, protoPkg.Ident("Message"), ` {`)
p.P(`return m.`, cloneName, `()`)
p.P(`}`)
p.P()
}
}
// body generates the code for the actual cloning logic of a structure containing the given fields.
// In practice, those can be the fields of a message.
// The object to be cloned is assumed to be called "m".
func (p *clone) body(allFieldsNullable bool, ccTypeName string, message *protogen.Message, cloneUnknownFields bool) {
// The method body for a message or a oneof wrapper always starts with a nil check.
p.P(`if m == nil {`)
// We use an explicitly typed nil to avoid returning the nil interface in the oneof wrapper
// case.
p.P(`return (*`, ccTypeName, `)(nil)`)
p.P(`}`)
fields := message.Fields
// Make a first pass over the fields, in which we initialize all non-reference fields via direct
// struct literal initialization, and extract all other (reference) fields for a second pass.
// Do not require qualified name because CloneVT generates in same file with definition.
p.Alloc("r", message, false)
var refFields []*protogen.Field
oneofFields := make(map[string]struct{}, len(fields))
for _, field := range fields {
if field.Oneof != nil && !field.Oneof.Desc.IsSynthetic() {
// Use the first field in a oneof as the representative for that oneof, disregard
// the other fields in that oneof.
if _, ok := oneofFields[field.Oneof.GoName]; !ok {
refFields = append(refFields, field)
oneofFields[field.Oneof.GoName] = struct{}{}
}
continue
}
if !isReference(allFieldsNullable, field) {
p.P(`r.`, field.GoName, ` = m.`, field.GoName)
continue
}
// Shortcut: for types where we know that an optimized clone method exists, we can call it directly as it is
// nil-safe.
if field.Desc.Cardinality() != protoreflect.Repeated {
switch {
case p.IsWellKnownType(field.Message):
p.P(`r.`, field.GoName, ` = (*`, field.Message.GoIdent, `)((*`, p.WellKnownTypeMap(field.Message), `)(m.`, field.GoName, `).`, cloneName, `())`)
continue
case p.IsLocalMessage(field.Message):
p.P(`r.`, field.GoName, ` = m.`, field.GoName, `.`, cloneName, `()`)
continue
}
}
refFields = append(refFields, field)
}
// Generate explicit assignment statements for all reference fields.
for _, field := range refFields {
p.cloneField("r", "m", allFieldsNullable, field)
}
if cloneUnknownFields && !p.Wrapper() {
// Clone unknown fields, if any
p.P(`if len(m.unknownFields) > 0 {`)
p.P(`r.unknownFields = make([]byte, len(m.unknownFields))`)
p.P(`copy(r.unknownFields, m.unknownFields)`)
p.P(`}`)
}
p.P(`return r`)
}
func (p *clone) bodyForOneOf(ccTypeName string, field *protogen.Field) {
// The method body for a message or a oneof wrapper always starts with a nil check.
p.P(`if m == nil {`)
// We use an explicitly typed nil to avoid returning the nil interface in the oneof wrapper
// case.
p.P(`return (*`, ccTypeName, `)(nil)`)
p.P(`}`)
p.P("r", " := new(", ccTypeName, `)`)
if !isReference(false, field) {
p.P(`r.`, field.GoName, ` = m.`, field.GoName)
p.P(`return r`)
return
}
// Shortcut: for types where we know that an optimized clone method exists, we can call it directly as it is
// nil-safe.
if field.Desc.Cardinality() != protoreflect.Repeated && field.Message != nil {
switch {
case p.IsWellKnownType(field.Message):
p.P(`r.`, field.GoName, ` = (*`, field.Message.GoIdent, `)((*`, p.WellKnownTypeMap(field.Message), `)(m.`, field.GoName, `).`, cloneName, `())`)
p.P(`return r`)
return
case p.IsLocalMessage(field.Message):
p.P(`r.`, field.GoName, ` = m.`, field.GoName, `.`, cloneName, `()`)
p.P(`return r`)
return
}
}
// Generate explicit assignment statements for reference field.
p.cloneField("r", "m", false, field)
p.P(`return r`)
}
// generateCloneMethodsForOneof generates the clone method for the oneof wrapper type of a
// field in a oneof.
func (p *clone) generateCloneMethodsForOneof(message *protogen.Message, field *protogen.Field) {
ccTypeName := field.GoIdent.GoName
ccInterfaceName := "is" + field.Oneof.GoIdent.GoName
if p.IsWellKnownType(message) {
p.P(`func (m *`, ccTypeName, `) `, cloneName, `() *`, ccTypeName, ` {`)
} else {
p.P(`func (m *`, ccTypeName, `) `, cloneName, `() `, ccInterfaceName, ` {`)
}
// Create a "fake" field for the single oneof member, pretending it is not a oneof field.
fieldInOneof := *field
fieldInOneof.Oneof = nil
// If we have a scalar field in a oneof, that field is never nullable, even when using proto2
p.bodyForOneOf(ccTypeName, &fieldInOneof)
p.P(`}`)
p.P()
}
func (p *clone) processMessageOneofs(message *protogen.Message) {
for _, field := range message.Fields {
if field.Oneof == nil || field.Oneof.Desc.IsSynthetic() {
continue
}
p.generateCloneMethodsForOneof(message, field)
}
}
func (p *clone) processMessage(proto3 bool, message *protogen.Message) {
for _, nested := range message.Messages {
p.processMessage(proto3, nested)
}
if message.Desc.IsMapEntry() {
return
}
p.once = true
p.generateCloneMethodsForMessage(proto3, message)
p.processMessageOneofs(message)
}
// isReference checks whether the Go equivalent of the given field is of reference type, i.e., can be nil.
func isReference(allFieldsNullable bool, field *protogen.Field) bool {
if allFieldsNullable || field.Oneof != nil || field.Message != nil || field.Desc.Cardinality() == protoreflect.Repeated || field.Desc.Kind() == protoreflect.BytesKind {
return true
}
if !isScalar(field.Desc.Kind()) {
panic("unexpected non-reference, non-scalar field")
}
return false
}
func isScalar(kind protoreflect.Kind) bool {
switch kind {
case
protoreflect.BoolKind,
protoreflect.StringKind,
protoreflect.DoubleKind, protoreflect.Fixed64Kind, protoreflect.Sfixed64Kind,
protoreflect.FloatKind, protoreflect.Fixed32Kind, protoreflect.Sfixed32Kind,
protoreflect.Int64Kind, protoreflect.Uint64Kind, protoreflect.Sint64Kind,
protoreflect.Int32Kind, protoreflect.Uint32Kind, protoreflect.Sint32Kind,
protoreflect.EnumKind:
return true
}
return false
}
|