Package org.passay.rule

Class IllegalCharacterRule

java.lang.Object
org.passay.rule.IllegalCharacterRule
All Implemented Interfaces:
Rule
public class IllegalCharacterRule extends Object implements Rule
Rule for determining if a password contains an illegal character. Validation will fail if the password contains any of the illegal characters.

  • Field Details

    • ERROR_CODE

      public static final String ERROR_CODE
      Error code for illegal character failures.
      See Also:

    • reportAllFailures

      protected final boolean reportAllFailures
      Whether to report all sequence matches or just the first.

    • illegalCharacters

      private final int[] illegalCharacters
      Stores the character code points that are not allowed.

    • matchBehavior

      private final MatchBehavior matchBehavior
      Where to match whitespace.

  • Constructor Details

    • IllegalCharacterRule

      public IllegalCharacterRule(UnicodeString unicodeString)
      Create a new illegal character rule.
      Parameters:
      unicodeString - illegal character code points

    • IllegalCharacterRule

      public IllegalCharacterRule(UnicodeString unicodeString, MatchBehavior behavior)
      Create a new illegal character rule.
      Parameters:
      unicodeString - illegal character code points
      behavior - how to match illegal characters

    • IllegalCharacterRule

      public IllegalCharacterRule(UnicodeString unicodeString, boolean reportAll)
      Create a new illegal character rule.
      Parameters:
      unicodeString - illegal character code points
      reportAll - whether to report all matches or just the first

    • IllegalCharacterRule

      public IllegalCharacterRule(UnicodeString unicodeString, MatchBehavior behavior, boolean reportAll)
      Create a new illegal character rule.
      Parameters:
      unicodeString - illegal character code points
      behavior - how to match illegal characters
      reportAll - whether to report all matches or just the first

  • Method Details

    • getReportAllFailures

      public boolean getReportAllFailures()
      Returns whether to report all matches or just the first.
      Returns:
      whether to report all matches or just the first

    • getIllegalCharacters

      public UnicodeString getIllegalCharacters()
      Returns the illegal character code points for this rule.
      Returns:
      illegal character code points

    • getMatchBehavior

      public MatchBehavior getMatchBehavior()
      Returns the match behavior for this rule.
      Returns:
      match behavior

    • validate

      public RuleResult validate(PasswordData passwordData)
      Description copied from interface: Rule
      Validates the supplied password data per the requirements of this rule.
      Specified by:
      validate in interface Rule
      Parameters:
      passwordData - to verify (not null).
      Returns:
      details on password verification

    • createRuleResultDetailParameters

      protected Map<String,Object> createRuleResultDetailParameters(int codePoint)
      Creates the parameter data for the rule result detail.
      Parameters:
      codePoint - illegal character code point
      Returns:
      map of parameter name to value

    • createRuleResultMetadata

      protected RuleResultMetadata createRuleResultMetadata(PasswordData password)
      Creates the rule result metadata.
      Parameters:
      password - data used for metadata creation
      Returns:
      rule result metadata

    • toString

      public String toString()
      Overrides:
      toString in class Object