Add validators

Issue 4253

Change-Id: Id5a06b7a2567cf5b23b7886f15faeb4f00a5cc34
Reviewed-on: http://gerrit.dmdirc.com/1456
Automatic-Compile: DMDirc Local Commits <dmdirc@googlemail.com>
Automatic-Compile: Gregory Holmes <greg@dmdirc.com>
Reviewed-by: Gregory Holmes <greg@dmdirc.com>

src/com/dmdirc/util/validators/FileNameValidator.java

@@ -0,0 +1,44 @@
+/*
+ * Copyright (c) 2006-2010 Chris Smith, Shane Mc Cormack, Gregory Holmes
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+package com.dmdirc.util.validators;
+
+/**
+ * Validates filenames.
+ */
+public class FileNameValidator implements Validator<String> {
+
+    /** Filename regex. */
+    private static final String FILENAME_REGEX = "[A-Za-z0-9 \\-_!]+";
+    /** Failure reason. */
+    private static final String FAILURE_REASON = "Must be a valid filename";
+
+    /** {@inheritDoc} */
+    @Override
+    public ValidationResponse validate(final String object) {
+        if (object.matches(FILENAME_REGEX)) {
+            return new ValidationResponse();
+        } else {
+            return new ValidationResponse(FAILURE_REASON);
+        }
+    }
+}

src/com/dmdirc/util/validators/IdentValidator.java

@@ -0,0 +1,45 @@
+/*
+ * Copyright (c) 2006-2010 Chris Smith, Shane Mc Cormack, Gregory Holmes
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+package com.dmdirc.util.validators;
+
+/**
+ * Validates idents.
+ */
+public class IdentValidator implements Validator<String> {
+
+    /** Ident regex. */
+    private static final String IDENT_REGEX = "[A-Za-z0-9\\[\\]{|}\\-\\^\\\\]*";
+    /** Failure reason. */
+    private static final String FAILURE_REASON = "Ident must only contain "
+            + "letters, numbers and []{}|-^\\.";
+
+    /** {@inheritDoc} */
+    @Override
+    public ValidationResponse validate(final String object) {
+        if (object.matches(IDENT_REGEX)) {
+            return new ValidationResponse();
+        } else {
+            return new ValidationResponse(FAILURE_REASON);
+        }
+    }
+}

src/com/dmdirc/util/validators/NicknameValidator.java

@@ -0,0 +1,45 @@
+/*
+ * Copyright (c) 2006-2010 Chris Smith, Shane Mc Cormack, Gregory Holmes
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+package com.dmdirc.util.validators;
+
+/**
+ * Validates nicknames.
+ */
+public class NicknameValidator implements Validator<String> {
+
+    /** Nickname regex. */
+    private static final String NICKNAME_REGEX = "[A-Za-z0-9\\[\\]{|}\\-\\^\\\\\\`\\_]+";
+    /** Failure reason. */
+    private static final String FAILURE_REASON = "Nickname must only contain "
+            + "letters, numbers and []{}|-^\\.`_";
+
+    /** {@inheritDoc} */
+    @Override
+    public ValidationResponse validate(final String object) {
+        if (object.matches(NICKNAME_REGEX)) {
+            return new ValidationResponse();
+        } else {
+            return new ValidationResponse(FAILURE_REASON);
+        }
+    }
+}

src/com/dmdirc/util/validators/NotEmptyValidator.java

@@ -0,0 +1,47 @@
+/*
+ * Copyright (c) 2006-2010 Chris Smith, Shane Mc Cormack, Gregory Holmes
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+package com.dmdirc.util.validators;
+
+/**
+ * Validator checking the string is not empty.
+ */
+public class NotEmptyValidator implements Validator<String> {
+
+    /**
+     * A version number for this class. It should be changed whenever the class
+     * structure is changed (or anything else that would prevent serialized
+     * objects being unserialized with the new class).
+     */
+    private static final long serialVersionUID = 1;
+
+    /** {@inheritDoc} */
+    @Override
+    public ValidationResponse validate(final String object) {
+        if (object == null || object.isEmpty()) {
+            return new ValidationResponse("Cannot be an empty string.");
+        } else {
+            return new ValidationResponse();
+        }
+    }
+
+}

src/com/dmdirc/util/validators/NumericalValidator.java

@@ -0,0 +1,90 @@
+/*
+ * Copyright (c) 2006-2010 Chris Smith, Shane Mc Cormack, Gregory Holmes
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+package com.dmdirc.util.validators;
+
+/**
+ * Validates that a number is within certain bounds.
+ *
+ * @author chris
+ */
+public class NumericalValidator implements Validator<String> {
+
+    /** The minimum value for this number. */
+    protected final int min;
+
+    /** The maximum value for this number. */
+    protected final int max;
+
+    /**
+     * Creates a new numerical validator with the specified bounds.
+     *
+     * @param min The minimum value for the number, or -1 for unlimited.
+     * @param max The maximum value for the number, or -1 for unlimited.
+     */
+    public NumericalValidator(int min, int max) {
+        this.max = max == -1 ? Integer.MAX_VALUE : max;
+        this.min = min == -1 ? Integer.MIN_VALUE : min;
+        if (this.min > this.max) {
+            throw new IllegalArgumentException("min must be less than max.");
+        }
+    }
+
+    /**
+     * Retrieves the maximum value that this validator will allow.
+     *
+     * @return This validator's maximum value
+     */
+    public int getMax() {
+        return max;
+    }
+
+    /**
+     * Retrieves the minimum value that this validator will allow.
+     *
+     * @return This validator's minimum value
+     */
+    public int getMin() {
+        return min;
+    }
+
+    /** {@inheritDoc} */
+    @Override
+    public ValidationResponse validate(final String object) {
+        int intv;
+
+        try {
+            intv = Integer.parseInt(object);
+        } catch (NumberFormatException ex) {
+            return new ValidationResponse("Must be a valid number");
+        }
+
+        if (intv < min) {
+            return new ValidationResponse("Must be at least " + min);
+        } else if (intv > max) {
+            return new ValidationResponse("Must be at most " + max);
+        } else {
+            return new ValidationResponse();
+        }
+    }
+
+}

src/com/dmdirc/util/validators/OptionalValidator.java

@@ -0,0 +1,69 @@
+/*
+ * Copyright (c) 2006-2010 Chris Smith, Shane Mc Cormack, Gregory Holmes
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+package com.dmdirc.util.validators;
+
+/**
+ * Validates an optional setting in tandem with another validator.
+ */
+public class OptionalValidator implements Validator<String> {
+
+    /** The minimum value for this number. */
+    protected final Validator<String> validator;
+
+    /**
+     * Creates a new Optional validator.
+     *
+     * @param validator The validator for the setting's value, if present
+     */
+    public OptionalValidator(final Validator<String> validator) {
+        this.validator = validator;
+    }
+
+    /**
+     * Gets the secondary validator.
+     *
+     * @return Secondary validator
+     */
+    public Validator<String> getValidator() {
+        return validator;
+    }
+
+    /** {@inheritDoc} */
+    @Override
+    public ValidationResponse validate(final String object) {
+        final int colonIndex = object.indexOf(':');
+
+        if (colonIndex == -1) {
+            return new ValidationResponse("Must contain boolean int seperator.");
+        }
+
+        final String booleanv = object.substring(0, colonIndex);
+
+        if (!"true".equals(booleanv) && !"false".equals(booleanv)) {
+            return new ValidationResponse("Must be true or false.");
+        }
+
+        return validator.validate(object.substring(colonIndex + 1));
+    }
+
+}

src/com/dmdirc/util/validators/PermissiveValidator.java

@@ -0,0 +1,48 @@
+/*
+ * Copyright (c) 2006-2010 Chris Smith, Shane Mc Cormack, Gregory Holmes
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+package com.dmdirc.util.validators;
+
+import com.dmdirc.util.validators.ValidationResponse;
+import com.dmdirc.util.validators.Validator;
+
+/**
+ * A validator that permits everything.
+ *
+ * @param <V> The type of data that this validator validates
+ * @author chris
+ */
+public class PermissiveValidator<V> implements Validator<V> {
+    
+    /**
+     * Creates a new instance of PermissiveValidator.
+     */
+    public PermissiveValidator() {
+        super();
+    }
+
+    /** {@inheritDoc} */
+    @Override
+    public ValidationResponse validate(final V object) {
+        return new ValidationResponse();
+    }
+
+}

src/com/dmdirc/util/validators/PortValidator.java

@@ -0,0 +1,41 @@
+/*
+ * Copyright (c) 2006-2010 Chris Smith, Shane Mc Cormack, Gregory Holmes
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+package com.dmdirc.util.validators;
+
+/**
+ * Validates a port number.
+ *
+ * @author chris
+ */
+public class PortValidator extends NumericalValidator {
+
+    /** The minimum port number. */
+    private static final int MIN_PORT = 1;
+
+    /** The maximum port number. */
+    private static final int MAX_PORT = 65535;
+
+    public PortValidator() {
+        super(MIN_PORT, MAX_PORT);
+    }
+
+}

src/com/dmdirc/util/validators/RegexStringValidator.java

@@ -0,0 +1,56 @@
+/*
+ * Copyright (c) 2006-2010 Chris Smith, Shane Mc Cormack, Gregory Holmes
+ * 
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ * 
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ * 
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+package com.dmdirc.util.validators;
+
+/**
+ * Regex validator.
+ */
+public class RegexStringValidator implements Validator<String> {
+
+    /** Regex. */
+    private final String regex;
+    /** Failure reason. */
+    private final String failedReason;
+
+    /**
+     * Instantiates a new regex validator.
+     *
+     * @param regex Regex to validate text against
+     * @param failedReason Reason for validation failure
+     */
+    public RegexStringValidator(final String regex, final String failedReason) {
+        this.regex = regex;
+        this.failedReason = failedReason;
+    }
+
+    /** {@inheritDoc} */
+    @Override
+    public ValidationResponse validate(final String object) {
+        if (object.matches(regex)) {
+            return new ValidationResponse();
+        } else {
+            return new ValidationResponse(failedReason);
+        }
+    }
+
+}

src/com/dmdirc/util/validators/RegexValidator.java

@@ -0,0 +1,46 @@
+/*
+ * Copyright (c) 2006-2010 Chris Smith, Shane Mc Cormack, Gregory Holmes
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+package com.dmdirc.util.validators;
+
+/**
+ * Validates a regular expression.
+ *
+ * @author chris
+ */
+public class RegexValidator implements Validator<String> {
+
+    /** {@inheritDoc} */
+    @Override
+    public ValidationResponse validate(final String object) {
+        try {
+            // Is there a proper way of doing this, as opposed to just seeing
+            // if it breaks?
+
+            "abc".matches(object);
+            return new ValidationResponse();
+        } catch (Exception ex) {
+            return new ValidationResponse(ex.getMessage());
+        }
+    }
+
+}

src/com/dmdirc/util/validators/StringLengthValidator.java

@@ -0,0 +1,61 @@
+/*
+ * Copyright (c) 2006-2010 Chris Smith, Shane Mc Cormack, Gregory Holmes
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+package com.dmdirc.util.validators;
+
+/**
+ * Validates that the length of a string is within certain bounds.
+ * 
+ * @author chris
+ */
+public class StringLengthValidator implements Validator<String> {
+    
+    /** The minimum string length. */
+    protected final int min;
+    
+    /** The maximum string length. */
+    protected final int max;
+
+    /**
+     * Creates a new string length validator that requires a string be between
+     * the specified min/max length.
+     *
+     * @param min The minimum length of the string, or -1 for unlimited.
+     * @param max The maximum length of the string, or -1 for unlimited.
+     */
+    public StringLengthValidator(final int min, final int max) {
+        this.min = min;
+        this.max = max;
+    }
+
+    /** {@inheritDoc} */
+    @Override
+    public ValidationResponse validate(final String object) {
+        if (object.length() < min && min != -1) {
+            return new ValidationResponse("Must be at least " + min + " characters long");
+        } else if (object.length() > max && max != -1) {
+            return new ValidationResponse("Must be at most " + max + " characters long");
+        } else {
+            return new ValidationResponse();
+        }
+    }
+
+}

src/com/dmdirc/util/validators/URIValidator.java

@@ -0,0 +1,49 @@
+/*
+ * Copyright (c) 2006-2010 Chris Smith, Shane Mc Cormack, Gregory Holmes
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+package com.dmdirc.util.validators;
+
+import java.net.URI;
+import java.net.URISyntaxException;
+
+/**
+ * Validates a string to see if it compiles to a URI.
+ */
+public class URIValidator implements Validator<String> {
+
+    /** {@inheritDoc} */
+    @Override
+    public ValidationResponse validate(final String object) {
+        ValidationResponse result;
+        try {
+            final URI uri = new URI(object);
+            if (uri.getHost() == null || uri.getHost().isEmpty()) {
+                result = new ValidationResponse("Address requires a hostname.");
+            } else {
+                result = new ValidationResponse();
+            }
+        } catch (URISyntaxException ex) {
+            result = new ValidationResponse(ex.getReason());
+        }
+        return result;
+    }
+}

src/com/dmdirc/util/validators/ValidationResponse.java

@@ -0,0 +1,69 @@
+/*
+ * Copyright (c) 2006-2010 Chris Smith, Shane Mc Cormack, Gregory Holmes
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+package com.dmdirc.util.validators;
+
+/**
+ * Describes the response from a Validator. The response may be either positive
+ * or negative. Negative responses have an associated failure reason.
+ *
+ * @author chris
+ */
+public class ValidationResponse {
+
+    /** The failure reason, or null if the validation passed. */
+    private final String failure;
+
+    /**
+     * Creates a new ValidationResponse for a positive response.
+     */
+    public ValidationResponse() {
+        this(null);
+    }
+
+    /**
+     * Creates a new ValidationResponse for a negative response.
+     *
+     * @param failure The reason for the negative response.
+     */
+    public ValidationResponse(final String failure) {
+        this.failure = failure;
+    }
+
+    /**
+     * Determines whether or not this response indicates that a failure occured.
+     *
+     * @return True if a failure occured, false otherwise.
+     */
+    public boolean isFailure() {
+        return failure != null;
+    }
+
+    /**
+     * Retrieves the reason for the validation failure.
+     *
+     * @return The reason for the validation failure.
+     */
+    public String getFailureReason() {
+        return failure;
+    }
+
+}

src/com/dmdirc/util/validators/Validator.java

@@ -0,0 +1,42 @@
+/*
+ * Copyright (c) 2006-2010 Chris Smith, Shane Mc Cormack, Gregory Holmes
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+package com.dmdirc.util.validators;
+
+/**
+ * Validator interface.
+ *
+ * @param <V> Type to validate
+ */
+public interface Validator<V> {
+
+    /**
+     * Validates the object.
+     *
+     * @param object Object to validate
+     *
+     * @return A validation response indicating the success/failure of the
+     * validation
+     */
+    ValidationResponse validate(final V object);
+
+}

src/com/dmdirc/util/validators/ValidatorChain.java

@@ -0,0 +1,65 @@
+/*
+ * Copyright (c) 2006-2010 Chris Smith, Shane Mc Cormack, Gregory Holmes
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+package com.dmdirc.util.validators;
+
+import java.util.ArrayList;
+import java.util.List;
+
+/**
+ * Allows multiple validators to be chained together.
+ *
+ * @param <A> The type of class that this chain validates
+ * @author chris
+ */
+public class ValidatorChain<A> implements Validator<A> {
+
+    /** A list of validators to use. */
+    private final List<Validator<A>> validatorList
+            = new ArrayList<Validator<A>>();
+
+    /**
+     * Creates a new validator chain containing the specified validators.
+     *
+     * @param validators The validators to be used in this chain.
+     */
+    public ValidatorChain(final Validator<A> ... validators) {
+        for (Validator<A> validator : validators) {
+            validatorList.add(validator);
+        }
+    }
+
+    /** {@inheritDoc} */
+    @Override
+    public ValidationResponse validate(final A object) {
+        for (Validator<A> validator : validatorList) {
+            final ValidationResponse res = validator.validate(object);
+
+            if (res.isFailure()) {
+                return res;
+            }
+        }
+
+        return new ValidationResponse();
+    }
+
+}

test/com/dmdirc/util/validators/FileNameValidatorTest.java

@@ -0,0 +1,39 @@
+/*
+ * Copyright (c) 2006-2010 Chris Smith, Shane Mc Cormack, Gregory Holmes
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+package com.dmdirc.util.validators;
+
+import com.dmdirc.util.validators.FileNameValidator;
+import org.junit.Test;
+import static org.junit.Assert.*;
+
+public class FileNameValidatorTest {
+
+    @Test
+    public void testValidate() {
+        final FileNameValidator rv = new FileNameValidator();
+        
+        assertTrue(rv.validate("/foo").isFailure());
+        assertFalse(rv.validate("filename").isFailure());
+    }
+
+}

test/com/dmdirc/util/validators/IdentValidatorTest.java

@@ -0,0 +1,41 @@
+/*
+ * Copyright (c) 2006-2010 Chris Smith, Shane Mc Cormack, Gregory Holmes
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+package com.dmdirc.util.validators;
+
+import com.dmdirc.util.validators.IdentValidator;
+import org.junit.Test;
+import static org.junit.Assert.*;
+
+public class IdentValidatorTest {
+
+    @Test
+    public void testPass() {
+        assertTrue(new IdentValidator().validate("foo bar").isFailure());
+    }
+
+    @Test
+    public void testFail() {
+        assertFalse(new IdentValidator().validate("foo[]bar").isFailure());
+    }
+
+}

test/com/dmdirc/util/validators/NicknameValidatorTest.java

@@ -0,0 +1,41 @@
+/*
+ * Copyright (c) 2006-2010 Chris Smith, Shane Mc Cormack, Gregory Holmes
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+package com.dmdirc.util.validators;
+
+import com.dmdirc.util.validators.NicknameValidator;
+import org.junit.Test;
+import static org.junit.Assert.*;
+
+public class NicknameValidatorTest {
+
+    @Test
+    public void testPass() {
+        assertTrue(new NicknameValidator().validate("foo bar").isFailure());
+    }
+
+    @Test
+    public void testFail() {
+        assertFalse(new NicknameValidator().validate("foo[]bar").isFailure());
+    }
+
+}

test/com/dmdirc/util/validators/NotEmptyValidatorTest.java

@@ -0,0 +1,40 @@
+/*
+ * Copyright (c) 2006-2010 Chris Smith, Shane Mc Cormack, Gregory Holmes
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+package com.dmdirc.util.validators;
+
+import com.dmdirc.util.validators.NotEmptyValidator;
+import org.junit.Test;
+import static org.junit.Assert.*;
+
+public class NotEmptyValidatorTest {
+
+    @Test
+    public void testValidate() {
+        final NotEmptyValidator nev = new NotEmptyValidator();
+        
+        assertTrue(nev.validate("").isFailure());
+        assertTrue(nev.validate("").getFailureReason().indexOf("empty") > -1);
+        assertFalse(nev.validate("moo").isFailure());
+        assertFalse(nev.validate(" ").isFailure());
+    }
+
+}

test/com/dmdirc/util/validators/NumericalValidatorTest.java

@@ -0,0 +1,76 @@
+/*
+ * Copyright (c) 2006-2010 Chris Smith, Shane Mc Cormack, Gregory Holmes
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+package com.dmdirc.util.validators;
+
+import com.dmdirc.util.validators.ValidationResponse;
+import com.dmdirc.util.validators.NumericalValidator;
+import org.junit.Test;
+import static org.junit.Assert.*;
+
+public class NumericalValidatorTest {
+
+    @Test
+    public void testGetMax() {
+        assertEquals(10, new NumericalValidator(1, 10).getMax());
+        assertEquals(Integer.MAX_VALUE, new NumericalValidator(1, -1).getMax());
+    }
+
+    @Test
+    public void testGetMin() {
+        assertEquals(1, new NumericalValidator(1, 10).getMin());
+        assertEquals(Integer.MIN_VALUE, new NumericalValidator(-1, 10).getMin());
+    }
+
+    @Test
+    public void testNAN() {
+        final ValidationResponse vr = new NumericalValidator(3, 5).validate("foo");
+        
+        assertTrue(vr.isFailure());
+        assertTrue(vr.getFailureReason().indexOf("number") > -1);
+    }
+    
+    @Test
+    public void testMin() {
+        final NumericalValidator nv1 = new NumericalValidator(-1, -1);
+        final NumericalValidator nv2 = new NumericalValidator(-5, -1);
+        
+        assertFalse(nv1.validate("-5").isFailure());
+        assertFalse(nv2.validate("-5").isFailure());
+        assertFalse(nv2.validate("-4").isFailure());
+        assertFalse(nv2.validate("10").isFailure());
+        assertTrue(nv2.validate("-6").isFailure());
+    }
+    
+    @Test
+    public void testMax() {
+        final NumericalValidator nv1 = new NumericalValidator(-1, -1);
+        final NumericalValidator nv2 = new NumericalValidator(-1, 10);
+        
+        assertFalse(nv1.validate("-5").isFailure());
+        assertFalse(nv1.validate("50").isFailure());
+        assertFalse(nv2.validate("-5").isFailure());
+        assertFalse(nv2.validate("-4").isFailure());
+        assertFalse(nv2.validate("10").isFailure());
+        assertTrue(nv2.validate("11").isFailure());
+    }    
+
+}

test/com/dmdirc/util/validators/OptionalValidatorTest.java

@@ -0,0 +1,63 @@
+/*
+ * Copyright (c) 2006-2010 Chris Smith, Shane Mc Cormack, Gregory Holmes
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+package com.dmdirc.util.validators;
+
+import com.dmdirc.util.validators.OptionalValidator;
+import com.dmdirc.util.validators.ValidationResponse;
+import com.dmdirc.util.validators.StringLengthValidator;
+import org.junit.Test;
+import static org.junit.Assert.*;
+
+public class OptionalValidatorTest {
+
+    @Test
+    public void testNoSeparator() {
+        final ValidationResponse res = new OptionalValidator(null).validate("foo");
+        assertTrue(res.isFailure());
+        assertTrue(res.getFailureReason().contains("boolean"));
+    }
+
+    @Test
+    public void testIllegalPrefix() {
+        final ValidationResponse res = new OptionalValidator(null).validate("foo:bar");
+        assertTrue(res.isFailure());
+        assertTrue(res.getFailureReason().contains("true"));
+        assertTrue(res.getFailureReason().contains("false"));
+    }
+
+    @Test
+    public void testTrueValidation() {
+        final ValidationResponse res = new OptionalValidator(new StringLengthValidator(0, 3))
+                .validate("true:bar");
+        assertFalse(res.isFailure());
+    }
+
+    @Test
+    public void testFalseValidation() {
+        final ValidationResponse res = new OptionalValidator(new StringLengthValidator(0, 2))
+                .validate("true:bar");
+        assertTrue(res.isFailure());
+        assertTrue(res.getFailureReason().contains("at most 2"));
+    }
+
+}

test/com/dmdirc/util/validators/PermissiveValidatorTest.java

@@ -0,0 +1,36 @@
+/*
+ * Copyright (c) 2006-2010 Chris Smith, Shane Mc Cormack, Gregory Holmes
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+package com.dmdirc.util.validators;
+
+import com.dmdirc.util.validators.PermissiveValidator;
+import org.junit.Test;
+import static org.junit.Assert.*;
+
+public class PermissiveValidatorTest {
+
+    @Test
+    public void testValidate() {
+        assertFalse(new PermissiveValidator<String>().validate("abc").isFailure());
+        assertFalse(new PermissiveValidator<String>().validate(null).isFailure());
+    }
+
+}

test/com/dmdirc/util/validators/PortValidatorTest.java

@@ -0,0 +1,38 @@
+/*
+ * Copyright (c) 2006-2010 Chris Smith, Shane Mc Cormack, Gregory Holmes
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+package com.dmdirc.util.validators;
+
+import com.dmdirc.util.validators.PortValidator;
+import org.junit.Test;
+import static org.junit.Assert.*;
+
+public class PortValidatorTest {
+
+    @Test
+    public void testBounds() {
+        final PortValidator pv = new PortValidator();
+        
+        assertEquals(1, pv.getMin());
+        assertEquals(65535, pv.getMax());
+    }
+
+}

test/com/dmdirc/util/validators/RegexStringValidatorTest.java

@@ -0,0 +1,40 @@
+/*
+ * Copyright (c) 2006-2010 Chris Smith, Shane Mc Cormack, Gregory Holmes
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+package com.dmdirc.util.validators;
+
+import com.dmdirc.util.validators.RegexStringValidator;
+import org.junit.Test;
+import static org.junit.Assert.*;
+
+public class RegexStringValidatorTest {
+
+    @Test
+    public void testValidate() {
+        final String reason = "abc 123";
+        final RegexStringValidator rv = new RegexStringValidator("[0-9]{5}", reason);
+        
+        assertTrue(rv.validate("abc").isFailure());
+        assertEquals(reason, rv.validate("abc").getFailureReason());
+        assertFalse(rv.validate("55555").isFailure());
+    }
+
+}

test/com/dmdirc/util/validators/RegexValidatorTest.java

@@ -0,0 +1,39 @@
+/*
+ * Copyright (c) 2006-2010 Chris Smith, Shane Mc Cormack, Gregory Holmes
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+package com.dmdirc.util.validators;
+
+import com.dmdirc.util.validators.RegexValidator;
+import org.junit.Test;
+import static org.junit.Assert.*;
+
+public class RegexValidatorTest {
+
+    @Test
+    public void testValidate() {
+        final RegexValidator rv = new RegexValidator();
+        
+        assertTrue(rv.validate("****").isFailure());
+        assertFalse(rv.validate("[a-z]").isFailure());
+    }
+
+}

test/com/dmdirc/util/validators/StringLengthValidatorTest.java

@@ -0,0 +1,68 @@
+/*
+ * Copyright (c) 2006-2010 Chris Smith, Shane Mc Cormack, Gregory Holmes
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+package com.dmdirc.util.validators;
+
+import com.dmdirc.util.validators.StringLengthValidator;
+import org.junit.Test;
+import static org.junit.Assert.*;
+
+public class StringLengthValidatorTest {
+
+    @Test
+    public void testUnlimited() {
+        final StringLengthValidator slv = new StringLengthValidator(-1, 10);
+        
+        assertFalse(slv.validate("123").isFailure());
+        assertFalse(slv.validate("").isFailure());
+        assertFalse(slv.validate("123456789").isFailure());
+        
+        final StringLengthValidator slv2 = new StringLengthValidator(0, -1);
+        
+        assertFalse(slv2.validate("123456789").isFailure());
+        assertFalse(slv2.validate("1").isFailure());
+    }
+    
+    @Test
+    public void testMinimum() {
+        final StringLengthValidator slv = new StringLengthValidator(5, 100);
+        
+        assertTrue(slv.validate("").isFailure());
+        assertTrue(slv.validate("123").isFailure());
+        assertTrue(slv.validate("1234").isFailure());
+        assertTrue(slv.validate("1234").getFailureReason().indexOf("at least 5") > -1);
+        assertFalse(slv.validate("12345").isFailure());
+        assertFalse(slv.validate("12345789").isFailure());
+    }
+    
+    @Test
+    public void testMaximum() {
+        final StringLengthValidator slv = new StringLengthValidator(0, 3);
+        
+        assertFalse(slv.validate("").isFailure());
+        assertFalse(slv.validate("12").isFailure());
+        assertFalse(slv.validate("123").isFailure());
+        assertTrue(slv.validate("1234").isFailure());
+        assertTrue(slv.validate("1234").getFailureReason().indexOf("at most 3") > -1);
+        assertTrue(slv.validate("12345").isFailure());
+    }    
+
+}

test/com/dmdirc/util/validators/ValidatorChainTest.java

@@ -0,0 +1,44 @@
+/*
+ * Copyright (c) 2006-2010 Chris Smith, Shane Mc Cormack, Gregory Holmes
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+package com.dmdirc.util.validators;
+
+import com.dmdirc.util.validators.ValidatorChain;
+import com.dmdirc.util.validators.RegexStringValidator;
+import com.dmdirc.util.validators.NotEmptyValidator;
+import org.junit.Test;
+import static org.junit.Assert.*;
+
+public class ValidatorChainTest {
+
+    @Test
+    public void testValidate() {
+        @SuppressWarnings("unchecked")
+        final ValidatorChain<String> chain = new ValidatorChain<String>(
+                new NotEmptyValidator(), new RegexStringValidator("[a-z]*", "abc"));
+        
+        assertTrue(chain.validate("").isFailure());
+        assertTrue(chain.validate("__").isFailure());
+        assertFalse(chain.validate("abc").isFailure());
+    }
+
+}