第四十章：Spring MVC框架之REST架构风格07

版权声明：作者：java_wxid https://blog.csdn.net/java_wxid/article/details/84666635

第一节 REST简介
1.概念
Representational State Transfer——表现层（资源）状态转化。是目前最流行的一种互联网软件架构风格。它倡导结构清晰、符合标准、易于理解、扩展方便的Web架构体系，主张严格按照HTTP协议中定义的规范设计结构严谨的Web应用架构体系。由于REST所倡导的理念让Web应用更易于开发和维护，更加优雅简洁，所以正得到越来越多网站的采用。
资源（Resources）：网络上的一个实体，或者说是网络上的一个具体信息。它可以是一段文本、一张图片、一首歌曲、一种服务，总之就是一个具体的存在。可以用一个URI（统一资源定位符）指向它，每种资源对应一个特定的 URI 。要获取这个资源，访问它的URI就可以，因此 URI 即为每一个资源的独一无二的识别符。

表现层（Representation）：把资源具体呈现出来的形式，叫做它的表现层（Representation）。比如，文本可以用txt格式表现，也可以用HTML格式、XML格式、JSON格式表现，甚至可以采用二进制格式。

状态转化（State Transfer）：每发出一个请求，就代表了客户端和服务器的一次交互过程。HTTP协议，是一个无状态协议，即所有的状态都保存在服务器端。因此，如果客户端想要操作服务器，必须通过某种手段，让服务器端发生“状态转化”（State Transfer）。而这种转化是建立在表现层之上的，所以就是 “表现层状态转化”。具体说，就是 HTTP 协议里面，四个表示操作方式的动词：GET、POST、PUT、DELETE。它们分别对应四种基本操作：GET 用来获取资源，POST 用来新建资源，PUT 用来更新资源，DELETE 用来删除资源。

请求方式 作用
GET          查询
POST        保存
PUT          更新
DELETE     删除

2.REST风格的URL

REST风格要求我们不要再使用问号键值对的方式携带请求参数，而是从URL地址中获取。下面我们进行一下对比：

3.REST风格URL的好处
①含蓄，安全

使用问号键值对的方式给服务器传递数据太明显，容易被人利用来对系统进行破坏。使用REST风格携带数据不再需要明显的暴露数据的名称。
②风格统一

URL地址整体格式统一，从前到后始终都使用斜杠划分各个内容部分，用简单一致的格式表达语义。
③无状态

在调用一个接口（访问、操作资源）的时候，可以不用考虑上下文，不用考虑当前状态，极大的降低了系统设计的复杂度。
④严谨，规范

严格按照HTTP1.1协议中定义的请求方式本身的语义进行操作。
⑤简洁，优雅

过去做增删改查操作需要设计4个不同的URL，现在一个就够了

⑥丰富的语义

通过URL地址就可以知道资源之间的关系。

http://localhost:8080/shop 
http://localhost:8080/shop/product 
http://localhost:8080/shop/product/cellPhone 
http://localhost:8080/shop/product/cellPhone/iPhone

第二节 SpringMVC对四种请求方式的支持
1.说明

受HTML的限制，只有GET请求和POST请求是可以直接生成的。为了生成PUT和DELETE请求方式我们需要借助一个过滤器：org.springframework.web.filter.HiddenHttpMethodFilter，这个过滤器可以将POST请求转换为PUT或DELETE等其他形式。
2.HiddenHttpMethodFilter的使用方法
①在web.xml中进行配置，拦截所有资源。

<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>

②在表单隐藏域中通过_method请求参数附带请求方式名称
jsp代码：

<input type="hidden" name="_method" value="put"/>

③通过点击超链接执行删除操作。

这是一个难点，超链接中没有表单隐藏域，所以需要将超链接转换为表单进行提交，这就需要借助于JavaScript。

[1]在页面上创建一个action属性为空的form表单
jsp代码：

<form method="POST">
	<input type="hidden" name="_method" value="DELETE" />
</form>

[2]给所有超链接绑定单击响应函数
jsp代码：

   <a href="${pageContext.request.contextPath}/emp/ID" class="empRemove">删除</a>

jsp中jquery代码：

$(".empRemove").click(function(){
			//※※※※※※※※※以下操作将GET请求转换为POST请求※※※※※※※※※
			//1.先获取到当前超链接原本要访问的URL地址
			//this是当前被点击的超链接的引用，是DOM对象
			var targetUrl = this.href;
	
			//2.获取负责转换请求方式的表单的jQuery对象
			var $form = $("form");
	
			//3.将表单的action属性设置为超链接的URL地址
			$form.attr("action",targetUrl );
	
			//4.提交表单
			//将表单元素封装为jQuery对象后调用submit()方法可以提交表单，相当于点击表单的提交按钮
			$form.submit();
	
			//5.超链接不跳转
			return false;
});

@PathVariable注解

通过URL地址携带的数据需要通过@PathVariable注解来获取。它的用法是：
Handled代码：

//使用@PathVariable注解将URL地址中的变量匹配出来
@RequestMapping(value="/emp/{empId}", method=RequestMethod.DELETE)
public String testPathVariable(@PathVariable("empId") String empId) {
	System.out.println("empId="+empId);
	return "redirect:/result";
}

实战代码：
项目结构

web.xml

<!-- The front controller of this Spring Web application, responsible for handling all application requests -->
	<servlet>
		<servlet-name>springDispatcherServlet</servlet-name>
		<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
		<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>

	<!-- Map all requests to the DispatcherServlet for handling -->
	<servlet-mapping>
		<servlet-name>springDispatcherServlet</servlet-name>
		<url-pattern>/</url-pattern>
	</servlet-mapping>
	
	<filter>
		<filter-name>CharacterEncodingFilter</filter-name>
		<filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
		<init-param>
			<param-name>encoding</param-name>
			<param-value>UTF-8</param-value>
		</init-param>
		<init-param>
			<param-name>forceEncoding</param-name>
			<param-value>true</param-value>
		</init-param>
	</filter>
	<filter-mapping>
		<filter-name>CharacterEncodingFilter</filter-name>
		<url-pattern>/*</url-pattern>
	</filter-mapping>
		<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>

spring-mvc.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"
	xmlns:mvc="http://www.springframework.org/schema/mvc"
	xsi:schemaLocation="http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc-4.0.xsd
		http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd
		http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-4.0.xsd">
	<!-- 包扫描 -->
	<context:component-scan base-package="com.*" />
	<!-- 加前缀后缀 -->
	<bean id="viewResolver"
		class="org.springframework.web.servlet.view.InternalResourceViewResolver">
		<property name="prefix" value="/WEB-INF/page/" />
		<property name="suffix" value=".jsp" />
	</bean>
	<!-- 保证常规资源可以访问 -->
	<mvc:annotation-driven></mvc:annotation-driven>
	<!-- 保证静态资源可以访问 -->
	<mvc:default-servlet-handler />
</beans>

index.jsp

<%@ page language="java" contentType="text/html; charset=UTF-8"
    pageEncoding="UTF-8"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Insert title here</title>
</head>
<body>
<a href="${pageContext.request.contextPath }/emp">去list页面</a>
</body>
</html>

dataList.jsp

<%@ page language="java" contentType="text/html; charset=UTF-8"
	pageEncoding="UTF-8"%>
<%@ taglib uri="http://java.sun.com/jsp/jstl/core" prefix="c"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Insert title here</title>
<script type="text/javascript" src="${pageContext.request.contextPath }/scripts/jquery-1.7.2.js"></script>
<script type="text/javascript">
	$(function(){
		$(".remove").click(function(){
			var data = $(this).parents("tr").children("td:eq(1)").text();
			var confirm = window.confirm("你确定要"+data+"删除吗？");
			if(!confirm){
				return false;
			}
			//※※※※※※※※※以下操作将GET请求转换为POST请求※※※※※※※※※
			//1.先获取到当前超链接原本要访问的URL地址
			//this是当前被点击的超链接的引用，是DOM对象
			var targetUrl = this.href;
	
			//2.获取负责转换请求方式的表单的jQuery对象
			var $form = $("form");
	
			//3.将表单的action属性设置为超链接的URL地址
			$form.attr("action",targetUrl );
	
			//4.提交表单
			//将表单元素封装为jQuery对象后调用submit()方法可以提交表单，相当于点击表单的提交按钮
			$form.submit();
	
			//5.超链接不跳转
			return false;
		});
	});
</script>
</head>
<body>
	<form method="POST">
		<input type="hidden" name="_method" value="DELETE" />
	</form>
	
	<center>
		<table>
			<c:if test="${empty requestScope.list }">
				<tr>
					<td>没有查询到数据</td>
				</tr>
			</c:if>
			<c:if test="${!empty requestScope.list }">
				<tr>
					<td>ID</td>
					<td>姓名</td>
					<td>SSN</td>
					<td>部门名称</td>
					<td colspan="2">操作</td>
				</tr>
				<c:forEach items="${requestScope.list }" var="list">
					<tr>
						<td>${list.empId}</td>
						<td>${list.empName}</td>
						<td>${list.ssn }</td>
						<td>${list.department.deptName }</td>
						<td><a href="${pageContext.request.contextPath }/emp/${list.empId}" class="remove">删除</a></td>
						<td><a href="${pageContext.request.contextPath }/emp/${list.empId}">编辑</a></td>
					</tr>
				</c:forEach>
			</c:if>
			<tr>
				<td colspan="6" align="center">
				<a href="${pageContext.request.contextPath }/emp/list">添加</a></td>
			</tr>
		</table>
	</center>
</body>
</html>

dataEdit.jsp

<%@ page language="java" contentType="text/html; charset=UTF-8"
	pageEncoding="UTF-8"%>
<%@ taglib uri="http://java.sun.com/jsp/jstl/core"  prefix="c"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Insert title here</title>
</head>
<body>
	<form action="${pageContext.request.contextPath }/emp"
		method="post">
		<input type="hidden" name="_method" value="put" />
		<input type="hidden" name="empId" value="${requestScope.emdit.empId }"/>
		<table>
			<tr>
				<td>姓名</td>
				<td><input type="text" name="empName" value="${emdit.empName }" />
				</td>
			</tr>
			<tr>
				<td>SSN</td>
				<td><input type="text" name="ssn" value="${emdit.ssn }" /></td>
			</tr>
			<tr>
				<td>所在部门</td>
				<td><select name="department.deptId">
						<c:if test="${!empty deptList }">
							<c:forEach items="${requestScope.deptList}" var="dept">
								<c:if test="${dept.deptId==requestScope.emdit.department.deptId }">
									<option value="${dept.deptId }" selected="selected">${dept.deptName }</option>
								</c:if>
								<option value="${dept.deptId }" selected="selected">${dept.deptName }</option>
							</c:forEach>
						</c:if>
				</select></td>
			</tr>
			<tr>
				<td colspan="2"><input type="submit" value="保存" /></td>
			</tr>
		</table>
	</form>
</body>
</html>

dataAdd.jsp

<%@ page language="java" contentType="text/html; charset=UTF-8"
    pageEncoding="UTF-8"%>
<%@ taglib uri="http://java.sun.com/jsp/jstl/core"  prefix="c"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Insert title here</title>
</head>
<body>
<form action="${pageContext.request.contextPath }/emp" method="post">
		<table>
			<tr>
				<td>姓名</td>
				<td>
					<input type="text" name="empName"/>
				</td>
			</tr>
			<tr>
				<td>SSN</td>
				<td>
					<input type="text" name="ssn"/>
				</td>
			</tr>
			<tr>
				<td>所在部门</td>
				<td>
					<select name="department.deptId">
						<c:if test="${empty deptList }">
							<option>部门数据查询失败！！！</option>
						</c:if>
						<c:if test="${!empty deptList }">
							<c:forEach items="${requestScope.deptList}" var="dept">
								<option value="${dept.deptId }">${dept.deptName }</option>
							</c:forEach>
						</c:if>
					</select>
				</td>
			</tr>
			<tr>
				<td colspan="2">
					<input type="submit" value="保存"/>
				</td>
			</tr>
		</table>
	</form>
</body>
</html>

DeptDao.java

package com.dao;

import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
import java.util.UUID;
import org.springframework.stereotype.Repository;
import com.pojo.Department;

@Repository
public class DeptDao {

	private static Map<String, Department> dataMap;
	private static Map<String, Department> namedMap;

	static {
		dataMap = new HashMap<>();
		namedMap = new HashMap<>();

		Department department = new Department(UUID.randomUUID().toString(), "市场部");
		dataMap.put(department.getDeptId(), department);
		namedMap.put(department.getDeptName(), department);

		department = new Department(UUID.randomUUID().toString(), "销售部");
		dataMap.put(department.getDeptId(), department);
		namedMap.put(department.getDeptName(), department);

		department = new Department(UUID.randomUUID().toString(), "行政部");
		dataMap.put(department.getDeptId(), department);
		namedMap.put(department.getDeptName(), department);

		department = new Department(UUID.randomUUID().toString(), "人事部");
		dataMap.put(department.getDeptId(), department);
		namedMap.put(department.getDeptName(), department);

		department = new Department(UUID.randomUUID().toString(), "技术部");
		dataMap.put(department.getDeptId(), department);
		namedMap.put(department.getDeptName(), department);

		department = new Department(UUID.randomUUID().toString(), "公关部");
		dataMap.put(department.getDeptId(), department);
		namedMap.put(department.getDeptName(), department);

	}

	public static Department getDeptByName(String deptName) {
		return namedMap.get(deptName);
	}

	public static Department getDeptById(String uuid) {
		return dataMap.get(uuid);
	}

	public List<Department> getDeptList() {
		return new ArrayList<>(dataMap.values());
	}
}

EmpDao.java

package com.dao;

import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
import java.util.UUID;
import org.springframework.stereotype.Repository;
import com.pojo.Department;
import com.pojo.Employee;
@Repository
public class EmpDao {
	private static Map<String, Employee> dataMap;
	static {
		dataMap = new HashMap<>();
		String empId = UUID.randomUUID().toString();
		dataMap.put(empId, new Employee(empId, "乔峰", "SSN001", DeptDao.getDeptByName("市场部")));
		
		empId = UUID.randomUUID().toString();
		dataMap.put(empId, new Employee(empId, "虚竹", "SSN002", DeptDao.getDeptByName("市场部")));
		
		empId = UUID.randomUUID().toString();
		dataMap.put(empId, new Employee(empId, "段誉", "SSN003", DeptDao.getDeptByName("市场部")));
		
		empId = UUID.randomUUID().toString();
		dataMap.put(empId, new Employee(empId, "鸠摩智", "SSN004", DeptDao.getDeptByName("技术部")));
		
		empId = UUID.randomUUID().toString();
		dataMap.put(empId, new Employee(empId, "萧远山", "SSN005", DeptDao.getDeptByName("技术部")));
		
		empId = UUID.randomUUID().toString();
		dataMap.put(empId, new Employee(empId, "慕容复", "SSN006", DeptDao.getDeptByName("技术部")));
		
		empId = UUID.randomUUID().toString();
		dataMap.put(empId, new Employee(empId, "段正淳", "SSN007", DeptDao.getDeptByName("公关部")));
		
		empId = UUID.randomUUID().toString();
		dataMap.put(empId, new Employee(empId, "段延庆", "SSN008", DeptDao.getDeptByName("公关部")));
		
		empId = UUID.randomUUID().toString();
		dataMap.put(empId, new Employee(empId, "丁春秋", "SSN009", DeptDao.getDeptByName("销售部")));
		
		empId = UUID.randomUUID().toString();
		dataMap.put(empId, new Employee(empId, "无崖子", "SSN010", DeptDao.getDeptByName("人事部")));
		
		empId = UUID.randomUUID().toString();
		dataMap.put(empId, new Employee(empId, "慕容博", "SSN011", DeptDao.getDeptByName("人事部")));
	}
	
	public void saveEmp(Employee employee) {
		
		String empId = UUID.randomUUID().toString();
		employee.setEmpId(empId);
		
		String deptId = employee.getDepartment().getDeptId();
		Department department = DeptDao.getDeptById(deptId);
		employee.setDepartment(department);
		
		dataMap.put(empId, employee);
	}
	
	public void removeEmp(String empId) {
		dataMap.remove(empId);
	}
	
	public void updateEmp(Employee employee) {
		
		String deptId = employee.getDepartment().getDeptId();
		Department department = DeptDao.getDeptById(deptId);
		employee.setDepartment(department);
		
		dataMap.put(employee.getEmpId(), employee);
	}
	
	public Employee getEmpById(String empId) {
		return dataMap.get(empId);
	}
	
	public List<Employee> getEmpList() {
		return new ArrayList<>(dataMap.values());
	}

}

Department

package com.pojo;

public class Department {

	private String deptId;
	private String deptName;
	public Department() {
		
	}
	public Department(String deptId, String deptName) {
		super();
		this.deptId = deptId;
		this.deptName = deptName;
	}
	public String getDeptId() {
		return deptId;
	}
	public void setDeptId(String deptId) {
		this.deptId = deptId;
	}
	public String getDeptName() {
		return deptName;
	}
	public void setDeptName(String deptName) {
		this.deptName = deptName;
	}
	@Override
	public String toString() {
		return "Department [deptId=" + deptId + ", deptName=" + deptName + "]";
	}
	
}

Employee

package com.pojo;

public class Employee {

	private String empId;
	private String empName;
	private String ssn;
	private Department department;
	public Employee(String empId, String empName, String ssn, Department department) {
		super();
		this.empId = empId;
		this.empName = empName;
		this.ssn = ssn;
		this.department = department;
	}
	public Employee() {
	}
	public String getEmpId() {
		return empId;
	}
	public void setEmpId(String empId) {
		this.empId = empId;
	}
	public String getEmpName() {
		return empName;
	}
	public void setEmpName(String empName) {
		this.empName = empName;
	}
	public String getSsn() {
		return ssn;
	}
	public void setSsn(String ssn) {
		this.ssn = ssn;
	}
	public Department getDepartment() {
		return department;
	}
	public void setDepartment(Department department) {
		this.department = department;
	}
	@Override
	public String toString() {
		return "Employee [empId=" + empId + ", empName=" + empName + ", ssn=" + ssn + ", department=" + department
				+ "]";
	}
	
}

Services

package com.services;

import java.util.List;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;
import com.dao.DeptDao;
import com.dao.EmpDao;
import com.pojo.Department;
import com.pojo.Employee;

@Service
public class Services {
	@Autowired
	private DeptDao deptDao;
	@Autowired
	private EmpDao empDao;
	
	public List<Department> deptDaoList(){
		return deptDao.getDeptList();
	};
	
	public List<Employee> empDaoList(){
		return empDao.getEmpList();
	}
	
	public void saveData(Employee employee) {
		empDao.saveEmp(employee);
	}
	
	public void delectData(String empId) {
		empDao.removeEmp(empId);
	}
	
	public Employee emdit(String empId) {
		Employee empById = empDao.getEmpById(empId);
		return empById;
	}
	
	public void updateEmp(Employee employee) {
		empDao.updateEmp(employee);
	}

}

Handled

package com.handled;

import java.util.List;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
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 com.pojo.Department;
import com.pojo.Employee;
import com.services.Services;
import com.sun.tracing.dtrace.ProviderAttributes;

@Controller
public class Handled {

	@Autowired
	private Services services;
	@RequestMapping("/emp")
	public String toList(Model model) {
		List<Employee> empDaoList = services.empDaoList();
		model.addAttribute("list", empDaoList);
		return "dataList";
	}
	@RequestMapping("/emp/list")
	public String toAddData(Model model) {
		List<Department> deptDaoList = services.deptDaoList();
		model.addAttribute("deptList", deptDaoList);
		return "dataAdd";
	}
	@RequestMapping(value="/emp",method=RequestMethod.POST)
	public String addData(Employee employee) {
		services.saveData(employee);
		return "redirect:/emp";
	}
	@RequestMapping(value="/emp/{empId}",method=RequestMethod.DELETE)
	public String deleteData(@PathVariable("empId") String empId) {
		services.delectData(empId);
		return "redirect:/emp";
	}
	@RequestMapping(value="/emp/{empId}",method=RequestMethod.GET)
	public String emditData(@PathVariable("empId") String empId,Model model) {
		List<Department> deptDaoList = services.deptDaoList();
		Employee employee = services.emdit(empId);
		model.addAttribute("emdit",employee);
		model.addAttribute("deptList",deptDaoList);
		return "dataEdit";
	}
	@RequestMapping(value="/emp",method=RequestMethod.PUT)
	public String subemdData(Employee employee) {
		services.updateEmp(employee);
		return "redirect:/emp";
	}
}