/*
* Licensed to the Apache Software Foundation (ASF) under one or more
* contributor license agreements. See the NOTICE file distributed with this
* work for additional information regarding copyright ownership. The ASF
* licenses this file to You under the Apache License, Version 2.0 (the
* "License"); you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
* http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law
* or agreed to in writing, software distributed under the License is
* distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
* KIND, either express or implied. See the License for the specific language
* governing permissions and limitations under the License.
*/
package easyJ.common.validate;
import java.io.Serializable;
import java.util.Locale;
import org.apache.oro.text.perl.Perl5Util;
import java.math.BigDecimal;
import java.util.ArrayList;
import java.util.List;
/**
* This class contains basic methods for performing validations.
*
* @version $Revision: 1.1.1.1 $ $Date: 2008/05/12 09:53:37 $
*/
public class GenericValidator implements Serializable {
/**
* UrlValidator used in wrapper method.
*/
private static final UrlValidator URL_VALIDATOR = new UrlValidator();
/**
* CreditCardValidator used in wrapper method.
*/
private static final CreditCardValidator CREDIT_CARD_VALIDATOR = new CreditCardValidator();
/**
* <p>
* Checks if the field isn't null and length of the field is greater than
* zero not including whitespace.
* </p>
*
* @param value
* The value validation is being performed on.
* @return true if blank or null.
*/
public static boolean isBlankOrNull(String value) {
return ((value == null) || (value.trim().length() == 0));
}
/**
* <p>
* Checks if the value matches the regular expression.
* </p>
*
* @param value
* The value validation is being performed on.
* @param regexp
* The regular expression.
* @return true if matches the regular expression.
*/
public static boolean matchRegexp(String value, String regexp) {
if (regexp == null || regexp.length() <= 0) {
return false;
}
Perl5Util matcher = new Perl5Util();
return matcher.match("/" + regexp + "/", value);
}
/**
* <p>
* Checks if the value can safely be converted to a byte primitive.
* </p>
*
* @param value
* The value validation is being performed on.
* @return true if the value can be converted to a Byte.
*/
public static boolean isByte(String value) {
if (value == null)
return true;
return (GenericTypeValidator.formatByte(value) != null);
}
/**
* <p>
* Checks if the value can safely be converted to a short primitive.
* </p>
*
* @param value
* The value validation is being performed on.
* @return true if the value can be converted to a Short.
*/
public static boolean isShort(String value) {
if (value == null)
return true;
return (GenericTypeValidator.formatShort(value) != null);
}
/**
* <p>
* Checks if the value can safely be converted to a int primitive.
* </p>
*
* @param value
* The value validation is being performed on.
* @return true if the value can be converted to an Integer.
*/
public static boolean isInt(String value) {
if (value == null)
return true;
return (GenericTypeValidator.formatInt(value) != null);
}
/**
* <p>
* Checks if the value can safely be converted to a long primitive.
* </p>
*
* @param value
* The value validation is being performed on.
* @return true if the value can be converted to a Long.
*/
public static boolean isLong(String value) {
if (value == null)
return true;
return (GenericTypeValidator.formatLong(value) != null);
}
/**
* <p>
* Checks if the value can safely be converted to a float primitive.
* </p>
*
* @param value
* The value validation is being performed on.
* @return true if the value can be converted to a Float.
*/
public static boolean isFloat(String value) {
if (value == null)
return true;
return (GenericTypeValidator.formatFloat(value) != null);
}
/**
* <p>
* Checks if the value can safely be converted to a double primitive.
* </p>
*
* @param value
* The value validation is being performed on.
* @return true if the value can be converted to a Double.
*/
public static boolean isDouble(String value) {
if (value == null)
return true;
return (GenericTypeValidator.formatDouble(value) != null);
}
/**
* <p>
* Checks if the field is a valid date. The <code>Locale</code> is used
* with <code>java.text.DateFormat</code>. The setLenient method is set
* to <code>false</code> for all.
* </p>
*
* @param value
* The value validation is being performed on.
* @param locale
* The locale to use for the date format, defaults to the
* system default if null.
* @return true if the value can be converted to a Date.
*/
public static boolean isDate(String value, Locale locale) {
return DateValidator.getInstance().isValid(value, locale);
}
/**
* <p>
* Checks if the class is a set type class.
* </p>
*
* @param value
* The value validation is being performed on.
* @param locale
* The locale to use for the date format, defaults to the
* system default if null.
* @return true if the value can be converted to a Date.
*/
public static boolean isSetType(Class type) {
Class[] types = type.getClasses();
Class[] interfaceTypes = type.getInterfaces();
for (int i = 0; i < types.length; i++)
if (types[i].equals(ArrayList.class) || types[i].equals(List.class))
return true;
for (int i = 0; i < interfaceTypes.length; i++)
if (interfaceTypes[i].equals(ArrayList.class)
|| interfaceTypes[i].equals(List.class))
return true;
return false;
}
/**
* <p>
* Checks if the field is a valid date. The pattern is used with
* <code>java.text.SimpleDateFormat</code>. If strict is true, then the
* length will be checked so '2/12/1999' will not pass validation with the
* format 'MM/dd/yyyy' because the month isn't two digits. The setLenient
* method is set to <code>false</code> for all.
* </p>
*
* @param value
* The value validation is being performed on.
* @param datePattern
* The pattern passed to <code>SimpleDateFormat</code>.
* @param strict
* Whether or not to have an exact match of the datePattern.
* @return true if the value can be converted to a Date.
*/
public static boolean isDate(String value, String datePattern,
boolean strict) {
return DateValidator.getInstance().isValid(value, datePattern, strict);
}
/**
* <p>
* Checks if a value is within a range (min & max specified in the vars
* attribute).
* </p>
*
* @param value
* The value validation is being performed on.
* @param min
* The minimum value of the range.
* @param max
* The maximum value of the range.
* @return true if the value is in the specified range.
*/
public static boolean isInRange(byte value, byte min, byte max) {
return ((value >= min) && (value <= max));
}
/**
* <p>
* Checks if a value is within a range (min & max specified in the vars
* attribute).
* </p>
*
* @param value
* The value validation is being performed on.
* @param min
* The minimum value of the range.
* @param max
* The maximum value of the range.
* @return true if the value is in the specified range.
*/
public static boolean isInRange(int value, int min, int max) {
return ((value >= min) && (value <= max));
}
/**
* <p>
* Checks if a value is within a range (min & max specified in the vars
* attribute).
* </p>
*
* @param value
* The value validation is being performed on.
* @param min
* The minimum value of the range.
* @param max
* The maximum value of the range.
* @return true if the value is in the specified range.
*/
public static boolean isInRange(float value, float min, float max) {
return ((value >= min) && (value <= max));
}
/**
* <p>
* Checks if a value is within a range (min & max specified in the vars
* attribute).
* </p>
*
* @param value
* The value validation is being performed on.
* @param min
* The minimum value of the range.
* @param max
* The maximum value of the range.
* @return true if the value is in the specified range.
*/
public static boolean isInRange(short value, short min, short max) {
return ((value >= min) && (value <= max));
}
/**
* <p>
* Checks if a value is within a range (min & max specified in the vars
* attribute).
* </p>
*
* @param value
* The value validation is being performed on.
* @param min
* The minimum value of the range.
* @param max
* The maximum value of the range.
* @return true if the value is in the specified range.
*/
public static boolean isInRange(long value, long min, long max) {
return ((value >= min) && (value <= max));
}
/**
* <p>
* Checks if a value is within a range (min & max specified in the vars
* attribute).
* </p>
*
* @param value
* The value validation is being performed on.
* @param min
* The minimum value of the range.
* @param max
* The maximum value of the range.
* @return true if the value is in the specified range.
*/
public static boolean isInRange(double value, double min, double max) {
return ((value >= min) && (value <= max));
}
/**
* <p>
* Checks if a value is within a range (min & max specified in the vars
* attribute).
* </p>
*
* @param value
* The value validation is being performed on.
* @param min
* The minimum value of the range.
* @param max
* The maximum value of the range.
* @return true if the value is in the specified range.
*/
public static boolean isInRange(String value, String min, String max,
Class type) {
if (type.equals(Integer.class))
return isInRange(Integer.parseInt(value), Integer.parseInt(min),
Integer.parseInt(max));
if (type.equals(Double.class))
return isInRange(Double.parseDouble(value),
Double.parseDouble(min), Double.parseDouble(max));
if (type.equals(Long.class))
return isInRange(Long.parseLong(value), Long.parseLong(min), Long
.parseLong(max));
if (type.equals(Float.class))
return isInRange(Float.parseFloat(value), Float.parseFloat(min),
Float.parseFloat(max));
if (type.equals(BigDecimal.class)) {
if (new BigDecimal(value).compareTo(new BigDecimal(min)) < 0)
return false;
if (new BigDecimal(value).compareTo(new BigDecimal(min)) > 0)
return false;
else
return true;
}
return false;
}
/**
* Checks if the field is a valid credit card number.
*
* @param value
* The value validation is being performed on.
* @return true if the value is valid Credit Card Number.
*/
public static boolean isCreditCard(String value) {
return CREDIT_CARD_VALIDATOR.isValid(value);
}
/**
* <p>
* Checks if a field has a valid e-mail address.
* </p>
*
* @param value
* The value validation is being performed on.
* @return true if the value is valid Email Address.
*/
public static boolean isEmail(String value) {
if (isBlankOrNull(value))
return true;
return EmailValidator.getInstance().isValid(value);
}
/**
* <p>
* Checks if a field is a valid url address.
* </p>
* If you need to modify what is considered valid then consider using the
* UrlValidator directly.
*
* @param value
* The value validation is being performed on.
* @return true if the value is valid Url.
*/
public static boolean isUrl(String value) {
return URL_VALIDATOR.isValid(value);
}
/**
* <p>
* Checks if the value's length is less than or equal to the max.
* </p>
*
* @param value
* The value validation is being performed on.
* @param max
* The maximum length.
* @return true if the value's length is less than the specified maximum.
*/
public static boolean maxLength(String value, int max) {
return (value.length() <= max);
}
/**
* <p>
* Checks if the value's length is less than or equal to the max.
* </p>
* 这里用maxLen这个方法名是因为在客户端maxLength用作方法名是有问题的。
*
* @param value
* The value validation is being performed on.
* @param max
* The maximum length.
* @return true if the value's length is less than the specified maximum.
*/
public static boolean maxLen(String value, String max) {
if (value == null)
return true;
return (value.length() <= Integer.parseInt(max));
}
/**
* <p>
* Checks if the value's adjusted length is less than or equal to the max.
* </p>
*
* @param value
* The value validation is being performed on.
* @param max
* The maximum length.
* @param lineEndLength
* The length to use for line endings.
* @return true if the value's length is less than the specified maximum.
*/
public static boolean maxLength(String value, int max, int lineEndLength) {
int adjustAmount = adjustForLineEnding(value, lineEndLength);
return ((value.length() + adjustAmount) <= max);
}
/**
* <p>
* Checks if the value's length is greater than or equal to the min.
* </p>
*
* @param value
* The value validation is being performed on.
* @param min
* The minimum length.
* @return true if the value's length is more than the specified minimum.
*/
public static boolean minLength(String value, int min) {
return (value.length() >= min);
}
/**
* <p>
* Checks if the value's length is greater than or equal to the min.
* </p>
*
* @param value
* The value validation is being performed on.
* @param min
* The minimum length.
* @return true if the value's length is more than the specified minimum.
*/
public static boolean minLen(String value, String min) {
if (value == null)
return true;
return (value.length() >= Integer.parseInt(min));
}
/**
* <p>
* Checks if the value's adjusted length is greater than or equal to the
* min.
* </p>
*
* @param value
* The value validation is being performed on.
* @param min
* The minimum length.
* @param lineEndLength
* The length to use for line endings.
* @return true if the value's length is more than the specified minimum.
*/
public static boolean minLength(String value, int min, int lineEndLength) {
int adjustAmount = adjustForLineEnding(value, lineEndLength);
return ((value.length() + adjustAmount) >= min);
}
/**
* Calculate an adjustment amount for line endings. See Bug 37962 for the
* rational behind this.
*
* @param value
* The value validation is being performed on.
* @param lineEndLength
* The length to use for line endings.
* @return the adjustment amount.
*/
private static int adjustForLineEnding(String value, int lineEndLength) {
int nCount = 0;
int rCount = 0;
for (int i = 0; i < value.length(); i++) {
if (value.charAt(i) == '\n') {
nCount++;
}
if (value.charAt(i) == '\r') {
rCount++;
}
}
return ((nCount * lineEndLength) - (rCount + nCount));
}
// See http://issues.apache.org/bugzilla/show_bug.cgi?id=29015 WRT the
// "value" methods
/**
* <p>
* Checks if the value is greater than or equal to the min.
* </p>
*
* @param value
* The value validation is being performed on.
* @param min
* The minimum numeric value.
* @return true if the value is >= the specified minimum.
*/
public static boolean minValue(int value, int min) {
return (value >= min);
}
/**
* <p>
* Checks if the value is greater than or equal to the min.
* </p>
*
* @param value
* The value validation is being performed on.
* @param min
* The minimum numeric value.
* @return true if the value is >= the specified minimum.
*/
public static boolean minValue(long value, long min) {
return (value >= min);
}
/**
* <p>
* Checks if the value is less than or equal to the max.
* </p>
*
* @param value
* The value validation is being performed on.
* @param min
* The maximum value in string format.
* @param type
* The class of the value and min
* @return true if the value is <= the specified min.
*/
public static boolean minValue(String value, String min) {
if (isBlankOrNull(value))
return true;
return (Double.parseDouble(value) >= Double.parseDouble(min));
}
/**
* <p>
* Checks if the value is greater than or equal to the min.
* </p>
*
* @param value
* The value validation is being performed on.
* @param min
* The minimum numeric value.
* @return true if the value is >= the specified minimum.
*/
public static boolean minValue(double value, double min) {
return (value >= min);
}
/**
* <p>
* Checks if the value is greater than or equal to the min.
* </p>
*
* @param value
* The value validation is being performed on.
* @param min
* The minimum numeric value.
* @return true if the value is >= the specified minimum.
*/
public static boolean minValue(float value, float min) {
return (value >= min);
}
/**
* <p>
* Checks if the value is less than or equal to the max.
* </p>
*
* @param value
* The value validation is being performed on.
* @param max
* The maximum numeric value.
* @return true if the value is <= the specified maximum.
*/
public static boolean maxValue(int value, int max) {
return (value <= max);
}
/**
* <p>
* Checks if the value is less than or equal to the max.
* </p>
*
* @param value
* The value validation is being performed on.
* @param max
* The maximum numeric value.
* @return true if the value is <= the specified maximum.
*/
public static boolean maxValue(long value, long max) {
return (value <= max);
}
/**
* <p>
* Checks if the value is less than or equal to the max.
* </p>
*
* @param value
* The value validation is being performed on.
* @param max
* The maximum numeric value.
* @return true if the value is <= the specified maximum.
*/
public static boolean maxValue(double value, double max) {
return (value <= max);
}
/**
* <p>
* Checks if the value is less than or equal to the max.
* </p>
*
* @param value
* The value validation is being performed on.
* @param max
* The maximum value in string format.
* @param type
* The class of the value and max
* @return true if the value is <= the specified maximum.
*/
public static boolean maxValue(String value, String max) {
/* 如果数字为空，说明用户没有填数据，这是允许的 */
if (isBlankOrNull(value))
return true;
return (Double.parseDouble(value) <= Double.parseDouble(max));
}
/**
* <p>
* Checks if the value is less than or equal to the max.
* </p>
*
* @param value
* The value validation is being performed on.
* @param max
* The maximum numeric value.
* @return true if the value is <= the specified maximum.
*/
public static boolean maxValue(float value, float max) {
return (value <= max);
}
}