X-Git-Url: https://git.pterodactylus.net/?p=Sone.git;a=blobdiff_plain;f=src%2Fmain%2Fjava%2Fnet%2Fpterodactylus%2Fsone%2Fcore%2FOptions.java;h=f280aaead58c69498e5b51ca817ee3bf9a234b35;hp=b7ece81fe64b8f87e794979c980eda6c3625e45d;hb=ecaea8c0b09431eabddd323a87fce59bba6f0238;hpb=33f333b35a73d3d4a4e79f41e9dd7b342db87b1a diff --git a/src/main/java/net/pterodactylus/sone/core/Options.java b/src/main/java/net/pterodactylus/sone/core/Options.java index b7ece81..f280aae 100644 --- a/src/main/java/net/pterodactylus/sone/core/Options.java +++ b/src/main/java/net/pterodactylus/sone/core/Options.java @@ -1,3 +1,20 @@ +/* + * Sone - Options.java - Copyright © 2010 David Roden + * + * This program is free software: you can redistribute it and/or modify + * it under the terms of the GNU General Public License as published by + * the Free Software Foundation, either version 3 of the License, or + * (at your option) any later version. + * + * This program is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU General Public License for more details. + * + * You should have received a copy of the GNU General Public License + * along with this program. If not, see . + */ + package net.pterodactylus.sone.core; import java.util.ArrayList; @@ -7,6 +24,8 @@ import java.util.HashMap; import java.util.List; import java.util.Map; +import net.pterodactylus.util.validation.Validator; + /** * Stores various options that influence Sone’s behaviour. * @@ -47,12 +66,26 @@ public class Options { public T getReal(); /** + * Validates the given value. Note that {@code null} is always a valid + * value! + * + * @param value + * The value to validate + * @return {@code true} if this option does not have a {@link Validator} + * , or the {@link Validator} validates this object, {@code + * false} otherwise + */ + public boolean validate(T value); + + /** * Sets the current value of the option. * * @param value * The new value of the option + * @throws IllegalArgumentException + * if the value is not valid for this option */ - public void set(T value); + public void set(T value) throws IllegalArgumentException; } @@ -96,6 +129,9 @@ public class Options { /** The current value. */ private volatile T value; + /** The validator. */ + private Validator validator; + /** The option watcher. */ private final List> optionWatchers = new ArrayList>(); @@ -108,7 +144,22 @@ public class Options { * The option watchers */ public DefaultOption(T defaultValue, OptionWatcher... optionWatchers) { + this(defaultValue, null, optionWatchers); + } + + /** + * Creates a new default option. + * + * @param defaultValue + * The default value of the option + * @param validator + * The validator for value validation + * @param optionWatchers + * The option watchers + */ + public DefaultOption(T defaultValue, Validator validator, OptionWatcher... optionWatchers) { this.defaultValue = defaultValue; + this.validator = validator; this.optionWatchers.addAll(Arrays.asList(optionWatchers)); } @@ -143,7 +194,18 @@ public class Options { * {@inheritDoc} */ @Override + public boolean validate(T value) { + return (validator == null) || (value == null) || validator.validate(value); + } + + /** + * {@inheritDoc} + */ + @Override public void set(T value) { + if ((value != null) && (validator != null) && (!validator.validate(value))) { + throw new IllegalArgumentException("New Value (" + value + ") could not be validated."); + } T oldValue = this.value; this.value = value; if (!get().equals(oldValue)) { @@ -164,6 +226,9 @@ public class Options { /** Holds all {@link String} {@link Option}s. */ private final Map> stringOptions = Collections.synchronizedMap(new HashMap>()); + /** Holds all {@link Enum} {@link Option}s. */ + private final Map>> enumOptions = Collections.synchronizedMap(new HashMap>>()); + /** * Adds a boolean option. * @@ -242,4 +307,37 @@ public class Options { return stringOptions.get(name); } + /** + * Adds an {@link Enum} {@link Option}. + * + * @param name + * The name of the option + * @param enumOption + * The option + * @return The given option + */ + public > Option addEnumOption(String name, Option enumOption) { + enumOptions.put(name, enumOption); + return enumOption; + } + + /** + * Returns a {@link Enum} {@link Option}. As the type can probably not be + * interred correctly you could help the compiler by calling this method + * like this: + *

+ * + *

+	 * options.<SomeEnum> getEnumOption("SomeEnumOption").get();
+	 * 
+ * + * @param name + * The name of the option + * @return The enum option, or {@code null} if there is no enum option with + * the given name + */ + public > Option getEnumOption(String name) { + return (Option) enumOptions.get(name); + } + }