Package jakarta.faces.validator

Class RegexValidator

java.lang.Object

jakarta.faces.validator.RegexValidator

All Implemented Interfaces:

PartialStateHolder, StateHolder, Validator, EventListener

@JSFValidator(name="f:validateRegex",
              bodyContent="empty")
@JSFJspProperty(name="binding",
                returnType="jakarta.faces.validator.RegexValidator",
                longDesc="A ValueExpression that evaluates to a RegexValidator.")
public class RegexValidator
extends Object
implements Validator, PartialStateHolder

RegexValidator is a Validator that checks the value of the corresponding component against specified pattern using Java regular expression syntax. The regular expression syntax accepted by the RegexValidator class is same as mentioned in class Pattern in package java.util.regex.

The following algorithm is implemented:

• If the passed value is null, exit immediately.
• If the passed value is not a String, exit with a NOT_MATCHED_MESSAGE_ID error message.
• If no pattern has been set, or pattern resolves to null or an empty String, throw a ValidatorException with a PATTERN_NOT_SET_MESSAGE_ID message.
• If pattern is not a valid regular expression, according to the rules as defined in class Pattern, throw a ValidatorException with a (@link #MATCH_EXCEPTION_MESSAGE_ID} message.
• If a pattern property has been configured on this Validator, check the passed value against this pattern. If value does not match pattern throw a ValidatorException containing a NOT_MATCHED_MESSAGE_ID message.

Since:

2.0

Field Summary

Fields

Modifier and Type	Field	Description
static final String	MATCH_EXCEPTION_MESSAGE_ID	This message ID is used when the pattern is not a valid regular expression, according to the rules as defined in class Pattern
static final String	NOT_MATCHED_MESSAGE_ID	This message ID is used when the passed value is not a String, or when the pattern does not match the passed value.
static final String	PATTERN_NOT_SET_MESSAGE_ID	This message ID is used when the pattern is null, or an empty String.
static final String	VALIDATOR_ID	Converter ID, as defined by the Faces 2.0 specification.

Constructor Summary

Constructors

Constructor	Description
RegexValidator()

Method Summary

Modifier and Type	Method	Description
void	clearInitialState()
String	getPattern()	Return the ValueExpression that yields the regular expression pattern when evaluated.
boolean	initialStateMarked()
boolean	isTransient()
void	markInitialState()
void	restoreState(FacesContext context, Object state)
Object	saveState(FacesContext context)
void	setPattern(String pattern)	The Regular Expression property to validate against.
void	setTransient(boolean isTransient)
void	validate(FacesContext context, UIComponent component, Object value)

Methods inherited from class java.lang.Object

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

Field Details

VALIDATOR_ID

public static final String VALIDATOR_ID

Converter ID, as defined by the Faces 2.0 specification.

See Also:

• Constant Field Values

PATTERN_NOT_SET_MESSAGE_ID

public static final String PATTERN_NOT_SET_MESSAGE_ID

This message ID is used when the pattern is null, or an empty String.

See Also:

• Constant Field Values

NOT_MATCHED_MESSAGE_ID

public static final String NOT_MATCHED_MESSAGE_ID

This message ID is used when the passed value is not a String, or when the pattern does not match the passed value.

See Also:

• Constant Field Values

MATCH_EXCEPTION_MESSAGE_ID

public static final String MATCH_EXCEPTION_MESSAGE_ID

This message ID is used when the pattern is not a valid regular expression, according to the rules as defined in class Pattern

See Also:

• Constant Field Values

Constructor Details

RegexValidator

public RegexValidator()

Method Details

validate

public void validate(FacesContext context,
 UIComponent component,
 Object value)

Specified by:

validate in interface Validator

saveState

public Object saveState(FacesContext context)

Specified by:

saveState in interface StateHolder

restoreState

public void restoreState(FacesContext context,
 Object state)

Specified by:

restoreState in interface StateHolder

isTransient

public boolean isTransient()

Specified by:

isTransient in interface StateHolder

setTransient

public void setTransient(boolean isTransient)

Specified by:

setTransient in interface StateHolder

setPattern

public void setPattern(String pattern)

The Regular Expression property to validate against. This property must be a ValueExpression that resolves to a String in the format of the java.util.regex patterns.

Parameters:

pattern - a ValueExpression that evaluates to a String that is the regular expression pattern

getPattern

@JSFProperty(required=true)
public String getPattern()

Return the ValueExpression that yields the regular expression pattern when evaluated.

Returns:

The pattern.

clearInitialState

public void clearInitialState()

Specified by:

clearInitialState in interface PartialStateHolder

initialStateMarked

public boolean initialStateMarked()

Specified by:

initialStateMarked in interface PartialStateHolder

markInitialState

public void markInitialState()

Specified by:

markInitialState in interface PartialStateHolder