Validates URLs.
Behavour 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")) {
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")) {
System.out.println("url is valid");
} else {
System.out.println("url is invalid");
}
prints out "url is valid"
ALLOW_2_SLASHES
public static final int ALLOW_2_SLASHES
Allow two slashes in the path component of the URL.
- 2
ALLOW_ALL_SCHEMES
public static final int ALLOW_ALL_SCHEMES
Allows all validly formatted schemes to pass validation instead of supplying a
set of valid schemes.
- 1
ALPHA_CHARS
private static final java.lang.String ALPHA_CHARS
- "a-zA-Z"
ALPHA_NUMERIC_CHARS
private static final java.lang.String ALPHA_NUMERIC_CHARS
- "a-zA-Z\\d"
ALPHA_PATTERN
private static final java.lang.String ALPHA_PATTERN
- "/^[a-zA-Z]/"
ATOM
private static final java.lang.String ATOM
- "[^\\s;/@&=,.?:+$]+"
ATOM_PATTERN
private static final java.lang.String ATOM_PATTERN
- "/([^\\s;/@&=,.?:+$]+)/"
AUTHORITY_CHARS
private static final java.lang.String AUTHORITY_CHARS
- "a-zA-Z\\d\\-\\."
AUTHORITY_PATTERN
private static final java.lang.String AUTHORITY_PATTERN
- "/^([a-zA-Z\\d\\-\\.]*)(:\\d*)?(.*)?/"
DOMAIN_PATTERN
private static final java.lang.String DOMAIN_PATTERN
- "/^[^\\s;/@&=,.?:+$]+(\\.[^\\s;/@&=,.?:+$]+)*$/"
IP_V4_DOMAIN_PATTERN
private static final java.lang.String IP_V4_DOMAIN_PATTERN
- "/^(\\d{1,3})[.](\\d{1,3})[.](\\d{1,3})[.](\\d{1,3})$/"
LEGAL_ASCII_PATTERN
private static final java.lang.String LEGAL_ASCII_PATTERN
- "/^[\\000-\\177]+$/"
NO_FRAGMENTS
public static final int NO_FRAGMENTS
Enabling this options disallows any URL fragments.
- 4
PARSE_AUTHORITY_EXTRA
private static final int PARSE_AUTHORITY_EXTRA
Should always be empty.
- 3
PARSE_AUTHORITY_HOST_IP
private static final int PARSE_AUTHORITY_HOST_IP
- 1
PARSE_AUTHORITY_PORT
private static final int PARSE_AUTHORITY_PORT
- 2
PARSE_URL_AUTHORITY
private static final int PARSE_URL_AUTHORITY
Includes hostname/ip and port number.
- 4
PARSE_URL_FRAGMENT
private static final int PARSE_URL_FRAGMENT
- 9
PARSE_URL_PATH
private static final int PARSE_URL_PATH
- 5
PARSE_URL_QUERY
private static final int PARSE_URL_QUERY
- 7
PARSE_URL_SCHEME
private static final int PARSE_URL_SCHEME
Schema/Protocol (ie. http:, ftp:, file:, etc).
- 2
PATH_PATTERN
private static final java.lang.String PATH_PATTERN
- "/^(/[-a-zA-Z0-9_:@&?=+,.!/~*'%$]*)$/"
PORT_PATTERN
private static final java.lang.String PORT_PATTERN
- "/^:(\\d{1,5})$/"
QUERY_PATTERN
private static final java.lang.String QUERY_PATTERN
- "/^(.*)$/"
SCHEME_CHARS
private static final java.lang.String SCHEME_CHARS
- "a-zA-Z"
SCHEME_PATTERN
private static final java.lang.String SCHEME_PATTERN
Protocol (ie. http:, ftp:,https:).
- "/^[a-zA-Z]/"
SPECIAL_CHARS
private static final java.lang.String SPECIAL_CHARS
- ";/@&=,.?:+$"
URL_PATTERN
private static final java.lang.String URL_PATTERN
This expression derived/taken from the BNF for URI (RFC2396).
- "/^(([^:/?#]+):)?(//([^/?#]*))?([^?#]*)(\\?([^#]*))?(#(.*))?/"
VALID_CHARS
private static final java.lang.String VALID_CHARS
- "[^\\s;/@&=,.?:+$]"
allowedSchemes
private java.util.Set allowedSchemes
The set of schemes that are allowed to be in a URL.
defaultSchemes
protected java.lang.String[] defaultSchemes
If no schemes are provided, default to this set.
options
private Flags options
Holds the set of current validation options.
countToken
protected int countToken(java.lang.String token,
java.lang.String target) Returns the number of times the token appears in the target.
isValid
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.
- true if the url is valid.
isValidAuthority
protected boolean isValidAuthority(java.lang.String authority)
Returns true if the authority is properly formatted. An authority is the combination
of hostname and port. A null authority value is considered invalid.
isValidFragment
protected boolean isValidFragment(java.lang.String fragment)
Returns true if the given fragment is null or fragments are allowed.
isValidPath
protected boolean isValidPath(java.lang.String path)
Returns true if the path is valid. A null value is considered invalid.
isValidQuery
protected boolean isValidQuery(java.lang.String query)
Returns true if the query is null or it's a properly formatted query string.
isValidScheme
protected boolean isValidScheme(java.lang.String scheme)
Validate scheme. If schemes[] was initialized to a non null,
then only those scheme's are allowed. Note this is slightly different
than for the constructor.
scheme - The scheme to validate. A null value is considered
invalid.
- true if valid.