0
点赞
收藏
分享

微信扫一扫

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


举报

相关推荐

0 条评论