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

Interface PrimitiveByteValidator

All Superinterfaces:
ComparableComponent<PrimitiveByteValidator,Byte>, NegativeNumberComponent<PrimitiveByteValidator>, PositiveNumberComponent<PrimitiveByteValidator>, ValidatorComponent<PrimitiveByteValidator,Byte>, ZeroNumberComponent<PrimitiveByteValidator>
public interface PrimitiveByteValidator extends ValidatorComponent<PrimitiveByteValidator,Byte>, NegativeNumberComponent<PrimitiveByteValidator>, ZeroNumberComponent<PrimitiveByteValidator>, PositiveNumberComponent<PrimitiveByteValidator>, ComparableComponent<PrimitiveByteValidator,Byte>
Validates the state of a byte.

  • Method Details

    • getValue

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

    • getValueOrDefault

      byte getValueOrDefault(byte 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

      PrimitiveByteValidator isEqualTo(byte 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

    • isEqualTo

      PrimitiveByteValidator isEqualTo(byte 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

    • isNotEqualTo

      PrimitiveByteValidator isNotEqualTo(byte 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

    • isNotEqualTo

      PrimitiveByteValidator isNotEqualTo(byte 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

    • isLessThan

      PrimitiveByteValidator isLessThan(byte 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

    • isLessThan

      PrimitiveByteValidator isLessThan(byte 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

    • isLessThanOrEqualTo

      PrimitiveByteValidator isLessThanOrEqualTo(byte 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

    • isLessThanOrEqualTo

      PrimitiveByteValidator isLessThanOrEqualTo(byte 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

    • isGreaterThanOrEqualTo

      PrimitiveByteValidator isGreaterThanOrEqualTo(byte 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

    • isGreaterThanOrEqualTo

      PrimitiveByteValidator isGreaterThanOrEqualTo(byte 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

    • isGreaterThan

      PrimitiveByteValidator isGreaterThan(byte 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

    • isGreaterThan

      PrimitiveByteValidator isGreaterThan(byte 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

    • isBetween

      PrimitiveByteValidator isBetween(byte minimumInclusive, byte 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

    • isBetween

      PrimitiveByteValidator isBetween(byte minimum, boolean minimumIsInclusive, byte 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
      • maximumIsInclusive is false and the value is greater than or equal to maximum

    • isMultipleOf

      PrimitiveByteValidator isMultipleOf(byte 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

    • isMultipleOf

      PrimitiveByteValidator isMultipleOf(byte 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

    • isNotMultipleOf

      PrimitiveByteValidator isNotMultipleOf(byte 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

      PrimitiveByteValidator isNotMultipleOf(byte 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