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

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

Загрузите и установите последнюю версию IntelliJ IDEA Ultimate Edition.

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

Создайте новый проект Spring Boot с Kotlin, используя мастера проектов в IntelliJ IDEA Ultimate Edition:

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

2. В панели слева выберите Новый проект | Spring Initializr.

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

   • Имя: demo

   • Язык: Kotlin

   • Система сборки: Gradle

   • JDK: Java 17 JDK

   • Java: 17

   

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

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

   • Веб / Spring Web

   • SQL / Spring Data JDBC

   • SQL / База данных H2

   

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

   IDE сгенерирует и откроет новый проект. Это может занять некоторое время для загрузки и импорта зависимостей проекта.

7. После этого вы можете увидеть следующую структуру в Представлении проекта:

   

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

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

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

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

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

Сразу после объявления пакета и операторов импорта вы можете увидеть первое объявление класса, class DemoApplication.

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

@SpringBootApplication аннотация

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

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

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

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

Аргументы переменной длины – args: Array<String>

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

Оператор распространения – (*args)

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

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

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

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

@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.

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

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

Вот полный код DemoApplication.kt.

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

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

1. Нажмите зелёную иконку «Запуск» в метке рядом с методом main():

   

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

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

   http://localhost:8080?name=John
   

   Вы должны увидеть «Hello, John!» в качестве ответа:

   

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

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

Перейти к следующей главе

Получите карту языка Kotlin

Получите вашу персональную карту языка, чтобы помочь вам в навигации по функциям Kotlin и отслеживании вашего прогресса в изучении языка. Мы также будем отправлять вам советы по языку и полезные материалы по использованию Kotlin с Spring.