Many resources are needed to download a project. Please understand that we have to compensate our server costs. Thank you in advance. Project price only 1 $
You can buy this project and download/modify it how often you want.
/**
* Copyright (C) 2006-2015 phloc systems
* http://www.phloc.com
* office[at]phloc[dot]com
*
* Licensed 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 com.phloc.commons;
import java.math.BigDecimal;
import java.math.BigInteger;
import java.util.Collection;
import java.util.Map;
import javax.annotation.Nonnegative;
import javax.annotation.Nonnull;
import javax.annotation.concurrent.Immutable;
@Immutable
public final class ValueEnforcer
{
private ValueEnforcer ()
{}
/**
* Check that the passed value is not null.
*
* @param aValue
* The value to check.
* @param sName
* The name of the value (e.g. the parameter name)
* @return The passed value and never null.
* @param
* The value type
*/
@Nonnull
public static T notNull (final T aValue, final String sName)
{
if (aValue == null)
throw new NullPointerException ("The value of '" + sName + "' may not be null!");
return aValue;
}
/**
* Check that the passed String is neither null nor empty.
*
* @param aValue
* The String to check.
* @param sName
* The name of the value (e.g. the parameter name)
* @return The passed value and never null.
* @param
* The value type
*/
@Nonnull
public static T notEmpty (final T aValue, final String sName)
{
notNull (aValue, sName);
if (aValue.length () == 0)
throw new IllegalArgumentException ("The value of the string '" + sName + "' may not be empty!");
return aValue;
}
/**
* Check that the passed Array is neither null nor empty.
*
* @param aValue
* The Array to check.
* @param sName
* The name of the value (e.g. the parameter name)
* @return The passed value and never null.
* @param
* The value type
*/
@Nonnull
public static T [] notEmpty (final T [] aValue, final String sName)
{
notNull (aValue, sName);
if (aValue.length == 0)
throw new IllegalArgumentException ("The value of the array '" + sName + "' may not be empty!");
return aValue;
}
/**
* Check that the passed Array is neither null nor empty.
*
* @param aValue
* The Array to check.
* @param sName
* The name of the value (e.g. the parameter name)
* @return The passed value and never null.
*/
@Nonnull
public static boolean [] notEmpty (final boolean [] aValue, final String sName)
{
notNull (aValue, sName);
if (aValue.length == 0)
throw new IllegalArgumentException ("The value of the array '" + sName + "' may not be empty!");
return aValue;
}
/**
* Check that the passed Array is neither null nor empty.
*
* @param aValue
* The Array to check.
* @param sName
* The name of the value (e.g. the parameter name)
* @return The passed value and never null.
*/
@Nonnull
public static byte [] notEmpty (final byte [] aValue, final String sName)
{
notNull (aValue, sName);
if (aValue.length == 0)
throw new IllegalArgumentException ("The value of the array '" + sName + "' may not be empty!");
return aValue;
}
/**
* Check that the passed Array is neither null nor empty.
*
* @param aValue
* The Array to check.
* @param sName
* The name of the value (e.g. the parameter name)
* @return The passed value and never null.
*/
@Nonnull
public static char [] notEmpty (final char [] aValue, final String sName)
{
notNull (aValue, sName);
if (aValue.length == 0)
throw new IllegalArgumentException ("The value of the array '" + sName + "' may not be empty!");
return aValue;
}
/**
* Check that the passed Array is neither null nor empty.
*
* @param aValue
* The Array to check.
* @param sName
* The name of the value (e.g. the parameter name)
* @return The passed value and never null.
*/
@Nonnull
public static double [] notEmpty (final double [] aValue, final String sName)
{
notNull (aValue, sName);
if (aValue.length == 0)
throw new IllegalArgumentException ("The value of the array '" + sName + "' may not be empty!");
return aValue;
}
/**
* Check that the passed Array is neither null nor empty.
*
* @param aValue
* The Array to check.
* @param sName
* The name of the value (e.g. the parameter name)
* @return The passed value and never null.
*/
@Nonnull
public static float [] notEmpty (final float [] aValue, final String sName)
{
notNull (aValue, sName);
if (aValue.length == 0)
throw new IllegalArgumentException ("The value of the array '" + sName + "' may not be empty!");
return aValue;
}
/**
* Check that the passed Array is neither null nor empty.
*
* @param aValue
* The Array to check.
* @param sName
* The name of the value (e.g. the parameter name)
* @return The passed value and never null.
*/
@Nonnull
public static int [] notEmpty (final int [] aValue, final String sName)
{
notNull (aValue, sName);
if (aValue.length == 0)
throw new IllegalArgumentException ("The value of the array '" + sName + "' may not be empty!");
return aValue;
}
/**
* Check that the passed Array is neither null nor empty.
*
* @param aValue
* The Array to check.
* @param sName
* The name of the value (e.g. the parameter name)
* @return The passed value and never null.
*/
@Nonnull
public static long [] notEmpty (final long [] aValue, final String sName)
{
notNull (aValue, sName);
if (aValue.length == 0)
throw new IllegalArgumentException ("The value of the array '" + sName + "' may not be empty!");
return aValue;
}
/**
* Check that the passed Array is neither null nor empty.
*
* @param aValue
* The Array to check.
* @param sName
* The name of the value (e.g. the parameter name)
* @return The passed value and never null.
*/
@Nonnull
public static short [] notEmpty (final short [] aValue, final String sName)
{
notNull (aValue, sName);
if (aValue.length == 0)
throw new IllegalArgumentException ("The value of the array '" + sName + "' may not be empty!");
return aValue;
}
/**
* Check that the passed Collection is neither null nor empty.
*
* @param
* The value type
* @param aValue
* The String to check.
* @param sName
* The name of the value (e.g. the parameter name)
* @return The passed value and never null.
*/
@Nonnull
public static > T notEmpty (final T aValue, final String sName)
{
notNull (aValue, sName);
if (aValue.isEmpty ())
throw new IllegalArgumentException ("The value of the collection '" + sName + "' may not be empty!");
return aValue;
}
/**
* Check that the passed Iterable is neither null nor empty.
*
* @param
* The value type
* @param aValue
* The String to check.
* @param sName
* The name of the value (e.g. the parameter name)
* @return The passed value and never null.
*/
@Nonnull
public static > T notEmpty (final T aValue, final String sName)
{
notNull (aValue, sName);
if (!aValue.iterator ().hasNext ())
throw new IllegalArgumentException ("The value of the iterable '" + sName + "' may not be empty!");
return aValue;
}
/**
* Check that the passed Collection is neither null nor empty.
*
* @param
* The value type
* @param aValue
* The String to check.
* @param sName
* The name of the value (e.g. the parameter name)
* @return The passed value and never null.
*/
@Nonnull
public static > T notEmpty (final T aValue, final String sName)
{
notNull (aValue, sName);
if (aValue.isEmpty ())
throw new IllegalArgumentException ("The value of the map '" + sName + "' may not be empty!");
return aValue;
}
/**
* Check that the passed Array is neither null nor empty and that
* no null value is contained.
*
* @param aValue
* The Array to check.
* @param sName
* The name of the value (e.g. the parameter name)
* @return The passed value and never null.
* @param
* The value type
*/
@Nonnull
public static T [] notEmptyNoNullValue (final T [] aValue, final String sName)
{
notEmpty (aValue, sName);
int nIndex = 0;
for (final T aItem : aValue)
{
if (aItem == null)
throw new IllegalArgumentException ("Item " + nIndex + " of array '" + sName + "' may not be null!");
++nIndex;
}
return aValue;
}
/**
* Check that the passed collection is neither null nor empty and
* that no null value is contained.
*
* @param aValue
* The collection to check.
* @param sName
* The name of the value (e.g. the parameter name)
* @return The passed value and never null.
* @param
* The value type
*/
@Nonnull
public static > T notEmptyNoNullValue (final T aValue, final String sName)
{
notEmpty (aValue, sName);
int nIndex = 0;
for (final Object aItem : aValue)
{
if (aItem == null)
throw new IllegalArgumentException ("Item " + nIndex + " of iterable '" + sName + "' may not be null!");
++nIndex;
}
return aValue;
}
/**
* Check that the passed collection is neither null nor empty and
* that no null value is contained.
*
* @param aValue
* The collection to check.
* @param sName
* The name of the value (e.g. the parameter name)
* @return The passed value and never null.
* @param
* The value type
*/
@Nonnull
public static > T notEmptyNoNullValue (final T aValue, final String sName)
{
notEmpty (aValue, sName);
int nIndex = 0;
for (final Object aItem : aValue)
{
if (aItem == null)
throw new IllegalArgumentException ("Item " + nIndex + " of collection '" + sName + "' may not be null!");
++nIndex;
}
return aValue;
}
/**
* Check that the passed value is not null and not equal to .
*
* @param aValue
* The value to check. May not be null.
* @param sName
* The name of the value (e.g. the parameter name)
* @param aUnexpectedValue
* The value that may not be equal to aValue. May not be
* null.
* @return The passed value and never null.
* @param
* The value type
*/
@Nonnull
public static T notNullNotEquals (@Nonnull final T aValue, final String sName, @Nonnull final T aUnexpectedValue)
{
notNull (aValue, sName);
notNull (aUnexpectedValue, "UnexpectedValue");
if (aValue.equals (aUnexpectedValue))
throw new NullPointerException ("The value of '" + sName + "' may not be equal to " + aUnexpectedValue + "!");
return aValue;
}
public static short isGE0 (final short nValue, final String sName)
{
if (nValue < 0)
throw new IllegalArgumentException ("The value of '" + sName + "' must be >= 0! The current value is: " + nValue);
return nValue;
}
public static int isGE0 (final int nValue, final String sName)
{
if (nValue < 0)
throw new IllegalArgumentException ("The value of '" + sName + "' must be >= 0! The current value is: " + nValue);
return nValue;
}
public static long isGE0 (final long nValue, final String sName)
{
if (nValue < 0)
throw new IllegalArgumentException ("The value of '" + sName + "' must be >= 0! The current value is: " + nValue);
return nValue;
}
public static double isGE0 (final double dValue, final String sName)
{
if (dValue < 0)
throw new IllegalArgumentException ("The value of '" + sName + "' must be >= 0! The current value is: " + dValue);
return dValue;
}
public static float isGE0 (final float fValue, final String sName)
{
if (fValue < 0)
throw new IllegalArgumentException ("The value of '" + sName + "' must be >= 0! The current value is: " + fValue);
return fValue;
}
@Nonnull
public static BigDecimal isGE0 (@Nonnull final BigDecimal aValue, final String sName)
{
notNull (aValue, sName);
if (aValue.compareTo (BigDecimal.ZERO) < 0)
throw new IllegalArgumentException ("The value of '" + sName + "' must be >= 0! The current value is: " + aValue);
return aValue;
}
@Nonnull
public static BigInteger isGE0 (@Nonnull final BigInteger aValue, final String sName)
{
notNull (aValue, sName);
if (aValue.compareTo (BigInteger.ZERO) < 0)
throw new IllegalArgumentException ("The value of '" + sName + "' must be >= 0! The current value is: " + aValue);
return aValue;
}
public static short isGT0 (final short nValue, final String sName)
{
if (nValue <= 0)
throw new IllegalArgumentException ("The value of '" + sName + "' must be > 0! The current value is: " + nValue);
return nValue;
}
public static int isGT0 (final int nValue, final String sName)
{
if (nValue <= 0)
throw new IllegalArgumentException ("The value of '" + sName + "' must be > 0! The current value is: " + nValue);
return nValue;
}
public static long isGT0 (final long nValue, final String sName)
{
if (nValue <= 0)
throw new IllegalArgumentException ("The value of '" + sName + "' must be > 0! The current value is: " + nValue);
return nValue;
}
public static double isGT0 (final double dValue, final String sName)
{
if (dValue <= 0)
throw new IllegalArgumentException ("The value of '" + sName + "' must be > 0! The current value is: " + dValue);
return dValue;
}
public static float isGT0 (final float fValue, final String sName)
{
if (fValue <= 0)
throw new IllegalArgumentException ("The value of '" + sName + "' must be > 0! The current value is: " + fValue);
return fValue;
}
@Nonnull
public static BigDecimal isGT0 (@Nonnull final BigDecimal aValue, final String sName)
{
notNull (aValue, sName);
if (aValue.compareTo (BigDecimal.ZERO) <= 0)
throw new IllegalArgumentException ("The value of '" + sName + "' must be > 0! The current value is: " + aValue);
return aValue;
}
@Nonnull
public static BigInteger isGT0 (@Nonnull final BigInteger aValue, final String sName)
{
notNull (aValue, sName);
if (aValue.compareTo (BigInteger.ZERO) <= 0)
throw new IllegalArgumentException ("The value of '" + sName + "' must be > 0! The current value is: " + aValue);
return aValue;
}
public static short isLE0 (final short nValue, final String sName)
{
if (nValue > 0)
throw new IllegalArgumentException ("The value of '" + sName + "' must be <= 0! The current value is: " + nValue);
return nValue;
}
public static int isLE0 (final int nValue, final String sName)
{
if (nValue > 0)
throw new IllegalArgumentException ("The value of '" + sName + "' must be <= 0! The current value is: " + nValue);
return nValue;
}
public static long isLE0 (final long nValue, final String sName)
{
if (nValue > 0)
throw new IllegalArgumentException ("The value of '" + sName + "' must be <= 0! The current value is: " + nValue);
return nValue;
}
public static double isLE0 (final double dValue, final String sName)
{
if (dValue > 0)
throw new IllegalArgumentException ("The value of '" + sName + "' must be <= 0! The current value is: " + dValue);
return dValue;
}
public static float isLE0 (final float fValue, final String sName)
{
if (fValue > 0)
throw new IllegalArgumentException ("The value of '" + sName + "' must be <= 0! The current value is: " + fValue);
return fValue;
}
@Nonnull
public static BigDecimal isLE0 (@Nonnull final BigDecimal aValue, final String sName)
{
notNull (aValue, sName);
if (aValue.compareTo (BigDecimal.ZERO) > 0)
throw new IllegalArgumentException ("The value of '" + sName + "' must be <= 0! The current value is: " + aValue);
return aValue;
}
@Nonnull
public static BigInteger isLE0 (@Nonnull final BigInteger aValue, final String sName)
{
notNull (aValue, sName);
if (aValue.compareTo (BigInteger.ZERO) > 0)
throw new IllegalArgumentException ("The value of '" + sName + "' must be <= 0! The current value is: " + aValue);
return aValue;
}
public static short isLT0 (final short nValue, final String sName)
{
if (nValue >= 0)
throw new IllegalArgumentException ("The value of '" + sName + "' must be < 0! The current value is: " + nValue);
return nValue;
}
public static int isLT0 (final int nValue, final String sName)
{
if (nValue >= 0)
throw new IllegalArgumentException ("The value of '" + sName + "' must be < 0! The current value is: " + nValue);
return nValue;
}
public static long isLT0 (final long nValue, final String sName)
{
if (nValue >= 0)
throw new IllegalArgumentException ("The value of '" + sName + "' must be < 0! The current value is: " + nValue);
return nValue;
}
public static double isLT0 (final double dValue, final String sName)
{
if (dValue >= 0)
throw new IllegalArgumentException ("The value of '" + sName + "' must be < 0! The current value is: " + dValue);
return dValue;
}
public static float isLT0 (final float fValue, final String sName)
{
if (fValue >= 0)
throw new IllegalArgumentException ("The value of '" + sName + "' must be < 0! The current value is: " + fValue);
return fValue;
}
@Nonnull
public static BigDecimal isLT0 (@Nonnull final BigDecimal aValue, final String sName)
{
notNull (aValue, sName);
if (aValue.compareTo (BigDecimal.ZERO) >= 0)
throw new IllegalArgumentException ("The value of '" + sName + "' must be < 0! The current value is: " + aValue);
return aValue;
}
@Nonnull
public static BigInteger isLT0 (@Nonnull final BigInteger aValue, final String sName)
{
notNull (aValue, sName);
if (aValue.compareTo (BigInteger.ZERO) >= 0)
throw new IllegalArgumentException ("The value of '" + sName + "' must be < 0! The current value is: " + aValue);
return aValue;
}
/**
* Check if
* nValue ≥ nLowerBoundInclusive && nValue ≤ nUpperBoundInclusive
*
* @param nValue
* Value
* @param sName
* Name
* @param nLowerBoundInclusive
* Lower bound
* @param nUpperBoundInclusive
* Upper bound
* @return The value
*/
public static short isBetweenInclusive (final short nValue,
final String sName,
final short nLowerBoundInclusive,
final short nUpperBoundInclusive)
{
if (nValue < nLowerBoundInclusive || nValue > nUpperBoundInclusive)
throw new IllegalArgumentException ("The value of '" +
sName +
"' must be >= " +
nLowerBoundInclusive +
" and <= " +
nUpperBoundInclusive +
"! The current value is: " +
nValue);
return nValue;
}
/**
* Check if
* nValue ≥ nLowerBoundInclusive && nValue ≤ nUpperBoundInclusive
*
* @param nValue
* Value
* @param sName
* Name
* @param nLowerBoundInclusive
* Lower bound
* @param nUpperBoundInclusive
* Upper bound
* @return The value
*/
public static int isBetweenInclusive (final int nValue,
final String sName,
final int nLowerBoundInclusive,
final int nUpperBoundInclusive)
{
if (nValue < nLowerBoundInclusive || nValue > nUpperBoundInclusive)
throw new IllegalArgumentException ("The value of '" +
sName +
"' must be >= " +
nLowerBoundInclusive +
" and <= " +
nUpperBoundInclusive +
"! The current value is: " +
nValue);
return nValue;
}
/**
* Check if
* nValue ≥ nLowerBoundInclusive && nValue ≤ nUpperBoundInclusive
*
* @param nValue
* Value
* @param sName
* Name
* @param nLowerBoundInclusive
* Lower bound
* @param nUpperBoundInclusive
* Upper bound
* @return The value
*/
public static long isBetweenInclusive (final long nValue,
final String sName,
final long nLowerBoundInclusive,
final long nUpperBoundInclusive)
{
if (nValue < nLowerBoundInclusive || nValue > nUpperBoundInclusive)
throw new IllegalArgumentException ("The value of '" +
sName +
"' must be >= " +
nLowerBoundInclusive +
" and <= " +
nUpperBoundInclusive +
"! The current value is: " +
nValue);
return nValue;
}
/**
* Check if
* nValue ≥ nLowerBoundInclusive && nValue ≤ nUpperBoundInclusive
*
* @param fValue
* Value
* @param sName
* Name
* @param fLowerBoundInclusive
* Lower bound
* @param fUpperBoundInclusive
* Upper bound
* @return The value
*/
public static float isBetweenInclusive (final float fValue,
final String sName,
final float fLowerBoundInclusive,
final float fUpperBoundInclusive)
{
if (fValue < fLowerBoundInclusive || fValue > fUpperBoundInclusive)
throw new IllegalArgumentException ("The value of '" +
sName +
"' must be >= " +
fLowerBoundInclusive +
" and <= " +
fUpperBoundInclusive +
"! The current value is: " +
fValue);
return fValue;
}
/**
* Check if
* nValue ≥ nLowerBoundInclusive && nValue ≤ nUpperBoundInclusive
*
* @param dValue
* Value
* @param sName
* Name
* @param dLowerBoundInclusive
* Lower bound
* @param dUpperBoundInclusive
* Upper bound
* @return The value
*/
public static double isBetweenInclusive (final double dValue,
final String sName,
final double dLowerBoundInclusive,
final double dUpperBoundInclusive)
{
if (dValue < dLowerBoundInclusive || dValue > dUpperBoundInclusive)
throw new IllegalArgumentException ("The value of '" +
sName +
"' must be >= " +
dLowerBoundInclusive +
" and <= " +
dUpperBoundInclusive +
"! The current value is: " +
dValue);
return dValue;
}
/**
* Check if
* nValue ≥ nLowerBoundInclusive && nValue ≤ nUpperBoundInclusive
*
* @param aValue
* Value
* @param sName
* Name
* @param aLowerBoundInclusive
* Lower bound
* @param aUpperBoundInclusive
* Upper bound
* @return The value
*/
public static BigDecimal isBetweenInclusive (@Nonnull final BigDecimal aValue,
final String sName,
@Nonnull final BigDecimal aLowerBoundInclusive,
@Nonnull final BigDecimal aUpperBoundInclusive)
{
notNull (aValue, sName);
notNull (aLowerBoundInclusive, "LowerBoundInclusive");
notNull (aUpperBoundInclusive, "UpperBoundInclusive");
if (aValue.compareTo (aLowerBoundInclusive) < 0 || aValue.compareTo (aUpperBoundInclusive) > 0)
throw new IllegalArgumentException ("The value of '" +
sName +
"' must be >= " +
aLowerBoundInclusive +
" and <= " +
aUpperBoundInclusive +
"! The current value is: " +
aValue);
return aValue;
}
/**
* Check if
* nValue ≥ nLowerBoundInclusive && nValue ≤ nUpperBoundInclusive
*
* @param aValue
* Value
* @param sName
* Name
* @param aLowerBoundInclusive
* Lower bound
* @param aUpperBoundInclusive
* Upper bound
* @return The value
*/
public static BigInteger isBetweenInclusive (@Nonnull final BigInteger aValue,
final String sName,
@Nonnull final BigInteger aLowerBoundInclusive,
@Nonnull final BigInteger aUpperBoundInclusive)
{
notNull (aValue, sName);
notNull (aLowerBoundInclusive, "LowerBoundInclusive");
notNull (aUpperBoundInclusive, "UpperBoundInclusive");
if (aValue.compareTo (aLowerBoundInclusive) < 0 || aValue.compareTo (aUpperBoundInclusive) > 0)
throw new IllegalArgumentException ("The value of '" +
sName +
"' must be >= " +
aLowerBoundInclusive +
" and <= " +
aUpperBoundInclusive +
"! The current value is: " +
aValue);
return aValue;
}
/**
* Check if
* nValue > nLowerBoundInclusive && nValue < nUpperBoundInclusive
*
* @param nValue
* Value
* @param sName
* Name
* @param nLowerBoundExclusive
* Lower bound
* @param nUpperBoundExclusive
* Upper bound
* @return The value
*/
public static short isBetweenExclusive (final short nValue,
final String sName,
final short nLowerBoundExclusive,
final short nUpperBoundExclusive)
{
if (nValue <= nLowerBoundExclusive || nValue >= nUpperBoundExclusive)
throw new IllegalArgumentException ("The value of '" +
sName +
"' must be > " +
nLowerBoundExclusive +
" and < " +
nUpperBoundExclusive +
"! The current value is: " +
nValue);
return nValue;
}
/**
* Check if
* nValue > nLowerBoundInclusive && nValue < nUpperBoundInclusive
*
* @param nValue
* Value
* @param sName
* Name
* @param nLowerBoundExclusive
* Lower bound
* @param nUpperBoundExclusive
* Upper bound
* @return The value
*/
public static int isBetweenExclusive (final int nValue,
final String sName,
final int nLowerBoundExclusive,
final int nUpperBoundExclusive)
{
if (nValue <= nLowerBoundExclusive || nValue >= nUpperBoundExclusive)
throw new IllegalArgumentException ("The value of '" +
sName +
"' must be > " +
nLowerBoundExclusive +
" and < " +
nUpperBoundExclusive +
"! The current value is: " +
nValue);
return nValue;
}
/**
* Check if
* nValue > nLowerBoundInclusive && nValue < nUpperBoundInclusive
*
* @param nValue
* Value
* @param sName
* Name
* @param nLowerBoundExclusive
* Lower bound
* @param nUpperBoundExclusive
* Upper bound
* @return The value
*/
public static long isBetweenExclusive (final long nValue,
final String sName,
final long nLowerBoundExclusive,
final long nUpperBoundExclusive)
{
if (nValue <= nLowerBoundExclusive || nValue >= nUpperBoundExclusive)
throw new IllegalArgumentException ("The value of '" +
sName +
"' must be > " +
nLowerBoundExclusive +
" and < " +
nUpperBoundExclusive +
"! The current value is: " +
nValue);
return nValue;
}
/**
* Check if
* nValue > nLowerBoundInclusive && nValue < nUpperBoundInclusive
*
* @param fValue
* Value
* @param sName
* Name
* @param fLowerBoundExclusive
* Lower bound
* @param fUpperBoundExclusive
* Upper bound
* @return The value
*/
public static float isBetweenExclusive (final float fValue,
final String sName,
final float fLowerBoundExclusive,
final float fUpperBoundExclusive)
{
if (fValue <= fLowerBoundExclusive || fValue >= fUpperBoundExclusive)
throw new IllegalArgumentException ("The value of '" +
sName +
"' must be > " +
fLowerBoundExclusive +
" and < " +
fUpperBoundExclusive +
"! The current value is: " +
fValue);
return fValue;
}
/**
* Check if
* nValue > nLowerBoundInclusive && nValue < nUpperBoundInclusive
*
* @param dValue
* Value
* @param sName
* Name
* @param dLowerBoundExclusive
* Lower bound
* @param dUpperBoundExclusive
* Upper bound
* @return The value
*/
public static double isBetweenExclusive (final double dValue,
final String sName,
final double dLowerBoundExclusive,
final double dUpperBoundExclusive)
{
if (dValue <= dLowerBoundExclusive || dValue >= dUpperBoundExclusive)
throw new IllegalArgumentException ("The value of '" +
sName +
"' must be > " +
dLowerBoundExclusive +
" and < " +
dUpperBoundExclusive +
"! The current value is: " +
dValue);
return dValue;
}
/**
* Check if
* nValue > nLowerBoundInclusive && nValue < nUpperBoundInclusive
*
* @param aValue
* Value
* @param sName
* Name
* @param aLowerBoundExclusive
* Lower bound
* @param aUpperBoundExclusive
* Upper bound
* @return The value
*/
public static BigDecimal isBetweenExclusive (@Nonnull final BigDecimal aValue,
final String sName,
@Nonnull final BigDecimal aLowerBoundExclusive,
@Nonnull final BigDecimal aUpperBoundExclusive)
{
notNull (aValue, sName);
notNull (aLowerBoundExclusive, "LowerBoundInclusive");
notNull (aUpperBoundExclusive, "UpperBoundInclusive");
if (aValue.compareTo (aLowerBoundExclusive) <= 0 || aValue.compareTo (aUpperBoundExclusive) >= 0)
throw new IllegalArgumentException ("The value of '" +
sName +
"' must be > " +
aLowerBoundExclusive +
" and < " +
aUpperBoundExclusive +
"! The current value is: " +
aValue);
return aValue;
}
/**
* Check if
* nValue > nLowerBoundInclusive && nValue < nUpperBoundInclusive
*
* @param aValue
* Value
* @param sName
* Name
* @param aLowerBoundExclusive
* Lower bound
* @param aUpperBoundExclusive
* Upper bound
* @return The value
*/
public static BigInteger isBetweenExclusive (@Nonnull final BigInteger aValue,
final String sName,
@Nonnull final BigInteger aLowerBoundExclusive,
@Nonnull final BigInteger aUpperBoundExclusive)
{
notNull (aValue, sName);
notNull (aLowerBoundExclusive, "LowerBoundInclusive");
notNull (aUpperBoundExclusive, "UpperBoundInclusive");
if (aValue.compareTo (aLowerBoundExclusive) <= 0 || aValue.compareTo (aUpperBoundExclusive) >= 0)
throw new IllegalArgumentException ("The value of '" +
sName +
"' must be > " +
aLowerBoundExclusive +
" and < " +
aUpperBoundExclusive +
"! The current value is: " +
aValue);
return aValue;
}
private static void _isArrayOfsLen (@Nonnegative final int nArrayLen,
@Nonnegative final int nOfs,
@Nonnegative final int nLen)
{
isGE0 (nOfs, "Offset");
isGE0 (nLen, "Length");
if ((nOfs + nLen) > nArrayLen)
throw new IllegalArgumentException ("Offset (" +
nOfs +
") + length (" +
nLen +
") exceeds array length (" +
nArrayLen +
")");
}
public static void isArrayOfsLen (@Nonnull final Object [] aArray,
@Nonnegative final int nOfs,
@Nonnegative final int nLen)
{
notNull (aArray, "Array");
_isArrayOfsLen (aArray.length, nOfs, nLen);
}
public static void isArrayOfsLen (@Nonnull final boolean [] aArray,
@Nonnegative final int nOfs,
@Nonnegative final int nLen)
{
notNull (aArray, "Array");
_isArrayOfsLen (aArray.length, nOfs, nLen);
}
public static void isArrayOfsLen (@Nonnull final byte [] aArray,
@Nonnegative final int nOfs,
@Nonnegative final int nLen)
{
notNull (aArray, "Array");
_isArrayOfsLen (aArray.length, nOfs, nLen);
}
public static void isArrayOfsLen (@Nonnull final char [] aArray,
@Nonnegative final int nOfs,
@Nonnegative final int nLen)
{
notNull (aArray, "Array");
_isArrayOfsLen (aArray.length, nOfs, nLen);
}
public static void isArrayOfsLen (@Nonnull final double [] aArray,
@Nonnegative final int nOfs,
@Nonnegative final int nLen)
{
notNull (aArray, "Array");
_isArrayOfsLen (aArray.length, nOfs, nLen);
}
public static void isArrayOfsLen (@Nonnull final float [] aArray,
@Nonnegative final int nOfs,
@Nonnegative final int nLen)
{
notNull (aArray, "Array");
_isArrayOfsLen (aArray.length, nOfs, nLen);
}
public static void isArrayOfsLen (@Nonnull final int [] aArray,
@Nonnegative final int nOfs,
@Nonnegative final int nLen)
{
notNull (aArray, "Array");
_isArrayOfsLen (aArray.length, nOfs, nLen);
}
public static void isArrayOfsLen (@Nonnull final long [] aArray,
@Nonnegative final int nOfs,
@Nonnegative final int nLen)
{
notNull (aArray, "Array");
_isArrayOfsLen (aArray.length, nOfs, nLen);
}
public static void isArrayOfsLen (@Nonnull final short [] aArray,
@Nonnegative final int nOfs,
@Nonnegative final int nLen)
{
notNull (aArray, "Array");
_isArrayOfsLen (aArray.length, nOfs, nLen);
}
}
