RestFul设计风格

RestFul风格

RESTFUL是一种网络应用程序的设计风格和开发方式，基于HTTP，可以使用XML格式定义或JSON格式定义。RESTFUL适用于移动互联网厂商作为业务接口的场景，实现第三方OTT调用移动网络资源的功能，动作类型为新增、变更、删除所调用资源。
(主要是避免代码的冗余，将动词和名词拆分)

HTTP动词

Get(select): 查
Post(create) : 增
Put(update) : 改
Delete(delete) : 删

名词举例

名词要用复数形式
Get /users
Post /users
Put /users/id
Delete /users/id

常用状态码

200 - 执行成功
201 - 修改或创建成功
204 - 用户数据删除成功
400 - 请求错误，无新建或修改
401 - 没有权限
403 - 有权限，但是禁止访问
404 - 请求记录不存在
500 - 服务器发生错误

 /**
     * 插入一个用户对象
     *
     * @param user 待插入的对象，ID为0或者null
     * @return 插入后的对象，一般来说id会更新
     */
    @PostMapping
    public ResponseEntity<User> insert(@RequestBody User user) {
        User result = userService.insert(user);// addUsers = add(动词crud) -> http method 代替动词 + User(名词)
        if (result.getId() == null || result.getId() == 0) {
            return ResponseEntity.status(400).body(result);
        } else {
            return ResponseEntity.ok(result);
        }
    }