com.smartgwt.client.types

## Enum ValidatorType

- java.lang.Object
- - java.lang.Enum<ValidatorType>
  - - com.smartgwt.client.types.ValidatorType

- All Implemented Interfaces:
    ValueEnum, java.io.Serializable, java.lang.Comparable<ValidatorType>

      public enum ValidatorType
      extends java.lang.Enum<ValidatorType>
      implements ValueEnum

  Used to name a validator or reference a standard, built-in `Validator` - see list below.

  To make use of a standard validator type for a field in a DataSource, or DynamicForm instance, specify the `validators` property to an array containing a validator definition where the `type` property is set to the appropriate type.

  A custom error message can be specified for any validator type by setting the `errorMessage` property on the validator definition object, and some validator types make use of additional properties on the validator definition object such as `max` or `min`.

  For example, to use the `integerRange` validator type:
  `field:{
  validators:[
  {type:"integerRange", min:1, max:100}
  ]
  }`

  Custom validators can be reused on the client by adding them to the global validator list, via the `Validator.addValidatorDefinition()` method.

- - ### Enum Constant Summary

    Enum Constants
    Enum Constant and Description
    `CONTAINS` Determine whether a string value contains some substring specified via `validator.substring`.
    `CUSTOM` Custom client-side validator.
    `DATERANGE` Tests whether the value for a date field is within the range specified.
    `DOESNTCONTAIN` Determine whether a string value does not contain some substring specified via `validator.substring`.
    `ENABLE` Change the enable/disable state of this field.
    `EQUALS` Tests whether the value for this field matches some value specified via `value`.
    `FLOATLIMIT` Validate a field as a valid floating point value within a value range.
    `FLOATPRECISION` Tests whether the value for this field is a floating point number with the appropriate number of decimal places - specified in `validator.precision` If the value is of higher precision and `validator.roundToPrecision` is specified, the value will be rounded to the specified number of decimal places and validation will pass, otherwise validation will fail.
    `FLOATRANGE` Tests whether the value for this field is a floating point number within the range specified.
    `HASRELATEDRECORD` Returns true if the record implied by a relation exists.
    `INSET` Tests whether the value for this field matches any value from an arbitrary list of acceptable values.
    `INTEGERRANGE` Tests whether the value for this field is a whole number within the range specified.
    `ISBOOLEAN` Validation will fail if this field is non-empty and has a non-boolean value.
    `ISFLOAT` Tests whether the value for this field is a valid floating point number.
    `ISFUNCTION` Tests whether the value for this field is a valid expression or function; if it is valid, creates a `stringMethod` object with the value and set the resultingValue to the StringMethod.
    `ISINTEGER` Tests whether the value for this field is a whole number.
    `ISONEOF` Tests whether the value for this field matches any value from an arbitrary list of acceptable values.
    `ISSTRING` Validation will fail if the value is not a string value.
    `ISUNIQUE` Returns true if the value for this field is unique.
    `LENGTHRANGE` This validator type applies to string values only.
    `MASK` Validate against a regular expression mask, specified as `validator.mask`.
    `MATCHESFIELD` Tests whether the value for this field matches the value of some other field.
    `MAXFILESIZE` This validator type is not for direct usage, instead `DataSourceField.maxFileSize` can be set and `maxFileSize` validator will be added automatically.
    `NOTEQUAL` Tests whether the value for this field does not match some value specified via `value`.
    `NOTINSET` Tests whether the value for this field does not match any value from an arbitrary list of unacceptable values.
    `READONLY` Disallows changes to this field, based on the `Validator.applyWhen` condition.
    `REGEXP` `regexp` type validators will determine whether the value specified matches a given regular expression.
    `REQUIRED` A non-empty value is required for this field to pass validation.
    `REQUIREDIF` RequiredIf type validators should be specified with an `expression` property set to a `stringMethod`, which takes four parameters: item - the DynamicForm item on which the error occurred (may be null) validator - a pointer to the validator object value - the value of the field in question record - the "record" object - the set of values being edited by the widget When validation is performed, the expression will be evaluated (or executed).
    `SERVERCUSTOM` Custom server-side validator that either evaluates the Velocity expression provided in `serverCondition` (see Velocity Expression Example) or makes DMI call to `serverObject` to evaluate condition (see DMI Validation Example).
    `SUBSTRINGCOUNT` Determine whether a string value contains some substring multiple times.
    `VISIBILITY` Change the visibility of this field.

  - ### Method Summary

    All Methods Static Methods Instance Methods Concrete Methods
    Modifier and Type | Method and Description
    --- | ---
    `java.lang.String` | `getValue()`
    `static ValidatorType` | `valueOf(java.lang.String name)` Returns the enum constant of this type with the specified name.
    `static ValidatorType[]` | `values()` Returns an array containing the constants of this enum type, in the order they are declared.

    - ### Methods inherited from class java.lang.Enum

      `clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf`

    - ### Methods inherited from class java.lang.Object

      `getClass, notify, notifyAll, wait, wait, wait`

- - ### Enum Constant Detail

    - #### ISBOOLEAN

          public static final ValidatorType ISBOOLEAN

      Validation will fail if this field is non-empty and has a non-boolean value.

      If this enumerated value is used in a `Component XML` file or server-side DataSource descriptor (.ds.xml file), use the value "isBoolean".

    - #### ISSTRING

          public static final ValidatorType ISSTRING

      Validation will fail if the value is not a string value.

      If this enumerated value is used in a `Component XML` file or server-side DataSource descriptor (.ds.xml file), use the value "isString".

    - #### ISINTEGER

          public static final ValidatorType ISINTEGER

      Tests whether the value for this field is a whole number. If `validator.convertToInteger` is true, float values will be converted into integers and validation will succeed.

      If this enumerated value is used in a `Component XML` file or server-side DataSource descriptor (.ds.xml file), use the value "isInteger".

    - #### ISFLOAT

          public static final ValidatorType ISFLOAT

      Tests whether the value for this field is a valid floating point number.

      If this enumerated value is used in a `Component XML` file or server-side DataSource descriptor (.ds.xml file), use the value "isFloat".

    - #### ISFUNCTION

          public static final ValidatorType ISFUNCTION

      Tests whether the value for this field is a valid expression or function; if it is valid, creates a `stringMethod` object with the value and set the resultingValue to the StringMethod.

      If this enumerated value is used in a `Component XML` file or server-side DataSource descriptor (.ds.xml file), use the value "isFunction".

    - #### REQUIREDIF

          public static final ValidatorType REQUIREDIF

      RequiredIf type validators should be specified with an `expression` property set to a `stringMethod`, which takes four parameters:
      - item - the DynamicForm item on which the error occurred (may be null)
      - validator - a pointer to the validator object
      - value - the value of the field in question
      - record - the "record" object - the set of values being edited by the widget
      When validation is performed, the expression will be evaluated (or executed). If it returns `true`, the field will be treated as a required field, so validation will fail if the field has no value, or, in the case of a `FileItem` or `UploadItem` and if client-side validation is supported by the browser, if no file is selected for upload or the selected file is empty.

      To allow server-side enforcement, a `required` validator can be used instead. With the exception of "binary" fields, conditional criteria can be specified with the `applyWhen` property.

      See Conditionally Required Example.

      Moreover, the expression provided needs to be in JavaScript, so to use this API, you should be familiar with JavaScript and Smart GWT APIs. A pure-Java alternative is to add a `RequiredIfValidator` on the DynamicForm or ListGrid where validation is required.

      NOTE: A requiredIf validator cannot be used to guarantee that a non-empty file is uploaded. The user's browser might not support client-side file validation. Using a requiredIf validator on a "binary" field may be appropriate in scenarios where the application does not technically require a non-empty file to be uploaded by the user. For example, in a bug tracking application, a file upload may be required if the "Have a test case?" checkbox is checked, but the value of the "Have a test case?" checkbox is not actually saved by the application; instead, whether the user is providing a test case is inferred by whether a non-empty test case file was uploaded.

      If this enumerated value is used in a `Component XML` file or server-side DataSource descriptor (.ds.xml file), use the value "requiredIf".

    - #### MATCHESFIELD

          public static final ValidatorType MATCHESFIELD

      Tests whether the value for this field matches the value of some other field. The field to compare against is specified via the `otherField` property on the validator object (should be set to a field name).

      See Match Value Example.

      If this enumerated value is used in a `Component XML` file or server-side DataSource descriptor (.ds.xml file), use the value "matchesField".

    - #### EQUALS

          public static final ValidatorType EQUALS

      Tests whether the value for this field matches some value specified via `value`.

      If this enumerated value is used in a `Component XML` file or server-side DataSource descriptor (.ds.xml file), use the value "equals".

    - #### NOTEQUAL

          public static final ValidatorType NOTEQUAL

      Tests whether the value for this field does not match some value specified via `value`.

      If this enumerated value is used in a `Component XML` file or server-side DataSource descriptor (.ds.xml file), use the value "notEqual".

    - #### ISONEOF

          public static final ValidatorType ISONEOF

      Tests whether the value for this field matches any value from an arbitrary list of acceptable values. The set of acceptable values is specified via the `list` property on the validator, which should be set to an array of values. If validator.list is not supplied, the valueMap for the field will be used. If there is no valueMap, not providing validator.list is an error.

      If this enumerated value is used in a `Component XML` file or server-side DataSource descriptor (.ds.xml file), use the value "isOneOf".

    - #### INSET

          public static final ValidatorType INSET

      Tests whether the value for this field matches any value from an arbitrary list of acceptable values. The set of acceptable values is specified via the `list` property on the validator, which should be set to an array of values. If validator.list is not supplied, the valueMap for the field will be used. If there is no valueMap, not providing validator.list is an error.

      If this enumerated value is used in a `Component XML` file or server-side DataSource descriptor (.ds.xml file), use the value "inSet".

    - #### NOTINSET

          public static final ValidatorType NOTINSET

      Tests whether the value for this field does not match any value from an arbitrary list of unacceptable values. The set of unacceptable values is specified via the `list` property on the validator, which should be set to an array of values. Not providing validator.list is an error.

      If this enumerated value is used in a `Component XML` file or server-side DataSource descriptor (.ds.xml file), use the value "notInSet".

    - #### INTEGERRANGE

          public static final ValidatorType INTEGERRANGE

      Tests whether the value for this field is a whole number within the range specified. The `max` and `min` properties on the validator are used to determine the acceptable range, inclusive. To specify the range as exclusive of the min/mix values, set `exclusive` to `true`.

      See Built-ins Example.

      If this enumerated value is used in a `Component XML` file or server-side DataSource descriptor (.ds.xml file), use the value "integerRange".

    - #### LENGTHRANGE

          public static final ValidatorType LENGTHRANGE

      This validator type applies to string values only. If the value is a string value validation will fail if the string's length falls outside the range specified by `validator.max` and `validator.min`.

      Note that non-string values will always pass validation by this validator type.

      Note that the `errorMessage` for this validator will be evaluated as a dynamicString - text within `${...}` will be evaluated as JS code when the message is displayed, with `max` and `min` available as variables mapped to `validator.max` and `validator.min`.

      If this enumerated value is used in a `Component XML` file or server-side DataSource descriptor (.ds.xml file), use the value "lengthRange".

    - #### CONTAINS

          public static final ValidatorType CONTAINS

      Determine whether a string value contains some substring specified via `validator.substring`.

      If this enumerated value is used in a `Component XML` file or server-side DataSource descriptor (.ds.xml file), use the value "contains".

    - #### DOESNTCONTAIN

          public static final ValidatorType DOESNTCONTAIN

      Determine whether a string value does not contain some substring specified via `validator.substring`.

      If this enumerated value is used in a `Component XML` file or server-side DataSource descriptor (.ds.xml file), use the value "doesntContain".

    - #### SUBSTRINGCOUNT

          public static final ValidatorType SUBSTRINGCOUNT

      Determine whether a string value contains some substring multiple times. The substring to check for is specified via `validator.substring`. The `validator.operator` property allows you to specify how to test the number of substring occurrences. Valid values for this property are `==`, `!=`, `<`, `<=`, `>`, `>=`.

      The number of matches to check for is specified via `validator.count`.

      If this enumerated value is used in a `Component XML` file or server-side DataSource descriptor (.ds.xml file), use the value "substringCount".

    - #### REGEXP

          public static final ValidatorType REGEXP

      `regexp` type validators will determine whether the value specified matches a given regular expression. The expression should be specified on the `validator` object as the `expression` property.

      See Regular Expression Example.

      If this enumerated value is used in a `Component XML` file or server-side DataSource descriptor (.ds.xml file), use the value "regexp".

    - #### MASK

          public static final ValidatorType MASK

      Validate against a regular expression mask, specified as `validator.mask`. If validation is successful a transformation can also be specified via the `validator.transformTo` property. This should be set to a string in the standard format for string replacement via the native JavaScript `replace()` method.

      See Value Transform Example.

      If this enumerated value is used in a `Component XML` file or server-side DataSource descriptor (.ds.xml file), use the value "mask".

    - #### DATERANGE

          public static final ValidatorType DATERANGE

      Tests whether the value for a date field is within the range specified. Range is inclusive, and is specified via `validator.min` and `validator.max`, which should be specified in XML Schema date format or as a live JavaScript Date object (for client-only validators only). To specify the range as exclusive of the min/mix values, set `exclusive` to `true`.

      Note that the `errorMessage` for this validator will be evaluated as a dynamicString - text within `${...}` will be evaluated as JS code when the message is displayed, with `max` and `min` available as variables mapped to `validator.max` and `validator.min`.

      If this enumerated value is used in a `Component XML` file or server-side DataSource descriptor (.ds.xml file), use the value "dateRange".

    - #### FLOATLIMIT

          public static final ValidatorType FLOATLIMIT

      Validate a field as a valid floating point value within a value range. Range is specified via `validator.min` and `validator.max`. Also checks precision, specified as number of decimal places in `validator.precision`. If `validator.roundToPrecision` is set a value that doesn't match the specified number of decimal places will be rounded to the nearest value that does.

      For backwards compatibility only. Use "floatRange" and/or "floatPrecision" instead.

      If this enumerated value is used in a `Component XML` file or server-side DataSource descriptor (.ds.xml file), use the value "floatLimit".

    - #### FLOATRANGE

          public static final ValidatorType FLOATRANGE

      Tests whether the value for this field is a floating point number within the range specified. The `max` and `min` properties on the validator are used to determine the acceptable range, inclusive. To specify the range as exclusive of the min/mix values, set `exclusive` to `true`.

      Note that the `errorMessage` for this validator will be evaluated as a dynamicString - text within `${...}` will be evaluated as JS code when the message is displayed, with `max` and `min` available as variables mapped to `validator.max` and `validator.min`.

      If this enumerated value is used in a `Component XML` file or server-side DataSource descriptor (.ds.xml file), use the value "floatRange".

    - #### FLOATPRECISION

          public static final ValidatorType FLOATPRECISION

      Tests whether the value for this field is a floating point number with the appropriate number of decimal places - specified in `validator.precision` If the value is of higher precision and `validator.roundToPrecision` is specified, the value will be rounded to the specified number of decimal places and validation will pass, otherwise validation will fail.

      If this enumerated value is used in a `Component XML` file or server-side DataSource descriptor (.ds.xml file), use the value "floatPrecision".

    - #### REQUIRED

          public static final ValidatorType REQUIRED

      A non-empty value is required for this field to pass validation.

      In the case of a "binary" field, a non-empty file must be uploaded.

      If this enumerated value is used in a `Component XML` file or server-side DataSource descriptor (.ds.xml file), use the value "required".

    - #### READONLY

          public static final ValidatorType READONLY

      Disallows changes to this field, based on the `Validator.applyWhen` condition.

      In addition to server-side enforcement, this validator will automatically cause editors for the field to become read-only, by rendering in a disabled appearance, readOnly appearance, or even by becoming hidden.

      The appearance of the read-only field can be controlled by validator.fieldAppearance. See `FieldAppearance` for choices. If `fieldAppearance` is not specified, the default is "readOnly".

      If this enumerated value is used in a `Component XML` file or server-side DataSource descriptor (.ds.xml file), use the value "readOnly".

    - #### VISIBILITY

          public static final ValidatorType VISIBILITY

      Change the visibility of this field.

      If this enumerated value is used in a `Component XML` file or server-side DataSource descriptor (.ds.xml file), use the value "visibility".

    - #### ENABLE

          public static final ValidatorType ENABLE

      Change the enable/disable state of this field.

      If this enumerated value is used in a `Component XML` file or server-side DataSource descriptor (.ds.xml file), use the value "enable".

    - #### ISUNIQUE

          public static final ValidatorType ISUNIQUE

      Returns true if the value for this field is unique. The uniqueness check is performed across the whole DataSource unless you specify property `validator.criteriaFields` as a comma-separated string of field names; in that case, the uniqueness check is done in the context of those extra criteria, allowing you to check, for example, whether an employee number is unique for the department and location found on the record being validated. By default the uniqueness check is not case sensitive but this can be controlled through the `caseSensitive` attribute. You can specify the `operation` to use for the uniqueness check with the `operationId` attribute.

      Validators of this type have requiresServer set to `true` and do not run on the client, unless all of the following are true:

      - The validation is run in the context of a DataBoundComponent or ValuesManager bound to some DataSource.
      - The DataSource is either clientOnly:true or cacheAllData: true and all data is loaded
      - The item is made available to the validator. Note that the item is not be available during a save performed without a form (eg programmatic save), or if the field is not available in the form.

      Note when isUnique validator is executed as part of validation process during update operation, it will perform uniqueness check only for single row updates. If update targets `multiple records`, then isUnique validator will be skipped. If uniqueness check is needed when updating multiple records, consider using `custom DMI` approach to add this check manually.

      See uniqueCheckValidation.

      If this enumerated value is used in a `Component XML` file or server-side DataSource descriptor (.ds.xml file), use the value "isUnique".

    - #### HASRELATEDRECORD

          public static final ValidatorType HASRELATEDRECORD

      Returns true if the record implied by a relation exists. The relation can be derived automatically from the `DataSourceField.foreignKey` attribute of the field being validated, or you can specify it manually via `validator.relatedDataSource` and `validator.relatedField`.

      You can specify at DataSource level that this validator should be automatically applied to all fields that specify a `foreignKey` - see `DataSource.validateRelatedRecords`.

      By default the uniqueness check is not case sensitive but this can be controlled through the `caseSensitive` attribute.

      Validators of this type have requiresServer set to `true` and do not run on the client.

      Note that this validation is generally unnecessary for data coming from a UI. The typical UI uses a `SelectItem` or `ComboBoxItem` with an `optionDataSource` for user entry, such that the user can't accidentally enter a related record if that doesn't exist, and a typical SQL schema will include constraints that prevent a bad insert if the user attempts to circumvent the UI. The primary purpose of declaring this validation explicitly is to provide clear, friendly error messages for use cases such as `BatchUploader`, where values aren't individually chosen by the user. See also the example Related Records.

      If this enumerated value is used in a `Component XML` file or server-side DataSource descriptor (.ds.xml file), use the value "hasRelatedRecord".

    - #### MAXFILESIZE

          public static final ValidatorType MAXFILESIZE

      This validator type is not for direct usage, instead `DataSourceField.maxFileSize` can be set and `maxFileSize` validator will be added automatically. Use `maxFileSizeExceededMessage` to customize validation error message.

      In supported browsers (Internet Explorer 10+, Chrome, Firefox, Safari 6+, Opera 11.1+), returns `true` if the file(s) selected by the user are not larger than the field's `DataSourceField.maxFileSize`. If not supported by the browser, the validator will always return `true`.

      Note that server-side enforcement of the `maxFileSize` is always required because the user's browser might not support client-side file size checks. Also, any client-side check can be bypassed by a malicious user.

      If this enumerated value is used in a `Component XML` file or server-side DataSource descriptor (.ds.xml file), use the value "maxFileSize".

    - #### CUSTOM

          public static final ValidatorType CUSTOM

      Custom client-side validator. Use by creating a subclass of Custom.CustomValidator and implementing the `condition` method.

      If this enumerated value is used in a `Component XML` file or server-side DataSource descriptor (.ds.xml file), use the value "custom".

    - #### SERVERCUSTOM

          public static final ValidatorType SERVERCUSTOM

      Custom server-side validator that either evaluates the Velocity expression provided in `serverCondition` (see Velocity Expression Example) or makes DMI call to `serverObject` to evaluate condition (see DMI Validation Example).

      Validators of this type have requiresServer set to `true` and do not run on the client.

      If this enumerated value is used in a `Component XML` file or server-side DataSource descriptor (.ds.xml file), use the value "serverCustom".

  - ### Method Detail

    - #### values

          public static ValidatorType[] values()

      Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:

          for (ValidatorType c : ValidatorType.values())
              System.out.println(c);

      Returns:
        an array containing the constants of this enum type, in the order they are declared

    - #### valueOf

          public static ValidatorType valueOf(java.lang.String name)

      Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)
      Parameters:
        `name` - the name of the enum constant to be returned.
      Returns:
        the enum constant with the specified name
      Throws:
        `java.lang.IllegalArgumentException` - if this enum type has no constant with the specified name
        `java.lang.NullPointerException` - if the argument is null

    - #### getValue

          public java.lang.String getValue()

      Specified by:
        `getValue` in interface `ValueEnum`