public class UrlValidator
extends java.lang.Object
implements java.io.Serializable
Validates URLs.
Behavour of validation is modified by passing in options: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"
Modifier and Type | Field and Description |
---|---|
static int |
ALLOW_2_SLASHES
Deprecated.
Allow two slashes in the path component of the URL.
|
static int |
ALLOW_ALL_SCHEMES
Deprecated.
Allows all validly formatted schemes to pass validation instead of
supplying a set of valid schemes.
|
private java.util.Set<java.lang.String> |
allowedSchemes
Deprecated.
The set of schemes that are allowed to be in a URL.
|
private static java.lang.String |
ALPHA_CHARS
Deprecated.
|
private static java.util.regex.Pattern |
ALPHA_PATTERN
Deprecated.
|
private static java.lang.String |
ATOM
Deprecated.
|
private static java.util.regex.Pattern |
ATOM_PATTERN
Deprecated.
|
private static java.lang.String |
AUTHORITY_CHARS_REGEX
Deprecated.
|
private static java.util.regex.Pattern |
AUTHORITY_PATTERN
Deprecated.
|
private static java.lang.String |
AUTHORITY_REGEX
Deprecated.
|
protected java.lang.String[] |
defaultSchemes
Deprecated.
If no schemes are provided, default to this set.
|
private static java.util.regex.Pattern |
DOMAIN_PATTERN
Deprecated.
|
private static java.util.regex.Pattern |
LEGAL_ASCII_PATTERN
Deprecated.
|
static int |
NO_FRAGMENTS
Deprecated.
Enabling this options disallows any URL fragments.
|
private Flags |
options
Deprecated.
Holds the set of current validation options.
|
private static int |
PARSE_AUTHORITY_EXTRA
Deprecated.
Should always be empty.
|
private static int |
PARSE_AUTHORITY_HOST_IP
Deprecated.
|
private static int |
PARSE_AUTHORITY_PORT
Deprecated.
|
private static int |
PARSE_URL_AUTHORITY
Deprecated.
Includes hostname/ip and port number.
|
private static int |
PARSE_URL_FRAGMENT
Deprecated.
|
private static int |
PARSE_URL_PATH
Deprecated.
|
private static int |
PARSE_URL_QUERY
Deprecated.
|
private static int |
PARSE_URL_SCHEME
Deprecated.
Schema/Protocol (ie.
|
private static java.util.regex.Pattern |
PATH_PATTERN
Deprecated.
|
private static java.util.regex.Pattern |
PORT_PATTERN
Deprecated.
|
private static java.util.regex.Pattern |
QUERY_PATTERN
Deprecated.
|
private static java.util.regex.Pattern |
SCHEME_PATTERN
Deprecated.
Protocol (ie.
|
private static long |
serialVersionUID
Deprecated.
|
private static java.lang.String |
SPECIAL_CHARS
Deprecated.
|
private static java.util.regex.Pattern |
URL_PATTERN
Deprecated.
|
private static java.lang.String |
URL_REGEX
Deprecated.
This expression derived/taken from the BNF for URI (RFC2396).
|
private static java.lang.String |
VALID_CHARS
Deprecated.
|
Constructor and Description |
---|
UrlValidator()
Deprecated.
Create a UrlValidator with default properties.
|
UrlValidator(int options)
Deprecated.
Initialize a UrlValidator with the given validation options.
|
UrlValidator(java.lang.String[] schemes)
Deprecated.
Behavior of validation is modified by passing in several strings options:
|
UrlValidator(java.lang.String[] schemes,
int options)
Deprecated.
Behavour of validation is modified by passing in options:
|
Modifier and Type | Method and Description |
---|---|
protected int |
countToken(java.lang.String token,
java.lang.String target)
Deprecated.
Returns the number of times the token appears in the target.
|
boolean |
isValid(java.lang.String value)
Deprecated.
Checks if a field has a valid url address.
|
protected boolean |
isValidAuthority(java.lang.String authority)
Deprecated.
Returns true if the authority is properly formatted.
|
protected boolean |
isValidFragment(java.lang.String fragment)
Deprecated.
Returns true if the given fragment is null or fragments are allowed.
|
protected boolean |
isValidPath(java.lang.String path)
Deprecated.
Returns true if the path is valid.
|
protected boolean |
isValidQuery(java.lang.String query)
Deprecated.
Returns true if the query is null or it's a properly formatted query string.
|
protected boolean |
isValidScheme(java.lang.String scheme)
Deprecated.
Validate scheme.
|
private static final long serialVersionUID
public static final int ALLOW_ALL_SCHEMES
public static final int ALLOW_2_SLASHES
public static final int NO_FRAGMENTS
private static final java.lang.String ALPHA_CHARS
private static final java.lang.String SPECIAL_CHARS
private static final java.lang.String VALID_CHARS
private static final java.lang.String AUTHORITY_CHARS_REGEX
private static final java.lang.String ATOM
private static final java.lang.String URL_REGEX
private static final java.util.regex.Pattern URL_PATTERN
private static final int PARSE_URL_SCHEME
private static final int PARSE_URL_AUTHORITY
private static final int PARSE_URL_PATH
private static final int PARSE_URL_QUERY
private static final int PARSE_URL_FRAGMENT
private static final java.util.regex.Pattern SCHEME_PATTERN
private static final java.lang.String AUTHORITY_REGEX
private static final java.util.regex.Pattern AUTHORITY_PATTERN
private static final int PARSE_AUTHORITY_HOST_IP
private static final int PARSE_AUTHORITY_PORT
private static final int PARSE_AUTHORITY_EXTRA
private static final java.util.regex.Pattern PATH_PATTERN
private static final java.util.regex.Pattern QUERY_PATTERN
private static final java.util.regex.Pattern LEGAL_ASCII_PATTERN
private static final java.util.regex.Pattern DOMAIN_PATTERN
private static final java.util.regex.Pattern PORT_PATTERN
private static final java.util.regex.Pattern ATOM_PATTERN
private static final java.util.regex.Pattern ALPHA_PATTERN
private final Flags options
private final java.util.Set<java.lang.String> allowedSchemes
protected java.lang.String[] defaultSchemes
public UrlValidator()
public UrlValidator(java.lang.String[] schemes)
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.public UrlValidator(int options)
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.public UrlValidator(java.lang.String[] schemes, int options)
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.public boolean isValid(java.lang.String value)
Checks if a field has a valid url address.
value
- The value validation is being performed on. A null
value is considered invalid.protected boolean isValidScheme(java.lang.String scheme)
scheme
- The scheme to validate. A null
value is considered
invalid.protected boolean isValidAuthority(java.lang.String authority)
null
authority value is considered invalid.authority
- Authority value to validate.protected boolean isValidPath(java.lang.String path)
null
value is considered invalid.path
- Path value to validate.protected boolean isValidQuery(java.lang.String query)
query
- Query value to validate.protected boolean isValidFragment(java.lang.String fragment)
fragment
- Fragment value to validate.protected int countToken(java.lang.String token, java.lang.String target)
token
- Token value to be counted.target
- Target value to count tokens in.