org.apache.tapestry.form.validator

Class Pattern

java.lang.Object

org.apache.tapestry.form.validator.BaseValidator

org.apache.tapestry.form.validator.Pattern

All Implemented Interfaces:

FormComponentContributor, Validator

public class Pattern
extends BaseValidator

Validates a user input string against a regular expression pattern.

Since:

4.0

Author:

Howard Lewis Ship

See Also:

RegexpMatcher

Constructor Summary

Constructors

Constructor and Description
Pattern()
Pattern(java.lang.String initializer)

Method Summary

Methods

Modifier and Type	Method and Description
void	renderContribution(IMarkupWriter writer, IRequestCycle cycle, FormComponentContributorContext context, IFormComponent field) Does nothing.
void	setPattern(java.lang.String pattern)
void	validate(IFormComponent field, ValidationMessages messages, java.lang.Object object) Invoked to validate input for the field.

Methods inherited from class org.apache.tapestry.form.validator.BaseValidator

getAcceptsNull, getMessage, isRequired, setMessage

Methods inherited from class java.lang.Object

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

Constructor Detail

Pattern

public Pattern()

Pattern

public Pattern(java.lang.String initializer)

Method Detail

validate

public void validate(IFormComponent field,
            ValidationMessages messages,
            java.lang.Object object)
              throws ValidatorException

Description copied from interface: Validator

Invoked to validate input for the field. A Translator will have already converted the submitted user input string into an object.

Parameters:

field - the form element component being validated, often used to determine the user presentable name for the field, used in error messages.

messages - access to the pre-defined validation messages, in the appropriate locale

object - the client-side representation of the field's data. May be null if the client did not provide a value for the field (most Validators should check for null and perform no check if null).

Throws:

ValidatorException - if the object violates the constraint represented by this Validator.

renderContribution

public void renderContribution(IMarkupWriter writer,
                      IRequestCycle cycle,
                      FormComponentContributorContext context,
                      IFormComponent field)

Description copied from class: BaseValidator

Does nothing.

Specified by:

renderContribution in interface FormComponentContributor

Overrides:

renderContribution in class BaseValidator

Parameters:

writer - allows contributor to write additional attributes into the component's tag

cycle - for accessing request information

context - utilities for genering messages and client-side validation

field - the field for which contributions are being rendered

setPattern

public void setPattern(java.lang.String pattern)