[Spring源码阅读]通过Assert校验参数

Spring Assert

在开发过程中，可能经常需要写下面的条件判断：

    if(XXX) {
        throw new BusinessException(ErrorCode.PARAM_ERROR, "参数校验失败");
    }

在Spring源码中发现了另一种相对更优雅的写法，通过Assert校验参数。

该工具类位于包： org.springframework.util

截取几个关键的方法：

	public static void state(boolean expression, String message) {
		if (!expression) {
			throw new IllegalStateException(message);
		}
	}

	public static void state(boolean expression, Supplier messageSupplier) {
		if (!expression) {
			throw new IllegalStateException(nullSafeGet(messageSupplier));
		}
	}

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

	public static void isTrue(boolean expression, Supplier messageSupplier) {
		if (!expression) {
			throw new IllegalArgumentException(nullSafeGet(messageSupplier));
		}
	}

	public static void isNull(@Nullable Object object, String message) {
		if (object != null) {
			throw new IllegalArgumentException(message);
		}
	}

	public static void isNull(@Nullable Object object, Supplier messageSupplier) {
		if (object != null) {
			throw new IllegalArgumentException(nullSafeGet(messageSupplier));
		}
	}

	@Deprecated
	public static void isNull(@Nullable Object object) {
		isNull(object, "[Assertion failed] - the object argument must be null");
	}

	public static void notNull(@Nullable Object object, String message) {
		if (object == null) {
			throw new IllegalArgumentException(message);
		}
	}

	public static void notNull(@Nullable Object object, Supplier messageSupplier) {
		if (object == null) {
			throw new IllegalArgumentException(nullSafeGet(messageSupplier));
		}
	}

优点

于是开头的if判断，可以通过下面的表达式进行参数校验

Assert.isTrue(XX, XX);

 用一个表达式替换之前的 if 和 throw，更加优雅简洁。

其实像三元表达式、JDK8的Optional，都是类似的思想，尽量用一个表达式替换 if else。

为什么不用jdk自带的assert

jdk自带的assert校验不通过会抛出一个Error，无法抛出具体业务相关的通用异常。所以即使assert不会给系统带来额外的开销，项目中使用的也不是很多。

如果自定义一个Assert工具类，则可以根据项目需要抛出自定义的异常，更契合项目。