当前位置: 首页 > news >正文

石家庄大的网站开发公司/哈尔滨最新消息

石家庄大的网站开发公司,哈尔滨最新消息,做字幕模板下载网站,建设摩托车110报价大全编号215原文链接AIP-215: API-specific protos状态批准创建日期2018-10-01更新日期2018-10-01 API通常使用API特定proto定义,偶尔依赖通用组件。保持API相互隔离可以避免版本问题和客户端库打包问题。 指南 所有特定于某个API的protos 必须 位于带有主版本号的包…
编号215
原文链接AIP-215: API-specific protos
状态批准
创建日期2018-10-01
更新日期2018-10-01

API通常使用API特定proto定义,偶尔依赖通用组件。保持API相互隔离可以避免版本问题和客户端库打包问题。

指南

  • 所有特定于某个API的protos 必须 位于带有主版本号的包中(例如 google.library.v1 )。
  • 对其他API中资源的引用 必须 通过资源名字(AIP-122)表达,而非使用资源消息。
  • 如果API的两个版本实际上使用相同的(API特定)proto,这个proto 必须 每个版本中独立定义。(换句话说,API 不得 创建自己的“API特定通用组件”包。)
  • 组织特定通用组件 可以 放在一个通用包中,如AIP-213所述,但 不得 被该组织外的任何API使用。
  • 全局通用组件(一如AIP-213所述) 可以 被任何API自由使用。

理由

如果一个API依赖于另一个API定义的protos,这会引发客户预期行为和客户端库依赖管理的不确定性。假设 google.cloud.library.v1 依赖于 google.cloud.movies.v2 中的protos(而非抽象资源)。对 google.cloud.movies.v2 的任何更改都可能产生问题。

例如:

  • 如果向 google.cloud.movies.v2 中的消息添加了一个域,使用 google.cloud.library.v1 的客户是否应该能够看到它?如果是,应该在域添加后的多久之后看到?其他API更改呢?
  • 如果整个主版本 google.cloud.movies.v2 废弃了(通常在v3发布后),这是否意味着 google.cloud.library.v1 必须更改为使用 google.cloud.movies.v3 ?如果是,需要为库API发布一个新的主版本吗?
  • 客户端库版本管理应该如何反映所依赖API的变更?

保持API相互隔离,并按照高度的纪律性维护一组有限的通用组件,可以减少许多依赖问题。

如果在多个版本之间共享API特定通用组件,会增加生成和打包客户端库的复杂性,在版本管理上也缺乏灵活性。

如果多个主版本初始包含同一个proto的副本,每个proto副本都可以随版本演进,因为它们相互独立。

修订记录

  • 2023-06-27 重构了AIP 215和213,提升清晰度。
  • 2023-05-11 将“PA”改为“组织”。
  • 2018-10-01 初稿。
http://www.lryc.cn/news/577593.html

相关文章:

  • 外网有哪些有趣的网站/抚顺网站建设
  • 重庆网站建设公司多少钱/站长之家站长工具
  • 一起做业网站/百度移动点击排名软件
  • 什么是二级网站推广/网站如何宣传推广
  • 网络广告视频/网站推广优化平台
  • 个体户可以备案网站吗/百度 seo优化作用
  • 站长要维护网站/seo网络推广有哪些
  • 河南网站优化要多少钱/营销方式有哪几种
  • 黄石做网站要多少钱/windows优化大师可以卸载吗
  • 网站图标可以用ps 做吗/百度问问首页
  • 成都市城乡建设委员会官方网站/360广告推广平台
  • 东莞知名网站建设/网站推广的6个方法是什么
  • reactjs 做的网站/短视频seo代理
  • 网站维护托管公司/营销软文300字
  • 中宁网站建设公司/营销型网站建设套餐
  • 手表 网站策划/网络营销的方法是什么
  • 旅游网站建设的概念/下载谷歌浏览器并安装
  • 电脑系统做的好的网站好/百度云搜索引擎入口
  • 如何做网站的seo/石家庄seo外包的公司
  • 珠宝类网站建设可执行报告/搜索引擎优化的主题
  • 网站划分栏目/郑州手机网站建设
  • 资源网站模板/百度账号客服
  • 云南建设监理协会网站/谷歌浏览器安卓版
  • 网站建设大赛策划书/海阳seo排名优化培训
  • 帮人做钓鱼网站/如何在各大网站发布信息
  • 网站更换服务器 备案/泉州seo按天收费
  • 北京海淀区是几环/重庆seo网站推广费用
  • 河北网站建设团队/电商网站建设
  • 百度上做网站/官方百度app下载安装
  • 注册域名的官方网站/软文推广一般发布在哪些平台