vaadin-framework/src/com/itmill/toolkit/data/validator/NullValidator.java

/* 
@ITMillApache2LicenseForJavaFiles@
 */

package com.itmill.toolkit.data.validator;

import com.itmill.toolkit.data.Validator;

/**
 * This validator is used for validating properties that do or do not allow null
 * values. By default, nulls are not allowed.
 * 
 * @author IT Mill Ltd.
 * @version
 * @VERSION@
 * @since 3.0
 */
public class NullValidator implements Validator {

    private boolean allowNull;

    private String errorMessage;

    /**
     * Creates a new NullValidator.
     * 
     * @param errorMessage
     *                the error message to display on invalidation.
     * @param allowNull
     *                Are nulls allowed?
     */
    public NullValidator(String errorMessage, boolean allowNull) {
        setErrorMessage(errorMessage);
        setNullAllowed(allowNull);
    }

    /**
     * Validates the data given in value.
     * 
     * @param value
     *                the value to validate.
     * @throws Validator.InvalidValueException
     *                 if the value was invalid.
     */
    public void validate(Object value) throws Validator.InvalidValueException {
        if ((allowNull && value != null) || (!allowNull && value == null)) {
            throw new Validator.InvalidValueException(errorMessage);
        }
    }

    /**
     * Tests if the given value is valid.
     * 
     * @param value
     *                the value to validate.
     * @returns <code>true</code> for valid value, otherwise
     *          <code>false</code>.
     */
    public boolean isValid(Object value) {
        return allowNull ? value == null : value != null;
    }

    /**
     * Returns <code>true</code> if nulls are allowed otherwise
     * <code>false</code>.
     */
    public final boolean isNullAllowed() {
        return allowNull;
    }

    /**
     * Sets if nulls are to be allowed.
     * 
     * @param allowNull
     *                If true, only nulls are allowed. If false only non-nulls
     *                are allowed. Do we allow nulls?
     */
    public void setNullAllowed(boolean allowNull) {
        this.allowNull = allowNull;
    }

    /**
     * Gets the error message that is displayed in case the value is invalid.
     * 
     * @return the Error Message.
     */
    public String getErrorMessage() {
        return errorMessage;
    }

    /**
     * Sets the error message to be displayed on invalid value.
     * 
     * @param errorMessage
     *                the Error Message to set.
     */
    public void setErrorMessage(String errorMessage) {
        this.errorMessage = errorMessage;
    }

}