关于API 开发-第二弹

17 阅读3分钟

随着 1.0.0 版本, Publish 到 Nexus 第一阶段算是结束啦。 PS 当前到 1.9.6-RELEASE (2023-03-21)

图片

DONE

图片

基础

  1. proto → swagger ↔ Java  之间对等转换

  2. trivial: pageable, plural, wrapper, enum 标准处理

  3. wire:协议的编织

  4. stub:客户端生成 + 微服务 delegator

  5. 版本控制: 版本 + Priority

  6. 项目结构

  7. 完整 demo 

过程

标准proto 项目:

image.png

项目元信息维护

image.png

swagger 迭代版本信息

image.png

image.png

可视化对比, 将Swagger 纳入版本管理, 才是对API 最基本的尊重:

图片

标准组件
统一对象协议层封装, 定义一个自动复制5个, 非常巴适,无需任何人工干预调用或者设置, 自动根据元信息配置。

image.png

image.png

妈妈再也不用怕我用错 Enum/Error, 这么完美的代码,都是自动帮您生成的, 完美到老板看到你以为是一个10年以上的老鸟!📣📣📣📣

图片

对外也是和 OAS 完全绝对兼容, 开放是我们的第一天条:

图片

这还没完事, 万事俱备,只欠东风, 你得落地哈!Stub 生成的代码,虽然称不上惊艳, 中规中矩中体现了大家风范, 完美企业级开发体验, 省去傍阿姨,细狗也有艳阳天,至少平添3/5年功力。 

图片

链式调用一路敲下去, 隔壁产品组的伊丽莎白.李花, 听到我一路爽脆的键盘声, 敢怒不敢言; 待到整6点, 我完美的收工背影, 又投来艳慕的目光,滋滋灼烧我从一品仓淘来的99块的马甲!
几乎市面上所有能够考虑的情景我们都帮你考虑到了:

图片

图片微服务也不再是开发的拦路虎, 痛苦只允许留给我们, 不能留给任何一位善良的开发人员, 如对待自己的孩子般,设计上尽显人性光辉, 只有在一行一行代码中体会, 无以言表!

图片
微服务,三层剥离, 四两拨千斤,开发的任督二脉彻底打开, 任由真气在您全身贯通。 能够阻止您敲代码速度的,某种意义上只有宇宙的限制--光速!

图片

图片

TODO

  1. Test test & test
  • Version control & merger  + 80% test case

  • Wire + Hub integration test

  • Swagger json generation      test 10%  need more

  • Swagger diff integration       test 10%  need more

  • advance configuration properties 

  • handbook 

  • spring contract  –  refer , local JAVA mock EASY micro-service  mock test! 

  • BDD 

  • entity design

  • middle ware abstract

  • safe,   proguard

  • TAPD、Tower、JIRA、禅道、SonarQube、GitLab、Zabbix、Ehr、企业微信、钉钉, APIFOX, APIPOST, EOLINK  API 对接!

  • Trivial: header cookie 处理
    
  • too much.....
    

题后

  1. 三爷的API 合集
  2. Dearxue.com - 第二学堂

从 WebService, RPC, RestfulAPI.... 等一系列的开发方法和理念层出不穷, 每个都有自己的优缺点,背负着时代的特色; 而程序员如过江之鲫, 在冗长的开发线和交付后的迭代和维护中, 开始的新鲜劲很快就过去, 当初色彩也渐渐凋零;如何能够更快乐敲代码? 如何避从技术栈,框架,工具,语言等腐朽、凋零、人+流程的 “堕落” 中解脱?  可能咱也解决不了, 这只是个尝试, 至少是饱含 Hope、Love 等一些柔软的内容, 是的,最能代表她的可能是一个大大的 Hug 吧! 🤗

image.png