本文发布于专栏Effective Java,如果您觉得看完之后对你有所帮助,欢迎订阅本专栏,也欢迎您将本专栏分享给您身边的工程师同学。
老婆经常喜欢翻看我订阅的技术杂志,她总能从她的视角提出很多有趣的问题。
一个悠闲的周日下午,她午觉醒来,又习惯性的抓起这个月的杂志,饶有兴趣地看了起来。
果不其然,看着看着,她又对我发难了,“Restful是什么呀,老公?是restaurant的形容词吗,突然就觉得好饿了啊……”
作为一个合格的程序员,我一直把能够将一项技术讲给老婆听,并且能给她讲懂,作为我已经掌握了这项技术的标准。
如果我直接回答说,“REST就是Representational State Transfer的缩写呀,翻译为中文就是‘表述性状态转移’”,那她今晚肯定得罚我跪键盘。我必须找个合适的机会,把Restful的来龙去脉给她形象的描述一遍。
“走,咱们去楼下咖啡厅吃个下午茶吧”,我对老婆说。
“一个芝士蛋糕,一杯拿铁,两条吸管,谢谢”,我对前台的服务员说,然后我们找了个角落坐了下来。
Level 0 - 面向前台
“刚才我们向前台点了一杯拿铁,这个过程可以用这段文字来描述”,说着,我在纸上写下了这段JSON,虽然她不知道什么叫JSON,但理解这段文字对于英语专业8级的她,实在再简单不过。
{
"addOrder": {
"orderName": "latte"
}
}
“我们通过这段文字,告诉前台,新增一笔订单,订单是一杯拿铁咖啡”,接着,前台给我们返回这么一串回复:
{
"orderId": "123456"
}
“订单ID?还是订单编号?”
“恩恩,就是订单编号”
“那我们就等着前台喊‘订单123456的客户可以取餐了’,然后就可以开吃了!”
“哈哈,你真聪明,不过,在这之前,假设我们有一张会员卡,我们想查询一下这张会员卡的余额,这时候,要向前台发起另一个询问”,我继续在纸上写着:
{
"queryBalance": {
"cardId": "886333"
}
}
“查询卡号为886333的卡的余额?”
“真棒!接着,查询的结果返回来了”
{
"balance": "0"
}
“切,没钱……”
“哈哈,没钱,现在我们要跟前台说,这杯咖啡不要了”,我在纸上写到:
{
"deleteOr