io.github.freya022.botcommands.api.localization.readers.LocalizationMapReaders Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of BotCommands Show documentation

A Kotlin-first (and Java) framework that makes creating Discord bots a piece of cake, using the JDA library.

There is a newer version: 3.0.0-alpha.18

package io.github.freya022.botcommands.api.localization.readers;

import io.github.freya022.botcommands.api.Logging;
import io.github.freya022.botcommands.api.core.service.ServiceContainer;
import io.github.freya022.botcommands.api.core.service.annotations.BService;
import io.github.freya022.botcommands.api.localization.LocalizationMap;
import io.github.freya022.botcommands.api.localization.LocalizationMapRequest;
import org.jetbrains.annotations.NotNull;
import org.jetbrains.annotations.Nullable;
import org.jetbrains.annotations.UnmodifiableView;
import org.slf4j.Logger;

import java.util.Collection;
import java.util.Collections;
import java.util.Locale;
import java.util.ResourceBundle;

/**
 * Class which contains all the {@link LocalizationMapReader}.
 * 
This is mainly used by the localization map providers.
 */
@BService
public final class LocalizationMapReaders {
    private static final Logger LOGGER = Logging.getLogger();
    private static final ResourceBundle.Control CONTROL = ResourceBundle.Control.getNoFallbackControl(ResourceBundle.Control.FORMAT_DEFAULT);

    private final ServiceContainer serviceContainer;

    private Collection readers = null;

    public LocalizationMapReaders(ServiceContainer serviceContainer) {
        this.serviceContainer = serviceContainer;
    }

    @NotNull
    @UnmodifiableView
    public Collection getReaders() {
        if (readers == null)
            readers = serviceContainer.getInterfacedServices(LocalizationMapReader.class);
        return Collections.unmodifiableCollection(readers);
    }

    /**
     * Cycles through all the registered readers with the specified base name and locale,
     * and returns when a reader returns non-null mappings, returns {@code null} otherwise
     *
     * @param baseName The base name of the localization bundle
     * @param locale   The locale of the localization bundle
     *
     * @return non-null mappings if a reader returned one, {@code null} otherwise
     */
    @Nullable
    public LocalizationMap cycleReaders(@NotNull String baseName, @NotNull Locale locale) {
        final LocalizationMapRequest request = new LocalizationMapRequest(baseName, locale, CONTROL.toBundleName(baseName, locale));
        for (LocalizationMapReader reader : getReaders()) {
            try {
                LocalizationMap localizationMap = reader.readLocalizationMap(request);

                if (localizationMap != null) {
                    return localizationMap;
                }
            } catch (Exception e) {
                LOGGER.error("An error occurred while reading a bundle '{}' with locale '{}' with reader '{}'", baseName, locale, reader.getClass().getName(), e);
            }
        }

        return null;
    }
}