package net.knarcraft.stargate.config; import net.knarcraft.stargate.Stargate; import net.knarcraft.stargate.utility.FileHelper; import java.io.BufferedReader; import java.io.BufferedWriter; import java.io.File; import java.io.IOException; import java.io.InputStream; import java.util.HashMap; import java.util.Map; import java.util.Set; /** * This class is responsible for loading all strings which are translated into several languages */ public final class LanguageLoader { private final String languageFolder; private final Map loadedBackupStrings; private String chosenLanguage; private Map loadedStringTranslations; /** * Instantiates a new language loader * *

This will only load the backup language. Set the chosen language and reload afterwards.

* * @param languageFolder

The folder containing the language files

*/ public LanguageLoader(String languageFolder) { this.languageFolder = languageFolder; File testFile = new File(languageFolder, "en.txt"); if (!testFile.exists()) { if (testFile.getParentFile().mkdirs()) { Stargate.debug("LanguageLoader", "Created language folder"); } } //Load english as backup language in case the chosen language is missing newly added text strings InputStream inputStream = FileHelper.getInputStreamForInternalFile("/lang/en.txt"); if (inputStream != null) { loadedBackupStrings = load("en", inputStream); } else { loadedBackupStrings = null; Stargate.getConsoleLogger().severe("[stargate] Error loading backup language. " + "There may be missing text in-game"); } } /** * Reloads languages from the files on disk */ public void reload() { //Extracts/Updates the language as needed updateLanguage(chosenLanguage); loadedStringTranslations = load(chosenLanguage); } /** * Gets the string to display given its name/key * * @param name

The name/key of the string to display

* @return

The string in the user's preferred language

*/ public String getString(String name) { String value = null; if (loadedStringTranslations != null) { value = loadedStringTranslations.get(name); } if (value == null) { value = getBackupString(name); } return value; } /** * Gets the string to display given its name/key * * @param name

The name/key of the string to display

* @return

The string in the backup language (English)

*/ public String getBackupString(String name) { String value = null; if (loadedBackupStrings != null) { value = loadedBackupStrings.get(name); } if (value == null) { return ""; } return value; } /** * Sets the chosen plugin language * * @param chosenLanguage

The new plugin language

*/ public void setChosenLanguage(String chosenLanguage) { this.chosenLanguage = chosenLanguage; } /** * Updates files in the plugin directory with contents from the compiled .jar * * @param language

The language to update

*/ private void updateLanguage(String language) { Map currentLanguageValues = load(language); InputStream inputStream = getClass().getResourceAsStream("/lang/" + language + ".txt"); if (inputStream == null) { Stargate.logInfo(String.format("The language %s is not available. Falling back to english, You can add a " + "custom language by creating a new text file in the lang directory.", language)); Stargate.debug("LanguageLoader::updateLanguage", String.format("Unable to load /lang/%s.txt", language)); return; } try { readChangedLanguageStrings(inputStream, language, currentLanguageValues); } catch (IOException ex) { ex.printStackTrace(); } } /** * Reads language strings * * @param inputStream

The input stream to read from

* @param language

The selected language

* @param currentLanguageValues

The current values of the loaded/processed language

* @throws IOException

if unable to read a language file

*/ private void readChangedLanguageStrings(InputStream inputStream, String language, Map currentLanguageValues) throws IOException { //Get language values BufferedReader bufferedReader = FileHelper.getBufferedReaderFromInputStream(inputStream); Map internalLanguageValues = FileHelper.readKeyValuePairs(bufferedReader); //If currentLanguageValues is null; the chosen language has not been used before if (currentLanguageValues == null) { updateLanguageFile(language, internalLanguageValues, null); Stargate.logInfo(String.format("Language (%s) has been loaded", language)); return; } //If a key is not found in the language file, add the one in the internal file. Must update the external file if (!internalLanguageValues.keySet().equals(currentLanguageValues.keySet())) { Map newLanguageValues = new HashMap<>(); boolean updateNecessary = false; for (String key : internalLanguageValues.keySet()) { if (currentLanguageValues.get(key) == null) { newLanguageValues.put(key, internalLanguageValues.get(key)); //Found at least one value in the internal file not in the external file. Need to update updateNecessary = true; } else { newLanguageValues.put(key, currentLanguageValues.get(key)); currentLanguageValues.remove(key); } } //Update the file itself if (updateNecessary) { updateLanguageFile(language, newLanguageValues, currentLanguageValues); Stargate.logInfo(String.format("Your language file (%s.txt) has been updated", language)); } } } /** * Updates the language file for a given language * * @param language

The language to update

* @param languageStrings

The updated language strings

* @param customLanguageStrings

Any custom language strings not recognized

* @throws IOException

If unable to write to the language file

*/ private void updateLanguageFile(String language, Map languageStrings, Map customLanguageStrings) throws IOException { BufferedWriter bufferedWriter = FileHelper.getBufferedWriterFromString(languageFolder + language + ".txt"); //Output normal Language data for (String key : languageStrings.keySet()) { bufferedWriter.write(key + "=" + languageStrings.get(key)); bufferedWriter.newLine(); } bufferedWriter.newLine(); //Output any custom language strings the user had if (customLanguageStrings != null) { for (String key : customLanguageStrings.keySet()) { bufferedWriter.write(key + "=" + customLanguageStrings.get(key)); bufferedWriter.newLine(); } } bufferedWriter.close(); } /** * Loads the given language * * @param lang

The language to load

* @return

A mapping between loaded string indexes and the strings to display

*/ private Map load(String lang) { return load(lang, null); } /** * Loads the given language * * @param lang

The language to load

* @param inputStream

An optional input stream to use. Defaults to using a file input stream

* @return

A mapping between loaded string indexes and the strings to display

*/ private Map load(String lang, InputStream inputStream) { Map strings; BufferedReader bufferedReader; try { if (inputStream == null) { bufferedReader = FileHelper.getBufferedReaderFromString(languageFolder + lang + ".txt"); } else { bufferedReader = FileHelper.getBufferedReaderFromInputStream(inputStream); } strings = FileHelper.readKeyValuePairs(bufferedReader); } catch (Exception e) { if (Stargate.getStargateConfig().isDebuggingEnabled()) { Stargate.getConsoleLogger().info("[Stargate] Unable to load language " + lang); } return null; } return strings; } /** * Prints debug output to the console for checking loaded language strings/translations */ public void debug() { if (loadedStringTranslations != null) { Set keys = loadedStringTranslations.keySet(); for (String key : keys) { Stargate.debug("LanguageLoader::Debug::loadedStringTranslations", key + " => " + loadedStringTranslations.get(key)); } } if (loadedBackupStrings == null) { return; } Set keys = loadedBackupStrings.keySet(); for (String key : keys) { Stargate.debug("LanguageLoader::Debug::loadedBackupStrings", key + " => " + loadedBackupStrings.get(key)); } } }