jakarta.faces.validator.DoubleRangeValidator Maven / Gradle / Ivy
Show all versions of jakarta.faces Show documentation
/*
* Copyright (c) 1997, 2020 Oracle and/or its affiliates. All rights reserved.
*
* This program and the accompanying materials are made available under the
* terms of the Eclipse Public License v. 2.0, which is available at
* http://www.eclipse.org/legal/epl-2.0.
*
* This Source Code may also be made available under the following Secondary
* Licenses when the conditions for such availability set forth in the
* Eclipse Public License v. 2.0 are satisfied: GNU General Public License,
* version 2 with the GNU Classpath Exception, which is available at
* https://www.gnu.org/software/classpath/license.html.
*
* SPDX-License-Identifier: EPL-2.0 OR GPL-2.0 WITH Classpath-exception-2.0
*/
package jakarta.faces.validator;
import jakarta.faces.component.PartialStateHolder;
import jakarta.faces.component.UIComponent;
import jakarta.faces.context.FacesContext;
import jakarta.faces.convert.Converter;
/**
*
* DoubleRangeValidator is a {@link Validator}
* that checks the value of the corresponding component against specified minimum and maximum values. The following
* algorithm is implemented:
*
*
*
* - If the passed value is
null, exit immediately.
* - If the current component value is not a floating point type, or a String that is convertible to double, throw a
* {@link ValidatorException} containing a TYPE_MESSAGE_ID message.
* - If both a
maximum and minimum property has been configured on this {@link Validator},
* check the component value against both limits. If the component value is not within this specified range, throw a
* {@link ValidatorException} containing a {@link #NOT_IN_RANGE_MESSAGE_ID} message.
* - If a
maximum property has been configured on this {@link Validator}, check the component value
* against this limit. If the component value is greater than the specified maximum, throw a {@link ValidatorException}
* containing a MAXIMUM_MESSAGE_ID message.
* - If a
minimum property has been configured on this {@link Validator}, check the component value
* against this limit. If the component value is less than the specified minimum, throw a {@link ValidatorException}
* containing a MINIMUM_MESSAGE_ID message.
*
*
*
* For all of the above cases that cause a {@link ValidatorException} to be thrown, if there are parameters to the
* message that match up with validator parameters, the values of these parameters must be converted using the
* {@link Converter} registered in the application under the converter id jakarta.faces.Number. This allows
* the values to be localized according to the current Locale.
*
*/
public class DoubleRangeValidator implements Validator, PartialStateHolder {
// ------------------------------------------------------ Manifest Constants
/**
*
* The standard converter id for this converter.
*
*/
public static final String VALIDATOR_ID = "jakarta.faces.DoubleRange";
/**
*
* The message identifier of the {@link jakarta.faces.application.FacesMessage} to be created if the maximum value check
* fails. The message format string for this message may optionally include the following placeholders:
*
* {0} replaced by the configured maximum value.{1} replaced by a String whose value is the label of the input component that produced
* this message.
*/
public static final String MAXIMUM_MESSAGE_ID = "jakarta.faces.validator.DoubleRangeValidator.MAXIMUM";
/**
*
* The message identifier of the {@link jakarta.faces.application.FacesMessage} to be created if the minimum value check
* fails. The message format string for this message may optionally include the following placeholders:
*
* {0} replaced by the configured minimum value.{1} replaced by a String whose value is the label of the input component that produced
* this message.
*/
public static final String MINIMUM_MESSAGE_ID = "jakarta.faces.validator.DoubleRangeValidator.MINIMUM";
/**
*
* The message identifier of the {@link jakarta.faces.application.FacesMessage} to be created if the maximum or minimum
* value check fails, and both the maximum and minimum values for this validator have been set. The message format
* string for this message may optionally include the following placeholders:
*
* {0} replaced by the configured minimum value.{1} replaced by the configured maximum value.{2} replaced by a String whose value is the label of the input component that produced
* this message.
*/
public static final String NOT_IN_RANGE_MESSAGE_ID = "jakarta.faces.validator.DoubleRangeValidator.NOT_IN_RANGE";
/**
*
* The message identifier of the {@link jakarta.faces.application.FacesMessage} to be created if the current value of
* this component is not of the correct type. The message format string for this message may optionally include a
* {0} placeholder that will be replaced by a String whose value is the label of the input
* component that produced this message.
*
*/
public static final String TYPE_MESSAGE_ID = "jakarta.faces.validator.DoubleRangeValidator.TYPE";
// ------------------------------------------------------------ Constructors
/**
*
* Construct a {@link Validator} with no preconfigured limits.
*
*/
public DoubleRangeValidator() {
super();
}
/**
*
* Construct a {@link Validator} with the specified preconfigured limit.
*
*
* @param maximum Maximum value to allow
*/
public DoubleRangeValidator(double maximum) {
super();
setMaximum(maximum);
}
/**
*
* Construct a {@link Validator} with the specified preconfigured limits.
*
*
* @param maximum Maximum value to allow
* @param minimum Minimum value to allow
*/
public DoubleRangeValidator(double maximum, double minimum) {
super();
setMaximum(maximum);
setMinimum(minimum);
}
// -------------------------------------------------------------- Properties
private Double maximum;
/**
*
* Return the maximum value to be enforced by this {@link Validator} or Double.MAX_VALUE if it has not been
* set.
*
*
* @return the maximum
*/
public double getMaximum() {
return maximum != null ? maximum : Double.MAX_VALUE;
}
/**
*
* Set the maximum value to be enforced by this {@link Validator}.
*
*
* @param maximum The new maximum value
*/
public void setMaximum(double maximum) {
clearInitialState();
this.maximum = maximum;
}
private Double minimum;
/**
*
* Return the minimum value to be enforced by this {@link Validator}, or Double.MIN_VALUE if it has not
* been set.
*
*
* @return the minimum value
*/
public double getMinimum() {
return minimum != null ? minimum : Double.MIN_VALUE;
}
/**
*
* Set the minimum value to be enforced by this {@link Validator}.
*
*
* @param minimum The new minimum value
*/
public void setMinimum(double minimum) {
clearInitialState();
this.minimum = minimum;
}
// ------------------------------------------------------- Validator Methods
/**
* @throws NullPointerException {@inheritDoc}
* @throws ValidatorException {@inheritDoc}
*/
@Override
public void validate(FacesContext context, UIComponent component, Object value) throws ValidatorException {
if (context == null || component == null) {
throw new NullPointerException();
}
if (value != null) {
try {
double converted = doubleValue(value);
if (isMaximumSet() && converted > maximum) {
if (isMinimumSet()) {
throw new ValidatorException(MessageFactory.getMessage(context, NOT_IN_RANGE_MESSAGE_ID, stringValue(component, minimum, context),
stringValue(component, maximum, context), MessageFactory.getLabel(context, component)));
} else {
throw new ValidatorException(MessageFactory.getMessage(context, MAXIMUM_MESSAGE_ID, stringValue(component, maximum, context),
MessageFactory.getLabel(context, component)));
}
}
if (isMinimumSet() && converted < minimum) {
if (isMaximumSet()) {
throw new ValidatorException(MessageFactory.getMessage(context, NOT_IN_RANGE_MESSAGE_ID, stringValue(component, minimum, context),
stringValue(component, maximum, context), MessageFactory.getLabel(context, component)));
} else {
throw new ValidatorException(MessageFactory.getMessage(context, MINIMUM_MESSAGE_ID, stringValue(component, minimum, context),
MessageFactory.getLabel(context, component)));
}
}
} catch (NumberFormatException e) {
throw new ValidatorException(MessageFactory.getMessage(context, TYPE_MESSAGE_ID, MessageFactory.getLabel(context, component)), e);
}
}
}
/**
*
* Overrides the default equals method to take the minimum and maximum into account when comparing DoubleRangeValidator
* instances.
*
*
* @param otherObj the object to compare against.
* @return true if equal, false otherwise.
*/
@Override
public boolean equals(Object otherObj) {
if (!(otherObj instanceof DoubleRangeValidator)) {
return false;
}
DoubleRangeValidator other = (DoubleRangeValidator) otherObj;
return getMaximum() == other.getMaximum() && getMinimum() == other.getMinimum() && isMaximumSet() == other.isMaximumSet()
&& isMinimumSet() == other.isMinimumSet();
}
/**
*
* Overrides the default hash code method to take the minimum and maximum into account when generating the hash code.
*
*
* @return the hash code.
*/
@Override
public int hashCode() {
int hashCode = Double.valueOf(getMinimum()).hashCode() + Double.valueOf(getMaximum()).hashCode() + Boolean.valueOf(isMinimumSet()).hashCode()
+ Boolean.valueOf(isMaximumSet()).hashCode();
return hashCode;
}
// --------------------------------------------------------- Private Methods
/**
*
* Return the specified attribute value, converted to a double.
*
*
* @param attributeValue The attribute value to be converted
* @throws NumberFormatException if conversion is not possible
*/
private static double doubleValue(Object attributeValue) throws NumberFormatException {
if (attributeValue instanceof Number) {
return ((Number) attributeValue).doubleValue();
} else {
return Double.parseDouble(attributeValue.toString());
}
}
private static String stringValue(UIComponent component, Double toConvert, FacesContext context) {
Converter converter = context.getApplication().createConverter("jakarta.faces.Number");
return converter.getAsString(context, component, toConvert);
}
private boolean isMaximumSet() {
return maximum != null;
}
private boolean isMinimumSet() {
return minimum != null;
}
// ----------------------------------------------------- StateHolder Methods
@Override
public Object saveState(FacesContext context) {
if (context == null) {
throw new NullPointerException();
}
if (!initialStateMarked()) {
Object values[] = new Object[2];
values[0] = maximum;
values[1] = minimum;
return values;
}
return null;
}
@Override
public void restoreState(FacesContext context, Object state) {
if (context == null) {
throw new NullPointerException();
}
if (state != null) {
Object values[] = (Object[]) state;
maximum = (Double) values[0];
minimum = (Double) values[1];
}
}
private boolean transientValue;
@Override
public boolean isTransient() {
return transientValue;
}
@Override
public void setTransient(boolean transientValue) {
this.transientValue = transientValue;
}
private boolean initialState;
@Override
public void markInitialState() {
initialState = true;
}
@Override
public boolean initialStateMarked() {
return initialState;
}
@Override
public void clearInitialState() {
initialState = false;
}
}