|
||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
java.lang.Objectorg.apache.myfaces.trinidad.validator.ByteLengthValidator
public class ByteLengthValidator
ByteLengthValidator is a Validator that checks
the value of the corresponding component for its byte length for the set
character encoding. The following algorithm is implemented:
null, exit immediately.encoding and maximum property
has been configured on this Validator, check the component
value byte length against the maximum. If the component value byte length
is greater than this specified maximum, throw a ValidatorException
containing a MAXIMUM_MESSAGE_ID message.maximum property has been configured on this
Validator, check the component value against
this limit defaulting the encoding to be iso-8859-1.
If the component value length is greater than the specified maximum,
throw a ValidatorException containing a MAXIMUM_MESSAGE_ID
message.encoding property has been configured on this
Validator, and if it is not a valid Java encoding, then throws a
IllegalCharsetNameExceptionmaximumMessageDetail is set, it is used for constructing
faces message, when validation fails. The message can contain placeholders
which will be replaced as specified in MAXIMUM_MESSAGE_ID
setMessageDetailMaximum(String)| Field Summary | |
|---|---|
static String |
MAXIMUM_MESSAGE_ID
The message identifier of the FacesMessage to be created if
the maximum byte length check fails. |
static String |
VALIDATOR_ID
Standard validator id for this validator. |
| Fields inherited from interface javax.faces.validator.Validator |
|---|
NOT_IN_RANGE_MESSAGE_ID |
| Constructor Summary | |
|---|---|
ByteLengthValidator()
Construct a Validator with iso-8859-1 as the encoding
and zero as the maximum bytes allowed. |
|
ByteLengthValidator(int maximum,
String encoding)
Construct a Validator with the specified preconfigured
values. |
|
| Method Summary | |
|---|---|
boolean |
equals(Object object)
Compares this ByteLengthValidator with the specified Object for equality. |
String |
getEncoding()
Return the character encoding set for this Validator or
iso-8859-1 if it has not been set. |
String |
getHintMaximum()
Return custom hint message. |
protected FacesMessage |
getLengthValidationFailureMessage(FacesContext context,
UIComponent component,
String value)
The FacesMessage to be returned if byte length validation fails. |
int |
getMaximum()
Return the maximum bytes to be enforced by this Validator or zero if it has not been
set. |
String |
getMessageDetailMaximum()
Return custom detail error message that was set for creating FacesMessage,
for values that exceeds the maximum byte length. |
ValueBinding |
getValueBinding(String name)
Deprecated. |
ValueExpression |
getValueExpression(String name)
Return the ValueExpression used to calculate the value for the
specified attribute name, if any. |
int |
hashCode()
Returns the hash code for this Validator. |
boolean |
isTransient()
|
void |
restoreState(FacesContext context,
Object state)
|
Object |
saveState(FacesContext context)
|
void |
setEncoding(String encoding)
Set the character encoding for this Validator. |
void |
setHintMaximum(String hintMaximum)
Custom hint message. |
void |
setMaximum(int maximum)
Set the maximum bytes to be enforced by this Validator. |
void |
setMessageDetailMaximum(String maximumMessageDetail)
Custom error message to be used, for creating detail part of the FacesMessage, when users input exceeds the maximum byte length. |
void |
setTransient(boolean transientValue)
|
void |
setValueBinding(String name,
ValueBinding binding)
Deprecated. |
void |
setValueExpression(String name,
ValueExpression expression)
Set the ValueExpression used to calculate the value for the
specified attribute if any. |
void |
validate(FacesContext context,
UIComponent component,
Object value)
Validates unless it is too long, in which case throws ValidatorException. |
| Methods inherited from class java.lang.Object |
|---|
clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait |
| Field Detail |
|---|
public static final String MAXIMUM_MESSAGE_ID
The message identifier of the FacesMessage to be created if
the maximum byte length check fails. The message format string for this
message may optionally include {0}, {1} and
{2} placeholders, which will be replaced by input value, label
associated with the component and the maximum bytes respectively.
public static final String VALIDATOR_ID
Standard validator id for this validator.
| Constructor Detail |
|---|
public ByteLengthValidator()
Construct a Validator with iso-8859-1 as the encoding
and zero as the maximum bytes allowed.
public ByteLengthValidator(int maximum,
String encoding)
Construct a Validator with the specified preconfigured
values.
maximum - the maximum number of bytes allowed.encoding - the Java character set encoding. This must be
an encoding supported by Java.| Method Detail |
|---|
public void setEncoding(String encoding)
Set the character encoding for this Validator.
encoding - The character encoding.public String getEncoding()
Return the character encoding set for this Validator or
iso-8859-1 if it has not been set.
public void setMaximum(int maximum)
Set the maximum bytes to be enforced by this Validator.
maximum - The new maximum valuepublic int getMaximum()
Return the maximum bytes to be enforced by this Validator or zero if it has not been
set.
public void setMessageDetailMaximum(String maximumMessageDetail)
Custom error message to be used, for creating detail part of the
FacesMessage, when users input exceeds the maximum byte length.
MAXIMUM_MESSAGE_ID
maximumMessageDetail - Custom error message.public String getMessageDetailMaximum()
Return custom detail error message that was set for creating FacesMessage,
for values that exceeds the maximum byte length.
setMessageDetailMaximum(String)public void setHintMaximum(String hintMaximum)
Custom hint message.
Overrides default hint message
hintMaximum - Custom hint message.public String getHintMaximum()
Return custom hint message.
setHintMaximum(String)
public void validate(FacesContext context,
UIComponent component,
Object value)
throws ValidatorException
Validates unless it is too long, in which case throws ValidatorException.
validate in interface ValidatorValidatorException - if validation fails
NullPointerException - if context
IllegalCharsetNameException - if encoding is
IllegalArgumentException - if value is not of type
String
unsupported
or component is nullpublic Object saveState(FacesContext context)
saveState in interface StateHolder
public void restoreState(FacesContext context,
Object state)
restoreState in interface StateHolderpublic boolean isTransient()
isTransient in interface StateHolderpublic void setTransient(boolean transientValue)
setTransient in interface StateHolder
public void setValueExpression(String name,
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 ValueExpression
NullPointerException - if name
is null
IllegalArgumentException - if name is not a valid
attribute of this converterpublic 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
ValueExpression
NullPointerException - if name
is null
IllegalArgumentException - if name is not a valid
attribute of this converter
public void setValueBinding(String name,
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 ValueBinding
NullPointerException - if name
is null
IllegalArgumentException - if name is not a valid
attribute of this validatorpublic 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
ValueBinding
NullPointerException - if name
is null
IllegalArgumentException - if name is not a valid
attribute of this validatorpublic boolean equals(Object object)
Compares this ByteLengthValidator with the specified Object for equality.
equals in class Objectobject - Object to which this ByteLengthValidator is to be compared.
public int hashCode()
Returns the hash code for this Validator.
hashCode in class Object
protected FacesMessage getLengthValidationFailureMessage(FacesContext context,
UIComponent component,
String value)
FacesMessage to be returned if byte length validation fails.
context - Faces contextvalue - The value entered / set by the user on the component
|
||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||