net.sf.click.extras.control
Class RegexField

java.lang.Object
  net.sf.click.control.AbstractControl
      net.sf.click.control.Field
          net.sf.click.control.TextField
              net.sf.click.extras.control.RegexField

All Implemented Interfaces:

Control, Serializable

public class RegexField

extends TextField

Provides a Regex Field control: <input type='text'>.

Regex Field

RegexField will validate the value using regular expression when the control is processed and invoke the control listener if defined.

RegexField Example

Examples using RegexField for version number and URL input are provided below:

 RegexField versionField = new RegexField("version");
 versionField.setPattern("[0-9]+\\.[0-9]+\\.[0-9]+");
 form.add(versionField);

 RegexField urlField = new RegexField("url", "URL");
 urlField.setPattern("(http|https)://.+");
 form.add(urlField); 

For details on valid regular expression patterns see Pattern Javadoc.

Note for performance reasons the regular expression pattern is compiled when the field is processed not when its value is set. If you set an invalid expression pattern a PatternSyntaxException will be thrown by the Field.onProcess() method.

See also the W3C HTML reference: INPUT

Author:

Naoki Takezoe

See Also:

Serialized Form

Field Summary

static String	HTML_IMPORTS The RegexField.js imports statement.
protected String	pattern The field pattern based on regular expression.
protected static String	VALIDATE_REGEXFIELD_FUNCTION The field validation JavaScript function template.

Fields inherited from class net.sf.click.control.TextField

maxLength, minLength, size, VALIDATE_TEXTFIELD_FUNCTION

Fields inherited from class net.sf.click.control.Field

disabled, error, focus, form, help, label, readonly, required, tabindex, title, validate, value

Fields inherited from class net.sf.click.control.AbstractControl

actionListener, attributes, listener, listenerMethod, messages, name, parent, styles

Fields inherited from interface net.sf.click.Control

CONTROL_MESSAGES

Constructor Summary

RegexField()
Create a RegexField with no name defined.

RegexField(String name)
Construct the RegexField with the given name.

RegexField(String name, boolean required)
Construct the RegexField with the given name and required status.

RegexField(String name, String label)
Construct the RegexField with the given name and label.

RegexField(String name, String label, boolean required)
Construct the RegexField with the given name, label and required status.

RegexField(String name, String label, int size)
Construct the RegexField with the given name, label and size.

RegexField(String name, String label, int size, boolean required)
Construct the RegexField with the given name, label, size and required status.

Method Summary

String	getHtmlImports() Return the HTML head import statements for the JavaScript (click/extras-control.js) file.
String	getPattern() Returns the field pattern.
String	getValidationJavaScript() Return the field JavaScript client side validation function.
void	onDeploy(ServletContext servletContext) Deploy the extras-control.js file to the click web directory when the application is initialized.
void	setPattern(String pattern) Sets the field pattern as regular expression.
void	validate() Validate the RegexField request submission.

Methods inherited from class net.sf.click.control.TextField

getControlSizeEst, getMaxLength, getMinLength, getSize, getTag, getType, render, setMaxLength, setMinLength, setSize

Methods inherited from class net.sf.click.control.Field

bindRequestValue, getError, getErrorLabel, getFocus, getFocusJavaScript, getForm, getHelp, getId, getLabel, getRequestValue, getTabIndex, getTextAlign, getTitle, getValidate, getValue, getValueObject, getWidth, isDisabled, isHidden, isReadonly, isRequired, isValid, onInit, onProcess, setDisabled, setError, setErrorMessage, setErrorMessage, setErrorMessage, setErrorMessage, setFocus, setForm, setHelp, setLabel, setListener, setParent, setReadonly, setRequired, setTabIndex, setTextAlign, setTitle, setValidate, setValue, setValueObject, setWidth

Methods inherited from class net.sf.click.control.AbstractControl

addStyleClass, appendAttributes, getActionListener, getAttribute, getAttributes, getContext, getMessage, getMessage, getMessage, getMessages, getName, getPage, getParent, getStyle, getStyles, hasAttribute, hasAttributes, hasStyles, onDestroy, onRender, registerActionEvent, removeStyleClass, renderTagBegin, renderTagEnd, setActionListener, setAttribute, setId, setName, setStyle, toString

Methods inherited from class java.lang.Object

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

Field Detail

VALIDATE_REGEXFIELD_FUNCTION

protected static final String VALIDATE_REGEXFIELD_FUNCTION

The field validation JavaScript function template. The function template arguments are:

• 0 - is the field id
• 1 - is the Field required status
• 2 - is the minimum length
• 3 - is the maximum length
• 4 - is the field pattern (regular expression)
• 5 - is the localized error message for required validation
• 6 - is the localized error message for minimum length validation
• 7 - is the localized error message for maximum length validation
• 8 - is the localized error message for pattern validation

See Also:

Constant Field Values

HTML_IMPORTS

public static final String HTML_IMPORTS

The RegexField.js imports statement.

See Also:

Constant Field Values

pattern

protected String pattern

The field pattern based on regular expression. If the pattern is specified, RegexField validates the field value using this.

Constructor Detail

RegexField

public RegexField(String name)

Construct the RegexField with the given name.

Parameters:

name - the name of the field

RegexField

public RegexField(String name,
                  boolean required)

Construct the RegexField with the given name and required status.

Parameters:

name - the name of the field

required - the field required status

RegexField

public RegexField(String name,
                  String label,
                  boolean required)

Construct the RegexField with the given name, label and required status.

Parameters:

name - the name of the field

label - the label of the field

required - the field required status

RegexField

public RegexField(String name,
                  String label,
                  int size)

Construct the RegexField with the given name, label and size.

Parameters:

name - the name of the field

label - the label of the field

size - the size of the field

RegexField

public RegexField(String name,
                  String label,
                  int size,
                  boolean required)

Construct the RegexField with the given name, label, size and required status.

Parameters:

name - the name of the field

label - the label of the field

size - the size of the field

required - the field required status

RegexField

public RegexField(String name,
                  String label)

Construct the RegexField with the given name and label.

Parameters:

name - the name of the field

label - the label of the field

RegexField

public RegexField()

Create a RegexField with no name defined.

Please note the control's name must be defined before it is valid.

Method Detail

setPattern

public void setPattern(String pattern)

Sets the field pattern as regular expression.

Parameters:

pattern - the field regular expression pattern

Throws:

PatternSyntaxException - if the regular expression pattern cannot be compiled

getPattern

public String getPattern()

Returns the field pattern.

Returns:

the field pattern

getHtmlImports

public String getHtmlImports()

Return the HTML head import statements for the JavaScript (click/extras-control.js) file.

Returns:

the HTML head import statements for the JavaScript file

See Also:

Control.getHtmlImports()

getValidationJavaScript

public String getValidationJavaScript()

Return the field JavaScript client side validation function.

The function name must follow the format validate_[id], where the id is the DOM element id of the fields focusable HTML element, to ensure the function has a unique name.

Returns:

the field JavaScript client side validation function

validate

public void validate()

Validate the RegexField request submission.

A field error message is displayed if a validation error occurs. These messages are defined in the resource bundle:

• /click-control.properties
  • field-maxlength-error
  • field-minlength-error
  • field-required-error
• /net/sf/click/extras/control/RegexField.properties
  • field-pattern-error

Throws:

PatternSyntaxException - if the pattern has a syntax error

onDeploy

public void onDeploy(ServletContext servletContext)

Deploy the extras-control.js file to the click web directory when the application is initialized.

Parameters:

servletContext - the servlet context

See Also:

Control.onDeploy(ServletContext)