使用 Kotlin 创建 Spring Boot 项目

开始之前的准备

下载并安装 IntelliJ IDEA Ultimate Edition 的最新版.

note

如果你使用的是 IntelliJ IDEA Community Edition 或其他 IDE, 你可以使用 基于 web 页面的项目生成器 来生成 Spring Boot 项目.

创建 Spring Boot 项目

使用 IntelliJ IDEA Ultimate Edition 中的 Project Wizard, 创建新的使用 Kotlin 的 Spring Boot 项目:

note

你也可以使用 IntelliJ IDEA 和 Spring Boot plugin 来创建新项目.

1. 在 IntelliJ IDEA 中, 选择 File | New | Project.

2. 在左侧面板中, 选择 New Project | Spring Boot.

3. 在 Project Wizard 窗口中, 指定以下项目和选项:

   • Name: demo

   • Language: Kotlin

   • Type: Gradle - Kotlin

     tip

     这个选项指定构建系统和 DSL.

   • Package name: demo

   • JDK: Java JDK

     note

     本教程使用 Amazon Corretto version 21. 如果你没有安装 JDK, 可以从下拉列表中下载.

   • Java: 17

   

4. 确认填写了所有的项目, 然后点击 Next.

5. 选择以下依赖项, 本教程将会需要它们:

   • Web | Spring Web

   • SQL | Spring Data JDBC

   • SQL | H2 Database

   

6. 点击 Create, 生成并设置项目.

   tip

   IDE 将会生成并打开新的项目. 可能需要一些时间来下载并导入项目的依赖项.

7. 之后, 你可以在 Project view 中看到下面的项目结构:

   

   生成的 Gradle 项目符合 Maven 的标注目录布局:

   • 在 main/kotlin 文件夹下是属于应用程序的包和类.

   • 应用程序的入口点是 DemoApplication.kt 文件的 main() 方法.

查看生成的 Spring Boot 应用程序

打开 DemoApplication.kt 文件:

// DemoApplication.kt
package demo

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

@SpringBootApplication
class DemoApplication

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

声明类 – DemoApplication 类

在包声明和 import 语句之后, 你可以看到第一个类声明, class DemoApplication.

在 Kotlin 中, 如果一个类不包含任何成员 (属性或函数), 你可以直接省略掉类的主体部分 ({}).

@SpringBootApplication 注解

@SpringBootApplication 注解 在 Spring Boot 应用程序中是一个很方便的注解. 它会启用 Spring Boot 的 自动配置, 组件扫描, 而且可以对 "应用程序类" 定义额外的配置.".

程序入口点 – main()

main() 函数是应用程序的入口点.

它声明为在 DemoApplication 类之外的一个 顶层函数. main() 函数调用 Spring 的 runApplication(*args) 函数, 使用 Spring Framework 来启动应用程序.

可变参数 – args: Array<String>

查看 runApplication() 函数的声明, 你会看到函数的参数标记了 vararg 修饰符: vararg args: String. 这表示, 你可以向这个函数传递可变数量的字符串参数.

展开(spread)操作符 – (*args)

args 是 main() 函数的参数, 它声明为一个字符串数组. 由于存在的是字符串的数组, 而你想要将它的内容传递给函数, 请使用展开(spread)操作符 (在数组之前加上星号 *).

创建 Controller

应用程序已经可以运行了, 但我们先来更新它的逻辑.

在 Spring 应用程序中, Controller 用来处理 Web 请求. 在与 DemoApplication.kt 文件相同的包中, 创建 MessageController.kt 文件, 其中包含 MessageController 类, 如下:

// MessageController.kt
package demo

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

@RestController
class MessageController {
    @GetMapping("/")
    fun index(@RequestParam("name") name: String) = "Hello, $name!"
}

@RestController 注解

你需要告诉 Spring, MessageController 是一个 REST Controller, 因此你应该对它标注 @RestController 注解.

这个注解表示这个类将会被组件扫描识别, 因为它和我们的 DemoApplication 类处在相同的包内.

@GetMapping 注解

@GetMapping 标注 REST Controller 的函数, 它实现了与 HTTP GET 调用对应的 endpoint:

@GetMapping("/")
fun index(@RequestParam("name") name: String) = "Hello, $name!"

@RequestParam 注解

函数参数 name 标注了 @RequestParam 注解. 这个注解表示方法参数应该绑定到一个 Web 请求参数.

因此, 如果你访问应用程序的根路径, 并提供一个请求名为 "name" 的参数, 例如 /?name=<your-value>, 这个参数值将会被用做调用 index() 函数时的参数.

单表达式函数 – index()

由于 index() 函数只包含一条语句, 你可以将它声明为一个 单表达式函数.

意思就是说, 大括号可以省略, 函数体直接放在等号 = 之后.

函数返回值的类型推断

index() 函数没有明确声明返回类型. 编译器会查看等号 = 右侧语句的结果, 以此推断返回类型.

Hello, $name! 表达式的类型是 String, 因此函数的返回类型也是 String.

字符串模板 – $name

Hello, $name! 表达式在 Kotlin 中称为 字符串模板.

字符串模板是字符串的字面值, 其中包含内嵌的表达式.

对于字符串的拼接操作, 这是一个很方便的替代方法.

运行应用程序

Spring 应用程序现在可以运行了:

1. 点击 main() 方法侧栏中的绿色 Run 图标:

   

   tip

   你也可以在终端窗口运行 ./gradlew bootRun 命令.

   这样会在你的计算机上启动本地服务器.

2. 应用程序启动后, 请打开以下 URL:

   http://localhost:8080?name=John

   你会看到输出的结果 "Hello, John!":

   

下一步

本教程的下一部分中, 你将学习 Kotlin 数据类, 以及如何在你的应用程序中使用.

阅读下一章