2019-08-06 08:15:48 +00:00
|
|
|
// Copyright 2018 The Go Authors. All rights reserved.
|
|
|
|
|
// Use of this source code is governed by a BSD-style
|
|
|
|
|
// license that can be found in the LICENSE file.
|
|
|
|
|
|
2018-09-07 19:45:37 +00:00
|
|
|
// Code generated by protoc-gen-go. DO NOT EDIT.
|
2020-02-04 23:03:30 +00:00
|
|
|
// source: cmd/protoc-gen-go/testdata/proto3/enum.proto
|
2018-09-07 19:45:37 +00:00
|
|
|
|
|
|
|
|
package proto3
|
|
|
|
|
|
2018-09-13 20:12:36 +00:00
|
|
|
import (
|
2019-05-14 06:55:40 +00:00
|
|
|
protoreflect "google.golang.org/protobuf/reflect/protoreflect"
|
|
|
|
|
protoimpl "google.golang.org/protobuf/runtime/protoimpl"
|
2019-07-15 06:04:40 +00:00
|
|
|
reflect "reflect"
|
2019-03-28 08:13:26 +00:00
|
|
|
sync "sync"
|
2018-09-13 20:12:36 +00:00
|
|
|
)
|
|
|
|
|
|
2018-09-07 19:45:37 +00:00
|
|
|
type Enum int32
|
|
|
|
|
|
|
|
|
|
const (
|
|
|
|
|
Enum_ZERO Enum = 0
|
|
|
|
|
Enum_ONE Enum = 1
|
|
|
|
|
Enum_TWO Enum = 2
|
|
|
|
|
)
|
|
|
|
|
|
2019-08-06 01:38:48 +00:00
|
|
|
// Enum value maps for Enum.
|
|
|
|
|
var (
|
|
|
|
|
Enum_name = map[int32]string{
|
|
|
|
|
0: "ZERO",
|
|
|
|
|
1: "ONE",
|
|
|
|
|
2: "TWO",
|
|
|
|
|
}
|
|
|
|
|
Enum_value = map[string]int32{
|
|
|
|
|
"ZERO": 0,
|
|
|
|
|
"ONE": 1,
|
|
|
|
|
"TWO": 2,
|
|
|
|
|
}
|
|
|
|
|
)
|
2018-09-07 19:45:37 +00:00
|
|
|
|
2019-05-14 22:06:03 +00:00
|
|
|
func (x Enum) Enum() *Enum {
|
|
|
|
|
p := new(Enum)
|
|
|
|
|
*p = x
|
|
|
|
|
return p
|
|
|
|
|
}
|
|
|
|
|
|
2018-09-07 19:45:37 +00:00
|
|
|
func (x Enum) String() string {
|
2019-05-01 19:29:25 +00:00
|
|
|
return protoimpl.X.EnumStringOf(x.Descriptor(), protoreflect.EnumNumber(x))
|
2018-09-07 19:45:37 +00:00
|
|
|
}
|
|
|
|
|
|
2019-05-01 19:29:25 +00:00
|
|
|
func (Enum) Descriptor() protoreflect.EnumDescriptor {
|
2020-02-04 23:03:30 +00:00
|
|
|
return file_cmd_protoc_gen_go_testdata_proto3_enum_proto_enumTypes[0].Descriptor()
|
2019-05-01 19:29:25 +00:00
|
|
|
}
|
|
|
|
|
|
2019-07-02 21:58:02 +00:00
|
|
|
func (Enum) Type() protoreflect.EnumType {
|
2020-02-04 23:03:30 +00:00
|
|
|
return &file_cmd_protoc_gen_go_testdata_proto3_enum_proto_enumTypes[0]
|
2019-07-02 21:58:02 +00:00
|
|
|
}
|
|
|
|
|
|
2019-04-01 19:59:24 +00:00
|
|
|
func (x Enum) Number() protoreflect.EnumNumber {
|
|
|
|
|
return protoreflect.EnumNumber(x)
|
|
|
|
|
}
|
|
|
|
|
|
2019-07-18 01:06:47 +00:00
|
|
|
// Deprecated: Use Enum.Descriptor instead.
|
2018-09-07 19:45:37 +00:00
|
|
|
func (Enum) EnumDescriptor() ([]byte, []int) {
|
2020-02-04 23:03:30 +00:00
|
|
|
return file_cmd_protoc_gen_go_testdata_proto3_enum_proto_rawDescGZIP(), []int{0}
|
2018-09-07 19:45:37 +00:00
|
|
|
}
|
|
|
|
|
|
2020-02-04 23:03:30 +00:00
|
|
|
var File_cmd_protoc_gen_go_testdata_proto3_enum_proto protoreflect.FileDescriptor
|
|
|
|
|
|
|
|
|
|
var file_cmd_protoc_gen_go_testdata_proto3_enum_proto_rawDesc = []byte{
|
|
|
|
|
0x0a, 0x2c, 0x63, 0x6d, 0x64, 0x2f, 0x70, 0x72, 0x6f, 0x74, 0x6f, 0x63, 0x2d, 0x67, 0x65, 0x6e,
|
|
|
|
|
0x2d, 0x67, 0x6f, 0x2f, 0x74, 0x65, 0x73, 0x74, 0x64, 0x61, 0x74, 0x61, 0x2f, 0x70, 0x72, 0x6f,
|
|
|
|
|
0x74, 0x6f, 0x33, 0x2f, 0x65, 0x6e, 0x75, 0x6d, 0x2e, 0x70, 0x72, 0x6f, 0x74, 0x6f, 0x12, 0x15,
|
|
|
|
|
0x67, 0x6f, 0x70, 0x72, 0x6f, 0x74, 0x6f, 0x2e, 0x70, 0x72, 0x6f, 0x74, 0x6f, 0x63, 0x2e, 0x70,
|
|
|
|
|
0x72, 0x6f, 0x74, 0x6f, 0x33, 0x2a, 0x22, 0x0a, 0x04, 0x45, 0x6e, 0x75, 0x6d, 0x12, 0x08, 0x0a,
|
|
|
|
|
0x04, 0x5a, 0x45, 0x52, 0x4f, 0x10, 0x00, 0x12, 0x07, 0x0a, 0x03, 0x4f, 0x4e, 0x45, 0x10, 0x01,
|
|
|
|
|
0x12, 0x07, 0x0a, 0x03, 0x54, 0x57, 0x4f, 0x10, 0x02, 0x42, 0x3e, 0x5a, 0x3c, 0x67, 0x6f, 0x6f,
|
|
|
|
|
0x67, 0x6c, 0x65, 0x2e, 0x67, 0x6f, 0x6c, 0x61, 0x6e, 0x67, 0x2e, 0x6f, 0x72, 0x67, 0x2f, 0x70,
|
|
|
|
|
0x72, 0x6f, 0x74, 0x6f, 0x62, 0x75, 0x66, 0x2f, 0x63, 0x6d, 0x64, 0x2f, 0x70, 0x72, 0x6f, 0x74,
|
|
|
|
|
0x6f, 0x63, 0x2d, 0x67, 0x65, 0x6e, 0x2d, 0x67, 0x6f, 0x2f, 0x74, 0x65, 0x73, 0x74, 0x64, 0x61,
|
|
|
|
|
0x74, 0x61, 0x2f, 0x70, 0x72, 0x6f, 0x74, 0x6f, 0x33, 0x62, 0x06, 0x70, 0x72, 0x6f, 0x74, 0x6f,
|
|
|
|
|
0x33,
|
2018-09-07 19:45:37 +00:00
|
|
|
}
|
cmd/protoc-gen-go: add support for protobuf reflection
Implement support in protoc-gen-go for generating messages and enums
that satisfy the v2 protobuf reflection interfaces. Specifically, the following
are added:
* top-level variable representing the file descriptor
* ProtoReflect method on enums (to implement protoV2.Enum)
* ProtoReflect method on messages (to implement protoV2.Message)
The following are not supported yet:
* resolving transitive dependencies for file imports
* Extension descriptors
* Service descriptors
The implementation approach creates a single array for all the message and enum
declarations and references sections of that array to complete dependencies.
Since protobuf declarations can form a graph (a message may depend on itself),
it is difficult to construct a graph as a single literal. One way is to use
placeholder descriptors, but that is not efficient as it requires encoding
the full name of each dependent enum and message and then later resolving it;
thus, both expanding the binary size and also increasing initialization cost.
Instead, we add a prototype.{Enum,Message}.Reference method to obtain a
descriptor reference for the purposes for satisfying dependencies.
As such, nested declarations and dependencies are populated in an init function.
Other changes to support the implementation:
* Added a protoimpl package to expose the MessageType type and also the
MessageTypeOf and EnumTypeOf helper functions.
* Added a protogen.File.GoIdent field to provide a suggested variable name
for the file descriptor.
* Added prototype.{Enum,Message}.Reference that provides a descriptor reference
for the purposes for satisfying cyclic dependencies.
* Added protoreflect.{Syntax,Cardinality,Kind}.GoString to obtain a Go source
identifier that represents the given constant.
Change-Id: I9455764882dee6ad10f251901e7d419091e8bf1d
Reviewed-on: https://go-review.googlesource.com/c/150074
Reviewed-by: Damien Neil <dneil@google.com>
2018-11-15 22:44:37 +00:00
|
|
|
|
2019-03-28 08:13:26 +00:00
|
|
|
var (
|
2020-02-04 23:03:30 +00:00
|
|
|
file_cmd_protoc_gen_go_testdata_proto3_enum_proto_rawDescOnce sync.Once
|
|
|
|
|
file_cmd_protoc_gen_go_testdata_proto3_enum_proto_rawDescData = file_cmd_protoc_gen_go_testdata_proto3_enum_proto_rawDesc
|
2019-03-28 08:13:26 +00:00
|
|
|
)
|
cmd/protoc-gen-go: add support for protobuf reflection
Implement support in protoc-gen-go for generating messages and enums
that satisfy the v2 protobuf reflection interfaces. Specifically, the following
are added:
* top-level variable representing the file descriptor
* ProtoReflect method on enums (to implement protoV2.Enum)
* ProtoReflect method on messages (to implement protoV2.Message)
The following are not supported yet:
* resolving transitive dependencies for file imports
* Extension descriptors
* Service descriptors
The implementation approach creates a single array for all the message and enum
declarations and references sections of that array to complete dependencies.
Since protobuf declarations can form a graph (a message may depend on itself),
it is difficult to construct a graph as a single literal. One way is to use
placeholder descriptors, but that is not efficient as it requires encoding
the full name of each dependent enum and message and then later resolving it;
thus, both expanding the binary size and also increasing initialization cost.
Instead, we add a prototype.{Enum,Message}.Reference method to obtain a
descriptor reference for the purposes for satisfying dependencies.
As such, nested declarations and dependencies are populated in an init function.
Other changes to support the implementation:
* Added a protoimpl package to expose the MessageType type and also the
MessageTypeOf and EnumTypeOf helper functions.
* Added a protogen.File.GoIdent field to provide a suggested variable name
for the file descriptor.
* Added prototype.{Enum,Message}.Reference that provides a descriptor reference
for the purposes for satisfying cyclic dependencies.
* Added protoreflect.{Syntax,Cardinality,Kind}.GoString to obtain a Go source
identifier that represents the given constant.
Change-Id: I9455764882dee6ad10f251901e7d419091e8bf1d
Reviewed-on: https://go-review.googlesource.com/c/150074
Reviewed-by: Damien Neil <dneil@google.com>
2018-11-15 22:44:37 +00:00
|
|
|
|
2020-02-04 23:03:30 +00:00
|
|
|
func file_cmd_protoc_gen_go_testdata_proto3_enum_proto_rawDescGZIP() []byte {
|
|
|
|
|
file_cmd_protoc_gen_go_testdata_proto3_enum_proto_rawDescOnce.Do(func() {
|
|
|
|
|
file_cmd_protoc_gen_go_testdata_proto3_enum_proto_rawDescData = protoimpl.X.CompressGZIP(file_cmd_protoc_gen_go_testdata_proto3_enum_proto_rawDescData)
|
2019-03-28 08:13:26 +00:00
|
|
|
})
|
2020-02-04 23:03:30 +00:00
|
|
|
return file_cmd_protoc_gen_go_testdata_proto3_enum_proto_rawDescData
|
2019-03-28 08:13:26 +00:00
|
|
|
}
|
cmd/protoc-gen-go: add support for protobuf reflection
Implement support in protoc-gen-go for generating messages and enums
that satisfy the v2 protobuf reflection interfaces. Specifically, the following
are added:
* top-level variable representing the file descriptor
* ProtoReflect method on enums (to implement protoV2.Enum)
* ProtoReflect method on messages (to implement protoV2.Message)
The following are not supported yet:
* resolving transitive dependencies for file imports
* Extension descriptors
* Service descriptors
The implementation approach creates a single array for all the message and enum
declarations and references sections of that array to complete dependencies.
Since protobuf declarations can form a graph (a message may depend on itself),
it is difficult to construct a graph as a single literal. One way is to use
placeholder descriptors, but that is not efficient as it requires encoding
the full name of each dependent enum and message and then later resolving it;
thus, both expanding the binary size and also increasing initialization cost.
Instead, we add a prototype.{Enum,Message}.Reference method to obtain a
descriptor reference for the purposes for satisfying dependencies.
As such, nested declarations and dependencies are populated in an init function.
Other changes to support the implementation:
* Added a protoimpl package to expose the MessageType type and also the
MessageTypeOf and EnumTypeOf helper functions.
* Added a protogen.File.GoIdent field to provide a suggested variable name
for the file descriptor.
* Added prototype.{Enum,Message}.Reference that provides a descriptor reference
for the purposes for satisfying cyclic dependencies.
* Added protoreflect.{Syntax,Cardinality,Kind}.GoString to obtain a Go source
identifier that represents the given constant.
Change-Id: I9455764882dee6ad10f251901e7d419091e8bf1d
Reviewed-on: https://go-review.googlesource.com/c/150074
Reviewed-by: Damien Neil <dneil@google.com>
2018-11-15 22:44:37 +00:00
|
|
|
|
2020-02-04 23:03:30 +00:00
|
|
|
var file_cmd_protoc_gen_go_testdata_proto3_enum_proto_enumTypes = make([]protoimpl.EnumInfo, 1)
|
2024-05-15 11:11:52 +00:00
|
|
|
var file_cmd_protoc_gen_go_testdata_proto3_enum_proto_goTypes = []any{
|
internal/fileinit: generate reflect data structures from raw descriptors
This CL takes a significantly different approach to generating support
for protobuf reflection. The previous approach involved generating a
large number of Go literals to represent the reflection information.
While that approach was correct, it resulted in too much binary bloat.
The approach taken here initializes the reflection information from
the raw descriptor proto, which is a relatively dense representation
of the protobuf reflection information. In order to keep initialization
cost low, several measures were taken:
* At program init, the bare minimum is parsed in order to initialize
naming information for enums, messages, extensions, and services declared
in the file. This is done because those top-level declarations are often
relevant for registration.
* Only upon first are most of the other data structures for protobuf
reflection actually initialized.
* Instead of using proto.Unmarshal, a hand-written unmarshaler is used.
This allows us to avoid a dependendency on the descriptor proto and also
because the API for the descriptor proto is fundamentally non-performant
since it requires an allocation for every primitive field.
At a high-level, the new implementation lives in internal/fileinit.
Several changes were made to other parts of the repository:
* cmd/protoc-gen-go:
* Stop compressing the raw descriptors. While compression does reduce
the size of the descriptors by approximately 2x, it is a pre-mature
optimization since the descriptors themselves are around 1% of the total
binary bloat that is due to generated protobufs.
* Seeding protobuf reflection from the raw descriptor significantly
simplifies the generator implementation since it is no longer responsible
for constructing a tree of Go literals to represent the same information.
* We remove the generation of the shadow types and instead call
protoimpl.MessageType.MessageOf. Unfortunately, this incurs an allocation
for every call to ProtoReflect since we need to allocate a tuple that wraps
a pointer to the message value, and a pointer to message type.
* internal/impl:
* We add a MessageType.GoType field and make it required that it is
set prior to first use. This is done so that we can avoid calling
MessageType.init except for when it is actually needed. The allows code
to call (*FooMessage)(nil).ProtoReflect().Type() without fearing that the
init code will run, possibly triggering a recursive deadlock (where the
init code depends on getting the Type of some dependency which may be
declared within the same file).
* internal/cmd/generate-types:
* The code to generate reflect/prototype/protofile_list_gen.go was copied
and altered to generated internal/fileinit.desc_list_gen.go.
At a high-level this CL adds significant technical complexity.
However, this is offset by several possible future changes:
* The prototype package can be drastically simplified. We can probably
reimplement internal/legacy to use internal/fileinit instead, allowing us
to drop another dependency on the prototype package. As a result, we can
probably delete most of the constructor types in that package.
* With the prototype package significantly pruned, and the fact that generated
code no longer depend on depends on that package, we can consider merging
what's left of prototype into protodesc.
Change-Id: I6090f023f2e1b6afaf62bd3ae883566242e30715
Reviewed-on: https://go-review.googlesource.com/c/158539
Reviewed-by: Herbie Ong <herbie@google.com>
Reviewed-by: Joe Tsai <thebrokentoaster@gmail.com>
2019-01-18 17:32:24 +00:00
|
|
|
(Enum)(0), // 0: goproto.protoc.proto3.Enum
|
cmd/protoc-gen-go: add support for protobuf reflection
Implement support in protoc-gen-go for generating messages and enums
that satisfy the v2 protobuf reflection interfaces. Specifically, the following
are added:
* top-level variable representing the file descriptor
* ProtoReflect method on enums (to implement protoV2.Enum)
* ProtoReflect method on messages (to implement protoV2.Message)
The following are not supported yet:
* resolving transitive dependencies for file imports
* Extension descriptors
* Service descriptors
The implementation approach creates a single array for all the message and enum
declarations and references sections of that array to complete dependencies.
Since protobuf declarations can form a graph (a message may depend on itself),
it is difficult to construct a graph as a single literal. One way is to use
placeholder descriptors, but that is not efficient as it requires encoding
the full name of each dependent enum and message and then later resolving it;
thus, both expanding the binary size and also increasing initialization cost.
Instead, we add a prototype.{Enum,Message}.Reference method to obtain a
descriptor reference for the purposes for satisfying dependencies.
As such, nested declarations and dependencies are populated in an init function.
Other changes to support the implementation:
* Added a protoimpl package to expose the MessageType type and also the
MessageTypeOf and EnumTypeOf helper functions.
* Added a protogen.File.GoIdent field to provide a suggested variable name
for the file descriptor.
* Added prototype.{Enum,Message}.Reference that provides a descriptor reference
for the purposes for satisfying cyclic dependencies.
* Added protoreflect.{Syntax,Cardinality,Kind}.GoString to obtain a Go source
identifier that represents the given constant.
Change-Id: I9455764882dee6ad10f251901e7d419091e8bf1d
Reviewed-on: https://go-review.googlesource.com/c/150074
Reviewed-by: Damien Neil <dneil@google.com>
2018-11-15 22:44:37 +00:00
|
|
|
}
|
2020-02-04 23:03:30 +00:00
|
|
|
var file_cmd_protoc_gen_go_testdata_proto3_enum_proto_depIdxs = []int32{
|
2019-08-14 18:55:31 +00:00
|
|
|
0, // [0:0] is the sub-list for method output_type
|
|
|
|
|
0, // [0:0] is the sub-list for method input_type
|
|
|
|
|
0, // [0:0] is the sub-list for extension type_name
|
|
|
|
|
0, // [0:0] is the sub-list for extension extendee
|
|
|
|
|
0, // [0:0] is the sub-list for field type_name
|
2019-06-06 20:01:53 +00:00
|
|
|
}
|
internal/fileinit: generate reflect data structures from raw descriptors
This CL takes a significantly different approach to generating support
for protobuf reflection. The previous approach involved generating a
large number of Go literals to represent the reflection information.
While that approach was correct, it resulted in too much binary bloat.
The approach taken here initializes the reflection information from
the raw descriptor proto, which is a relatively dense representation
of the protobuf reflection information. In order to keep initialization
cost low, several measures were taken:
* At program init, the bare minimum is parsed in order to initialize
naming information for enums, messages, extensions, and services declared
in the file. This is done because those top-level declarations are often
relevant for registration.
* Only upon first are most of the other data structures for protobuf
reflection actually initialized.
* Instead of using proto.Unmarshal, a hand-written unmarshaler is used.
This allows us to avoid a dependendency on the descriptor proto and also
because the API for the descriptor proto is fundamentally non-performant
since it requires an allocation for every primitive field.
At a high-level, the new implementation lives in internal/fileinit.
Several changes were made to other parts of the repository:
* cmd/protoc-gen-go:
* Stop compressing the raw descriptors. While compression does reduce
the size of the descriptors by approximately 2x, it is a pre-mature
optimization since the descriptors themselves are around 1% of the total
binary bloat that is due to generated protobufs.
* Seeding protobuf reflection from the raw descriptor significantly
simplifies the generator implementation since it is no longer responsible
for constructing a tree of Go literals to represent the same information.
* We remove the generation of the shadow types and instead call
protoimpl.MessageType.MessageOf. Unfortunately, this incurs an allocation
for every call to ProtoReflect since we need to allocate a tuple that wraps
a pointer to the message value, and a pointer to message type.
* internal/impl:
* We add a MessageType.GoType field and make it required that it is
set prior to first use. This is done so that we can avoid calling
MessageType.init except for when it is actually needed. The allows code
to call (*FooMessage)(nil).ProtoReflect().Type() without fearing that the
init code will run, possibly triggering a recursive deadlock (where the
init code depends on getting the Type of some dependency which may be
declared within the same file).
* internal/cmd/generate-types:
* The code to generate reflect/prototype/protofile_list_gen.go was copied
and altered to generated internal/fileinit.desc_list_gen.go.
At a high-level this CL adds significant technical complexity.
However, this is offset by several possible future changes:
* The prototype package can be drastically simplified. We can probably
reimplement internal/legacy to use internal/fileinit instead, allowing us
to drop another dependency on the prototype package. As a result, we can
probably delete most of the constructor types in that package.
* With the prototype package significantly pruned, and the fact that generated
code no longer depend on depends on that package, we can consider merging
what's left of prototype into protodesc.
Change-Id: I6090f023f2e1b6afaf62bd3ae883566242e30715
Reviewed-on: https://go-review.googlesource.com/c/158539
Reviewed-by: Herbie Ong <herbie@google.com>
Reviewed-by: Joe Tsai <thebrokentoaster@gmail.com>
2019-01-18 17:32:24 +00:00
|
|
|
|
2020-02-04 23:03:30 +00:00
|
|
|
func init() { file_cmd_protoc_gen_go_testdata_proto3_enum_proto_init() }
|
|
|
|
|
func file_cmd_protoc_gen_go_testdata_proto3_enum_proto_init() {
|
|
|
|
|
if File_cmd_protoc_gen_go_testdata_proto3_enum_proto != nil {
|
2019-03-09 01:18:11 +00:00
|
|
|
return
|
|
|
|
|
}
|
2019-07-15 06:04:40 +00:00
|
|
|
type x struct{}
|
2019-06-06 20:01:53 +00:00
|
|
|
out := protoimpl.TypeBuilder{
|
|
|
|
|
File: protoimpl.DescBuilder{
|
2019-07-15 06:04:40 +00:00
|
|
|
GoPackagePath: reflect.TypeOf(x{}).PkgPath(),
|
2020-02-04 23:03:30 +00:00
|
|
|
RawDescriptor: file_cmd_protoc_gen_go_testdata_proto3_enum_proto_rawDesc,
|
2019-06-06 20:01:53 +00:00
|
|
|
NumEnums: 1,
|
|
|
|
|
NumMessages: 0,
|
|
|
|
|
NumExtensions: 0,
|
|
|
|
|
NumServices: 0,
|
|
|
|
|
},
|
2020-02-04 23:03:30 +00:00
|
|
|
GoTypes: file_cmd_protoc_gen_go_testdata_proto3_enum_proto_goTypes,
|
|
|
|
|
DependencyIndexes: file_cmd_protoc_gen_go_testdata_proto3_enum_proto_depIdxs,
|
|
|
|
|
EnumInfos: file_cmd_protoc_gen_go_testdata_proto3_enum_proto_enumTypes,
|
2019-06-06 20:01:53 +00:00
|
|
|
}.Build()
|
2020-02-04 23:03:30 +00:00
|
|
|
File_cmd_protoc_gen_go_testdata_proto3_enum_proto = out.File
|
|
|
|
|
file_cmd_protoc_gen_go_testdata_proto3_enum_proto_rawDesc = nil
|
|
|
|
|
file_cmd_protoc_gen_go_testdata_proto3_enum_proto_goTypes = nil
|
|
|
|
|
file_cmd_protoc_gen_go_testdata_proto3_enum_proto_depIdxs = nil
|
cmd/protoc-gen-go: add support for protobuf reflection
Implement support in protoc-gen-go for generating messages and enums
that satisfy the v2 protobuf reflection interfaces. Specifically, the following
are added:
* top-level variable representing the file descriptor
* ProtoReflect method on enums (to implement protoV2.Enum)
* ProtoReflect method on messages (to implement protoV2.Message)
The following are not supported yet:
* resolving transitive dependencies for file imports
* Extension descriptors
* Service descriptors
The implementation approach creates a single array for all the message and enum
declarations and references sections of that array to complete dependencies.
Since protobuf declarations can form a graph (a message may depend on itself),
it is difficult to construct a graph as a single literal. One way is to use
placeholder descriptors, but that is not efficient as it requires encoding
the full name of each dependent enum and message and then later resolving it;
thus, both expanding the binary size and also increasing initialization cost.
Instead, we add a prototype.{Enum,Message}.Reference method to obtain a
descriptor reference for the purposes for satisfying dependencies.
As such, nested declarations and dependencies are populated in an init function.
Other changes to support the implementation:
* Added a protoimpl package to expose the MessageType type and also the
MessageTypeOf and EnumTypeOf helper functions.
* Added a protogen.File.GoIdent field to provide a suggested variable name
for the file descriptor.
* Added prototype.{Enum,Message}.Reference that provides a descriptor reference
for the purposes for satisfying cyclic dependencies.
* Added protoreflect.{Syntax,Cardinality,Kind}.GoString to obtain a Go source
identifier that represents the given constant.
Change-Id: I9455764882dee6ad10f251901e7d419091e8bf1d
Reviewed-on: https://go-review.googlesource.com/c/150074
Reviewed-by: Damien Neil <dneil@google.com>
2018-11-15 22:44:37 +00:00
|
|
|
}
|
