如何使用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
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值