文件结构

    文件结构 必须 坚持较高等级和更重要的定义在前,较低等级和重要性较低的定义在后的原则。在每一个proto文件中,可以接受的章节顺序如下所示:

    • Proto ,packageoption和的声明(注意顺序)
    • API 概述,方便读者快速了解文章的剩余内容
    • 资源消息体定义,父级必须在其子级的前面定义
    • RPC请求和响应的定义,保持相关方法的先后顺序。每个请求消息必须在相应的响应消息(如果有的话)前面定义

    大型的.proto文件可以分割成多个小文件。可以将服务、资源消息和请求/响应消息,分别保存在不同的文件中。

    Proto 文件名 应该 小写,下划线分隔,并且 必须 使用 作为后缀名。 例如: service_controller.proto

    Proto 选项