开发restful api总结的几点小经验

与其说是开发,不如说是打补丁! 

是个jesery+spring的restful service,加了一个权限校验部分,做了一些调整。

本来其实很简单的一个事,后来发现,这个代码太霸道。本来传个参数是action_id 这个东西,结果参数名字有如下:action_id,actionID,id 我只能说傻傻分不清楚到底你传的什么,

因为还有其他id,参数名字参考刚才的。

 

代码中的也是混乱,虽然我知道有很多先人在修改了,但是也不至于这样吧。

吐槽完毕。

1、N次开发restful api主意版本迭代,不要在别人的基础上改,比如这次做,我直接修改!后来就是,重新建了自己的一个version package。

  这样做可以避免之前用老api人的影响,同时可以自己掌控代码的质量,至少不用改别人的代码。别人已经写好的,你看着不行就改,可以救直接调用。

2、注意代码的可用性,尽量不要使用递归这种东西,很无脑。除非这个操作很简单。 这次修改的代码就是使用 锁+递归 =》做sql查询,这简直爆炸了好么。

  直接把递归这种东西做掉了。

3、多用常量,避免hard code。

4、sql查询不要使用select * 。 把需要查询的字段都写上,这样做是为了防止后续schema修改,你的bean不兼容的问题。

5、尽量把整个api都看懂,因为别人不只问你你开发的,你还要解决别人留下的那些很傻x的bugs

posted @ 2015-11-25 22:13  _Doraemon  阅读(368)  评论(0编辑  收藏  举报