001package jmri.jmrix.powerline.dmx512;
002
003import edu.umd.cs.findbugs.annotations.SuppressFBWarnings;
004import java.util.Locale;
005import javax.annotation.CheckReturnValue;
006import javax.annotation.CheckForNull;
007import javax.annotation.ParametersAreNonnullByDefault;
008
009@ParametersAreNonnullByDefault
010@CheckReturnValue
011@SuppressFBWarnings(value = "NM_SAME_SIMPLE_NAME_AS_SUPERCLASS", justification = "Desired pattern is repeated class names with package-level access to members")
012
013@javax.annotation.concurrent.Immutable
014
015/**
016 * Provides standard access for resource bundles in a package.
017 *
018 * Convention is to provide a subclass of this name in each package, working off
019 * the local resource bundle name.
020 *
021 * @author Bob Jacobsen Copyright (C) 2012
022 * @author Ken Cameron Copyright (C) 2023
023 * @since 3.3.1
024 */
025public class Bundle extends jmri.jmrix.powerline.Bundle {
026
027    @CheckForNull
028    private static final String name = null; // No local resources
029
030    //
031    // below here is boilerplate to be copied exactly
032    //
033    /**
034     * Provides a translated string for a given key from the package resource
035     * bundle or parent.
036     * <p>
037     * Note that this is intentionally package-local access.
038     *
039     * @param key Bundle key to be translated
040     * @return Internationalized text
041     */
042    static String getMessage(String key) {
043        return getBundle().handleGetMessage(key);
044    }
045
046    /**
047     * Merges user data with a translated string for a given key from the
048     * package resource bundle or parent.
049     * <p>
050     * Uses the transformation conventions of the Java MessageFormat utility.
051     * <p>
052     * Note that this is intentionally package-local access.
053     *
054     * @see java.text.MessageFormat
055     * @param key  Bundle key to be translated
056     * @param subs One or more objects to be inserted into the message
057     * @return Internationalized text
058     */
059    static String getMessage(String key, Object... subs) {
060        return getBundle().handleGetMessage(key, subs);
061    }
062
063    /**
064     * Merges user data with a translated string for a given key in a given
065     * locale from the package resource bundle or parent.
066     * <p>
067     * Uses the transformation conventions of the Java MessageFormat utility.
068     * <p>
069     * Note that this is intentionally package-local access.
070     *
071     * @see java.text.MessageFormat
072     * @param locale The locale to be used
073     * @param key    Bundle key to be translated
074     * @param subs   One or more objects to be inserted into the message
075     * @return Internationalized text
076     */
077    static String getMessage(Locale locale, String key, Object... subs) {
078        return getBundle().handleGetMessage(locale, key, subs);
079    }
080
081
082    private final static Bundle b = new Bundle();
083
084    @Override
085    @CheckForNull
086    protected String bundleName() {
087        return name;
088    }
089
090    protected static jmri.Bundle getBundle() {
091        return b;
092    }
093
094    @Override
095    protected String retry(Locale locale, String key) {
096        return super.getBundle().handleGetMessage(locale,key);
097    }
098
099}