commons之BooleanUtils

import org.apache.commons.lang3.BooleanUtils;

public class BooleanUtilsDemo {
	
	private static final String n = null;

	/**
	 * @param args
	 */
	public static void main(String[] args) {
		/*
		 * 否定指定的boolean值
		 * <pre>
	     *   BooleanUtils.negate(Boolean.TRUE)  = Boolean.FALSE;
	     *   BooleanUtils.negate(Boolean.FALSE) = Boolean.TRUE;
	     *   BooleanUtils.negate(null)          = null;
	     * </pre>
		 */
		System.out.println("negate:"+BooleanUtils.negate(Boolean.TRUE));
		
		/*
		 * 检查一个boolean值是否为true,如果参数为null,返回false
		 *  <pre>
	     *   BooleanUtils.isTrue(Boolean.TRUE)  = true
	     *   BooleanUtils.isTrue(Boolean.FALSE) = false
	     *   BooleanUtils.isTrue(null)          = false
	     * </pre>
		 */
		System.out.println("isTrue:"+BooleanUtils.isTrue(Boolean.TRUE));
		
		
		/*
		 * 检查一个boolean值是否为false,如果参数为null,返回true.
		 * <pre>
	     *   BooleanUtils.isNotTrue(Boolean.TRUE)  = false
	     *   BooleanUtils.isNotTrue(Boolean.FALSE) = true
	     *   BooleanUtils.isNotTrue(null)          = true
	     * </pre>
		 */
		System.out.println("isNotTrue:"+BooleanUtils.isNotTrue(Boolean.TRUE));
		
		
		/*
		 * 检查一个boolean值是否为false,如果是 返回true.
		 * 如果检查的值为true或null返回false.
		 * <pre>
	     *   BooleanUtils.isFalse(Boolean.TRUE)  = false
	     *   BooleanUtils.isFalse(Boolean.FALSE) = true
	     *   BooleanUtils.isFalse(null)          = false
	     * </pre>
		 */
		System.out.println("isFalse:"+BooleanUtils.isFalse(Boolean.TRUE));
		
		
		/*
		 * 检查一个boolean值是否不为false,如果是返回true.
		 * <pre>
	     *   BooleanUtils.isNotFalse(Boolean.TRUE)  = true
	     *   BooleanUtils.isNotFalse(Boolean.FALSE) = false
	     *   BooleanUtils.isNotFalse(null)          = true
	     * </pre>
		 */
		System.out.println("isNotFalse:"+BooleanUtils.isNotFalse(Boolean.TRUE));
		
		
		/*
		 * 转换一个为null的boolean值,返回一个false.
		 * <pre>
	     *   BooleanUtils.toBoolean(Boolean.TRUE)  = true
	     *   BooleanUtils.toBoolean(Boolean.FALSE) = false
	     *   BooleanUtils.toBoolean(null)          = false
	     * </pre>
		 */
		System.out.println("toBoolean:"+BooleanUtils.toBoolean(n));
		
		/*
		 * 转换一个为null的boolean值,返回后面参数给定的boolean值.
		 * <pre>
	     *   BooleanUtils.toBooleanDefaultIfNull(Boolean.TRUE, false) = true
	     *   BooleanUtils.toBooleanDefaultIfNull(Boolean.FALSE, true) = false
	     *   BooleanUtils.toBooleanDefaultIfNull(null, true)          = true
	     * </pre>
		 */
		System.out.println("toBooleanDefaultIfNull:"+BooleanUtils.toBooleanDefaultIfNull(null, false));
		
		/*
		 * 当参数为0是返回false,其它都返回true.
		 * <pre>
	     *   BooleanUtils.toBoolean(0) = false
	     *   BooleanUtils.toBoolean(1) = true
	     *   BooleanUtils.toBoolean(2) = true
	     * </pre>
		 */
		System.out.println("toBoolean (int):"+BooleanUtils.toBoolean(0));
		
		/*
		 * 当参数为0是返回Boolean.FALSE对象,其它都返回Boolean.TRUE.
		 * <pre>
	     *   BooleanUtils.toBoolean(0) = Boolean.FALSE
	     *   BooleanUtils.toBoolean(1) = Boolean.TRUE
	     *   BooleanUtils.toBoolean(2) = Boolean.TRUE
	     * </pre>
		 */
		System.out.println("toBooleanObject (int):"+BooleanUtils.toBooleanObject(0));
		
		
		/*
		 * 当参数为0是返回Boolean.FALSE对象,为null返回null
		 * 其它则返回Boolean.TRUE.
		 * <pre>
	     *   BooleanUtils.toBoolean(new Integer(0))    = Boolean.FALSE
	     *   BooleanUtils.toBoolean(new Integer(1))    = Boolean.TRUE
	     *   BooleanUtils.toBoolean(new Integer(null)) = null
	     * </pre>
		 */
		System.out.println("toBooleanObject (Integer):"+BooleanUtils.toBooleanObject(0));
		
		
		/*
		 * 如果第一个参数和第二个参数相等返回true,
		 * 如果第一个参数和第三个参数相等返回false,
		 * 如果都没有相等的,返回一个IllegalArgumentException
		 * * <pre>
	     *   BooleanUtils.toBoolean(0, 1, 0) = false
	     *   BooleanUtils.toBoolean(1, 1, 0) = true
	     *   BooleanUtils.toBoolean(2, 1, 2) = false
	     *   BooleanUtils.toBoolean(2, 2, 0) = true
	     * </pre>
		 */
		System.out.println("toBoolean "+BooleanUtils.toBoolean(4, 3, 4));
		
		/*
		 * 如果第一个参数和第二个参数相等返回true,
		 * 如果第一个参数和第三个参数相等返回false,
		 * 如果第一个参数和第四个参数相等返回null,
		 * 
		 * 如果都没有相等的,返回一个IllegalArgumentException
		 * <pre>
	     *   BooleanUtils.toBooleanObject(0, 0, 2, 3) = Boolean.TRUE
	     *   BooleanUtils.toBooleanObject(2, 1, 2, 3) = Boolean.FALSE
	     *   BooleanUtils.toBooleanObject(3, 1, 2, 3) = null
	     * </pre>
		 */
		System.out.println("toBoolean "+BooleanUtils.toBoolean(new Integer(0), new Integer(0), new Integer(2)));
		
		/*
		 * 如果是true返回1,
		 * 如果是false返回0。
		 */
		System.out.println("toInteger:"+BooleanUtils.toInteger(false));
		
		/*
		 * 如果是true返回1,
		 * 如果是false返回0。
		 */
		System.out.println("toIntegerObject:"+BooleanUtils.toIntegerObject(false));
		System.out.println("toIntegerObject Boolean:"+BooleanUtils.toIntegerObject(Boolean.TRUE));
		
		/*
		 * 如果第一个参数为true,返回第二个参数
		 * 如果第一个参数为false,返回第三个参数.
		 * <pre>
	     *   BooleanUtils.toInteger(true, 1, 0)  = 1
	     *   BooleanUtils.toInteger(false, 1, 0) = 0
	     * </pre>
		 * 
		 */
		System.out.println("toInteger 2:"+BooleanUtils.toInteger(Boolean.TRUE, 1, 0));
		/*
		 * 如果第一个参数为true,返回第二个参数
		 * 如果第一个参数为false,返回第三个参数.
		 * 如果第一个参数为null,返回第四个参数.
		 * <pre>
	     *   BooleanUtils.toInteger(Boolean.TRUE, 1, 0, 2)  = 1
	     *   BooleanUtils.toInteger(Boolean.FALSE, 1, 0, 2) = 0
	     *   BooleanUtils.toInteger(null, 1, 0, 2)          = 2
	     * </pre>
		 * 
		 */
		System.out.println("toInteger 3:"+BooleanUtils.toInteger(Boolean.TRUE,1,0,2));
		
		/*
		 * 根据参数字符串返回boolean值.
		 *  * <pre>
	     *   BooleanUtils.toBooleanObject(null)    = null
	     *   BooleanUtils.toBooleanObject("true")  = Boolean.TRUE
	     *   BooleanUtils.toBooleanObject("false") = Boolean.FALSE
	     *   BooleanUtils.toBooleanObject("on")    = Boolean.TRUE
	     *   BooleanUtils.toBooleanObject("ON")    = Boolean.TRUE
	     *   BooleanUtils.toBooleanObject("off")   = Boolean.FALSE
	     *   BooleanUtils.toBooleanObject("oFf")   = Boolean.FALSE
	     *   BooleanUtils.toBooleanObject("blue")  = null
	     * </pre>
		 */
		System.out.println("toBooleanObject:"+BooleanUtils.toBooleanObject("on"));
		
		
		/*
		 * 根据参数的boolean对象返回一个字符串.
		 *   <pre>
	     *   BooleanUtils.toStringTrueFalse(Boolean.TRUE)  = "true"
	     *   BooleanUtils.toStringTrueFalse(Boolean.FALSE) = "false"
	     *   BooleanUtils.toStringTrueFalse(null)          = null;
	     * </pre>
		 */
		System.out.println("toBooleanObject:"+BooleanUtils.toStringTrueFalse(Boolean.TRUE));
		System.out.println("toStringOnOff:"+BooleanUtils.toStringOnOff(Boolean.TRUE));
		System.out.println("toStringYesNo:"+BooleanUtils.toStringYesNo(Boolean.TRUE));
		
		/*
		 * 根据第一个参数为true或false来返回第二个或第三个参数.
		 * <pre>
	     *   BooleanUtils.toString(true, "true", "false")   = "true"
	     *   BooleanUtils.toString(false, "true", "false")  = "false"
	     * </pre>
		 */
		System.out.println("toString:"+BooleanUtils.toString(true, "返回true的字符串", "返回false的字符串"));
		
		/*
		 * 异或运算
		 * <pre>
	     *   BooleanUtils.xor(new boolean[] { true, true })   = false
	     *   BooleanUtils.xor(new boolean[] { false, false }) = false
	     *   BooleanUtils.xor(new boolean[] { true, false })  = true
	     * </pre>
		 */
		System.out.println("xor:"+BooleanUtils.xor(new boolean[] { false, true }));
		
	}

}