文件结构
文件结构 必须 坚持较高等级和更重要的定义在前,较低等级和重要性较低的定义在后的原则。在每一个proto文件中,可以接受的章节顺序如下所示:
- Proto ,
package
,option
和的声明(注意顺序) - API 概述,方便读者快速了解文章的剩余内容
- 资源
消息
体定义,父级必须在其子级的前面定义 - RPC请求和响应的定义,保持相关方法的先后顺序。每个请求消息必须在相应的响应消息(如果有的话)前面定义
大型的.proto文件可以分割成多个小文件。可以将服务、资源消息和请求/响应消息,分别保存在不同的文件中。
Proto 文件名 应该 小写,下划线分隔,并且 必须 使用 作为后缀名。 例如: service_controller.proto
。