Kotlin & Spring Boot @ConfigurationProperties

Here is how I have it working with my application.yml file.

myconfig: my-host: ssl://example.com my-port: 23894 my-user: user my-pass: pass 

Here is the kotlin file:

@Configuration @ConfigurationProperties(prefix = "myconfig") class MqttProperties { lateinit var myHost: String lateinit var myPort: String lateinit var myUser: String lateinit var myPass: String } 

This worked great for me.

Update: As of Spring Boot 2.2.0, you can use data classes as follows:

@ConstructorBinding @ConfigurationProperties("example.kotlin") data class KotlinExampleProperties( val name: String, val description: String, val myService: MyService) { data class MyService( val apiToken: String, val uri: URI ) } 

For further reference, see the official documentation.

Obsolete as of Spring Boot 2.2.0, Issue closed

As stated in the docs: A "Java Bean“ has to be provided in order to use ConfigurationProperties. This means your properties need to have getters and setters, thus val is not possible at the moment.

Getters and setters are usually mandatory, since binding is via standard Java Beans property descriptors, just like in Spring MVC. There are cases where a setter may be omitted [...]

This has been resolved for Spring Boot 2.2.0, which is supposed to be released soon: https://github.com/spring-projects/spring-boot/issues/8762

On Spring Boot 2.4.3 with Kotlin 1.4.3 the next approach is no longer working (maybe because of a bug):

import org.springframework.boot.autoconfigure.SpringBootApplication import org.springframework.boot.context.properties.EnableConfigurationProperties @SpringBootApplication @EnableConfigurationProperties(TestProperties::class) class Application fun main(args: Array<String>) { runApplication<Application>(*args) } 

import org.springframework.boot.context.properties.ConfigurationProperties import org.springframework.boot.context.properties.ConstructorBinding @ConfigurationProperties(prefix = "test") @ConstructorBinding data class TestProperties( val value: String ) 

The code above starts working after implying one of the next two approaches:

1. Add dependency

implementation("org.jetbrains.kotlin:kotlin-reflect") 

2. Update Properties class

import org.springframework.boot.context.properties.ConfigurationProperties import org.springframework.boot.context.properties.ConstructorBinding @ConfigurationProperties(prefix = "test") data class TestProperties @ConstructorBinding constructor( val value: String ) 

The problem happens at the line org/springframework/boot/context/properties/ConfigurationPropertiesBindConstructorProvider.java#68

@ConstructorBinding @ConfigurationProperties(prefix = "your.prefix") data class AppProperties ( val invoiceBaseDir: String, val invoiceOutputFolderPdf: String, val staticFileFolder: String ) 

Don't forget to add @ConfigurationPropertiesScan

@ConfigurationPropertiesScan class Application fun main(args: Array<String>) { runApplication<Application>(*args) } 

And finally the application.properties file:

your.prefix.invoiceBaseDir=D:/brot-files your.prefix.invoiceOutputFolderPdf=invoices-pdf your.prefix.staticFileFolder=static-resources 

As of Spring Boot 3.0 if you have a single constructor, you don't need to use @ConstructorBinding annotation anymore.

 @ConfigurationProperties("app") data class Config( val foo: String = "default foo" ) 

more info here

@Value("\${some.property.key:}") lateinit var foo:String 

could be used this way

application.properties

metro.metro2.url= ###### 

Metro2Config.kt

@Component @ConfigurationProperties(prefix = "metro") data class Metro2PropertyConfiguration( val metro2: Metro2 = Metro2() ) data class Metro2( var url: String ?= null ) 

build.gradle

Plugins: id 'org.jetbrains.kotlin.kapt' version '1.2.31' // kapt dependencies required for IntelliJ auto complete of kotlin config properties class kapt "org.springframework.boot:spring-boot-configuration-processor" compile "org.springframework.boot:spring-boot-configuration-processor" 

This is how I did it:

application.properties

my.prefix.myValue=1 

MyProperties.kt

import org.springframework.boot.context.properties.ConfigurationProperties import org.springframework.stereotype.Component @Component @ConfigurationProperties(prefix = "my.prefix") class MyProperties { private var myValue = 0 fun getMyValue(): Int { return myValue; } fun setMyValue(value: Int){ myValue = value } } 

MyService.kt

@Component class MyService(val myProperties: MyProperties) { fun doIt() { System.console().printf(myProperties.getMyValue().toString()) } } 

In addition to what's already been said, note that val and @ConstructorBinding has some limitations. You cannot alias one variable to another. Let's say you're running in Kubernetes and want to capture the hostname, which is given by the env var HOSTNAME. The easiest way to do this is to apply @Value("\${HOSTNAME}:)" to a property, but it only works for a mutable property and without constructor binding.

See @ConstructorBinding with immutable properties don't work with @Value in Spring Boot Kotlin @ConfigurationProperties.