使用Speedment和Spring创建REST API

随着Spring Boot的第4版发布，为Web开发企业应用程序变得非常容易。代表开发人员仍然需要大量时间的事情是，例如在Hibernate中对现有数据库进行建模，以获取数据的面向对象的视图。在本教程中，我们将探索如何与开源一起使用开源工具Speedment与Spring一起生成实体，管理器和控制器，从而使您可以更快地开始开发。

关于速度

Speedment是一个开放源代码Java工具包，使开发人员可以快速生成与数据库进行通信所需的所有粘合。使用图形工具，您可以在几秒钟内连接到数据库并生成Java源。与Spring一样，Speedment以模块化的方式构建，因此易于学习和仅使用您感兴趣的部分。在本文中，除了标准文件之外，我们还将使用Speedment插件来生成Spring控制器。

步骤1：创建一个新的Spring Boot项目

Spring Boot由许多模板组成，可以轻松地开始使用新应用程序。我们将使用一个称为“ spring-boot-starter-web”的框架来设置我们的Web应用程序。

首先创建一个新的Maven项目，然后将以下内容添加到“ pom.xml”文件中：

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"><modelVersion>4.0.0</modelVersion><parent><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-parent</artifactId><version>1.4.1.RELEASE</version></parent><groupId>com.github.pyknic</groupId><artifactId>speedment-spring-example</artifactId><version>1.0.0-SNAPSHOT</version><packaging>jar</packaging><properties><java.version>1.8</java.version><speedment.version>3.0.1</speedment.version><mysql.version>5.1.39</mysql.version></properties><build><plugins><plugin><groupId>org.springframework.boot</groupId><artifactId>spring-boot-maven-plugin</artifactId></plugin><plugin><groupId>com.speedment</groupId><artifactId>speedment-maven-plugin</artifactId><version>${speedment.version}</version><dependencies><dependency><groupId>mysql</groupId><artifactId>mysql-connector-java</artifactId><version>${mysql.version}</version></dependency><dependency><groupId>com.speedment.plugins</groupId><artifactId>spring-generator</artifactId><version>${speedment.version}</version></dependency></dependencies><configuration><components>                       
<component>com.speedment.plugins.spring.SpringGeneratorBundle</component></components></configuration></plugin></plugins></build><dependencies><dependency><groupId>com.speedment</groupId><artifactId>runtime</artifactId><version>${speedment.version}</version><type>pom</type></dependency><dependency><groupId>com.speedment.plugins</groupId><artifactId>spring-generator</artifactId><version>${speedment.version}</version></dependency><dependency><groupId>mysql</groupId><artifactId>mysql-connector-java</artifactId><version>${mysql.version}</version></dependency><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-web</artifactId></dependency></dependencies>
</project>

这会将您的项目配置为Spring Boot应用程序，并告诉它将Springment与Spring Generator插件一起使用。

步骤2：使用速度生成源

修改pom文件后，IDE中将提供许多新的Maven目标。速度可以图形方式使用，也可以从命令行使用。在本教程中，我们将使用UI。要启动Speedment Tool，请在项目上执行以下Maven目标：

mvn speedment:tool

将打开一个对话框，使您可以连接到数据库。连接后，您将在左侧看到一个窗口，其中概述了数据库，而在中心则显示了各种配置选项。对于本教程，默认设置就足够了，因此只需在工具栏中按“生成”即可。

如果切换回IDE，您将看到新生成的源。您会注意到每个类都有两个副本，其中一个带有“ Generated”前缀。这样做的原因是，如果您需要在某个时候重新生成源代码，则允许进行修改而没有覆盖更改的风险。具有“已生成”前缀的文件将始终被覆盖，而没有前缀的文件将仅被创建一次。

步骤3：创建一个主文件

Speedment已经生成了完整的数据库面向对象模型，但是我们仍然需要为应用程序创建一个入口点。我们将其放在主程序包中，并将其命名为Main.java。

Main.java

package com.github.pyknic.spring;import com.speedment.common.logger.Level;
import com.speedment.common.logger.LoggerManager;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;@SpringBootApplication
public class Main {public static void main(String... args) {SpringApplication.run(Main.class, args);}
}

如果我们启动应用程序，Spring Boot将为数据库中的每个表设置一个独立的Web应用程序，并为其生成一个控制器。我们可以通过在浏览器中转到以下路径来进行尝试：

http://localhost:8080/hare/

现在将返回数据库中“兔子”表的JSON表示形式。

[{"id":1, "name":"Harry", "color":"Gray", "age":3},{"id":2, "name":"Henrietta", "color":"White", "age":2},{"id":3, "name":"Henry", "color":"Black", "age":9}
]

注意＃1：如果您遇到一个异常，说明此内容…

There was an unexpected error (type=Internal Server Error, status=500). 
Could not write content: No value present (through reference chain: 
java.util.ArrayList[0]...

…这可能意味着您的数据库中有Speedment选择实现为OptionalLong，OptionalInt等的可空列。您可以通过在Speedment Tool中将“可空实现”字段设置为WRAPPER而不是那些列的OPTIONAL来关闭此功能。

注意＃2：如果您在这种样式中遇到异常，则…

java.sql.SQLException: Access denied for user 'root'@'localhost' 
(using password: YES)

…您将需要在项目的根目录中创建一个application.properties文件，并添加数据库的身份验证详细信息。

application.properties

jdbc.username=root
jdbc.password=password

摘要

在本文中，我们使用了Speedment和Spring Generator插件来自动创建完整的Spring Boot Application。 Speedment已生成用于与数据库通信的实体，管理器和REST控制器。如果您想了解有关Speedment的更多信息以及如何控制生成的代码，请在Speedment GitHub页面上查看许多示例！