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

Interface PrimitiveCharacterValidator

All Superinterfaces:
ComparableComponent<PrimitiveCharacterValidator,Character>, ValidatorComponent<PrimitiveCharacterValidator,Character>
public interface PrimitiveCharacterValidator extends ValidatorComponent<PrimitiveCharacterValidator,Character>, ComparableComponent<PrimitiveCharacterValidator,Character>
Validates the state of a char.

  • Method Details

    • getValue

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

    • getValueOrDefault

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

      PrimitiveCharacterValidator isEqualTo(char 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

      PrimitiveCharacterValidator isEqualTo(char 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

      PrimitiveCharacterValidator isNotEqualTo(char 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

      PrimitiveCharacterValidator isNotEqualTo(char 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

      PrimitiveCharacterValidator isLessThan(char 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

      PrimitiveCharacterValidator isLessThan(char 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

      PrimitiveCharacterValidator isLessThanOrEqualTo(char 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

      PrimitiveCharacterValidator isLessThanOrEqualTo(char 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

      PrimitiveCharacterValidator isGreaterThanOrEqualTo(char 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

      PrimitiveCharacterValidator isGreaterThanOrEqualTo(char 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

      PrimitiveCharacterValidator isGreaterThan(char 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

      PrimitiveCharacterValidator isGreaterThan(char 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

      PrimitiveCharacterValidator isBetween(char minimumInclusive, char 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

      PrimitiveCharacterValidator isBetween(char minimum, boolean minimumIsInclusive, char 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