io.leopard.burrow.lang.AssertUtil Maven / Gradle / Ivy

Go to download
package io.leopard.burrow.lang;

import java.util.List;
import java.util.Set;

import org.apache.commons.lang.StringUtils;

/**
 * 参数验证
 * 
 * @author 阿海
 * 
 */
public class AssertUtil {

	/**
	 * 判断一个字符串是否超过最大长度
 注意：如果字符串为空，抛java.lang.IllegalArgumentException异常
 参数不允许为空

	 * 
	 * @param str
	 *            字符串
	 * @param maxLength
	 *            最大长度
	 * @param message
	 *            抛出的异常信息
	 */
	public static void maxLength(String str, int maxLength, String message) {
		if (StringUtils.isEmpty(str)) {
			throw new IllegalArgumentException("参数不允许为空.");
		}
		if (str.length() > maxLength) {
			throw new IllegalArgumentException(message);
		}
	}

	/**
	 * 判断一个字段是否合法的字段名称
 合法的字段名称必需以a-z或者A-Z开头
	 * 
	 * @param fieldName
	 *            字段名称
	 * @param message
	 *            抛出的异常信息
	 */
	public static void assertFieldName(String fieldName, String message) {
		if (StringUtils.isEmpty(fieldName)) {
			throw new IllegalArgumentException(message);
		}
		boolean isFieldName = fieldName.matches("^[a-zA-Z]+$");
		if (!isFieldName) {
			throw new IllegalArgumentException(message);
		}
	}

	/**
	 * 判断一个对象是否为空

	 * 
	 * @param obj
	 *            对象
	 * @param message
	 *            如果为空,抛出的异常信息
	 */
	public static void notNull(Object obj, String message) {
		if (obj == null) {
			throw new IllegalArgumentException(message);
		}
	}

	/**
	 * 判断一个对象是否为空

	 * 
	 * @param obj
	 *            对象
	 * @param message
	 *            如果为空,抛出的异常信息
	 */
	public static void assertNotNull(Object obj, String message) {
		if (obj == null) {
			throw new IllegalArgumentException(message);
		}
	}

	/**
	 * 判断一个字符串是否为空

	 * 
	 * @param str
	 *            字符串
	 * @param message
	 *            如果为空,抛出的异常信息
	 */
	public static void assertNotEmpty(String str, String message) {
		if (StringUtils.isEmpty(str)) {
			throw new IllegalArgumentException(message);
		}
	}

	/**
	 * 判断一个字符串是否为空

	 * 
	 * @param str
	 *            字符串
	 * @param message
	 *            如果为空,抛出的异常信息
	 */
	public static void empty(String str, String message) {
		if (StringUtils.isEmpty(str)) {
			throw new IllegalArgumentException(message);
		}
	}

	/**
	 * 列表不为空则正常，为空则抛异常

	 * 
	 * @param list
	 *            列表
	 * @param message
	 *            如果列表为空，抛出的异常信息
	 */
	public static void isEmpty(List list, String message) {
		if (list == null || list.isEmpty()) {
			return;
		}
		throw new IllegalArgumentException(message);
	}

	/**
	 * 判断列表是否为空，为空则抛异常

	 * 
	 * @param list
	 *            列表
	 * @param message
	 *            如果列表为空，抛出的异常信息
	 */
	public static void assertNotEmpty(List list, String message) {
		if (list == null || list.isEmpty()) {
			throw new IllegalArgumentException(message);
		}
	}

	/**
	 * 判断set是否为空，为空则抛异常

	 * 
	 * @param set
	 *            列表
	 * @param message
	 *            如果set为空，抛出的异常信息
	 */
	public static void assertNotEmpty(Set set, String message) {
		if (set == null || set.isEmpty()) {
			throw new IllegalArgumentException(message);
		}
	}

	/**
	 * 判断一个布尔值是否为真,不为真抛异常 

	 * 
	 * @param flag
	 *            列表
	 * @param message
	 *            如果flag为空，抛出的异常信息
	 */

	public static void assertTrue(boolean flag, String message) {
		if (!flag) {
			throw new IllegalArgumentException(message);
		}
	}

	/**
	 * 判断一个整数，是否大于0

	 * 
	 * @param num
	 *            整数
	 * @param message
	 *            为空，或者小于0，抛出的异常信息
	 */
	public static void greatZero(Integer num, String message) {
		if (num == null || num <= 0) {
			throw new IllegalArgumentException(message);
		}
	}

	/**
	 * 判断一个Long，是否大于0

	 * 
	 * @param num
	 *            Long
	 * @param message
	 *            为空，或者小于0，抛出的异常信息
	 */

	public static void greatZero(Long num, String message) {
		if (num == null || num <= 0) {
			throw new IllegalArgumentException(message);
		}
	}

	/**
	 * 判断一个整数是否大于0

	 * 
	 * @param num
	 *            整数
	 * @param message
	 *            为空，或者小于0，抛出的异常信息
	 */
	public static void isGreaterZero(Integer num, String message) {
		AssertUtil.greatZero(num, message);
	}

	/**
	 * 判断二个整数是否相等 

	 * 
	 * @param num1
	 *            整数1
	 * @param num2
	 *            整数2
	 * @param message
	 *            不相等时，抛出的异常信息
	 */
	public static void isEquals(int num1, int num2, String message) {
		if (num1 == num2) {
			return;
		}
		throw new IllegalArgumentException(message);
	}

	/**
	 * 判断二个字符串是否相等，忽略大小写

	 * 
	 * @param str1
	 *            字符串1
	 * @param str2
	 *            字符串2
	 * @param message
	 *            不相等时，抛出的异常信息
	 */
	public static void equalsIgnoreCase(String str1, String str2, String message) {
		if (str1.equalsIgnoreCase(str2)) {
			return;
		}
		throw new IllegalArgumentException(message);
	}

	/**
	 * 判断一个整数是否大于等于0,如果不是则抛异常

	 * 
	 * @param str
	 *            整数
	 * @param message
	 *            不相等时，抛出的异常信息
	 */
	public static void isGreaterEqualZero(Integer num, String message) {
		if (num >= 0) {
			return;
		}
		throw new IllegalArgumentException(message);
	}

}