UrlValidator

java.lang.Object
- org.codehaus.groovy.grails.validation.routines.UrlValidator

All Implemented Interfaces:

java.io.Serializable
```
public class UrlValidator
extends java.lang.Object
implements java.io.Serializable
```
URL Validation routines.
Behavior of validation is modified by passing in options:
ALLOW_2_SLASHES - [FALSE] Allows double '/' characters in the path component.
NO_FRAGMENT- [FALSE] By default fragments are allowed, if this option is included then fragments are flagged as illegal.
ALLOW_ALL_SCHEMES - [FALSE] By default only http, https, and ftp are considered valid schemes. Enabling this option will let any scheme pass validation.

Originally based in on php script by Debbie Dyer, validation.php v1.2b, Date: 03/07/02, http://javascript.internet.com. However, this validation now bears little resemblance to the php original.

   Example of usage:
   Construct a UrlValidator with valid schemes of "http", and "https".

    String[] schemes = {"http","https"}.
    UrlValidator urlValidator = new UrlValidator(schemes);
    if (urlValidator.isValid("ftp://foo.bar.com/")) {
       System.out.println("url is valid");
    } else {
       System.out.println("url is invalid");
    }

    prints "url is invalid"
   If instead the default constructor is used.

    UrlValidator urlValidator = new UrlValidator();
    if (urlValidator.isValid("ftp://foo.bar.com/")) {
       System.out.println("url is valid");
    } else {
       System.out.println("url is invalid");
    }

   prints out "url is valid"

Since:: Validator 1.4
See Also:: Uniform Resource Identifiers (URI): Generic Syntax , Serialized Form

Field Summary

Fields
Modifier and Type	Field and Description
`static long`	`ALLOW_2_SLASHES` Allow two slashes in the path component of the URL.
`static long`	`ALLOW_ALL_SCHEMES` Allows all validly formatted schemes to pass validation instead of supplying a set of valid schemes.
`static long`	`NO_FRAGMENTS` Enabling this options disallows any URL fragments.

Constructor Summary

Constructors
Constructor and Description
`UrlValidator()` Create a UrlValidator with default properties.
`UrlValidator(long options)` Initialize a UrlValidator with the given validation options.
`UrlValidator(RegexValidator authorityValidator, long options)` Initialize a UrlValidator with the given validation options.
`UrlValidator(java.lang.String[] schemes)` Behavior of validation is modified by passing in several strings options:
`UrlValidator(java.lang.String[] schemes, long options)` Behavior of validation is modified by passing in options:
`UrlValidator(java.lang.String[] schemes, RegexValidator authorityValidator, long options)` Customizable constructor.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`static UrlValidator`	`getInstance()` Returns the singleton instance of this class with default schemes and options.
`boolean`	`isValid(java.lang.String value)` Checks if a field has a valid url address.

Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - ALLOW_ALL_SCHEMES
```
public static final long ALLOW_ALL_SCHEMES
```
    Allows all validly formatted schemes to pass validation instead of supplying a set of valid schemes.
    
    See Also:
    
    Constant Field Values
  - ALLOW_2_SLASHES
```
public static final long ALLOW_2_SLASHES
```
    Allow two slashes in the path component of the URL.
    
    See Also:
    
    Constant Field Values
  - NO_FRAGMENTS
```
public static final long NO_FRAGMENTS
```
    Enabling this options disallows any URL fragments.
    
    See Also:
    
    Constant Field Values
- Constructor Detail
  - UrlValidator
```
public UrlValidator()
```
    Create a UrlValidator with default properties.
  - UrlValidator
```
public UrlValidator(java.lang.String[] schemes)
```
    Behavior of validation is modified by passing in several strings options:
    
    Parameters:
    
    schemes - Pass in one or more url schemes to consider valid, passing in a null will default to "http,https,ftp" being valid. If a non-null schemes is specified then all valid schemes must be specified. Setting the ALLOW_ALL_SCHEMES option will ignore the contents of schemes.
  - UrlValidator
```
public UrlValidator(long options)
```
    Initialize a UrlValidator with the given validation options.
    
    Parameters:
    
    options - The options should be set using the public constants declared in this class. To set multiple options you simply add them together. For example, ALLOW_2_SLASHES + NO_FRAGMENTS enables both of those options.
  - UrlValidator
```
public UrlValidator(java.lang.String[] schemes,
                    long options)
```
    Behavior of validation is modified by passing in options:
    
    Parameters:
    
    schemes - The set of valid schemes.
    
    options - The options should be set using the public constants declared in this class. To set multiple options you simply add them together. For example, ALLOW_2_SLASHES + NO_FRAGMENTS enables both of those options.
  - UrlValidator
```
public UrlValidator(RegexValidator authorityValidator,
                    long options)
```
    Initialize a UrlValidator with the given validation options.
    
    Parameters:
    
    authorityValidator - Regular expression validator used to validate the authority part
    
    options - Validation options. Set using the public constants of this class. To set multiple options, simply add them together:
    ALLOW_2_SLASHES + NO_FRAGMENTS
    enables both of those options.
  - UrlValidator
```
public UrlValidator(java.lang.String[] schemes,
                    RegexValidator authorityValidator,
                    long options)
```
    Customizable constructor. Validation behavior is modifed by passing in options.
    
    Parameters:
    
    schemes - the set of valid schemes
    
    authorityValidator - Regular expression validator used to validate the authority part
    
    options - Validation options. Set using the public constants of this class. To set multiple options, simply add them together:
    ALLOW_2_SLASHES + NO_FRAGMENTS
    enables both of those options.
- Method Detail
  - getInstance
```
public static UrlValidator getInstance()
```
    Returns the singleton instance of this class with default schemes and options.
    
    Returns:
    
    singleton instance with default schemes and options
  - isValid
```
public boolean isValid(java.lang.String value)
```
    Checks if a field has a valid url address.
    
    Parameters:
    
    value - The value validation is being performed on. A null value is considered invalid.
    
    Returns:
    
    true if the url is valid.

Class UrlValidator

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

ALLOW_ALL_SCHEMES

ALLOW_2_SLASHES

NO_FRAGMENTS

Constructor Detail

UrlValidator

UrlValidator

UrlValidator

UrlValidator

UrlValidator

UrlValidator

Method Detail

getInstance

isValid