首页 > 技术文章 > Language Guide (proto3) | proto3 语言指南(十一)包

itheo 2021-01-13 18:11 原文

Packages - 包

可以向.proto文件中添加可选的package明符,以防止协议消息类型之间的名称冲突。

package foo.bar;
message Open { ... }

然后你可以在定义你的消息类型的字段时使用包说明符:

message Foo {
  ...
  foo.bar.Open open = 1;
  ...
}

包说明符对生成代码的影响取决于您选择的语言:

  • C++中,生成的类被封装在C++命名空间内。例如,Open将位于名称空间foo::bar中。
  • Java中,该包用作Java包,除非在.proto文件中显式提供option java_package
  • Python中,package指令被忽略,因为Python模块是根据它们在文件系统中的位置来组织的。
  • Go中,包用作Go包名称,除非在.proto文件中显式提供option go_package
  • Ruby中,生成的类被包装在嵌套的Ruby名称空间中,并转换为所需的Ruby大写样式(第一个字母大写;如果第一个字符不是字母,则在前面加上PB_)。例如,Open将位于名称空间Foo::Bar中。
  • C#中,包在转换为帕斯卡命名法后用作命名空间,除非在.proto文件中显式提供选项option csharp_namespace。例如,Open将位于Foo.Bar命名空间中。

包和名称的解析

协议缓冲区语言中的类型名称解析的工作方式与C++类似:首先搜索最内层的作用域,然后搜索下一个最内层的作用域,以此类推,每个包都被认为是其父包的“内层”。以“.”开头(例如.foo.bar. baz)意味着从最外层的作用域开始。
协议缓冲区编译器通过解析导入的.proto文件来解析所有类型名。每种语言的代码生成器都知道如何引用该语言中的每种类型,即使它有不同的作用域规则。

原文:https://www.cnblogs.com/itheo/p/14273536.html

作者:Theo·Chan
版权:本文版权归作者和博客园共有
转载:欢迎转载,但未经作者同意,必须保留此段声明;必须在文章中给出原文连接,否则必究法律责任

推荐阅读