com.threerings.gwt.ui

Class Validator

java.lang.Object

com.threerings.gwt.ui.Validator

public class Validator
extends Object

Simplifies the process of validating a collection of form fields and providing validation feedback.

Usage is like so:

_validator.add(_username).requireNonEmpty("Please enter your username.");
 _validator.add(_password).requireLengthOf(6, "Enter a password of at least 6 characters.");
 _validator.add(_agreeTOS).requireChecked("Agreement with the Terms of Service is required.");
 // ..before submitting form...
 if (!_validator.validate(true)) // abort!
 

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	Validator.CheckBoxValidator
class	Validator.IntegerBoxValidator
static interface	Validator.Rule Checks a single validation condition.
class	Validator.TextBoxValidator

Constructor Summary

Constructors

Constructor and Description
Validator()

Method Summary

Methods

Modifier and Type	Method and Description
Validator.CheckBoxValidator	add(CheckBox box)
Validator.IntegerBoxValidator	add(IntegerBox box)
Validator.TextBoxValidator	add(TextBox box) Returns a validator that provides rules for text boxes.
boolean	validate(boolean asError) Executes all registered validators (in registration order).

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Validator

public Validator()

Method Detail

add

public Validator.TextBoxValidator add(TextBox box)

Returns a validator that provides rules for text boxes. The validator will automatically validate the text box's contents when it loses focus.

add

public Validator.CheckBoxValidator add(CheckBox box)

add

public Validator.IntegerBoxValidator add(IntegerBox box)

validate

public boolean validate(boolean asError)

Executes all registered validators (in registration order). If any validator fires a rule that fails, its feedback will be displayed, the validation process will be stopped, and false will be returned. If all validators succeed, true will be returned.