org.springframework.boot.SpringApplicationExtensions.kt Maven / Gradle / Ivy
/*
* Copyright 2012-2023 the original author or authors.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* https://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package org.springframework.boot
import org.springframework.context.ConfigurableApplicationContext
import org.springframework.util.Assert
import org.springframework.util.ClassUtils
import org.springframework.util.ReflectionUtils
import kotlin.reflect.KClass
/**
* Top-level function acting as a Kotlin shortcut allowing to write
* `runApplication(arg1, arg2)` instead of
* `SpringApplication.run(MyApplication::class.java, arg1, arg2)`.
*
* @author Sebastien Deleuze
* @since 2.0.0
*/
inline fun runApplication(vararg args: String): ConfigurableApplicationContext =
SpringApplication.run(T::class.java, *args)
/**
* Top-level function acting as a Kotlin shortcut allowing to write
* `runApplication(arg1, arg2) { // SpringApplication customization ... }`
* instead of instantiating `SpringApplication` class, customize it and then invoking
* `run(arg1, arg2)`.
*
* @author Sebastien Deleuze
* @since 2.0.0
*/
inline fun runApplication(vararg args: String, init: SpringApplication.() -> Unit): ConfigurableApplicationContext =
SpringApplication(T::class.java).apply(init).run(*args)
/**
* Top-level function acting as a Kotlin shortcut allowing to write
* `fromApplication().with(...)`. This method assumes that
* the `main` function is declared in the same file as `T`.
*
* @author Phillip Webb
* @since 3.1.1
*/
inline fun fromApplication(): SpringApplication.Augmented {
val type = T::class
val ktClassName = type.qualifiedName + "Kt"
try {
val ktClass = ClassUtils.resolveClassName(ktClassName, type.java.classLoader)
val mainMethod = ReflectionUtils.findMethod(ktClass, "main", Array::class.java)
Assert.notNull(mainMethod, "Unable to find main method")
return SpringApplication.from { ReflectionUtils.invokeMethod(mainMethod!!, null, it) }
} catch (ex: Exception) {
throw IllegalStateException("Unable to use 'fromApplication' with " + type.qualifiedName)
}
}
/**
* Extension function that allows [SpringApplication.Augmented.with] to work with Kotlin classes.
*
* @author Phillip Webb
* @author Sebastien Deleuze
* @since 3.1.1
*/
fun SpringApplication.Augmented.with(vararg types: KClass<*>): SpringApplication.Augmented {
return this.with(*types.map(KClass<*>::java).toTypedArray())!!
}