summaryrefslogtreecommitdiff
path: root/support/arara/source/src/main/kotlin/org/islandoftex/arara/localization/LanguageController.kt
blob: e000ab4d63b71b0a59df12d821bdc14a24061dca (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
// SPDX-License-Identifier: BSD-3-Clause
package org.islandoftex.arara.localization

import ch.qos.cal10n.IMessageConveyor
import ch.qos.cal10n.MessageConveyor
import java.util.Locale
import org.islandoftex.arara.configuration.AraraSpec

/**
 * Implements the language controller. This controller provides a singleton
 * object that holds the application messages, easily available to all model
 * and utilitary classes.
 *
 * @author Island of TeX
 * @version 5.0
 * @since 4.0
 */
object LanguageController {
    // the message conveyor helps us to get localized messages
    // according to the provided locale
    // The fallback language is set to English for all
    // messages in arara.
    private var conveyor: IMessageConveyor = MessageConveyor(Locale(
            AraraSpec.Application.defaultLanguageCode.default))

    /**
     * Sets the current locale. This method actually resets the language
     * conveyor in order to use the new locale. It's quite simple.
     * @param locale The new locale for localized messages through the language
     * conveyor.
     */
    fun setLocale(locale: Locale) {
        conveyor = MessageConveyor(locale)
    }

    /**
     * Gets the localized message indexed by the provided enumeration key,
     * applying an array of objects as parameters. This method is a wrapper to
     * the conveyor's method of the same name.
     * @param E Enumeration type that represents the conveyor messages.
     * @param key Key set in the provided enumeration type.
     * @param parameters Array of objects to be used as parameters.
     * @return A string containing a localized message indexed by the provided
     * enumeration key and applied the array of objects as parameters.
     */
    @Suppress("SpreadOperator")
    fun <E : Enum<*>> getMessage(key: E, vararg parameters: Any): String =
            conveyor.getMessage(key, *parameters)

    /**
     * Gets the localized message indexed by the provided enumeration key. This
     * method is a wrapper to the conveyor's method of the same name.
     * @param E Enumeration type that represents the conveyor messages.
     * @param key Key set in the provided enumeration type.
     * @return A string containing a localized message indexed by the provided
     * enumeration key.
     */
    fun <E : Enum<*>> getMessage(key: E): String = conveyor.getMessage(key)
}