如何使用Spring Boot，Spring Data和H2 DB实现REST API

在本文中，我们将讨论Kotlin。 我在Kotlin中使用Spring Boot，Spring Data和H2内存数据库开发了一个非常简单的REST API。

Kotlin和Spring Boot很好地协同工作。

您将在代码演练部分中注意到项目中没有控制器和NO服务类。 这是Spring的魔力，   @RepositoryRestResource 下面将进一步解释。

我没有Kotlin的经验，但我在GitHub项目中阅读和看到的Kotlin代码绝对值得探索。

您可能会问的一个重要问题是：为什么Kotlin？

为何选择Kotlin？ 

• Kotlin编译为字节码，因此它可以像Java一样运行。

• Kotlin比Java更简洁。

• Kotlin的类比   Data   Java的 value   类 更简洁   。

• 默认情况下，类是final，对应于Effective Java Item 17 -  如果要使类可继承，则 需要显式   打开  。

• 默认情况下，抽象类是打开的。

• Kotlin的一个关键特性是null-safety，它在编译时干净地处理空值，而不是 NullPointerException  在运行时 碰到着名   的。 

• 主构造函数与辅助构造函数 - 如果您需要多个构造函数，那么只有您可以使用辅助构造函数。 否则，大多数Kotlin类都会有一个主构造函数。

• Kotlin也可以用作脚本语言。

• Kotlin和Java是可互操作的，所以很容易在代码库的一小部分上试用Kotlin。

• Kotlin使用积极类型推断来确定未声明类型的值和表达式的类型。 这减少了相对于Java的语言冗长度。

• Google完全支持Kotlin与他们的Android操作系统一起使用。

以下两点参考维基百科：

• “根据JetBrains的博客，Kotlin被亚马逊网络服务，Pinterest，Coursera，Netflix，Uber和其他公司使用.Corda是由知名银行财团（如高盛，富国银行，摩根大通）开发的分布式账本，德意志银行，瑞士银行，汇丰银行，法国巴黎银行，法国兴业银行（SociétéGénérale），其代码库中有超过90％的Kotlin。“

• 根据谷歌的说法，Kotlin已被几家主要开发商采用 - 例如Expedia，Flipboard，Pinterest，Square等 - 用于他们的Android制作应用程序。

代码演练

这个例子的项目代码可以在我的 Kotlin Github Repo 上找到 ，演示了一个使用Kotlin和Spring Boot的简单REST API  

克隆   - https://github.com/BeTheCodeWithYou/SpringBoot-Kotlin.git

• 科特林

• 春季启动

• 春季数据

• H2内存数据库

• 摇篮

了解build.gradle

  org.jetbrains.kotlin:kotlin-gradle-plugin    编译Kotlin源和模块。

  org.jetbrains.kotlin:kotlin-allopen  - 这是他有趣的部分。 在Kotlin中，默认情况下，所有课程都是   最终的 。 
现在，为了使类可继承，您必须使用open关键字进行批注。 而且，问题在于许多其他库，如Spring，测试库（Mockito等），这需要类和方法成为非最终的。 在Spring中，这些类主要包括   @Configuration   类和   @Bean   方法。

这里的规则很简单;  你需要注释   @Configuration   和   @Bean   方法来标记它们是开放的，但这种方法很乏味且容易出错，因此Kotlin提出了编译器插件，通过这种依赖使用 和 自动化这个过程 。   org.jetbrains.kotlin:kotlin-noarg       
  apply plugin: 'kotlin-jpa'

为了能够使用Kotlin不可变类，我们需要启用Kotlin JPA插件。 它将为任何使用@Entity注释的类生成no-arg构造函数，   apply plugin: 'kotlin'.

要定位JVM，需要应用Kotlin插件：   apply plugin: 'kotlin-spring' 。 这是Spring Kotlin集成所必需的

编译器选项

Spring可空性注释为整个Spring API提供了对Kotlin开发人员的null安全性，具有在编译时处理与null相关的问题的优势。 可以通过  -Xjsr305   使用strict选项 添加 编译器标志 来启用此功能   。 并且，它还配置Kotlin编译器以生成Java 8字节码。

compileKotlin {

kotlinOptions {

freeCompilerArgs  = [ “ -  Xjsr305 = strict” ]

jvmTarget  =  “1.8”

}

}

compile("org.jetbrains.kotlin:kotlin-stdlib-jdk8")  我 是Kotlin标准库的Java 8变体。

compile('com.fasterxml.jackson.module:jackson-module-kotlin')  一个 用于科特林和数据类的序列化/反序列化DDS支持。

compile("org.jetbrains.kotlin:kotlin-reflect")  我 是Kotlin反射库。

Spring Boot Gradle插件自动使用Kotlin Gradle插件上声明的Kotlin版本，因此未在依赖项部分明确定义该版本。

所有剩余的条目都是不言自明的。

Kotlin代码

Spring Boot应用程序

/src/main/kotlin/com.xp.springboot.kotlin.SpringBootKotlinRestApiApplication.kt  

注意上面缺少的分号。 只有拥有@ Bean时才需要打开和关闭类的大括号。否则，需要一个类   name   。  Runapplication   是一个顶级的功能。

创建数据类

然后，我们通过使用科特林数据类，其目的是为了保存数据，并自动提供创建我们的模型 equals() ， hashCode() ， toString() ，   componentN()   功能，和 copy() 。

此外，您可以在同一数据类中定义多个实体。   Var   类似于一般变量，在Kotlin中被称为可变变量，可以多次分配。

还有另一种类型：   val 它   类似于常量变量，在Kotlin中被称为不可变的，只能初始化一次。 此外，它   val   是只读的，您不能显式写入   val 。

创建存储库

是的，只有一个单行程序来定义Spring Data curd存储库的存储库接口。 这里有趣的Spring注释是   RepositoryRestResource 。 这是通过添加   spring-boot-starter-data-rest  依赖项来实现的。

如果你注意到，   没有控制器，也没有服务。  此项目在启用HATEOAS的情况下公开以下REST端点。

  GET  -   http：// localhost：8080 / parkrun / runners

  POST   - http：// localhost：8080 / parkrun / runners

  GET   - http：// localhost：8080 / parkrun / runners / 2

  DELETE   - http：// localhost：8080 / parkrun / runners / 1

这是神奇的 @RepositoryRestResource 。

应用于 collectionResourceRel   定义自定义资源标签，否则，注释将根据模型类名称（ /parkRunners ） 使用默认值 。

在运行时，Spring Data REST    将自动创建此接口的实现。 然后，它将使用   @RepositoryRestResource   注释来指导Spring MVC并在其中创建RESTful端点    /parkRunners 。

运行应用程序

在Gradle clean build之后准备好jar后，使用以下命令运行应用程序：    java -jar SpringBootKotlinRestAPI-0.0.1-SNAPSHOT.jar   并点击 GET上 的URL  。 以下是对响应的看法：   http://localhost:8080/parkrun    

{

    “_links”：{

        “跑步者”：{

            “href”：“http：// localhost：8080 / parkrun / runners”

        }，

        “个人资料”：{

            “href”：“http：// localhost：8080 / parkrun / profile”

        }

    }

}

http://localhost:8080/parkrun/runners    在GET上 点击URL    。

这是你的回答：

{

   “_embedded”：{

      “跑步者”：[

         {

            “firstName”：“NEERAJ”，

            “lastName”：“SIDHAYE”，

            “性别”：“M”，

            “runningClub”：“RUNWAY”，

            “totalRuns”：“170”，

            “_links”：{

               “自我”：{

                  “href”：“http：// localhost：8080 / parkrun / runners / 1”

               }，

               “parkRunner”：{

                  “href”：“http：// localhost：8080 / parkrun / runners / 1”

               }

            }

         }

      ]

   }，

   “_links”：{

      “自我”：{

         “href”：“http：// localhost：8080 / parkrun / runners”

      }，

      “个人资料”：{

         “href”：“http：// localhost：8080 / parkrun / profile / runners”

      }

   }

}

接下来，选择配置文件URL并查看您使用的内容   http://localhost:8080/parkrun/profile/runners ：

{

   “阿尔卑斯山”：{

      “版本”：“1.0”，

      “描述符”：[

         {

            “id”：“parkRunner-representation”，

            “href”：“http：// localhost：8080 / parkrun / profile / runners”，

            “描述符”：[

               {

                  “name”：“firstName”，

                  “type”：“SEMANTIC”

               }，

               {

                  “name”：“lastName”，

                  “type”：“SEMANTIC”

               }，

               {

                  “名字”：“性别”，

                  “type”：“SEMANTIC”

               }，

               {

                  “名字”：“runningClub”，

                  “type”：“SEMANTIC”

               }，

               {

                  “名字”：“totalRuns”，

                  “type”：“SEMANTIC”

               }

            ]

         }，

         {

            “id”：“get-runners”，

            “名字”：“跑步者”，

            “类型”：“安全”，

            “rt”：“＃parkRunner-representation”

         }，

         {

            “id”：“创造跑步者”，

            “名字”：“跑步者”，

            “type”：“UNSAFE”，

            “rt”：“＃parkRunner-representation”

         }，

         {

            “id”：“patch-parkRunner”，

            “名字”：“parkRunner”，

            “type”：“UNSAFE”，

            “rt”：“＃parkRunner-representation”

         }，

         {

            “id”：“get-parkRunner”，

            “名字”：“parkRunner”，

            “类型”：“安全”，

            “rt”：“＃parkRunner-representation”

         }，

         {

            “id”：“delete-parkRunner”，

            “名字”：“parkRunner”，

            “type”：“IDEMPOTENT”，

            “rt”：“＃parkRunner-representation”

         }，

         {

            “id”：“update-parkRunner”，

            “名字”：“parkRunner”，

            “type”：“IDEMPOTENT”，

            “rt”：“＃parkRunner-representation”

         }

      ]

   }

}

希望这有助于您更好地理解Kotlin中REST API的快速开发。 快乐的编码！

来自 “ ITPUB博客 ” ，链接：http://blog.itpub.net/31557424/viewspace-2220401/，如需转载，请注明出处，否则将追究法律责任。

转载于:http://blog.itpub.net/31557424/viewspace-2220401/