io.micronaut.kotlin.context.ApplicationContextExtensions.kt Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of micronaut-kotlin-extension-functions Show documentation
Includes extensions to Micronaut for Kotlin
There is a newer version: 4.4.0
Show newest version
/*
 * Copyright 2017-2020 original 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 io.micronaut.kotlin.context

import io.micronaut.context.ApplicationContext
import io.micronaut.context.env.PropertySource

/**
 *  Top level function acting as a Kotlin shortcut allowing to write `run("env")`
 *  instead of `ApplicationContext.run(Foo::class.java, "env")`.
 *
 * @param T The type
 * @param environments The environments to use
 * @return The running bean
 * @author Alejandro Gomez
 * @since 1.0.0
 */
inline fun  run(vararg environments: String): T =
        ApplicationContext.run(T::class.java, *environments)

/**
 *  Top level function acting as a Kotlin shortcut allowing to write `run(props, "env")`
 *  instead of `ApplicationContext.run(Foo::class.java, props, "env")`.
 *
 * @param T The type
 * @param properties Additional properties
 * @param environments The environments to use
 * @return The running bean
 * @author Alejandro Gomez
 * @since 1.0.0
 */
inline fun  run(properties: Map, vararg environments: String): T =
        ApplicationContext.run(T::class.java, properties, *environments)

/**
 *  Top level function acting as a Kotlin shortcut allowing to write `run(props, "env")`
 *  instead of `ApplicationContext.run(Foo::class.java, props, "env")`.
 *
 * @param T The type
 * @param propertySource Additional properties
 * @param environments The environments to use
 * @return The running bean
 * @author Alejandro Gomez
 * @since 1.0.0
 */
inline fun  run(propertySource: PropertySource, vararg environments: String): T =
        ApplicationContext.run(T::class.java, propertySource, *environments)

/**
 *  Top level function acting as a Kotlin shortcut allowing to write `buildAndStart(mapOf("foo" to "bar"))`
 *  instead of `ApplicationContext.build(Foo::class.java)propertySources(propSource).start()`.
 *
 * @param T The type
 * @return The running [ApplicationContext]
 * @author Alejandro Gomez
 * @since 1.0.0
 */
inline fun  buildAndStart(): ApplicationContext = ApplicationContext.builder(T::class.java).start()

/**
 *  Top level function acting as a Kotlin shortcut allowing to write `buildAndStart(mapOf("foo" to "bar"))`
 *  instead of `ApplicationContext.build(Foo::class.java)propertySources(propSource).start()`.
 *
 * @param T The type
 * @param propertySources The property sources to include
 * @return The running [ApplicationContext]
 * @author Alejandro Gomez
 * @since 1.0.0
 */
inline fun  buildAndStart(vararg propertySources: PropertySource): ApplicationContext =
        ApplicationContext.builder(T::class.java).propertySources(*propertySources).start()

/**
 *  Top level function acting as a Kotlin shortcut allowing to write `buildAndStart("env")`
 *  instead of `ApplicationContext.build(Foo::class.java, "env").start()`.
 *
 * @param T The type
 * @param environments The environments to use
 * @return The running [ApplicationContext]
 * @author Alejandro Gomez
 * @since 1.0.0
 */
inline fun  buildAndStart(vararg environments: String): ApplicationContext = ApplicationContext.builder(
        T::class.java,
        *environments
).start()

/**
 *  Top level function acting as a Kotlin shortcut allowing to write `buildAndStart("env")`
 *  instead of `ApplicationContext.build(mapOf("foo" to "bar"), "env").mainClass(Foo::class.java).start()`.
 *
 * @param T The type
 * @param properties Additional properties
 * @param environments The environments to use
 * @return The running [ApplicationContext]
 * @author Alejandro Gomez
 * @since 1.0.0
 */
inline fun  buildAndStart(properties: Map, vararg environments: String): ApplicationContext =
        ApplicationContext.builder(properties, *environments).mainClass(T::class.java).start()

/**
 *  Top level function acting as a Kotlin shortcut allowing to write `buildAndStart("env")`
 *  instead of `ApplicationContext.build(Foo::class.java, "env").propertySources(propSource).start()`.
 *
 * @param T The type
 * @param propertySource The property source to include
 * @param environments The environments to use
 * @return The running [ApplicationContext]
 * @author Alejandro Gomez
 * @since 1.0.0
 */
inline fun  buildAndStart(propertySource: PropertySource, vararg environments: String): ApplicationContext =
        ApplicationContext.builder(T::class.java, *environments).propertySources(propertySource).start()