如何使用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/

你可能感兴趣的:(移动开发,java,git)