跟松哥学 Spring Boot
首页 死磕 Java 优质系列 Java 技术总览 Java 面试宝典 关于我

Spring Boot 中 10 行代码构建 RESTful 风格应用

转
 2023-01-07  阅读(1)
©版权
原文作者：江南一点雨 原文地址：http://springboot.javaboy.org

RESTful ，到现在相信已经没人不知道这个东西了吧！关于 RESTful 的概念，我这里就不做过多介绍了，传统的 Struts 对 RESTful 支持不够友好 ，但是 SpringMVC 对于 RESTful 提供了很好的支持，常见的相关注解有：

    @RestController
    @GetMapping
    @PutMapping
    @PostMapping
    @DeleteMapping
    @ResponseBody
    ...

这些注解都是和 RESTful 相关的，在移动互联网中，RESTful 得到了非常广泛的使用。RESTful 这个概念提出来很早，但是以前没有移动互联网时，我们做的大部分应用都是前后端不分的，在这种架构的应用中，数据基本上都是在后端渲染好返回给前端展示的，此时 RESTful 在 Web 应用中基本就没用武之地，移动互联网的兴起，让我们一套后台对应多个前端项目，因此前后端分离，RESTful 顺利走上前台。

Spring Boot 继承自 Spring + SpringMVC， SpringMVC 中对于 RESTful 支持的特性在 Spring Boot 中全盘接收，同时，结合 Jpa 和 自动化配置，对于 RESTful 还提供了更多的支持，使得开发者几乎不需要写代码（很少几行），就能快速实现一个 RESTful 风格的增删改查。

接下来，松哥通过一个简单的案例，来向大家展示 Spring Boot 对于 RESTful 的支持。

实战

创建工程

首先创建一个 Spring Boot 工程，引入 Web 、 Jpa 、 MySQL 、Rest Repositories 依赖：

202301071953050431.png

创建完成后，还需要锁定 MySQL 驱动的版本以及加入 Druid 数据库连接池，完整依赖如下：

    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-data-jpa</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-data-rest</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <dependency>
            <groupId>com.alibaba</groupId>
            <artifactId>druid-spring-boot-starter</artifactId>
            <version>1.1.10</version>
        </dependency>
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <scope>runtime</scope>
            <version>5.1.27</version>
        </dependency>
    </dependencies>

配置数据库

主要配置两个，一个是数据库，另一个是 Jpa：

    spring.datasource.type=com.alibaba.druid.pool.DruidDataSource
    spring.datasource.username=root
    spring.datasource.password=root
    spring.datasource.url=jdbc:mysql:///test01
    spring.datasource.driver-class-name=com.mysql.jdbc.Driver
    spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.MySQL57Dialect
    spring.jpa.show-sql=true
    spring.jpa.hibernate.ddl-auto=update
    spring.jpa.database-platform=mysql
    spring.jpa.database=mysql

这里的配置，和 Jpa 中的基本一致。

前面五行配置了数据库的基本信息，包括数据库连接池、数据库用户名、数据库密码、数据库连接地址以及数据库驱动名称。

接下来的五行配置了 JPA 的基本信息，分别表示生成 SQL 的方言、打印出生成的 SQL 、每次启动项目时根据实际情况选择是否更新表、数据库平台是 MySQL。

这两段配置是关于 MySQL + JPA 的配置，没用过 JPA 的小伙伴可以参考松哥之前的 JPA 文章：http://www.javaboy.org/2019/0407/springboot-jpa.html

构建实体类

    @Entity(name = "t_book")
    public class Book {
        @Id
        @GeneratedValue(strategy = GenerationType.IDENTITY)
        private Long id;
        @Column(name = "book_name")
        private String name;
        private String author;
        //省略 getter/setter
    }
    public interface BookRepository extends JpaRepository<Book,Long> {
    }

这里一个是配置了一个实体类 Book，另一个则是配置了一个 BookRepository ，项目启动成功后，框架会根据 Book 类的定义，在数据库中自动创建相应的表，BookRepository 接口则是继承自 JpaRepository ，JpaRepository 中自带了一些基本的增删改查方法。

好了，代码写完了。

啥？你好像啥都没写啊？是的，啥都没写，啥都不用写，一个 RESTful 风格的增删改查应用就有了，这就是 Spring Boot 的魅力！

测试

此时，我们就可以启动项目进行测试了，使用 POSTMAN 来测试（大家也可以自行选择趁手的 HTTP 请求工具）。

此时我们的项目已经默认具备了一些接口，我们分别来看：

根据 id 查询接口

  • http://127.0.0.1:8080/books/{id}

这个接口表示根据 id 查询某一本书：

202301071953058592.png

分页查询

  • http://127.0.0.1:8080/books

这是一个批量查询接口，默认请求路径是类名首字母小写，并且再加一个 s 后缀。这个接口实际上是一个分页查询接口，没有传参数，表示查询第一页，每页 20 条数据。

202301071953067473.png

查询结果中，除了该有的数据之外，也包含了分页数据：

202301071953076574.png

分页数据中：

  1. size 表示每页查询记录数
  2. totalElements 表示总记录数
  3. totalPages 表示总页数
  4. number 表示当前页数，从0开始计

如果要分页或者排序查询，可以使用 _links 中的链接。http://127.0.0.1:8080/books?page=1&size=3&sort=id,desc 。

202301071953084855.png

添加

也可以添加数据，添加是 POST 请求，数据通过 JSON 的形式传递，如下：

202301071953093486.png

添加成功之后，默认会返回添加成功的数据。

修改

修改接口默认也是存在的，数据修改请求是一个 PUT 请求，修改的参数也是通过 JSON 的形式传递：

202301071953104617.png

默认情况下，修改成功后，会返回修改成功的数据。

删除

当然也可以通过 DELETE 请求根据 id 删除数据：

202301071953115288.png

删除成功后，是没有返回值的。

不需要几行代码，一个基本的增删改查就有了。

这些都是默认的配置，这些默认的配置实际上都是在 JpaRepository 的基础上实现的，实际项目中，我们还可以对这些功能进行定制。

查询定制

最广泛的定制，就是查询，因为增删改操作的变化不像查询这么丰富。对于查询的定制，非常容易，只需要提供相关的方法即可。例如根据作者查询书籍：

    public interface BookRepository extends JpaRepository<Book,Long> {
        List<Book> findBookByAuthorContaining(@Param("author") String author);
    }

注意，方法的定义，参数要有 @Param 注解。

定制完成后，重启项目，此时就多了一个查询接口，开发者可以通过 http://localhost:8080/books/search 来查看和 book 相关的自定义接口都有哪些：

202301071953123239.png

查询结果表示，只有一个自定义接口，接口名就是方法名，而且查询结果还给出了接口调用的示例。我们来尝试调用一下自己定义的查询接口：

2023010719531343210.png

开发者可以根据实际情况，在BookRepository中定义任意多个查询方法，查询方法的定义规则和Jpa中一模一样（不懂Jpa的小伙伴，可以参考[干货 一文读懂SpringDataJpa！](https://mp.weixin.qq.com/s/Fg5ssXuvabZwEfRMKfpY9Q)，或者在松哥个人网站www.javaboy.org上搜索JPA，有相关教程参考）。但是，这样有一个缺陷，就是Jpa中方法名太长，因此，如果不想使用方法名作为接口名，则可以自定义接口名：
开发者可以根据实际情况，在BookRepository中定义任意多个查询方法，查询方法的定义规则和Jpa中一模一样（不懂Jpa的小伙伴，可以参考[干货 一文读懂SpringDataJpa！](https://mp.weixin.qq.com/s/Fg5ssXuvabZwEfRMKfpY9Q)，或者在松哥个人网站www.javaboy.org上搜索JPA，有相关教程参考）。但是，这样有一个缺陷，就是Jpa中方法名太长，因此，如果不想使用方法名作为接口名，则可以自定义接口名： 
    public interface BookRepository extends JpaRepository<Book, Long> {
        @RestResource(rel = "byauthor",path = "byauthor")
        List<Book> findBookByAuthorContaining(@Param("author") String author);
    }

@RestResource 注解中，两个参数的含义：

  • rel 表示接口查询中，这个方法的 key
  • path 表示请求路径

这样定义完成后，表示接口名为 byauthor ，重启项目，继续查询接口：

2023010719531495611.png

除了 rel 和 path 两个属性之外，@RestResource 中还有一个属性，exported 表示是否暴露接口，默认为 true ，表示暴露接口，即方法可以在前端调用，如果仅仅只是想定义一个方法，不需要在前端调用这个方法，可以设置 exported 属性为 false 。

如果不想暴露官方定义好的方法，例如根据 id 删除数据，只需要在自定义接口中重写该方法，然后在该方法上加 @RestResource 注解并且配置相关属性即可。

    public interface BookRepository extends JpaRepository<Book, Long> {
        @RestResource(rel = "byauthor",path = "byauthor")
        List<Book> findBookByAuthorContaining(@Param("author") String author);
        @Override
        @RestResource(exported = false)
        void deleteById(Long aLong);
    }

另外生成的 JSON 字符串中的集合名和单个 item 的名字都是可以自定义的：

    @RepositoryRestResource(collectionResourceRel = "bs",itemResourceRel = "b",path = "bs")
    public interface BookRepository extends JpaRepository<Book, Long> {
        @RestResource(rel = "byauthor",path = "byauthor")
        List<Book> findBookByAuthorContaining(@Param("author") String author);
        @Override
        @RestResource(exported = false)
        void deleteById(Long aLong);
    }

path 属性表示请求路径，请求路径默认是类名首字母小写+s，可以在这里自己重新定义。

2023010719531589212.png

其他配置

最后，也可以在 application.properties 中配置 REST 基本参数：

    spring.data.rest.base-path=/api
    spring.data.rest.sort-param-name=sort
    spring.data.rest.page-param-name=page
    spring.data.rest.limit-param-name=size
    spring.data.rest.max-page-size=20
    spring.data.rest.default-page-size=0
    spring.data.rest.return-body-on-update=true
    spring.data.rest.return-body-on-create=true

配置含义，从上往下，依次是：

  1. 给所有的接口添加统一的前缀
  2. 配置排序参数的 key ，默认是 sort
  3. 配置分页查询时页码的 key，默认是 page
  4. 配置分页查询时每页查询页数的 key，默认是size
  5. 配置每页最大查询记录数，默认是 20 条
  6. 分页查询时默认的页码
  7. 更新成功时是否返回更新记录
  8. 添加成功时是否返回添加记录

总结

本文主要向大家介绍了 Spring Boot 中快速实现一个 RESTful 风格的增删改查应用的方案，整体来说还是比较简单的，并不难。相关案例我已上传到 GitHub 上了，小伙伴可以自行下载：https://github.com/lenve/javaboy-code-samples。

关于本文，有问题欢迎留言讨论。

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 Boot 入门Spring Boot 教程Spring Boot