Spring MVC 教程
首页 死磕 Java 优质系列 Java 技术总览 Java 面试宝典 关于我

Spring MVC RESTful风格开发

转
 2022-08-20  阅读(43)
©版权

1 什么是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 并没有一个明确的标准， 而更像是一种设计的风格。REST 其核心价值在于如何设计出符合 REST 风格的网络接口。 基于这个风格设计的软件可以更简洁， 更有层次， 更易于实现缓存等机制。

简单地说：使用RESTful风格可以让我们客户端与服务端访问的URL更加简洁方便！

以下给出两个例子，前者没有采用RESTful风格，后者采用RESTful风格。

没有采用RESTful风格的URL ：

  • 增加： http://localhost:8080/user?method=add
  • 修改： http://localhost:8080/user?method=update
  • 删除： http://localhost:8080/user?method=delete
  • 查询： http://localhost:8080/user?method=find

采用RESTful风格的URL ：

  • 增加： http://localhost:8080/user （使用POST请求）
  • 修改： http://localhost:8080/user/1 （使用PUT请求）
  • 删除： http://localhost:8080/user/1 （使用DELETE请求）
  • 查询： http://localhost:8080/user （使用GET请求）

对比发现，RESTful风格更加简洁，RESTful主要依靠不同的请求方法来区分不同操作类型，这个与传统URL最大的区别。

2 Spring MVC开发RESTful应用

2.1 配置请求方式转换过滤器

为了在前端模拟出不同的请求方式，需要引入SpringMVC提供的HiddenHttpMethodFilter。

            
            <!-- 转换请求方式的过滤器 -->
            <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>

2.2 设计页面

            
            <%@ page contentType="text/html;charset=UTF-8" language="java" %>
            <html>
            <head>
                <title>一点教程网-Spring MVC进行RESTful风格开发</title>
                <script src="/js/jquery-3.3.1.min.js"></script>
            </head>
            <body>
            
            <!--增加 -->
            <form action="/rest" method="post">
                <input type="submit" value="增加">
            </form>
            
            <!--查询 -->
            <form action="/rest" method="get">
                <input type="submit" value="查询">
            </form>
            
            <!--修改 -->
            <form action="/rest/1" method="post">
                <input type="hidden" name="_method" value="put">
                <input type="submit" value="修改">
            </form>
            
            <!--删除 -->
            <form action="/rest/1" method="post">
                <input type="hidden" name="_method" value="delete">
                <input type="submit" value="删除">
            </form>
            </body>
            </html>

2.3 控制器接收RESTful请求

            
            package com.yiidian.controller;
            import com.yiidian.domain.User;
            import org.springframework.stereotype.Controller;
            import org.springframework.ui.Model;
            import org.springframework.ui.ModelMap;
            import org.springframework.web.bind.annotation.*;
            
            /**
             *  演示RESTful风格的开发
             * 一点教程网 - www.yiidian.com
             */
            @Controller
            @RequestMapping("/rest")
            public class RestfulController {
            
                /**
                 * 增加
                 */
                @RequestMapping(method= RequestMethod.POST)
                @ResponseBody
                public String save(){
                    System.out.println("增加...");
                    return "success";
                }
            
                /**
                 * 查询
                 */
                @RequestMapping(method= RequestMethod.GET)
                @ResponseBody
                public String find(){
                    System.out.println("查询...");
                    return "success";
                }
            
            
                /**
                 * 修改
                 */
                @RequestMapping(value = "/{id}",method= RequestMethod.PUT)
                @ResponseBody
                public String update(@PathVariable("id") Integer id){
                    System.out.println("修改...id="+id);
                    return "success";
                }
            
            
                /**
                 * 删除
                 */
                @RequestMapping(value="/{id}",method= RequestMethod.DELETE)
                @ResponseBody
                public String delete(@PathVariable("id") Integer id){
                    System.out.println("删除...id="+id);
                    return "success";
                }
            }

这里有几个注意点：

  1. 为了接收RESTful请求，使用method属性指定对应的请求方式
  2. 使用@PathVariable注解接收RESTful请求的参数
  3. RESTful风格的请求处理完毕后，通常@ResponseBody注解把数据转换为Json返回，尽量不要转发或重定向页面，因为页面不支持PUT和DELETE请求。

2.4 springmvc.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:mvc="http://www.springframework.org/schema/mvc"
                   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/mvc http://www.springframework.org/schema/mvc/spring-mvc.xsd http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context.xsd">
            
                <!-- 1.扫描Controller的包-->
                <context:component-scan base-package="com.yiidian.controller"/>
            
                <!-- 2.配置视图解析器 -->
                <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
                    <!-- 2.1 页面前缀 -->
                    <property name="prefix" value="/pages/"/>
                    <!-- 2.2 页面后缀 -->
                    <property name="suffix" value=".jsp"/>
                </bean>
            
                <!-- 3.创建处理器适配器和处理器映射器-->
                <mvc:annotation-driven/>
            
                <!--静态资源处理-->
                <mvc:default-servlet-handler/>
            </beans>

2.5 运行测试

202202131335022431.png

分别点击每个按钮，控制台输出效果如下：

202202131335027212.png

源码下载：https://pan.baidu.com/s/1ivAFle-44IRd482FyaT9lQ

Java 面试宝典是大明哥全力打造的 Java 精品面试题，它是一份靠谱、强大、详细、经典的 Java 后端面试宝典。它不仅仅只是一道道面试题，而是一套完整的 Java 知识体系，一套你 Java 知识点的扫盲贴。

它的内容包括：

  • 大厂真题：Java 面试宝典里面的题目都是最近几年的高频的大厂面试真题。
  • 原创内容：Java 面试宝典内容全部都是大明哥原创，内容全面且通俗易懂，回答部分可以直接作为面试回答内容。
  • 持续更新：一次购买，永久有效。大明哥会持续更新 3+ 年，累计更新 1000+，宝典会不断迭代更新，保证最新、最全面。
  • 覆盖全面：本宝典累计更新 1000+，从 Java 入门到 Java 架构的高频面试题，实现 360° 全覆盖。
  • 不止面试：内容包含面试题解析、内容详解、知识扩展，它不仅仅只是一份面试题，更是一套完整的 Java 知识体系。
  • 宝典详情：https://www.yuque.com/chenssy/sike-java/xvlo920axlp7sf4k
  • 宝典总览：https://www.yuque.com/chenssy/sike-java/yogsehzntzgp4ly1
  • 宝典进展：https://www.yuque.com/chenssy/sike-java/en9ned7loo47z5aw

目前 Java 面试宝典累计更新 400+ 道，总字数 42w+。大明哥还在持续更新中，下图是大明哥在 2024-12 月份的更新情况：

想了解详情的小伙伴，扫描下面二维码加大明哥微信【daming091】咨询

同时，大明哥也整理一套目前市面最常见的热点面试题。微信搜[大明哥聊 Java]或扫描下方二维码关注大明哥的原创公众号[大明哥聊 Java] ，回复【面试题】 即可免费领取。

阅读全文
文章标签： Spring MVC 入门Spring MVC 实战Spring MVC