学习了koa项目中使用REST的问题及解决思路总结

  1. 问题一:组织url

    1. 通过url中的开头来解决,/static/表示静态资源,/api/表示rest api

    2. 通过子域名区分

  2. 问题二:统一输出

    1. 区分REST API 和 非REST API

    2. 绑定一个rest()方法,设置得有ctx.response.type = "application/json" ctx.response.body = data

    3. 该middleware不仅仅能实现REST API的需求,还得满足可能出现的其他需求

  3. 问题三:处理错误

    1. REST API 请求出错时,如何返回错误

    2. 客户端如何判断时成功还是错误

REST API发生错误不外乎两种情况,

第一类,403,404,500一类的http请求错误,客户端可以识别,但是无法操控错误代码

第二类,业务逻辑错误,即email格式错误,密码错误一类的客户端可识别,可修正的错误。这类错误完全可以以 json 的格式返回给客户端,并且客户可根据提示修正错误。

HTTP的返回码选择:

第一种选择,使用200,识别出第一类错误后,如果遇到200响应,则根据json判断是否出错。着对于动态语言很方便。

第二种选择,成功使用200,错误使用400,这时即使客户端时静态语言也能根据http返回码进行判断出错。

注意:如果选择了第二种方式就不能再混合其他的错误码,401,403等。因为HTTP协议定义的错误码偏向底层,而“REST API”属于“高级协议”不应该复用底层的错误码。

  1. 问题四:定义错误码

    1. 建议使用字符串定义,方便理解错误码的意思。

  2. 问题五:返回错误

    1. 注意,不是第二点统一输出

    2. 这里是返回错误。推荐使用异步函数调用throw抛出错误

  • 1
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值