去年刚入职这家公司的时候要求用restful,微服务。
给整的一脸懵逼。最后发现restful一点也不神奇。
特此 记录一下精华,给需要的小伙伴。
精华 1 ,http的请求方式 表示动作 !http的请求方式 表示动作 !!http的请求方式 表示动作 !!!
常用的四种 get,post,put,delete
得到数据就用get,新增数据就用post,修改就用put,删除就用delete
2 地址中不要有动词!地址中不要有动词!!地址中不要有动词!!!
http的请求方式已经表明想要做什么,所以不需要在地址用加动词。
示例错误的 api
get /api/v1.0/getUser
post /api/v1.0/saveUser
post /api/v1.0/updateUser
post /api/v1.0/deleteUser
正确的resutful风格的接口
get /api/v1.0/user
post /api/v1.0/user
put /api/v1.0/user
delete /api/v1.0/user
自认比较规范的后台接口示意
上面的controller生成的swagger 如下
完毕,qq 102528071 小伙伴们可以交流一下。