请君入坑：RESTFul设计风格（一）

①

有一次面试，面试官问：“什么是REST风格？”

自己也是刚接触这一个概念，并没有系统化的去学习，就含含糊糊地回答：“前台用GET请求，后台也用GET接收；前台用POST请求，后台也用POST接收……”

还没等我说完，就被面试官就打断：“前台用GET请求，后台用POST接收，能接收到吗？”

“额，不能。”

“你们项目里用过吗？”

“用过的。”

“有接口文档吗？”

“有”

“接口是怎么命名的？”

当时，傻了眼，不知道该怎么描述，是动词名词相结合吗，驼峰式的命名法？支支吾吾了半天……更不知道面试官葫芦里装的什么药，这样问的目的是什么，心里的几只小兔子一直蹦呀跳呀，不敢轻易回答，忐忑。

就这样，在这场面试中，灰不溜秋的败下阵来。

回到家中，立刻翻书查资料，终于明白了面试官为何这样问。

②

请看这段代码：

@RestController

public class TestController {

          @RequestMapping("/test")

          public Object test(){

return "test";

          }

}

如果仅仅在Controller类上加上@RestController，有了Rest字样，就认为已经实现了REST风格，那也是大错特错了，这只是RESTFul风格的冰山一角哟。当然，自己也曾经这么傻傻地认为。

先来说说这个@RestController的作用吧，

@RestController = @Controller + @ResponseBody，没错上面的代码等同于下面的代码：

@Controller

public class TestController {

          @ResponseBody

          @RequestMapping("/test")

          public Object test(){

   return "test";

          }

}

为什么等同呢，一看运行结果，二看源码，请看@ResponseBody的源码，源码最有说服力：

图-1

③

那到底什么是RESTFul风格呢？看官方解释，REST是英文Representational State Transfer的简称，可以翻译为表现层状态转换。它是一种软件架构风格，在两千年的时候，这种思想提出了，如今发展也快十个年头了，具体的可以自己网上搜，个人推荐阮一峰的网络日志：http://www.ruanyifeng.com/blog/2011/09/restful.html

下面上代码，进入使用阶段，下面的这四种是比较常用的，还有PATCH(UPDATE)、HEAD、OPTIONS这三种不常用，就不列举了。

/**

* RESTFul风格代码示范

* @author ME

*

*/

@RequestMapping("/user")

@RestController

public class UserController {

          /**

          * 新增(CREATE)

          * @param user

          * @return

          */

    @RequestMapping(value="/save",method= RequestMethod.POST)

    public Object save(User user) {

          System.out.println("数据库持久层操作");

          returnuser.getUserMobile();

    }

/**

     * 修改(UPDATE)

     * @param userUid

     * @param user

     * @return

     */

    @RequestMapping(value="/{userUid}",method= RequestMethod.PUT)

    public Object update(@PathVariableInteger userUid,User user) {

          System.out.println("数据库持久层操作");

          returnuserUid;

    }

    /**

     * 删除数据(DELETE)

     * @param userUid

     * @return

     */

    @RequestMapping(value="/{userUid}",method= RequestMethod.DELETE)

    public Object delete(@PathVariableString userUid) {

          System.out.println("数据库持久层操作");

                   return userUid;

    }

    /**

     * 查询单条数据（VISIT）

     * @param userUid

     * @return

     */

    @RequestMapping(value="/{userUid}",method= RequestMethod.GET)

    public Object info(@PathVariableString userUid) {

          System.out.println("数据库查询操作");

          returnuserUid;

    }

}