如何使用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的快速开发。快乐的编码！

阅读更多