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

Interface PrimitiveFloatValidator

All Superinterfaces:
ComparableComponent<PrimitiveFloatValidator,Float>, DecimalNumberComponent<PrimitiveFloatValidator>, FixedPrecisionDecimalNumberComponent<PrimitiveFloatValidator>, NegativeNumberComponent<PrimitiveFloatValidator>, PositiveNumberComponent<PrimitiveFloatValidator>, ValidatorComponent<PrimitiveFloatValidator,Float>, ZeroNumberComponent<PrimitiveFloatValidator>
public interface PrimitiveFloatValidator extends ValidatorComponent<PrimitiveFloatValidator,Float>, NegativeNumberComponent<PrimitiveFloatValidator>, ZeroNumberComponent<PrimitiveFloatValidator>, PositiveNumberComponent<PrimitiveFloatValidator>, DecimalNumberComponent<PrimitiveFloatValidator>, FixedPrecisionDecimalNumberComponent<PrimitiveFloatValidator>, ComparableComponent<PrimitiveFloatValidator,Float>
Validates the state of a float.

  • Method Details

    • getValue

      float getValue()
      Returns the value that is being validated.
      Returns:
      the value
      Throws:
      IllegalStateException - if a previous validation failed

    • getValueOrDefault

      float getValueOrDefault(float defaultValue)
      Returns the value that is being validated.
      Parameters:
      defaultValue - the fallback value in case of a validation failure
      Returns:
      the value, or defaultValue if a previous validation failed

    • isEqualTo

      PrimitiveFloatValidator isEqualTo(float expected)
      Ensures that the value is equal to expected.
      Parameters:
      expected - the expected value
      Returns:
      this
      Throws:
      IllegalArgumentException - if the value is not equal to expected per Float.equals(Object)

    • isEqualTo

      PrimitiveFloatValidator isEqualTo(float expected, String name)
      Ensures that the value is equal to expected.
      Parameters:
      expected - the expected value
      name - the name of the expected value
      Returns:
      this
      Throws:
      NullPointerException - if name is 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 equal to expected per Float.equals(Object)

    • isNotEqualTo

      PrimitiveFloatValidator isNotEqualTo(float unwanted)
      Ensures that the value is not equal to unwanted.
      Parameters:
      unwanted - the value to compare to
      Returns:
      this
      Throws:
      IllegalArgumentException - if the value is equal to unwanted per Float.equals(Object)

    • isNotEqualTo

      PrimitiveFloatValidator isNotEqualTo(float unwanted, String name)
      Ensures that the value is not equal to unwanted.
      Parameters:
      unwanted - the value to compare to
      name - the name of the other value
      Returns:
      this
      Throws:
      NullPointerException - if name is 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 equal to unwanted per Float.equals(Object)

    • isMultipleOf

      PrimitiveFloatValidator isMultipleOf(float factor)
      Ensures that the value is a multiple of factor.
      Parameters:
      factor - the number being multiplied
      Returns:
      this
      Throws:
      IllegalArgumentException - if the value is:
      • not a multiple of factor
      • not a number

    • isMultipleOf

      PrimitiveFloatValidator isMultipleOf(float 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 name is 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
      • the value is not a number

    • isNotMultipleOf

      PrimitiveFloatValidator isNotMultipleOf(float factor)
      Ensures that the value is not a multiple of factor.
      Parameters:
      factor - the number being multiplied
      Returns:
      this
      Throws:
      IllegalArgumentException - if the value is a multiple of factor

    • isNotMultipleOf

      PrimitiveFloatValidator isNotMultipleOf(float 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 name is 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

      PrimitiveFloatValidator isLessThan(float maximumExclusive)
      Ensures that the value is less than an upper bound.
      Parameters:
      maximumExclusive - the exclusive upper bound
      Returns:
      this
      Throws:
      IllegalArgumentException - if the value is:
      • greater than or equal to maximumExclusive
      • not a number

    • isLessThan

      PrimitiveFloatValidator isLessThan(float 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 name is 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
      • the value is not a number

    • isLessThanOrEqualTo

      PrimitiveFloatValidator isLessThanOrEqualTo(float maximumInclusive)
      Ensures that the value is less than or equal to a maximum value.
      Parameters:
      maximumInclusive - the inclusive upper value
      Returns:
      this
      Throws:
      IllegalArgumentException - if the value is:
      • greater than maximumInclusive
      • not a number

    • isLessThanOrEqualTo

      PrimitiveFloatValidator isLessThanOrEqualTo(float 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 name is 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
      • the value is not a number

    • isGreaterThanOrEqualTo

      PrimitiveFloatValidator isGreaterThanOrEqualTo(float minimumInclusive)
      Ensures that the value is greater than or equal to a minimum value.
      Parameters:
      minimumInclusive - the minimum value
      Returns:
      this
      Throws:
      IllegalArgumentException - if the value is:
      • less than minimumInclusive
      • not a number

    • isGreaterThanOrEqualTo

      PrimitiveFloatValidator isGreaterThanOrEqualTo(float 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 name is 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
      • the value is not a number

    • isGreaterThan

      PrimitiveFloatValidator isGreaterThan(float minimumExclusive)
      Ensures that the value is greater than a lower bound.
      Parameters:
      minimumExclusive - the exclusive lower bound
      Returns:
      this
      Throws:
      IllegalArgumentException - if the value is:
      • less than or equal to minimumExclusive
      • not a number

    • isGreaterThan

      PrimitiveFloatValidator isGreaterThan(float 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 name is 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
      • the value is not a number

    • isBetween

      PrimitiveFloatValidator isBetween(float minimumInclusive, float 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:
      IllegalArgumentException - if:
      • minimumInclusive is greater than maximumExclusive
      • the value is greater than or equal to maximumExclusive
      • the value is not a number

    • isBetween

      PrimitiveFloatValidator isBetween(float minimum, boolean minimumIsInclusive, float 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:
      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
      • maximumInclusive is false and the value is greater than or equal to maximum
      • the value is not a number