io.github.resilience4j.kotlin.retry.RetryRegistry.kt Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of resilience4j-kotlin Show documentation
Resilience4j is a lightweight, easy-to-use fault tolerance library designed for Java8 and functional programming
There is a newer version: 2.2.0
/*
 *
 * Copyright 2020
 *
 * 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
 *
 * http://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.
 *
 *
 */
@file:Suppress("FunctionName")

package io.github.resilience4j.kotlin.retry

import io.github.resilience4j.retry.RetryConfig
import io.github.resilience4j.retry.RetryRegistry
import io.vavr.Tuple2 as VavrTuple2
import io.vavr.collection.HashMap as VavrHashMap

/**
 * Creates new custom [RetryRegistry].
 *
 * ```kotlin
 * val retryRegistry = RetryRegistry {
 *     withRetryConfig(defaultConfig)
 *     withTags(commonTags)
 * }
 * ```
 *
 * @param config methods of [RetryRegistry.Builder] that customize resulting `RetryRegistry`
 */
inline fun RetryRegistry(
    config: RetryRegistry.Builder.() -> Unit
): RetryRegistry {
    return RetryRegistry.custom().apply(config).build()
}

/**
 * Configures a [RetryRegistry] with a custom default Retry configuration.
 *
 * ```kotlin
 * val retryRegistry = RetryRegistry {
 *     withRetryConfig {
 *         waitDuration(Duration.ofMillis(10))
 *         retryOnResult { result -> result == "ERROR" }
 *     }
 * }
 * ```
 *
 * @param config methods of [RetryConfig.Builder] that customize default `RetryConfig`
 */
inline fun  RetryRegistry.Builder.withRetryConfig(
    config: RetryConfig.Builder.() -> Unit
) {
    withRetryConfig(RetryConfig(config))
}

/**
 * Configures a [RetryRegistry] with a custom default Retry configuration.
 *
 * ```kotlin
 * val retryRegistry = RetryRegistry {
 *     withRetryConfig {
 *         waitDuration(Duration.ofMillis(10))
 *         retryOnResult { result -> result == "ERROR" }
 *     }
 * }
 * ```
 *
 * @param config methods of [RetryConfig.Builder] that customize default `RetryConfig`
 */
@JvmName("withUntypedRetryConfig")
inline fun RetryRegistry.Builder.withRetryConfig(
    config: RetryConfig.Builder.() -> Unit
) {
    withRetryConfig(RetryConfig(config))
}

/**
 * Configures a [RetryRegistry] with a custom default Retry configuration.
 *
 * ```kotlin
 * val retryRegistry = RetryRegistry {
 *     withRetryConfig(baseRetryConfig) {
 *         waitDuration(Duration.ofMillis(10))
 *         retryOnResult { result -> result == "ERROR" }
 *     }
 * }
 * ```
 *
 * @param baseConfig base `RetryConfig`
 * @param config methods of [RetryConfig.Builder] that customize default `RetryConfig`
 */
inline fun  RetryRegistry.Builder.withRetryConfig(
    baseConfig: RetryConfig,
    config: RetryConfig.Builder.() -> Unit
) {
    withRetryConfig(RetryConfig(baseConfig, config))
}

/**
 * Configures a [RetryRegistry] with a custom default Retry configuration.
 *
 * ```kotlin
 * val retryRegistry = RetryRegistry {
 *     withRetryConfig(baseRetryConfig) {
 *         waitDuration(Duration.ofMillis(10))
 *     }
 * }
 * ```
 *
 * @param baseConfig base `RetryConfig`
 * @param config methods of [RetryConfig.Builder] that customize default `RetryConfig`
 */
@JvmName("withUntypedRetryConfig")
inline fun RetryRegistry.Builder.withRetryConfig(
    baseConfig: RetryConfig,
    config: RetryConfig.Builder.() -> Unit
) {
    withRetryConfig(RetryConfig(baseConfig, config))
}

/**
 * Configures a [RetryRegistry] with a custom Retry configuration.
 *
 * ```kotlin
 * val retryRegistry = RetryRegistry {
 *     addRetryConfig("sharedConfig1") {
 *         waitDuration(Duration.ofMillis(10))
 *         retryOnResult { result -> result == "ERROR" }
 *     }
 * }
 * ```
 *
 * @param configName configName for a custom shared Retry configuration
 * @param config methods of [RetryConfig.Builder] that customize resulting `RetryConfig`
 */
inline fun  RetryRegistry.Builder.addRetryConfig(
    configName: String,
    config: RetryConfig.Builder.() -> Unit
) {
    addRetryConfig(configName, RetryConfig(config))
}

/**
 * Configures a [RetryRegistry] with a custom Retry configuration.
 *
 * ```kotlin
 * val retryRegistry = RetryRegistry {
 *     addRetryConfig("sharedConfig1") {
 *         waitDuration(Duration.ofMillis(10))
 *     }
 * }
 * ```
 *
 * @param configName configName for a custom shared Retry configuration
 * @param config methods of [RetryConfig.Builder] that customize resulting `RetryConfig`
 */
@JvmName("addUntypedRetryConfig")
inline fun RetryRegistry.Builder.addRetryConfig(
    configName: String,
    config: RetryConfig.Builder.() -> Unit
) {
    addRetryConfig(configName, RetryConfig(config))
}

/**
 * Configures a [RetryRegistry] with a custom Retry configuration.
 *
 * ```kotlin
 * val retryRegistry = RetryRegistry {
 *     addRetryConfig("sharedConfig1", baseRetryConfig) {
 *         waitDuration(Duration.ofMillis(10))
 *         retryOnResult { result -> result == "ERROR" }
 *     }
 * }
 * ```
 *
 * @param configName configName for a custom shared Retry configuration
 * @param baseConfig base `RetryConfig`
 * @param config methods of [RetryConfig.Builder] that customize resulting `RetryConfig`
 */
inline fun  RetryRegistry.Builder.addRetryConfig(
    configName: String,
    baseConfig: RetryConfig,
    config: RetryConfig.Builder.() -> Unit
) {
    addRetryConfig(configName, RetryConfig(baseConfig, config))
}

/**
 * Configures a [RetryRegistry] with a custom Retry configuration.
 *
 * ```kotlin
 * val retryRegistry = RetryRegistry {
 *     addRetryConfig("sharedConfig1", baseRetryConfig) {
 *         waitDuration(Duration.ofMillis(10))
 *     }
 * }
 * ```
 *
 * @param configName configName for a custom shared Retry configuration
 * @param baseConfig base `RetryConfig`
 * @param config methods of [RetryConfig.Builder] that customize resulting `RetryConfig`
 */
@JvmName("addUntypedRetryConfig")
inline fun RetryRegistry.Builder.addRetryConfig(
    configName: String,
    baseConfig: RetryConfig,
    config: RetryConfig.Builder.() -> Unit
) {
    addRetryConfig(configName, RetryConfig(baseConfig, config))
}

/**
 * Configures a [RetryRegistry] with Tags.
 *
 * Tags added to the registry will be added to every instance created by this registry.
 *
 * @param tags default tags to add to the registry.
 */
fun RetryRegistry.Builder.withTags(tags: Map) {
    withTags(VavrHashMap.ofAll(tags))
}

/**
 * Configures a [RetryRegistry] with Tags.
 *
 * Tags added to the registry will be added to every instance created by this registry.
 *
 * @param tags default tags to add to the registry.
 */
fun RetryRegistry.Builder.withTags(vararg tags: Pair) {
    withTags(VavrHashMap.ofEntries(tags.map { VavrTuple2(it.first, it.second) }))
}