Module com.github.cowwoc.requirements10.java

Package com.github.cowwoc.requirements10.java.validator

Interface UnsignedIntegerValidator

All Superinterfaces:

ComparableComponent<UnsignedIntegerValidator,Integer>, ObjectComponent<UnsignedIntegerValidator,Integer>, PositiveNumberComponent<UnsignedIntegerValidator>, ValidatorComponent<UnsignedIntegerValidator,Integer>, ZeroNumberComponent<UnsignedIntegerValidator>

public interface UnsignedIntegerValidator
extends ValidatorComponent<UnsignedIntegerValidator,Integer>, ObjectComponent<UnsignedIntegerValidator,Integer>, ZeroNumberComponent<UnsignedIntegerValidator>, PositiveNumberComponent<UnsignedIntegerValidator>, ComparableComponent<UnsignedIntegerValidator,Integer>

Validates the state of an Integer that does not support negative values.

Method Summary

Modifier and Type	Method	Description
UnsignedIntegerValidator	isBetween(int minimum, boolean minimumIsInclusive, int maximum, boolean maximumIsInclusive)	Ensures that the value is within a range.
UnsignedIntegerValidator	isBetween(int minimumInclusive, int maximumExclusive)	Ensures that the value is within a range.
UnsignedIntegerValidator	isGreaterThan(int minimumExclusive)	Ensures that the value is greater than a lower bound.
UnsignedIntegerValidator	isGreaterThan(int minimumExclusive, String name)	Ensures that the value is greater than a lower bound.
UnsignedIntegerValidator	isGreaterThanOrEqualTo(int minimumInclusive)	Ensures that the value is greater than or equal to a minimum value.
UnsignedIntegerValidator	isGreaterThanOrEqualTo(int minimumInclusive, String name)	Ensures that the value is greater than or equal a minimum value.
UnsignedIntegerValidator	isLessThan(int maximumExclusive)	Ensures that the value is less than an upper bound.
UnsignedIntegerValidator	isLessThan(int maximumExclusive, String name)	Ensures that the value is less than an upper bound.
UnsignedIntegerValidator	isLessThanOrEqualTo(int maximumInclusive)	Ensures that the value is less than or equal to a maximum value.
UnsignedIntegerValidator	isLessThanOrEqualTo(int maximumInclusive, String name)	Ensures that the value is less than or equal to a maximum value.
UnsignedIntegerValidator	isMultipleOf(int factor)	Ensures that the value is a multiple of factor.
UnsignedIntegerValidator	isMultipleOf(int factor, String name)	Ensures that the value is a multiple of factor.
UnsignedIntegerValidator	isNotMultipleOf(int factor)	Ensures that the value is not a multiple of factor.
UnsignedIntegerValidator	isNotMultipleOf(int factor, String name)	Ensures that the value is not a multiple of factor.

Methods declared in interface com.github.cowwoc.requirements10.java.validator.component.ComparableComponent

isBetween, isBetween, isGreaterThan, isGreaterThan, isGreaterThanOrEqualTo, isGreaterThanOrEqualTo, isLessThan, isLessThan, isLessThanOrEqualTo, isLessThanOrEqualTo

Methods declared in interface com.github.cowwoc.requirements10.java.validator.component.ObjectComponent

getValue, isEqualTo, isEqualTo, isInstanceOf, isInstanceOf, isNotEqualTo, isNotEqualTo, isNotInstanceOf, isNotInstanceOf, isNotNull, isNull, isReferenceEqualTo, isReferenceNotEqualTo

Methods declared in interface com.github.cowwoc.requirements10.java.validator.component.PositiveNumberComponent

isNotPositive, isPositive

Methods declared in interface com.github.cowwoc.requirements10.java.validator.component.ValidatorComponent

and, elseGetFailures, elseThrow, getContext, getContextAsString, getName, getValueOrDefault, validationFailed, withContext

Methods declared in interface com.github.cowwoc.requirements10.java.validator.component.ZeroNumberComponent

isNotZero, isZero

Method Details

isMultipleOf

UnsignedIntegerValidator isMultipleOf(int factor)

Ensures that the value is a multiple of factor.

Parameters:

factor - the number being multiplied

Returns:

this

Throws:

NullPointerException - if the value is null

IllegalArgumentException - if the value is not a multiple of factor

isMultipleOf

UnsignedIntegerValidator isMultipleOf(int factor,
 String name)

Ensures that the value is a multiple of factor.

Parameters:

factor - the number being multiplied

name - the name of the factor

Returns:

this

Throws:

NullPointerException - if the value or name are null

IllegalArgumentException - if:

• name is empty
• name contains whitespace
• name is already in use by the value being validated or the validator context
• the value is not a multiple of factor

isNotMultipleOf

UnsignedIntegerValidator isNotMultipleOf(int factor)

Ensures that the value is not a multiple of factor.

Parameters:

factor - the number being multiplied

Returns:

this

Throws:

NullPointerException - if the value is null

IllegalArgumentException - if the value is a multiple of factor

isNotMultipleOf

UnsignedIntegerValidator isNotMultipleOf(int factor,
 String name)

Ensures that the value is not a multiple of factor.

Parameters:

factor - the number being multiplied

name - the name of the factor

Returns:

this

Throws:

NullPointerException - if the value or name are null

IllegalArgumentException - if:

• name is empty
• name contains whitespace
• name is already in use by the value being validated or the validator context
• the value is a multiple of factor

isLessThan

UnsignedIntegerValidator isLessThan(int maximumExclusive)

Ensures that the value is less than an upper bound.

Parameters:

maximumExclusive - the exclusive upper bound

Returns:

this

Throws:

NullPointerException - if the value is null

IllegalArgumentException - if the value is greater than or equal to maximumExclusive

isLessThan

UnsignedIntegerValidator isLessThan(int maximumExclusive,
 String name)

Ensures that the value is less than an upper bound.

Parameters:

maximumExclusive - the exclusive upper bound

name - the name of the upper bound

Returns:

this

Throws:

NullPointerException - if the value or name are null

IllegalArgumentException - if:

• name is empty
• name contains whitespace
• name is already in use by the value being validated or the validator context
• the value is greater than or equal to maximumExclusive

isLessThanOrEqualTo

UnsignedIntegerValidator isLessThanOrEqualTo(int maximumInclusive)

Ensures that the value is less than or equal to a maximum value.

Parameters:

maximumInclusive - the inclusive upper value

Returns:

this

Throws:

NullPointerException - if the value is null

IllegalArgumentException - if the value is greater than maximumInclusive

isLessThanOrEqualTo

UnsignedIntegerValidator isLessThanOrEqualTo(int maximumInclusive,
 String name)

Ensures that the value is less than or equal to a maximum value.

Parameters:

maximumInclusive - the maximum value

name - the name of the maximum value

Returns:

this

Throws:

NullPointerException - if the value or name are null

IllegalArgumentException - if:

• name is empty
• name contains whitespace
• name is already in use by the value being validated or the validator context
• the value is greater than maximumInclusive

isGreaterThanOrEqualTo

UnsignedIntegerValidator isGreaterThanOrEqualTo(int minimumInclusive)

Ensures that the value is greater than or equal to a minimum value.

Parameters:

minimumInclusive - the minimum value

Returns:

this

Throws:

NullPointerException - if the value is null

IllegalArgumentException - if the value is less than minimumInclusive

isGreaterThanOrEqualTo

UnsignedIntegerValidator isGreaterThanOrEqualTo(int minimumInclusive,
 String name)

Ensures that the value is greater than or equal a minimum value.

Parameters:

minimumInclusive - the minimum value

name - the name of the minimum value

Returns:

this

Throws:

NullPointerException - if the value or name are null

IllegalArgumentException - if:

• name is empty
• name contains whitespace
• name is already in use by the value being validated or the validator context
• the value is less than minimumInclusive

isGreaterThan

UnsignedIntegerValidator isGreaterThan(int minimumExclusive)

Ensures that the value is greater than a lower bound.

Parameters:

minimumExclusive - the exclusive lower bound

Returns:

this

Throws:

NullPointerException - if the value is null

IllegalArgumentException - if the value is less than or equal to minimumExclusive

isGreaterThan

UnsignedIntegerValidator isGreaterThan(int minimumExclusive,
 String name)

Ensures that the value is greater than a lower bound.

Parameters:

minimumExclusive - the exclusive lower bound

name - the name of the lower bound

Returns:

this

Throws:

NullPointerException - if the value or name are null

IllegalArgumentException - if:

• name is empty
• name contains whitespace
• name is already in use by the value being validated or the validator context
• the value is less or equal to minimumExclusive

isBetween

UnsignedIntegerValidator isBetween(int minimumInclusive,
 int maximumExclusive)

Ensures that the value is within a range.

Parameters:

minimumInclusive - the lower bound of the range (inclusive)

maximumExclusive - the upper bound of the range (exclusive)

Returns:

this

Throws:

NullPointerException - if the value is null

IllegalArgumentException - if:

• minimumInclusive is greater than maximumExclusive
• the value is greater than or equal to maximumExclusive

isBetween

UnsignedIntegerValidator isBetween(int minimum,
 boolean minimumIsInclusive,
 int maximum,
 boolean maximumIsInclusive)

Ensures that the value is within a range.

Parameters:

minimum - the lower bound of the range

minimumIsInclusive - true if the lower bound of the range is inclusive

maximum - the upper bound of the range

maximumIsInclusive - true if the upper bound of the range is inclusive

Returns:

this

Throws:

NullPointerException - if the value is null

IllegalArgumentException - if:

• minimum is greater than maximum
• minimumIsInclusive is true and the value is less than minimum
• minimumIsInclusive is false and the value is less than or equal to minimum
• maximumIsInclusive is true and the value is greater than maximum
• maximumIsInclusive is false and the value is greater than or equal to maximum