org.identityconnectors.common.Assertions Maven / Gradle / Ivy
/**
* ====================
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
*
* Copyright 2008-2009 Sun Microsystems, Inc. All rights reserved.
* Copyright 2011-2013 Tirasa. All rights reserved.
*
* The contents of this file are subject to the terms of the Common Development
* and Distribution License("CDDL") (the "License"). You may not use this file
* except in compliance with the License.
*
* You can obtain a copy of the License at https://oss.oracle.com/licenses/CDDL
* See the License for the specific language governing permissions and limitations
* under the License.
*
* When distributing the Covered Code, include this CDDL Header Notice in each file
* and include the License file at https://oss.oracle.com/licenses/CDDL.
* If applicable, add the following below this CDDL Header, with the fields
* enclosed by brackets [] replaced by your own identifying information:
* "Portions Copyrighted [year] [name of copyright owner]"
* ====================
*/
package org.identityconnectors.common;
public final class Assertions {
private final static String NULL_FORMAT = "Parameter '%s' must not be null.";
private static final String BLANK_FORMAT = "Parameter '%s' must not be blank.";
private Assertions() {
throw new AssertionError();
}
/**
* Throws {@link NullPointerException} if the parameter
* o is
* null.
*
* @param o check if the object is null.
* @param param name of the parameter to check for null.
* @throws NullPointerException if o is null and constructs a
* message with the name of the parameter.
*/
public static void nullCheck(final Object o, final String param) {
assert StringUtil.isNotBlank(param);
if (o == null) {
throw new NullPointerException(String.format(NULL_FORMAT, param));
}
}
/**
* Throws {@link NullPointerException} if the parameter
* o is
* null, otherwise returns the value of the
* o parameter.
*
* @param o check if the object is null.
* @param param name of the parameter to check for null.
* @return the value of the o parameter.
* @throws NullPointerException if o is null and constructs a
* message with the name of the parameter.
*
* @since 1.2
*/
public static T nullChecked(final T o, final String param) {
// Avoid calling nullCheck() here to reuse code: it deepens the stack trace.
// We want the exception to be thrown as close to the call site as possible.
assert StringUtil.isNotBlank(param);
if (o == null) {
throw new NullPointerException(String.format(NULL_FORMAT, param));
}
return o;
}
/**
* Throws {@link IllegalArgumentException} if the parameter
* o * is
* null or blank.
*
* @param o value to test for blank.
* @param param name of the parameter to check.
*/
public static void blankCheck(final String o, final String param) {
assert StringUtil.isNotBlank(param);
if (StringUtil.isBlank(o)) {
throw new IllegalArgumentException(String.format(BLANK_FORMAT, param));
}
}
/**
* Throws {@link IllegalArgumentException} if the parameter
* o is
* null or blank, otherwise returns the value of the
* o parameter.
*
* @param o value to test for blank.
* @param param name of the parameter to check.
* @return the value of the o parameter.
*
* @since 1.2
*/
public static String blankChecked(final String o, final String param) {
// Avoid calling blankCheck() here to reuse code: it deepens the stack trace.
// We want the exception to be thrown as close to the call site as possible.
assert StringUtil.isNotBlank(param);
if (StringUtil.isBlank(o)) {
throw new IllegalArgumentException(String.format(BLANK_FORMAT, param));
}
return o;
}
}