向 Spring Boot 项目添加数据类

这是 **Spring Boot 和 Kotlin 入门** 教程的第二部分。在继续之前，请确保你已完成以下步骤：

使用 Kotlin 创建 Spring Boot 项目
向 Spring Boot 项目添加数据类
为 Spring Boot 项目添加数据库支持
使用 Spring Data CrudRepository 进行数据库访问

在本教程的这一部分，你将为应用程序添加更多功能，并了解更多 Kotlin 语言特性，例如数据类。 这需要更改 MessageController 类，使其能够响应包含序列化对象集合的 JSON 文档。

更新你的应用程序

1. 在同一包中，紧邻 DemoApplication.kt 文件，创建一个 Message.kt 文件。

2. 在 Message.kt 文件中，创建一个具有两个属性：id 和 text 的数据类：

   // Message.kt
   package com.example.demo
   
   data class Message(val id: String?, val text: String)

   Message 类将用于数据传输：一个序列化的 Message 对象列表将构成控制器响应浏览器请求的 JSON 文档。

   数据类 – data class Message

   Kotlin 中 数据类 的主要目的是持有数据。此类用 `data` 关键字标记，并且一些标准功能和实用函数通常可以从类结构中机械地派生出来。

   在此示例中，你将 `Message` 声明为一个数据类，因为其主要目的是存储数据。

   val 和 var 属性

   Kotlin 中的属性 可以声明为以下两种之一：

   • 可变，使用 `var` 关键字
   • 只读，使用 `val` 关键字

   `Message` 类使用 `val` 关键字声明了两个属性：`id` 和 `text`。编译器将自动为这两个属性生成 getter。在创建 `Message` 类的实例后，将无法重新赋值这些属性。

   可空类型 – String?

   Kotlin 提供 对可空类型的内置支持。在 Kotlin 中，类型系统区分可以持有 `null` 的引用（可空引用）和不能持有 `null` 的引用（非可空引用）。
   例如，`String` 类型的常规变量不能持有 `null`。要允许空值，你可以通过编写 `String?` 将变量声明为可空字符串。

   `id` 属性的 `Message` 类这次被声明为可空类型。因此，可以通过将 `null` 作为 `id` 的值来创建 `Message` 类的实例：

   Message(null, "Hello!")

3. 在 MessageController.kt 文件中，用 listMessages() 函数替换 index() 函数，该函数返回一个 Message 对象列表：

   // MessageController.kt
   package com.example.demo
   
   import org.springframework.web.bind.annotation.GetMapping
   import org.springframework.web.bind.annotation.RequestMapping
   import org.springframework.web.bind.annotation.RestController
   
   @RestController
   @RequestMapping("/")
   class MessageController {
       @GetMapping
       fun listMessages() = listOf(
           Message("1", "Hello!"),
           Message("2", "Bonjour!"),
           Message("3", "Privet!"),
       )
   }

   集合 – listOf()

   Kotlin 标准库为基本集合类型（集、列表和映射）提供实现。
   每种集合类型都可以是只读或可变的：

   • 只读集合提供用于访问集合元素的操作。
   • 可变集合还提供用于添加、移除和更新其元素的写入操作。

   Kotlin 标准库也提供了相应的工厂函数来创建此类集合的实例。

   在本教程中，你使用 listOf() 函数来创建一个 `Message` 对象列表。这是创建只读对象列表的工厂函数：你不能从列表中添加或删除元素。
   如果需要对列表执行写入操作，请调用 mutableListOf() 函数来创建可变列表实例。

MessageController 的响应现在将是一个包含 Message 对象集合的 JSON 文档。

NOTE

如果 Jackson 库在 classpath 中，Spring 应用程序中的任何控制器默认都会渲染 JSON 响应。正如你 在 build.gradle.kts 文件中指定了 spring-boot-starter-web 依赖，你获得了 Jackson 作为_传递_依赖。因此，如果端点返回一个可以序列化为 JSON 的数据结构，应用程序将以 JSON 文档响应。

以下是 DemoApplication.kt、MessageController.kt 和 Message.kt 文件的完整代码：

// DemoApplication.kt
package com.example.demo

import org.springframework.boot.autoconfigure.SpringBootApplication
import org.springframework.boot.runApplication

@SpringBootApplication
class DemoApplication

fun main(args: Array<String>) {
    runApplication<DemoApplication>(*args)
}

// MessageController.kt
package com.example.demo

import org.springframework.web.bind.annotation.GetMapping
import org.springframework.web.bind.annotation.RequestMapping
import org.springframework.web.bind.annotation.RestController

@RestController
@RequestMapping("/")
class MessageController {
    @GetMapping
    fun listMessages() = listOf(
        Message("1", "Hello!"),
        Message("2", "Bonjour!"),
        Message("3", "Privet!"),
    )
}

// Message.kt
package com.example.demo

data class Message(val id: String?, val text: String)

运行应用程序

Spring 应用程序已准备好运行：

1. 再次运行应用程序。

2. 应用程序启动后，打开以下 URL：

   http://localhost:8080

   你将看到一个包含 JSON 格式消息集合的页面：

   

下一步

在本教程的下一部分中，你将为项目添加和配置数据库，并发出 HTTP 请求。

继续下一章