|
||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
java.lang.Objectorg.apache.wicket.behavior.Behavior
org.apache.wicket.validation.validator.AbstractValidator<String>
org.apache.wicket.validation.validator.UrlValidator
public class UrlValidator
Validator for checking URLs. The default schemes allowed are http://,
https://, and ftp://.
The behavior of validation is modified by passing in one of these 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.
This was originally based org.apache.commons.validator.UrlValidator, but the
dependency on Jakarta-ORO was removed and it now uses java.util.regexp instead. Usage example:
<code>
Component.add(new UrlValidator({"http", "https"}));
</code>
| Field Summary | |
|---|---|
static int |
ALLOW_2_SLASHES
Allow two slashes in the path component of the URL. |
static int |
ALLOW_ALL_SCHEMES
Allows all validly-formatted schemes to pass validation instead of supplying a set of valid schemes. |
protected String[] |
defaultSchemes
If no schemes are provided, default to this set of protocols. |
static int |
NO_FRAGMENTS
Enabling this option disallows any URL fragments. |
| Constructor Summary | |
|---|---|
UrlValidator()
Constructs a UrlValidator with default properties. |
|
UrlValidator(int options)
Constructs a UrlValidator with the given validation options. |
|
UrlValidator(String[] schemes)
Constructs a UrlValidator with the given String array of scheme
options. |
|
UrlValidator(String[] schemes,
int options)
Constructs a UrlValidator with the given scheme and validation options (see
class description). |
|
| Method Summary | |
|---|---|
protected int |
countToken(String token,
String target)
Returns the number of times the token appears in the target. |
static boolean |
isBlankOrNull(String value)
Checks if the field isn't null and if length of the field is greater than zero,
not including whitespace. |
boolean |
isOff(long flag)
Tests whether the given flag is off. |
boolean |
isOn(long flag)
Tests whether the given flag is on. |
boolean |
isValid(String value)
Checks if a field has a valid URL. |
protected boolean |
isValidAuthority(String authority)
Returns true if the authority is properly formatted. |
protected boolean |
isValidFragment(String fragment)
Returns true if the given fragment is null or fragments are
allowed. |
protected boolean |
isValidPath(String path)
Returns true if the path is valid. |
protected boolean |
isValidQuery(String query)
Returns true if the query is null or if it's a properly-formatted
query string. |
protected boolean |
isValidScheme(String scheme)
Validates a scheme. |
protected void |
onValidate(IValidatable<String> validatable)
Validates the IValidatable instance. |
| Methods inherited from class org.apache.wicket.validation.validator.AbstractValidator |
|---|
error, error, error, error, resourceKey, validate, validateOnNullValue, variablesMap |
| Methods inherited from class org.apache.wicket.behavior.Behavior |
|---|
afterRender, beforeRender, bind, canCallListenerInterface, canCallListenerInterface, detach, getStatelessHint, isEnabled, isTemporary, onComponentTag, onConfigure, onEvent, onException, renderHead, unbind |
| Methods inherited from class java.lang.Object |
|---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
| Field Detail |
|---|
public static final int ALLOW_ALL_SCHEMES
public static final int ALLOW_2_SLASHES
URL.
public static final int NO_FRAGMENTS
URL fragments.
protected String[] defaultSchemes
| Constructor Detail |
|---|
public UrlValidator()
UrlValidator with default properties.
public UrlValidator(String[] schemes)
UrlValidator with the given String array of scheme
options. The validation is modified by passing in options in the schemes
argument.
schemes - Pass in one or more URL schemes to consider valid. Passing in a
null will default to "http,https,ftp" being used. If a
non-null scheme 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)
UrlValidator with the given validation 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(String[] schemes,
int options)
UrlValidator with the given scheme and validation options (see
class description).
schemes - Pass in one or more URL schemes to consider valid. Passing in a
null will default to "http,https,ftp" being used. If a
non-null scheme is specified, then all valid schemes must be
specified. Setting the ALLOW_ALL_SCHEMES option will ignore the
contents of 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.| Method Detail |
|---|
protected void onValidate(IValidatable<String> validatable)
AbstractValidatorIValidatable instance.
onValidate in class AbstractValidator<String>validatable - the given IValidatable instanceAbstractValidator.onValidate(IValidatable)public final boolean isValid(String value)
URL. This method is public because it is directly
used in tests.
value - The value validation is being performed on. A null value is
considered invalid.
true if the URL is validprotected boolean isValidScheme(String scheme)
null, then only those
schemes are allowed. Note that this is slightly different than for the constructor.
scheme - The scheme to validate. A null value is considered invalid.
true if the URL is validprotected boolean isValidAuthority(String authority)
true if the authority is properly formatted. An authority is the
combination of host name and port. A null authority value is considered invalid.
authority - an authority value to validate
protected boolean isValidPath(String path)
true if the path is valid. A null value is considered
invalid.
path - a path value to validate.
true if path is valid.protected boolean isValidQuery(String query)
true if the query is null or if it's a properly-formatted
query string.
query - a query value to validate
true if the query is validprotected boolean isValidFragment(String fragment)
true if the given fragment is null or fragments are
allowed.
fragment - a fragment value to validate
true if the fragment is valid
protected int countToken(String token,
String target)
token - a token value to be countedtarget - a target String to count tokens in
public static boolean isBlankOrNull(String value)
null and if length of the field is greater than zero,
not including whitespace.
value - the value validation is being performed on
true if blank or nullpublic boolean isOn(long flag)
flag - flag value to check
public boolean isOff(long flag)
flag - flag value to check.
|
||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||