@JSFValidator(configExcluded=true) public class RegExpValidator extends Object implements javax.faces.component.StateHolder, javax.faces.validator.Validator
RegExpValidator 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 RegExpValidator class is
 same as mentioned in class Pattern in package
 java.util.regex. The following algorithm is implemented:
null or empty string, exit immediately.pattern property has been configured on this
     Validator, check the component value against this pattern.
     If value does not match pattern throw a ValidatorException
     containing a NO_MATCH_MESSAGE_ID message.
     If noMatchMessageDetail is set, it is used for constructing faces
     message. The message can contain placeholders which will be replaced as
     specified in NO_MATCH_MESSAGE_IDsetMessageDetailNoMatch(String)| Modifier and Type | Field and Description | 
|---|---|
| static String | NO_MATCH_MESSAGE_IDThe message identifier of the  FacesMessageto be created if the match fails. | 
| static String | VALIDATOR_IDStandard validator id for this validator. | 
| Constructor and Description | 
|---|
| RegExpValidator()Construct a RegExpValidator with no preconfigured pattern. | 
| RegExpValidator(String pattern)Construct a RegExpValidator with preconfigured pattern. | 
| Modifier and Type | Method and Description | 
|---|---|
| boolean | equals(Object object)Compares this PatternValidator with the specified Object for
 equality. | 
| String | getHint()Return custom hint message. | 
| String | getMessageDetailNoMatch()Return custom detail error message that was set for creating faces message,
 for values that do not match the specified pattern. | 
| String | getPattern()Return the pattern value to be enforced by this  Validator | 
| javax.faces.el.ValueBinding | getValueBinding(String name)Deprecated.   | 
| javax.el.ValueExpression | getValueExpression(String name)Return the  ValueExpressionused to calculate the value for the
 specified attribute name, if any. | 
| int | hashCode()Returns the hash code for this Validator. | 
| boolean | isDisabled()Return whether it is disabled. | 
| boolean | isTransient() | 
| void | restoreState(javax.faces.context.FacesContext context,
            Object state) | 
| Object | saveState(javax.faces.context.FacesContext context) | 
| void | setDisabled(boolean isDisabled)Return whether it is disabled. | 
| void | setHint(String hintPattern)Custom hint message. | 
| void | setMessageDetailNoMatch(String noMatchMessageDetail)Custom error message to be used, for creating detail part of the
  FacesMessage, when value does not match the specified pattern. | 
| void | setPattern(String pattern)Set the pattern value to be enforced by this  Validator | 
| void | setTransient(boolean transientValue) | 
| void | setValueBinding(String name,
               javax.faces.el.ValueBinding binding)Deprecated.   | 
| void | setValueExpression(String name,
                  javax.el.ValueExpression expression)Set the  ValueExpressionused to calculate the value for the
 specified attribute if any. | 
| void | validate(javax.faces.context.FacesContext context,
        javax.faces.component.UIComponent component,
        Object value) | 
public static final String VALIDATOR_ID
Standard validator id for this validator.
public static final String NO_MATCH_MESSAGE_ID
The message identifier of the FacesMessage
 to be created if the match fails.  The message format
 string for this message may optionally include a {0},
 {1} and {4} placeholders, which will be replaced
 input value, label associated with the component and pattern respectively.
public RegExpValidator()
Construct a RegExpValidator with no preconfigured pattern.
public RegExpValidator(String pattern)
Construct a RegExpValidator with preconfigured pattern.
public void validate(javax.faces.context.FacesContext context,
            javax.faces.component.UIComponent component,
            Object value)
              throws javax.faces.validator.ValidatorException
validate in interface javax.faces.validator.Validatorjavax.faces.validator.ValidatorException - if validation failsNullPointerException - if context
 or component or pattern is nullIllegalArgumentException - if value is not of type
 String@JSFProperty(istransient=true,
             tagExcluded=true)
public boolean isTransient()
isTransient in interface javax.faces.component.StateHolderpublic void setTransient(boolean transientValue)
setTransient in interface javax.faces.component.StateHolderpublic Object saveState(javax.faces.context.FacesContext context)
saveState in interface javax.faces.component.StateHolderpublic void restoreState(javax.faces.context.FacesContext context,
                Object state)
restoreState in interface javax.faces.component.StateHolderpublic void setValueExpression(String name, javax.el.ValueExpression expression)
Set the ValueExpression used to calculate the value for the
 specified attribute if any.
name - Name of the attribute for which to set a ValueExpressionexpression - The ValueExpression to set, or null
  to remove any currently set ValueExpressionNullPointerException - if name
  is nullIllegalArgumentException - if name is not a valid
            attribute of this converterpublic javax.el.ValueExpression getValueExpression(String name)
Return the ValueExpression used to calculate the value for the
 specified attribute name, if any.
name - Name of the attribute or property for which to retrieve a
  ValueExpressionNullPointerException - if name
  is nullIllegalArgumentException - if name is not a valid
 attribute of this converterpublic void setValueBinding(String name, javax.faces.el.ValueBinding binding)
Set the ValueBinding used to calculate the value for the
 specified attribute if any.
name - Name of the attribute for which to set a ValueBindingbinding - The ValueBinding to set, or null
  to remove any currently set ValueBindingNullPointerException - if name
  is nullIllegalArgumentException - if name is not a valid
            attribute of this validatorpublic javax.faces.el.ValueBinding getValueBinding(String name)
Return the ValueBinding used to calculate the value for the
 specified attribute name, if any.
name - Name of the attribute or property for which to retrieve a
  ValueBindingNullPointerException - if name
  is nullIllegalArgumentException - if name is not a valid
 attribute of this validatorpublic boolean equals(Object object)
Compares this PatternValidator with the specified Object for equality.
public int hashCode()
Returns the hash code for this Validator.
public void setHint(String hintPattern)
Custom hint message.
Overrides default hint messagehintPattern - Custom hint message.@JSFProperty(tagExcluded=true) public String getHint()
Return custom hint message.
setHint(String)public void setPattern(String pattern)
Set the pattern value to be enforced by this Validator
pattern - to be enforced.@JSFProperty public String getPattern()
Return the pattern value to be enforced by this Validator
public void setMessageDetailNoMatch(String noMatchMessageDetail)
Custom error message to be used, for creating detail part of the
 FacesMessage, when value does not match the specified pattern.
NO_MATCH_MESSAGE_IDnoMatchMessageDetail - @JSFProperty public String getMessageDetailNoMatch()
Return custom detail error message that was set for creating faces message, for values that do not match the specified pattern.
setMessageDetailNoMatch(String)public void setDisabled(boolean isDisabled)
public boolean isDisabled()
Copyright © 2001-2017 The Apache Software Foundation. All Rights Reserved.