Spring Boot With Kotlin

当前，Spring 5 中已经支持可以使用 Kotlin 来做开发了，那我们就使用 Kotlin 来做一个简单的 CRUD，学习使用 Kotlin 来开发 SpringBoot 的基本套路。
本文主要是一个使用 Kotlin 来编写 SpringBoot 的一个简单 Starter，不牵扯任何底层原理之类的知识，属于教你如何用的 Tutorials。
代码：https://github.com/coding-farmer-ming/spring-boot-with-kotlin

下载基础项目

可以从 https://start.spring.io 下载基础的项目，SpringBoot 的版本选择 2.0.0.M1，编程语言选择 Kotlin，然后生成并使用 IDEA 打开
使用 Kotlin 开发 SpringBoot，需要添加的关于 Kotlin 的依赖有如下两个（在 Spring Start 下载的项目中已经包含这两个依赖）：

<dependency>
    <groupId>org.jetbrains.kotlin</groupId>
    <artifactId>kotlin-stdlib-jre8</artifactId>
    <version>1.1.2</version>
</dependency>
<dependency>
    <groupId>org.jetbrains.kotlin</groupId>
    <artifactId>kotlin-reflect</artifactId>
    <version>1.1.2</version>
</dependency>

如果需要使用 Jackson 来做对象转 JSON，需要添加如下依赖：

<dependency>
    <groupId>com.fasterxml.jackson.module</groupId>
    <artifactId>jackson-module-kotlin</artifactId>
    <version>2.8.8</version>
</dependency>

开发 Web 需要添加如下依赖：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>

编写简单的 Controller

入门 Hello World

1、首先写一个 Controller，可以命名为 HelloController.kt，然后为该 Controller 添加注解 @RestController，
2、编写第一个方法：

@GetMapping("/hello")
fun helloKotlin(): String {
    return "hello kotlin"
}

启动项目，输入 http://localhost:8080/hello，可以看到已经输出了 hello kotlin

包含一个 Service 的 Hello World

1、首先编写一个 Service，将其命名为 HelloService.kt：

class HelloService {
    fun getHello(): String {
        return "hello kotlin from service"
    }
}

2、改写 HelloController.kt 的声明：

class HelloController(val helloService: HelloService) {}

3、添加一个方法：

@GetMapping("/hello-service")
fun helloKotlinService(): String {
    return helloService.getHello()
}

启动项目，输入 http://localhost:8080/hello-service，可以看到已经输出了 hello kotlin from service

返回一个 DTO 转换的 JSON

1、首先定义一个 DTO，可以命名为 HelloDTO.kt，声明其有一个 greeting 属性：

data class HelloDTO(val greeting: String)

2、在 HelloController.kt 中添加一个方法：

@GetMapping("/hello-dto")
fun helloDTO(): HelloDTO {
    return HelloDTO("hello kotlin from the dto")
}

启动项目，输入 http://localhost:8080/hello-dto，可以看到已经输出了 {"greeting":"hello kotlin from the dto"}

使用数据库来保存数据

1、引入依赖

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-data-jpa</artifactId>
</dependency>
<dependency>
    <groupId>com.h2database</groupId>
    <artifactId>h2</artifactId>
</dependency>

2、数据库配置文件 application.yml：

spring:
  jpa:
    generate-ddl: false
    show-sql: true
    hibernate:
      ddl-auto: none
  datasource:
    platform: h2
    schema: classpath:schema.sql
    data: classpath:data.sql

3、提供 SQL 脚本，分别是 schema.sql 与 data.sql

CREATE TABLE user (
    id bigint NOT NULL AUTO_INCREMENT PRIMARY KEY,
    first_name VARCHAR(50) DEFAULT '' NULL,
    last_name VARCHAR(50) DEFAULT '' NULL
);
insert into user (id, first_name, last_name) values (1, 'zhang', 'san');
insert into user (id, first_name, last_name) values (2, 'li', 'si');
insert into user (id, first_name, last_name) values (3, 'wang', 'wu');

4、编写实体类：

@Entity
class User(
        @Column(name = "first_name") var firstName: String = "",
        @Column(name = "last_name") var lastName: String = "",
        @Id @GeneratedValue(strategy = GenerationType.AUTO) var id: Long = 0)

5、编写 Repository：

@Repository
interface UserRepository: JpaRepository<User, Long> {
    fun findByLastName(name: String): User
}

6、提供 UserController：

@RestController
@RequestMapping("/user")
class UserController(val userRepository: UserRepository) {
    @GetMapping
    fun findAll() = userRepository.findAll()

    @GetMapping("/{name}")
    fun findByLastName(@PathVariable name: String) = userRepository.findByLastName(name)
}

启动项目，输入 http://localhost:8080/user 和 http://localhost:8080/san 可以看到对应的结果。