标签：return HttpStatus 接口 详解 user ResponseEntity import RESTful id

REST是英文representational state transfer(表象性状态转变)或者表述性状态转移;Rest是web服务的一种架构风格;使用HTTP,URI,XML,JSON,HTML等广泛流行的标准和协议;轻量级,跨平台,跨语言的架构设计;它是一种设计风格,不是一种标准,是一种思想

Rest架构的主要原则：

• 网络上的所有事物都被抽象为资源
• 每个资源都有一个唯一的资源标识符
• 同一个资源具有多种表现形式(xml,json等)
• 对资源的各种操作不会改变资源标识符
• 所有的操作都是无状态的

符合REST原则的架构方式即可称为RESTful

什么是Restful:

对应的中文是rest式的;Restful web service是一种常见的rest的应用,是遵守了rest风格的web服务;
rest式的web服务是一种ROA(The Resource-Oriented Architecture)(面向资源的架构).

为什么会出现Restful

• 在Restful之前的操作：
  http://127.0.0.1/user/query/1 GET 根据用户id查询用户数据
  http://127.0.0.1/user/save POST 新增用户
  http://127.0.0.1/user/update POST 修改用户信息
  http://127.0.0.1/user/delete/1 GET/POST 删除用户信息

• RESTful用法：
  http://127.0.0.1/user/1 GET 根据用户id查询用户数据
  http://127.0.0.1/user POST 新增用户
  http://127.0.0.1/user PUT 修改用户信息
  http://127.0.0.1/user DELETE 删除用户信息

之前的操作是没有问题的,大神认为是有问题的,
有什么问题呢?你每次请求的接口或者地址,都在做描述,例如查询的时候用了query,新增的时候用了save,其实完全没有这个必要,
我使用了get请求,就是查询.使用post请求,就是新增的请求,我的意图很明显,完全没有必要做描述,这就是为什么有了restful.

如何使用:

SpringMVC实现restful服务:

SpringMVC原生态的支持了REST风格的架构设计

所涉及到的注解:

---@RequestMapping
---@PathVariable
---@ResponseBody

package cn.itcast.mybatis.controller;

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.ResponseBody;

import cn.itcast.mybatis.pojo.User;
import cn.itcast.mybatis.service.NewUserService;

@RequestMapping("restful/user")
@Controller
public class RestUserController {

@Autowired
private NewUserService newUserService;

/**
 * 根据用户id查询用户数据
 * 
 * @param id
 * @return
 */
@RequestMapping(value = "{id}", method = RequestMethod.GET)
@ResponseBody
public ResponseEntity<User> queryUserById(@PathVariable("id") Long id) {
    try {
        User user = this.newUserService.queryUserById(id);
        if (null == user) {
            // 资源不存在，响应404
            return ResponseEntity.status(HttpStatus.NOT_FOUND).body(null);
        }
        // 200
        // return ResponseEntity.status(HttpStatus.OK).body(user);
        return ResponseEntity.ok(user);
    } catch (Exception e) {
        e.printStackTrace();
    }
    // 500
    return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body(null);
}

/**
 * 新增用户
 * 
 * @param user
 * @return
 */
@RequestMapping(method = RequestMethod.POST)
public ResponseEntity<Void> saveUser(User user) {
    try {
        this.newUserService.saveUser(user);
        return ResponseEntity.status(HttpStatus.CREATED).build();
    } catch (Exception e) {
        // TODO Auto-generated catch block
        e.printStackTrace();
    }
    // 500
    return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body(null);
}

/**
 * 更新用户资源
 * 
 * @param user
 * @return
 */
@RequestMapping(method = RequestMethod.PUT)
public ResponseEntity<Void> updateUser(User user) {
    try {
        this.newUserService.updateUser(user);
        return ResponseEntity.status(HttpStatus.NO_CONTENT).build();
    } catch (Exception e) {
        e.printStackTrace();
    }
    // 500
    return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body(null);
}

/**
 * 删除用户资源
 * 
 * @param user
 * @return
 */
@RequestMapping(method = RequestMethod.DELETE)
public ResponseEntity<Void> deleteUser(@RequestParam(value = "id", defaultValue = "0") Long id) {
    try {
        if (id.intValue() == 0) {
            // 请求参数有误
            return ResponseEntity.status(HttpStatus.BAD_REQUEST).build();
        }
        this.newUserService.deleteUserById(id);
        // 204
        return ResponseEntity.status(HttpStatus.NO_CONTENT).build();
    } catch (Exception e) {
        e.printStackTrace();
    }
    // 500
    return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body(null);
}
}

HTTP相应状态码:

那么Restful 接口的缺点是什么呢？欢迎讨论
转载自 https://www.jianshu.com/p/7893169a7c93

标签：return,HttpStatus,接口,详解,user,ResponseEntity,import,RESTful,id
来源： https://www.cnblogs.com/SmallVillageChief/p/16214833.html

本站声明： 1. iCode9 技术分享网（下文简称本站）提供的所有内容，仅供技术学习、探讨和分享；
2. 关于本站的所有留言、评论、转载及引用，纯属内容发起人的个人观点，与本站观点和立场无关；
3. 关于本站的所有言论和文字，纯属内容发起人的个人观点，与本站观点和立场无关；
4. 本站文章均是网友提供，不完全保证技术分享内容的完整性、准确性、时效性、风险性和版权归属；如您发现该文章侵犯了您的权益，可联系我们第一时间进行删除；
5. 本站为非盈利性的个人网站，所有内容不会用来进行牟利，也不会利用任何形式的广告来间接获益，纯粹是为了广大技术爱好者提供技术内容和技术思想的分享性交流网站。