阿里腾讯都在用的Restful编码风格
2020-05-14
加入收藏
Restful 风格的介绍
Restful 一种软件架构风格、设计风格，而不是标准，只是提供了一组设计原则和约束条件。它主要用于客户端和服务器交互类的软件。基于这个风格设计的软件可以更简洁，更有层次，更易于实现缓存等机制。
REST（英文：Representational State Transfer，简称REST）描述了一个架构样式的网络系统，比如 web 应用程序。它首次出现在 2000 年 Roy Fielding 的博士论文中，他是 HTTP 规范的主要编写者之一。在目前主流的三种Web服务交互方案中，REST相比于SOAP（Simple Object Access protocol，简单对象访问协议）以及XML-RPC更加简单明了，无论是对URL的处理还是对Payload的编码，REST都倾向于用更加简单轻量的方法设计和实现。值得注意的是REST并没有一个明确的标准，而更像是一种设计的风格。
看总结简单明了
Restful是一种设计风格。对于我们Web开发人员来说。就是使用一个url地址表示一个唯一的资源。然后把原来的请求参数加入到请求资源地址中。然后原来请求的增，删，改，查操作。改为使用HTTP协议中请求方式GET、POST、PUT、DELETE表示
使用Restful风格，这里需要明确一下几点
1. 就是把传统的请求参数加入到请求地址是什么样子？
传统的方式是：
比如：http://ip:port/工程名/资源名?请求参数
举例：http://127.0.0.1:8080/springmvc/user?action=delete&id=1
Restful风格是：
比如：http://ip:port/工程名/资源名/请求参数/请求参数
举例：http://127.0.0.1:8080/springmvc/user/1
2. Restful风格中请求方式GET、POST、PUT、DELETE分别表示查、增、改、删。
SpringMVC中如何发送GET请求、POST请求、PUT请求、DELETE请求。
我们知道发起 GET 请求和 POST 请求，只需要在表单的 form 标签中，设置 method ="get" 就是GET请求。
设置 form 标签的method="post"。就会发起 POST 请求。而 PUT 请求和 DELETE 请求。
- 要有 post 请求的 form 标签
- 在 form 表单中，添加一个额外的隐藏域 _method ="PUT" 或 _method = "DELETE"
- 在web.xml中配置一个Filter过滤器org.springframework.web.filter.HiddenHttpMethodFilter（注意，这个Filter一定要在处理乱码的Filter后面 ）
简单代码实现
1. RestController.JAVA
package com.spring.mvc.controller;
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.servlet.ModelAndView;
/**
* Restful风格的 Controller
* Created by YongXin Xue on 2020/05/12 9:55
*/
@Controller
public class RestController {
///// restful风格中请求方式GET、POST、PUT、DELETE分别表示查、增、改、删。
/**
* @PathVariable 路径参数获取
* value = "/queryUserById/{id}" 中的 {id} 表示路径参数 ,表示一个可变的值。 {id} 里面的 id 是变量的名称
*
* @PathVariable("id") Integer id 表示把指定 id 的路径参数值，赋给方法参数id。
* [ 也可以设置多个值 ] 如下 : Integer id; String name;
*/
@RequestMapping(value = "/queryUserById/{id}/{name}", method = RequestMethod.GET)
public ModelAndView queryUserById(@PathVariable("id") Integer id,
@PathVariable("name") String name){
System.out.println(" 查询一条用户记录信息!! " + id + name);
// redirect 到 index.jsp 页面
return new ModelAndView("/index.jsp");
}
@RequestMapping(value = "/queryUserList", method = RequestMethod.GET)
public ModelAndView queryUserList() {
System.out.println(" 查询全部用户记录信息!! ");
// redirect 到 index.jsp 页面
return new ModelAndView("redirect:/index.jsp");
}
@RequestMapping(value = "/saveUser", method = RequestMethod.POST)
public ModelAndView saveUser() {
System.out.println(" 保存用户记录信息!! ");
// redirect 到 index.jsp 页面
return new ModelAndView("redirect:/index.jsp");
}
@RequestMapping(value = "/updateUser/1", method = RequestMethod.PUT)
public ModelAndView updateUser() {
System.out.println(" 更新用户记录信息!! ");
// redirect 到 index.jsp 页面
return new ModelAndView("/index.jsp");
}
@RequestMapping(value = "/deleteUserById/1", method = RequestMethod.DELETE)
public ModelAndView deleteUserById() {
System.out.println(" 删除用户记录信息!! ");
// redirect 到 index.jsp 页面
return new ModelAndView("redirect:/index.jsp");
}
}
2. spring-mcv.xml
<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:context="http://www.springframework.org/schema/context"
xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd http://www.springframework.org/schema/context https://www.springframework.org/schema/context/spring-context.xsd">
<!-- 包扫描 -->
<context:component-scan base-package="com.spring.mvc"/>
</beans>
3. web.xml
<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_4_0.xsd"
version="4.0">
<!-- 配置前端控制器 -->
<servlet>
<servlet-name>DispatcherServlet</servlet-name>
<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
<!-- 配置 SpringMVC 的容器配置文件路径 -->
<init-param>
<param-name>contextConfigLocation</param-name>
<param-value>classpath:spring-mvc.xml</param-value>
</init-param>
<load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>DispatcherServlet</servlet-name>
<url-pattern>/</url-pattern>
</servlet-mapping>
<!-- 中配置 Restful 的 Filter 过滤器用来识别 PUT 和 DELETE 请求 -->
<filter>
<filter-name>HiddenHttpMethodFilter</filter-name>
<filter-class>org.springframework.web.filter.HiddenHttpMethodFilter</filter-class>
</filter>
<filter-mapping>
<filter-name>HiddenHttpMethodFilter</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
</web-app>
4. index.jsp
<%--
Created by YongXin Xue on 2020/05/12 9:52
--%>
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
<title>Restful 风格</title>
</head>
<body>
<h2>Restful ADN CRUD</h2>
<h3><a href="${pageContext.request.contextPath}/queryUserById/290/lance">查询一条用户记录</a></h3>
<h3><a href="${pageContext.request.contextPath}/queryUserList">查询全部用户记录</a></h3>
<form action="${pageContext.request.contextPath}/saveUser" method="post">
<input type="submit" value="保存用户">
</form>
<%--
如何发送 PUT请求,和 DELETE 请求
1. 首先要有一个 post 请求的表单
2. 要有一个隐藏域
<input type="hidden" name="_method" value="PUT">
<input type="hidden" name="_method" value="DELETE">
3. 在 web.xml 中配置 Restful 的 Filter 过滤器用来识别 PUT 和 DELETE 请求
--%>
<form action="${pageContext.request.contextPath}/updateUser/1" method="post">
<input type="hidden" name="_method" value="PUT">
<input type="submit" value="更新用户">
</form>
<form action="${pageContext.request.contextPath}/deleteUserById/1" method="post">
<input type="hidden" name="_method" value="DELETE">
<input type="submit" value="删除用户">
</form>
</body>
</html>
