遇上频繁更新，无文档的 API …

最新推荐文章于 2022-07-31 16:00:28 发布

程序员的那些事_

最新推荐文章于 2022-07-31 16:00:28 发布

阅读量250

点赞数

（给程序员的那些事加星标）

原创整理：程序员的那些事（id：iProgrammer）

如果有人问你，当遇上频繁更新，并且没有文档的 API 之时，程序员会是有什么样的感受？

那就让他看看这是视频！

（提示：有声视频）

网友评论

@新建文本文档Tx：简直想打人

@-会有喵星人的-：最可气的是不告诉你

@千寻客：说得很生动形象呢

@Holt_：做数学题就要这个思维

@L等待2015：有无数个瞬间想打死不写文档的人，虽然自己也很少写

往期热文（点击图片即可阅读）

关注「程序员的那些事」加星标，不错过圈内事

640?wx_fmt=png

每日看趣图，身心愉悦

确定要放弃本次机会？

福利倒计时

: :

立减 ¥

普通VIP年卡可用

立即使用

程序员的那些事_

关注关注

0
点赞
踩
0

收藏

觉得还不错? 一键收藏
0
评论
复制链接

分享到 QQ

分享到新浪微博

扫一扫

BAT 大厂Java 面试题集锦之核心篇附参考答案

AI天才研究院

11-05

1万+

核心篇数据结构与算法网路:TCP/IP,HTTP操作系统, 文件, shell, CPU, IO, epoll, 非阻塞IO,进程/线程/协程,锁HashMap, Co...

mysql5.7性能提升一百倍调优宝典

lifetragedy的专栏

05-06

1万+

全文中一共有常用的（事实上你如果花1-2周阅读、理解、自己动手设一下后是需要这么多参数的）76个参数，我是按照：每一个参数干吗？在某些典型硬件配置下的db上参数该设多少？设会怎么样？不设会怎么样？有什么坑如何填坑？有些参数怎么算、算法又如何这种style来写的，具体请看文档！一千个DBA就有一千种配置方式! 大家一定记得不要轻易去看网上，要看只看官网！网上很多博客都...

参与评论您还未登录，请先登录后发表或查看评论

api文档生成工具apiggs的使用

zpflwy1314的博客

04-25

3479

代码即文档 Apiggs是一个非侵入的RestDoc文档生成工具。工具通过分析代码和注释，获取文档信息，生成RestDoc文档。首先需要在pom中添加apiggs的依赖依赖，<dependency>../bot-manage-domain/src/main/java</dependency>是实体对象所在路径，当没有dependency内容时不会读取到返回的对象导致没...

使用apiggs自动生成api文档

java_t_t的博客

08-12

651

程序员最讨厌的两件事：一是别人的代码没有文档，二是给自己的代码写文档。有买卖就有伤害有需求就有市场，比如swagger就可以自动生成文档，但是swagger是侵入式的，和业务代码混在一起，而apiggs是一个非侵入式的maven插件，可以生成三种格式的文档： html：api文档 json：可直接导入postman adoc：一种asciidoc文档，可用文件处理器转换成其它格式文档，如html等使用：在pom.xml添加以下配置，maven打包时即可生成文档 <plug..

Apiggs - 非侵入的RestDoc文档生成工具

w360188606的博客

10-25

2036

前言程序员一直以来都有一个烦恼，只想写代码，不想写文档。代码就表达了我的思想和灵魂。 Python提出了一个方案，叫docstring，来试图解决这个问题。即编写代码，同时也能写出文档，保持代码和文档的一致。docstring说白了就是一堆代码中的注释。Python的docstring可以通过help函数直接输出一份有格式的文档，本工具的思想与此类似。代码即文档 Apiggs是一个非侵入的Re...

Apiggs和postman配合使用

github_39333092的博客

07-11

271

Apiggs - 非侵入的RestDoc文档生成工具使用方法在pom里<plugins>里复制粘贴下面  <plugin> <groupId>com.github.apiggs</groupId> <artifactId&...

spring-boot 一款无侵入型，轻量级的接口文档生成工具apiggs

zhangsir的博客

09-05

9460

spring-boot 一款无侵入型，轻量级的接口文档生成工具apiggs 名字叫：apiggs 使用只需两步，先把插件代码引入pom文件，然后编译打包即可之后项目的target目录下，就会多出一个apiggs的文件夹，里面便是项目controller的文档 github上有源码：https://github.com/apigcc/apigcc-maven-plugin <build&gt...

当技术重构遇上DDD，如何实现业务、技术双赢？

q1472750149的博客

01-07

605

百度Geek说正在上传…重新上传取消架构师 @ 百度全文9000字，预计阅读时间21分钟一、困境：项目背景爱番番沟通基于百度商桥快速完成了产品功能和技术架构的从无到有，但同时也继承了百度商桥历史功能繁杂、技术架构陈旧的缺点。为了能更好地服务于爱番番沟通将来的产品演进，提高产研能效，需要从实际问题出发，聚焦主要矛盾，对产品架构和业务架构进行重构。为了更好的理解本文内容，以下是必要的名词解释： 1.1 爱番番沟通是什么？爱番番沟通是连接访客和商家的在线咨询工具。一方面访客可以...

SQLAlchemy遇上SQLite：轻量级数据库操作的高效秘诀

[SQLAlchemy遇上SQLite：轻量级数据库操作的高效秘诀](https://img-blog.csdnimg.cn/img_convert/63a31b65a62152d13c05a6d985c8c46e.png) # 1. SQLAlchemy与SQLite简介 ## 数据库技术概述 SQLite和SQLAlchemy作为轻...

阿里Dubbo疯狂更新，关Spring Cloud什么事？

m0_67698950的博客

07-31

259

在工程启动阶段，如遇到ZK不可达，当前版本的行为是使用注册中心缓存继续启动。而SpringCloud诞生于微服务架构时代，考虑的是微服务治理的方方面面，另外由于依托了Spirng、SpirngBoot的优势之上，两个框架在开始目标就不一致，Dubbo定位服务治理、SpirngCloud是一个生态。虽然稍稍有所期待，但也不知道阿里这次拿出了多少的诚意来做这件事，于是我昨天又到GitHub逛了一下，发现从9月开始，阿里三个月连着发布了四个版本，还是非常有诚意的，值得关注。...

Matlab代码迁移至C++（上）

lijiayu2015的博客

12-02

1万+

一、背景用MATLAB的强大神器——Coder将MATLAB代码转移到C++

基于matlab的LIBSVM的调试

Potential

06-01

5232

MinGW全称Minimalist GNU For Windows，是个精简的Windows平台C/C++、ADA及Fortran编译器，相比Cygwin而言，体积要小很多，使用较为方便。MinGW提供了一套完整的开源编译工具集，以适合Windows平台应用开发，且不依赖任何第三方C运行时库。MinGW包括：一套集成编译器，包括C、C++、ADA语言和Fortran语言编译器用于生成Windows

彻底解决Matlab中mex-setup未找到支持的编译器或SDK

热门推荐

u010129349的博客

08-08

5万+

在Matlab（不分版本）命令面板中写入mex -setup后，提示：错误使用 mex 未找到支持的编译器或 SDK。您可以安装免费提供的 MinGW-w64 C/C++编译器；请参阅安装 MinGW-w64 编译器。如需更多选项，请参阅、、、、、、、、、、、解决方法很简单，http://tdm-gcc.tdragon.net/download (或者使用作者提供CSDN链接-htt...

Matlab安装MinGW-w64实现c，c++以及fortran编译（亲测有效）

吉大秦少游

03-08

2万+

matlab固然强大，其中的simulink更是理工科仿真、建模研究中不可缺少的工具，一般而言matlab/simulink能满足多数使用要求，但是往往在研究中会使用User-difinition s-function或者调用c,c++的库函数，这时候就需要matlab能进行c，c++以及fortran语言的编译。但是matlab本身是没有包含上述语言的编译器，因此通常需要安装Mi...

VS2017调用Matlab2016b进行绘图

shouzang的博客

06-25

1万+

1、运行环境 Windows 10 64bit Visual Studio Community 2017 Matlab 2016b 注：也适用于Matlab 2017a 2、matlab安装补丁打开https://ww2.mathworks.cn/support/sysreq/previous_releases.html，如下图所示。打开对应的matlab版本“Support...

【通告随时知APP】项目进度

你若盛开，清风自来

03-30

1410

客户端界面及其功能（进度10%）注册–完成登录—完成查看通告发布通告点赞分享定位收藏公告后台管理系统（进度70%）登录–完成增–完成删–完成改–完成查–完成分页–完成模糊搜索–完成权限–待完善上传–完成服务端提供接口（进度50%）客户端界面（进度60%） 1.主页点击详情进入详情页 2.通告页点击申请权限进入申请权限页面 3.我的页面...

11、Update API

mine_1的专栏

01-04

217

原文地址：https://www.elastic.co/guide/en/elasticsearch/reference/current/docs-update.html#_updates_with_a_partial_document elasticsearch版本：6.5 更新API允许根据提供的脚本更新文档。该操作从索引中获取文档（在每个分片中的集合），运行脚本（使用可选的脚本语言和参数...

Centos7 redis5 集群环境安装、启动、关闭教程

jrgdspuwij的博客

02-01

3137

1、redis介绍、项目介绍 Redis 是一个开源（BSD许可）的，内存中的数据结构存储系统，它可以用作数据库、缓存和消息中间件。它支持多种类型的数据结构，如字符串（strings），散列（hashes），列表（lists），集合（sets），有序集合（sorted sets）与范围查询， bitmaps， hyperloglogs 和地理空间（geospatial）索引半径查...

Windows自动更新API (1)

weixin_30590285的博客

07-13

184

前几天写过关于Vista下防火墙的设置，今天觉得防火墙都有对应的API，那自动更新是否有相应的API呢？Vista下的与Xp下的有多少不同呢？带着这个疑问开始一天的调查。查了很多资料找到要操作Windows Update必须经由Windows Update Agent（WUA）。在Vista和Xp下，该wuapi.dll都能找到(Windows\System32下)，奇怪的是，Vista下该dll...