使用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中关闭此功能，方法是将“ Nullable Implementation”字段设置为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页面上查看许多示例！

翻译自: https://www.javacodegeeks.com/2016/12/creating-rest-api-speedment-spring.html