Создание проекта Spring Boot на Kotlin

Перед началом

Скачайте и установите последнюю версию IntelliJ IDEA и используйте подписку Ultimate.

Создание проекта Spring Boot

Создайте проект Spring Boot на Kotlin с помощью мастера проектов в IntelliJ IDEA:

1. В IntelliJ IDEA выберите Файл | Создать | Проект.

2. На панели слева выберите Spring Boot в разделе Генераторы.

3. Укажите следующие поля и параметры в окне Новый проект:

   • Имя: demo

   • Язык: Kotlin

   • Тип: Gradle — Kotlin

   • Имя пакета: com.example.demo

   • JDK: Java JDK

   • Java: 17

   

4. Убедитесь, что указали все поля, и нажмите Далее.

5. Выберите следующие зависимости, необходимые для выполнения руководства:

   • Web | Spring Web

   • SQL | Spring Data JDBC

   • SQL | H2 Database

   

6. Нажмите Создать, чтобы создать и настроить проект.

7. После этого в представлении «Проект» будет видна следующая структура:

   

   Созданный проект Gradle соответствует стандартной структуре каталогов Maven:

   • В папке main/kotlin находятся пакеты и классы, относящиеся к приложению.

   • Точкой входа приложения является метод main() в файле DemoApplication.kt.

Изучение созданного приложения Spring Boot

Откройте файл DemoApplication.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)
}

Объявление классов — class DemoApplication

Сразу после объявления пакета и операторов импорта находится первое объявление класса — class DemoApplication.

В Kotlin, если класс не содержит членов (свойств или функций), фигурные скобки тела класса ({}) можно опустить.

Аннотация @SpringBootApplication

@SpringBootApplication annotation — это удобная аннотация для приложения Spring Boot. Она включает автоконфигурацию Spring Boot и сканирование компонентов, а также позволяет определить дополнительные настройки в «классе приложения».

Точка входа программы — main()

Функция main() является точкой входа приложения.

Она объявлена как функция верхнего уровня вне класса DemoApplication. Функция main() вызывает функцию runApplication(*args) из Spring, чтобы запустить приложение с помощью Spring Framework.

Переменное число аргументов — args: Array<String>

Если посмотреть на объявление функции runApplication(), можно заметить, что параметр функции помечен модификатором vararg: vararg args: String. Это означает, что функции можно передать произвольное количество аргументов типа String.

Оператор spread — (*args)

args — это параметр функции main(), объявленный как массив строк. Чтобы передать содержимое массива в функцию, используйте оператор spread (добавьте перед массивом звездочку *).

Создание контроллера

Приложение готово к запуску, но сначала обновим его логику.

В приложении Spring контроллер используется для обработки веб-запросов. В том же пакете, рядом с файлом DemoApplication.kt, создайте файл MessageController.kt с классом MessageController, как показано ниже:

// MessageController.kt
package com.example.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-контроллер. Для этого пометьте его аннотацией @RestController.

Благодаря этой аннотации класс будет обнаружен при сканировании компонентов, поскольку он находится в том же пакете, что и класс DemoApplication.

Аннотация @GetMapping

@GetMapping помечает функции REST-контроллера, реализующие конечные точки для HTTP-запросов GET:

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

Аннотация @RequestParam

Параметр функции name помечен аннотацией @RequestParam. Эта аннотация указывает, что параметр метода должен быть связан с параметром веб-запроса.

Таким образом, если открыть корневой адрес приложения и передать параметр запроса с именем "name", например /?name=<your-value>, его значение будет использовано в качестве аргумента при вызове функции index().

Функции с единственным выражением — index()

Поскольку функция index() содержит только одну инструкцию, ее можно объявить как функцию с единственным выражением.

Это означает, что фигурные скобки можно опустить, а тело функции указать после знака равенства =.

Вывод типа возвращаемого значения функции

Функция index() не объявляет тип возвращаемого значения явно. Вместо этого компилятор выводит его, анализируя результат инструкции справа от знака равенства =.

Тип выражения Hello, $name! — String, поэтому тип возвращаемого значения функции также равен String.

Шаблоны строк — $name

Выражение Hello, $name! в Kotlin называется шаблоном строки.

Шаблоны строк — это строковые литералы, содержащие встроенные выражения.

Это удобная замена операциям конкатенации строк.

Запуск приложения

Теперь приложение Spring готово к запуску:

1. В файле DemoApplication.kt нажмите зеленый значок Запустить на поле рядом с методом main():

   

   Это запустит локальный сервер на вашем компьютере.

2. После запуска приложения откройте следующий URL-адрес:

   http://localhost:8080?name=John
   

   В ответе должно появиться сообщение "Hello, John!":

   

Следующий шаг

В следующей части руководства вы узнаете о классах данных Kotlin и о том, как использовать их в приложении.

• Следующий шаг