javax.faces.validator.LongRangeValidator Maven / Gradle / Ivy
Show all versions of jboss-jsf-api_2.3_spec Show documentation
/*
* Copyright (c) 1997, 2018 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 javax.faces.validator;
import javax.faces.component.UIComponent;
import javax.faces.component.PartialStateHolder;
import javax.faces.context.FacesContext;
import javax.faces.convert.Converter;
/**
* LongRangeValidator 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 long,
* 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 javax.faces.Number. This allows
* the values to be localized according to the current
* Locale.
*/
public class LongRangeValidator implements Validator, PartialStateHolder {
// ------------------------------------------------------ Manifest Constants
/**
* The standard converter id for this converter.
*/
public static final String VALIDATOR_ID = "javax.faces.LongRange";
/**
* The message identifier of the {@link javax.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 =
"javax.faces.validator.LongRangeValidator.MAXIMUM";
/**
* The message identifier of the {@link javax.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 =
"javax.faces.validator.LongRangeValidator.MINIMUM";
/**
* The message identifier of the {@link javax.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 =
"javax.faces.validator.LongRangeValidator.NOT_IN_RANGE";
/**
* The message identifier of the {@link javax.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 =
"javax.faces.validator.LongRangeValidator.TYPE";
// ------------------------------------------------------------ Constructors
/**
* Construct a {@link Validator} with no preconfigured limits.
*/
public LongRangeValidator() {
super();
}
/**
* Construct a {@link Validator} with the specified preconfigured
* limit.
*
* @param maximum Maximum value to allow
*/
public LongRangeValidator(long 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 LongRangeValidator(long maximum, long minimum) {
super();
setMaximum(maximum);
setMinimum(minimum);
}
// -------------------------------------------------------------- Properties
private Long maximum;
/**
* Return the maximum value to be enforced by this {@link Validator}.
*
* @return the maximum
*/
public long getMaximum() {
return (this.maximum != null ? this.maximum : 0);
}
/**
* Set the maximum value to be enforced by this {@link Validator}.
*
* @param maximum The new maximum value
*/
public void setMaximum(long maximum) {
clearInitialState();
this.maximum = maximum;
}
private Long minimum;
/**
* Return the minimum value to be enforced by this {@link Validator}.
*
* @return the minimum
*/
public long getMinimum() {
return (this.minimum != null ? this.minimum : 0);
}
/**
* Set the minimum value to be enforced by this {@link Validator}.
*
* @param minimum The new minimum value
*/
public void setMinimum(long 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 {
long converted = longValue(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);
}
}
}
@Override
public boolean equals(Object otherObj) {
if (!(otherObj instanceof LongRangeValidator)) {
return false;
}
LongRangeValidator other = (LongRangeValidator) otherObj;
return ((this.getMaximum() == other.getMaximum())
&& (this.getMinimum() == other.getMinimum())
&& (this.isMaximumSet() == other.isMaximumSet())
&& (this.isMinimumSet() == other.isMinimumSet()));
}
@Override
public int hashCode() {
int hashCode = Long.valueOf(getMinimum()).hashCode()
+ Long.valueOf(getMaximum()).hashCode()
+ Boolean.valueOf(isMinimumSet()).hashCode()
+ Boolean.valueOf(isMaximumSet()).hashCode();
return (hashCode);
}
// --------------------------------------------------------- Private Methods
/**
* Return the specified attribute value, converted to a
* long.
*
* @param attributeValue The attribute value to be converted
* @throws NumberFormatException if conversion is not possible
*/
private static long longValue(Object attributeValue)
throws NumberFormatException {
if (attributeValue instanceof Number) {
return (((Number) attributeValue).longValue());
} else {
return (Long.parseLong(attributeValue.toString()));
}
}
private static String stringValue(UIComponent component,
Long toConvert,
FacesContext context) {
Converter converter =
context.getApplication().createConverter("javax.faces.Number");
return converter.getAsString(context, component, toConvert);
}
private boolean isMinimumSet() {
return (minimum != null);
}
private boolean isMaximumSet() {
return (maximum != 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 = (Long) values[0];
minimum = (Long) values[1];
}
}
private boolean transientValue;
@Override
public boolean isTransient() {
return (this.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;
}
}