Class InputValidator


  • public final class InputValidator
    extends java.lang.Object
    Provides basic validation services for HTTP parameters. Three standard validators are provided: email address, identifier and standard input. Standard input validator will reject any HTML-like input, and any of a number of special characters. ID validator rejects HTML and quoted strings, and a couple of special characters.
    Since:
    2.3.54
    • Field Summary

      Fields 
      Modifier and Type Field Description
      static int EMAIL
      Input validator for e-mail addresses.
      static int ID  
      static int STANDARD
      Standard input validator.
    • Constructor Summary

      Constructors 
      Constructor Description
      InputValidator​(java.lang.String form, Context context)
      Constructs a new input validator for a specific form and wiki session.
    • Method Summary

      All Methods Static Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      static boolean isBlank​(java.lang.String input)
      Returns true if a supplied string is null or blank
      boolean validate​(java.lang.String input, java.lang.String label, int type)
      Validates a string against a particular pattern type: e-mail address, standard HTML input, etc.
      boolean validateNotNull​(java.lang.String input, java.lang.String label)
      Validates a string against the STANDARD validator and additionally checks that the value is not null or blank.
      boolean validateNotNull​(java.lang.String input, java.lang.String label, int type)
      Validates a string against a particular pattern type and additionally checks that the value is not null or blank.
      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    • Constructor Detail

      • InputValidator

        public InputValidator​(java.lang.String form,
                              Context context)
        Constructs a new input validator for a specific form and wiki session. When validation errors are detected, they will be added to the wiki session's messages.
        Parameters:
        form - the ID or name of the form this validator should be associated with
        context - the wiki context
    • Method Detail

      • validateNotNull

        public boolean validateNotNull​(java.lang.String input,
                                       java.lang.String label)
        Validates a string against the STANDARD validator and additionally checks that the value is not null or blank.
        Parameters:
        input - the string to validate
        label - the label for the string or field ("E-mail address")
        Returns:
        returns true if valid, false otherwise
      • validateNotNull

        public boolean validateNotNull​(java.lang.String input,
                                       java.lang.String label,
                                       int type)
        Validates a string against a particular pattern type and additionally checks that the value is not null or blank. Delegates to validate(String, String, int).
        Parameters:
        input - the string to validate
        label - the label for the string or field ("E-mail address")
        type - the pattern type to use (e.g., STANDARD, EMAIL.
        Returns:
        returns true if valid, false otherwise
      • validate

        public boolean validate​(java.lang.String input,
                                java.lang.String label,
                                int type)
        Validates a string against a particular pattern type: e-mail address, standard HTML input, etc. Note that a blank or null string will always validate.
        Parameters:
        input - the string to validate
        label - the label for the string or field ("E-mail address")
        type - the target pattern to validate against (STANDARD, EMAIL)
        Returns:
        returns true if valid, false otherwise
      • isBlank

        public static boolean isBlank​(java.lang.String input)
        Returns true if a supplied string is null or blank
        Parameters:
        input - the string to check
        Returns:
        true if null or blank (zero-length); false otherwise