Java / Spring:如何快速生成整个数据库CRUD REST API


随着时间的流逝,Spring框架已成为Java中使用最广泛的Web开发框架之一,这一点显而易见。在接下来的十年中,Spring最受欢迎的模块Spring Boot刚刚进行了重大更新。 新的Spring Boot版本“ 2.2.0”和年份“ 2020”几乎完美匹配。因此,Speedment团队现在通过改进Spring Boot插件填补了这一空白。

如果这是您第一次了解Speedment,那么您将大饱口福,因为我们将演示Speedment Spring Boot插件如何使开发人员轻松地使用Speedment构建Spring数据库应用程序,Speedment是一个具有基于Stream的强大查询API的ORM ,作为其骨干。

关于速度 速度可以描述为Java社区应得的ORM,这是适合那些喜欢快速开发甚至更快的应用程序的人的工具包。通过利用Java Stream API作为与您选择的数据库进行通信的主要方式,Speedment使具有Java经验的开发人员感到宾至如归。除了易于使用的API外,Speedment还为开发人员提供了图形化工具,可在几秒钟内为他们生成域模型。

如果您总体上对Speedment感兴趣,请访问以下链接,以获取 带有示例的详细文档。本文的其余部分将重点介绍Spring Boot插件。

您可能还会喜欢: 如何使用Spring Boot创建REST API Speedment Spring Boot插件已经存在了一段时间,但是从Speedment 3.2.2开始引入了一个主要功能-能够直接从数据库模型生成完整的CRUD REST API的功能。

步骤取决于您是从头开始还是已有项目,步骤会有所不同,但是请放心,无论您的项目状态如何,集成过程都是毫不费力的。

如果您希望将Spring Boot集成到现有的Speedment项目中,则需要在pom.xml中添加以下2个子句:

<plugin>
    <groupId>com.speedment.enterprise</groupId>
    <artifactId>speedment-enterprise-maven-plugin</artifactId>
    <version>${speedment.version}</version>

    <configuration>
        <components>
            <component>com.speedment.enterprise.plugins.spring.SpringGeneratorBundle</component>
        </components>
        <appName>${project.artifactId}</appName>
        <packageName>${project.groupId}</packageName>
    </configuration>
    ... // Database connector dependency           
</plugin>
<dependencies>
 ...
<dependency>
    <groupId>javax.annotation</groupId>
    <artifactId>javax.annotation-api</artifactId>
    <version>1.3.1</version>
</dependency>
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
    <version>2.2.1.RELEASE</version>
</dependency>
<dependency>
    <groupId>com.speedment.enterprise.plugins</groupId>
    <artifactId>spring-runtime</artifactId>
    <version>${speedment.version}</version>
</dependency>
...
</dependencies>

添加后,下次重新生成域模型时,应生成特定于Speedment的Spring配置。生成的配置为Speedment生成的各种管理器处理数据库连接属性和Bean注册。

如果您是从头开始,请转到项目初始化程序,为您生成一个Spring-Boot-ready项目。如何配置项目取决于您自己,但是要在生成的项目中包括Spring Boot插件,请确保选中了Plugins部分中Spring旁边的复选框。对项目配置满意后,单击“下载”按钮,您将收到一个准备好使用的压缩项目。

at 14.38.37.png

CRUD Made Easy 安装插件后,Speedment工具中将提供一些特定于Spring Boot的选项,可用于配置REST API。您可以通过发出以下命令来启动Speedment工具:

mvn speedment:tool

如果这是您第一次使用Speedment,则可能需要遵循“ Hello Speedment”快速入门指南来熟悉工作流程。

默认情况下,Speedment工具不会生成REST API。要为特定表生成CRUD REST API,请在树视图中选择该表,然后选中“ Generate @RestController”选项和“ REST Enable Create / Update / Delete”选项。通过单击“生成”,将生成一组为特定表实施CRUD操作的REST映射。

14.46.35.png

就是这样!无需手动编码。只需发出以下命令来启动生成的Spring:

爪哇 1个 mvn spring - boot:运行

使用REST创建实体 要使用生成的REST API创建新实体,必须对工具中指定的路由执行POST请求。默认情况下,此路由的名称与表的名称相同,并以模式名称为前缀。如果取消选中“ REST Endpoint”选项,则可以指定自定义路由名称。请求主体应在JSON对象中包含键值对,其中该工具的“ REST字段名称”值是键。

如果我们要创建一个名为“ person”的表,其中包含“ id”,“ name”和“ age”列,我们将发送以下请求以创建一个新的“ person”实体:

POST localhost:8080/db/person
{
    "id": 1,
    "name": "Jane",
    "age": 25
}
curl -d '{"id": 1,"name": "Jane","age": 25}' -H "Content-Type:application/json" -X POST localhost:8080/db/person

如果列是自动生成的(或正在使用序列),则可以将其从POST正文中排除。如果要强制从POST正文中排除某些列,请在工具树视图中单击特定列,然后取消选中“包括在创建正文中”并重新生成域模型。另一方面,如果要在执行请求时强制POST正文中存在某个列,请选中“在创建正文中是必需的”并重新生成域模型。

22.png

使用REST检索实体 要检索我们新创建的实体,我们必须在用于实体创建的同一路径上执行GET请求:

GET localhost:8080/db/person
curl localhost:8080/db/person/1

执行的请求将返回所有现有实体的JSON数组。在我们的例子中,它将返回一个仅包含我们唯一实体的数组:

[
2
    {
3
        "id": 1,
4
        "name": "Jane",
5
        "age": 25
6
    }
7
]

正式的Speedment文档中详细介绍了过滤器和分类器等高级概念。

使用REST更新现有实体 使用REST API更新现有实体的方式与创建实体的方式类似。代替POST请求,我们执行PATCH请求,并且通过实体标识符扩展路由。我们的实体标识符取决于该表的“主键”列。由于我们的PK列是数字类型,因此我们的实体标识符将是整数。

要更新在上一个示例中创建的实体,我们将执行以下请求:

PATCH localhost:8080/db/person/1
{
    "name": "Mike",
    "age": 43
}
curl -d '{"name": "Jane","age": 25}' -H "Content-Type:application/json" -X PATCH localhost:8080/db/person/1

默认情况下,所有列都包含在PATCH主体中(“主键”列除外),但是它们不是强制性的。如果要强制从请求正文中排除某些列,请在工具树视图中单击特定列,然后取消选中“包含在更新正文中”并重新生成域模型。另一方面,如果要在请求正文中强制列存在,请选中“在更新正文中是必需的”并重新生成域模型。

使用REST删除实体 使用您的REST API删除实体非常简单-我们在用于实体更新的同一路径上执行DELETE请求。

要删除我们在前面的示例中创建和更新的实体,我们将执行以下请求:

DELETE localhost:8080/db/person/1
curl -X DELETE localhost:8080/db/person/1

概括 启动新项目有时会很麻烦。作为开发人员,我们希望尽可能避免这些不便,并直接涉足编码。借助Speedment的新Spring Boot插件,开发人员可以直接从数据库中自动生成所有必需的配置和REST控制器,从而领先于游戏。

我们希望您喜欢Speedment Spring Boot插件提供的有关新CRUD功能的简短指南。如果您对新功能的更详细说明感兴趣,请转至官方文档,您将在其中找到有关CRUD新功能的深入说明和示例。


原文链接:https://codingdict.com/