javax.faces.validator.LengthValidator Maven / Gradle / Ivy
/*
* $Id: LengthValidator.java,v 1.49 2007/01/29 07:13:41 rlubke Exp $
*/
/*
* The contents of this file are subject to the terms
* of the Common Development and Distribution License
* (the License). You may not use this file except in
* compliance with the License.
*
* You can obtain a copy of the License at
* https://javaserverfaces.dev.java.net/CDDL.html or
* legal/CDDLv1.0.txt.
* See the License for the specific language governing
* permission and limitations under the License.
*
* When distributing Covered Code, include this CDDL
* Header Notice in each file and include the License file
* at legal/CDDLv1.0.txt.
* If applicable, add the following below the CDDL Header,
* with the fields enclosed by brackets [] replaced by
* your own identifying information:
* "Portions Copyrighted [year] [name of copyright owner]"
*
* [Name of File] [ver.__] [Date]
*
* Copyright 2005 Sun Microsystems Inc. All Rights Reserved
*/
package javax.faces.validator;
import javax.faces.component.StateHolder;
import javax.faces.component.UIComponent;
import javax.faces.context.FacesContext;
import javax.faces.convert.Converter;
/**
* LengthValidator is a {@link Validator} that checks
* the number of characters in the String representation of the value of the
* associated component. The following algorithm is implemented:
*
* - Convert the passed value to a String, if necessary, by calling its
*
toString() method.
* - If a
maximum property has been configured on this
* {@link Validator}, check the length of the converted
* String against this limit. If the String length is larger than the
* specified maximum, throw a {@link ValidatorException} containing a
* a MAXIMUM_MESSAGE_ID message.
* - If a
minimum property has been configured on this
* {@link Validator}, check the length of the converted
* String against this limit. If the String length is less than the
* specified minimum, throw a {@link ValidatorException} containing a
* 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 LengthValidator implements Validator, StateHolder {
// ------------------------------------------------------ Manifest Constants
/**
* The standard validator id for this validator.
*/
public static final String VALIDATOR_ID = "javax.faces.Length";
/**
* The message identifier of the {@link javax.faces.application.FacesMessage} to be created if
* the maximum length check fails. The message format string for
* this message may optionally include the following placeholders:
*
* {0} replaced by the configured maximum length.{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.LengthValidator.MAXIMUM";
/**
* The message identifier of the {@link javax.faces.application.FacesMessage} to be created if
* the minimum length check fails. The message format string for
* this message may optionally include the following placeholders:
*
* {0} replaced by the configured minimum length.{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.LengthValidator.MINIMUM";
// ------------------------------------------------------------ Constructors
/**
* Construct a {@link Validator} with no preconfigured limits.
*/
public LengthValidator() {
super();
}
/**
* Construct a {@link Validator} with the specified preconfigured
* limit.
*
* @param maximum Maximum value to allow
*/
public LengthValidator(int 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 LengthValidator(int maximum, int minimum) {
super();
setMaximum(maximum);
setMinimum(minimum);
}
// -------------------------------------------------------------- Properties
private int maximum = 0;
private boolean maximumSet = false;
/**
* Return the maximum length to be enforced by this {@link
* Validator}, or 0 if the maximum has not been
* set.
*/
public int getMaximum() {
return (this.maximum);
}
/**
* Set the maximum length to be enforced by this {@link Validator}.
*
* @param maximum The new maximum value
*/
public void setMaximum(int maximum) {
this.maximum = maximum;
this.maximumSet = true;
}
private int minimum = 0;
private boolean minimumSet = false;
/**
* Return the minimum length to be enforced by this {@link
* Validator}, or 0 if the minimum has not been
* set.
*/
public int getMinimum() {
return (this.minimum);
}
/**
* Set the minimum length to be enforced by this {@link Validator}.
*
* @param minimum The new minimum value
*/
public void setMinimum(int minimum) {
this.minimum = minimum;
this.minimumSet = true;
}
// ------------------------------------------------------- Validator Methods
/**
* @throws NullPointerException {@inheritDoc}
* @throws ValidatorException {@inheritDoc}
*/
public void validate(FacesContext context,
UIComponent component,
Object value) throws ValidatorException {
if ((context == null) || (component == null)) {
throw new NullPointerException();
}
if (value != null) {
String converted = stringValue(value);
if (maximumSet &&
(converted.length() > maximum)) {
throw new ValidatorException(MessageFactory.getMessage
(context,
MAXIMUM_MESSAGE_ID,
integerToString(component,
new Integer(maximum), context),
MessageFactory.getLabel(context, component)));
}
if (minimumSet &&
(converted.length() < minimum)) {
throw new ValidatorException(MessageFactory.getMessage
(context,
MINIMUM_MESSAGE_ID,
integerToString(component,
new Integer(minimum), context),
MessageFactory.getLabel(context, component)));
}
}
}
public boolean equals(Object otherObj) {
if (!(otherObj instanceof LengthValidator)) {
return false;
}
LengthValidator other = (LengthValidator) otherObj;
return ((maximum == other.maximum) &&
(minimum == other.minimum) &&
(maximumSet == other.maximumSet) &&
(minimumSet == other.minimumSet));
}
public int hashCode() {
int hashCode = minimum + maximum
+ Boolean.valueOf(minimumSet).hashCode()
+ Boolean.valueOf(maximumSet).hashCode();
return (hashCode);
}
// -------------------------------------------------------- Private Methods
/**
* Return the specified attribute value, converted to a
* String.
*
* @param attributeValue The attribute value to be converted
*/
private static String stringValue(Object attributeValue) {
if (attributeValue == null) {
return (null);
} else if (attributeValue instanceof String) {
return ((String) attributeValue);
} else {
return (attributeValue.toString());
}
}
private static String integerToString(UIComponent component,
Integer toConvert,
FacesContext context) {
Converter converter =
context.getApplication().createConverter("javax.faces.Number");
String result = converter.getAsString(context, component, toConvert);
return result;
}
// ----------------------------------------------------- StateHolder Methods
public Object saveState(FacesContext context) {
Object values[] = new Object[4];
values[0] = new Integer(maximum);
values[1] = maximumSet ? Boolean.TRUE : Boolean.FALSE;
values[2] = new Integer(minimum);
values[3] = minimumSet ? Boolean.TRUE : Boolean.FALSE;
return (values);
}
public void restoreState(FacesContext context, Object state) {
Object values[] = (Object[]) state;
maximum = ((Integer) values[0]).intValue();
maximumSet = ((Boolean) values[1]).booleanValue();
minimum = ((Integer) values[2]).intValue();
minimumSet = ((Boolean) values[3]).booleanValue();
}
private boolean transientValue = false;
public boolean isTransient() {
return (this.transientValue);
}
public void setTransient(boolean transientValue) {
this.transientValue = transientValue;
}
}