c语言sscanf函数的用法是什么
315
2023-02-06
本文目录一览:
一些刚开始写接口文档的服务端同学,很容易按着代码的思路去编写接口文档,这让客户端同学或者是服务对接方技术人员经常吐槽,看不懂接口文档。这篇文章提供一个常规接口文档的编写方法,给大家参考。
推荐使用的是docway 写接口文档,方便保存和共享,支持导出PDF MARKDOWN,支持团队项目管理。
一、请求参数
1. 请求方法
GET
用于获取数据
POST
用于更新数据,可与PUT互换,语义上PUT支持幂等
PUT
用于新增数据,可与POST互换,语义上PUT支持幂等
DELETE
用于删除数据
其他
其他的请求方法在一般的接口中很少使用。如:PATCH HEAD OPTIONS
2. URL
url表示了接口的请求路径。路径中可以包含参数,称为地址参数,如**/user/{id}**,其中id作为一个参数。
3. HTTP Header
HTTP Header用于此次请求的基础信息,在接口文档中以K-V方式展示,其中Content-Type则是一个非常必要的header,它描述的请求体的数据类型。
常用的content-type:
application/x-www-form-urlencoded
请求参数使用“”符号连接。
application/json
内容为json格式
application/xml
内容为xml格式
multipart/form-data
内容为多个数据组成,有分隔符隔开
4. HTTP Body
描述http body,依赖于body中具体的数据类型。如果body中的数据是对象类型。则需要描述对象中字段的名称、类型、长度、不能为空、默认值、说明。以表格的方式来表达最好。
示例:
二、响应参数
1. 响应 HTTP Body
响应body同请求body一样,需要描述请清除数据的类型。
另外,如果服务会根据不同的http status code 返回不同的数据结构, 也需要针对不同的http status code对内容进行描述。
三、接口说明
说明接口的应用场景,特别的注意点,比如,接口是否幂等、处理是同步方式还是异步方式等。
四、示例
上个示例(重点都用红笔圈出来,记牢了):
五、接口工具
推荐使用的是http://docway.net(以前叫小幺鸡) 写接口文档,方便保存和共享,支持导出PDF MARKDOWN,支持团队项目管理。
常用接口种类,具体如下。
1.java.lang.String
String类无可争议的获得冠军,应该没有人会否认这一点,这是一个最终类,用于创建/操作不可变的字符串文字。
2.java.lang.System
System类的使用取决于你工作的项目类型,你可能没有在项目中使用过它,但它仍然是受欢迎的Java类之一,这是一个不能被实例化的工具类。
这个类的主要用途是访问标准输入、输出、环境变量等等。
3.java.lang.Exception
Throwable是所有错误和异常的超类,所有异常情况的处理都属于Exception类。
NullPointerException在所有的异常中是最受欢迎的,而Exception异常是在所有异常层次结构的顶部。
4.java.util.ArrayList
一个实现数组的数据结构的类。这个类实现了List接口,是最受欢迎的Java集合类的成员,Arr ayList和Vector之间的差异是初学者常见的问题之一,它也经常在java面试中被问到。
5.ava.util.HashMap
一个实现键值对数据结构的类,这个类实现了Map接口,类似比较ArrayList与Vector,Hash Map与Hashtable也是经常拿来比较的。
它也是一个受欢迎的集合类,作为一个属性-值的容器,经常用在应用程序多个层之间的数据传递。
6.java.lang.Object
所有Java类的根类,每一个Java类都是Object类的一个子类,经常使用在平台/框架上。
它包含了一些重要方法,比如:equals, hashcode, clone, toString等等。它自从Java诞生的第一天开始可用。
7.java.lang.Thread
线程是一个单一执行的序列,多个线程可以共同存在,共享资源,我们可以扩展Thread类,并创建自己的线程。
当然,使用Runnable也是另一种选择,是否使用这个类取决于你的应用程序的需要,一个普通的应用程序是完全没有必要使用线程的。
8.java.lang.Class
Class类是一个直接继承Object类的子类,这个类没有构造函数,它们的对象是被Java虚拟机通过类加载器加载的。
我们大多数人可能没有直接使用过它,但我认为它是一个重要的做反射的类。
9.java.util.Date
这是用来处理日期的类,有时候,我们觉得这个类应该加入更多的实用方法,就像每个企业级应用程序都会创建一个日期的实用工具单元。
它自JDK 1.0开始引入,后来在JDK1.1中发生巨大变化,弃用了一大堆的方法。
10.java.util.Iterator
这是一个接口,它很受欢迎,用来替换枚举,这是一个简单易用的单元,它用Iterable同步工作。
版权声明:本文内容由网络用户投稿,版权归原作者所有,本站不拥有其著作权,亦不承担相应法律责任。如果您发现本站中有涉嫌抄袭或描述失实的内容,请联系我们jiasou666@gmail.com 处理,核实后本网站将在24小时内删除侵权内容。
发表评论
暂时没有评论,来抢沙发吧~