net.guizhanss.guizhanlib.minecraft.LanguageHelper Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of GuizhanLib-minecraft Show documentation
The newest version!
package net.guizhanss.guizhanlib.minecraft;

import com.google.common.base.Preconditions;
import com.google.gson.Gson;
import com.google.gson.reflect.TypeToken;
import lombok.experimental.UtilityClass;

import javax.annotation.Nonnull;
import javax.annotation.Nullable;
import java.io.BufferedReader;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.lang.reflect.Type;
import java.nio.charset.StandardCharsets;
import java.util.HashMap;
import java.util.Map;

/**
 * 从Minecraft的语言文件中获取内容。
 * 只有读取语言文件后，其他包内的助手才能正常使用。
 *
 * @author ybw0014
 */
@UtilityClass
@SuppressWarnings("ConstantConditions")
public final class LanguageHelper {

    private static final Gson GSON = new Gson();
    private static Map lang = new HashMap<>();

    /**
     * 从输入流({@link InputStream})中读取语言文件
     *
     * @param stream 输入流({@link InputStream})
     * @throws IllegalArgumentException 如果输入流为空
     */
    public static void loadFromStream(@Nonnull InputStream stream) {
        Preconditions.checkArgument(stream != null, "输入流不能为空");

        BufferedReader reader = new BufferedReader(new InputStreamReader(
            stream, StandardCharsets.UTF_8
        ));
        // @formatter:off
        Type type = new TypeToken>() {}.getType();
        // @formatter:on
        lang = GSON.fromJson(reader, type);
    }

    /**
     * 获取语言文件中指定键名的内容
     *
     * @param key        {@link String} 键名
     * @param defaultVal 默认值
     * @return 键名内容
     */
    @Nonnull
    public static String getLangOrDefault(@Nonnull String key, @Nonnull String defaultVal) {
        String lang = getLangOrNull(key);
        return lang != null ? lang : defaultVal;
    }

    /**
     * 获取语言文件中指定键名的内容
     *
     * @param key {@link String} 键名
     * @return 键名内容
     */
    @Nonnull
    public static String getLangOrKey(@Nonnull String key) {
        return getLangOrDefault(key, key);
    }

    /**
     * 获取语言文件中指定键名的内容
     *
     * @param key {@link String} 键名
     * @return 键名内容
     */
    @Nullable
    public static String getLangOrNull(@Nonnull String key) {
        Preconditions.checkArgument(key != null, "键名不能为空");

        return lang.get(key);
    }
}