最新 最热

构建下一代 HTTP API - OpenAPI spec 和解析器

在 抽象的能力 一文结尾的地方,我简单谈到了做 feed 的一些心得。当时我接手这个工作的时候,之前的工程师已经留下了好几万行 php 代码,这些代码处理几十个来自不同厂商的 feed,把里面的内容提取出来存在数据库中。因为 f...

2021-01-04
1

使用 swagger 生成规范化的RESTful API 代码

REST(英文:Representational State Transfer,又称具象状态传输)是Roy Thomas Fielding博士于2000年在他的博士论文[1] 中提出来的一种万维网软件架构风格,目的是便于不同软件/程序在网络(例如互联网)中互相传递信息。...

2021-01-02
1

使用 swagger 生成Flask RESTful API

REST(英文:Representational State Transfer,又称具象状态传输)是Roy Thomas Fielding博士于2000年在他的博士论文[1] 中提出来的一种万维网软件架构风格,目的是便于不同软件/程序在网络(例如互联网)中互相传递信息。...

2021-01-02
1

构建下一代 HTTP API - 架构

在构思 Quenya 的时候,我已经有之前 UAPI 和 Goldorin 在生产环境下的应用经验。总结起来,就是 UAPI 有一个很好的结构(见我四年前的文章:再谈 API 的撰写 - 架构),但它做事的顺序反了,先有代码,再有 spec,通过代码生成 spec(当...

2020-12-16
1

构建下一代 HTTP API - 测试

不得不承认的是,为代码中各种潜在的组合绞尽脑汁撰写单元测试,实在不是一件容易的事情。我个人喜欢在一些项目中对于关键路径撰写单元测试,确保后续的功能更新或者重构不会影响关键流程;然后有空的时候再去补上更多的单元...

2020-12-16
1

构建下一代 HTTP API - 总览

十月底我应邀在一个技术群里做个分享,思来想去我选择了 API 这个话题,因为很多互联网初创公司产品的第一步就是如何定义和设计一套 API,来满足产品核心所能提供的用户体验。我把 2016 年我在 Tubi 做 UAPI,2018 年我在 Ar...

2020-12-16
1

还在手动维护API文档吗?是时候用用丝袜哥(swagger)了!

OpenAPI规范是Linux基金会的一个项目,试图通过定义一种用来描述API格式或API定义的语言,来规范RESTful服务开发过程。OpenAPI规范帮助我们描述一个API的基本信息。...

2020-12-02
1

Spring Cloud Alibaba 系列之 Nacos 集群

官方文档 说开源的时候推荐用户把所有服务列表放到一个 vip 下面,然后挂到一个域名下面   ♞ http://ip:port/openAPI 直连 ip 模式,机器挂载需要修改 ip 才可以使用;   ♞ http://VIP:port/openAPI 挂载 VIP 模式,直...

2020-11-24
1

Swagger 3.0使用教程

由于Spring的流行,Marty Pitt编写了一个基于Spring的组件swagger-springmvc,用于将swagger集成到springmvc中来,而springfox则是从这个组件发展而来。

2020-11-24
1

后端Coder如何做好代码设计?

说明:生鲜电商属于一个软件的产品,那么如何做好代码设计呢?代码设计,是程序员做项目时,在coding之前非常重要的一个步骤,可以说关系到整个系统、整个团队的研发质量和效率。一般说代码设计,可能涵盖以下几种:...

2020-11-13
1