provide translation value replacement

src/main/java/de/marhali/easyi18n/model/Translation.java

@@ -7,6 +7,7 @@ import java.util.HashMap;
  * This class contains only the translations for this unspecific element.
  * @author marhali
  */
+@Deprecated // Replaced by TranslationValue
 public class Translation extends HashMap<String, String> {
     public Translation() {
         super();

src/main/java/de/marhali/easyi18n/model/translation/TranslationValue.java

@@ -0,0 +1,107 @@
+package de.marhali.easyi18n.model.translation;
+
+import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
+
+import java.util.HashMap;
+import java.util.Map;
+
+/**
+ * Represents the set values behind a specific translation.
+ * @author marhali
+ */
+public class TranslationValue {
+
+    private @Nullable String description;
+    private @NotNull Map<String, String> values;
+    private @Nullable Object misc;
+
+    public TranslationValue(@Nullable String description, @NotNull Map<String, String> values, @Nullable Object misc) {
+        this.description = description;
+        this.values = values;
+        this.misc = misc;
+    }
+
+    public TranslationValue(@NotNull Map<String, String> values) {
+        this(null, values, null);
+    }
+
+    public TranslationValue(@NotNull String locale, @NotNull String value) {
+        this(Map.of(locale, value));
+    }
+
+    public TranslationValue() {
+        this(null, new HashMap<>(), null);
+    }
+
+    /**
+     * Retrieve additional description for this translation
+     * @return Description
+     */
+    public @Nullable String getDescription() {
+        return description;
+    }
+
+    /**
+     * Override or set description for this translation
+     * @param description Description
+     */
+    public void setDescription(@Nullable String description) {
+        this.description = description;
+    }
+
+    /**
+     * Set locale specific values.
+     * @param values New values
+     */
+    public void setValues(@NotNull Map<String, String> values) {
+        this.values = values;
+    }
+
+    /**
+     * Overrides or sets a value for a specific locale.
+     * @param locale Locale type
+     * @param value New value
+     */
+    public void put(@NotNull String locale, @Nullable String value) {
+        if(value == null) { // Delete operation
+            values.remove(locale);
+        } else {
+            values.put(locale, value);
+        }
+    }
+
+    /**
+     * Retrieves the associated value for a specific locale
+     * @param locale Locale type
+     * @return Value or null if missing
+     */
+    public @Nullable String get(@NotNull String locale) {
+        return values.get(locale);
+    }
+
+    /**
+     * I18n support data
+     * @return Data
+     */
+    public @Nullable Object getMisc() {
+        return misc;
+    }
+
+    /**
+     * Set or update I18n support data
+     * @param misc New Data
+     */
+    public void setMisc(@Nullable Object misc) {
+        this.misc = misc;
+    }
+
+    @Override
+    public String toString() {
+        return "TranslationValue{" +
+                "description='" + description + '\'' +
+                ", values=" + values +
+                ", misc=" + misc +
+                '}';
+    }
+}