LongRangeValidator (Java EE 5)

LongRangeValidator 是一个 Validator，它根据指定的最小值和最大值检查相应组件的值。实现以下算法：

• 如果传递的值为 null，则立即退出。
• 如果当前组件值不是浮点类型，或者是可以转换成 long 的 String，则抛出包含 TYPE_MESSAGE_ID 消息的 ValidatorException。
• 如果对此 Validator 配置了 maximum 和 minimum 属性，则根据这两个限制检查组件值。如果组件值不在此指定范围内，则抛出包含 #NOT_IN_RANGE_MESSAGE_ID 消息的 ValidatorException。
• 如果对此 Validator 配置了 maximum 属性，则根据此限制检查组件值。如果组件值大于指定的最大值，则抛出包含 MAXIMUM_MESSAGE_ID 消息的 ValidatorException。
• 如果对此 Validator 配置了 minimum 属性，则根据此限制检查组件值。如果组件值小于指定的最小值，则抛出包含 MINIMUM_MESSAGE_ID 消息的 ValidatorException。

对于所有导致抛出 ValidatorException 的上述原因，如果有些消息的参数匹配验证器参数，则这些参数的值必须使用转换器 ID javax.faces.Number 在应用程序中注册的 Converter 转换。这使值可以根据当前的 Locale 进行本地化。

LongRangeValidator is a Validator that checks the value of the corresponding component against specified minimum and maximum values. The following algorithm is implemented:

• If the passed value is null, exit immediately.
• If the current component value is not a floating point type, or a String that is convertible to long, throw a ValidatorException containing a TYPE_MESSAGE_ID message.
• If both a maximum and minimum property has been configured on this Validator, check the component value against both limits. If the component value is not within this specified range, throw a ValidatorException containing a NOT_IN_RANGE_MESSAGE_ID message.
• If a maximum property has been configured on this Validator, check the component value against this limit. If the component value is greater than the specified maximum, throw a ValidatorException containing a MAXIMUM_MESSAGE_ID message.
• If a minimum property has been configured on this Validator, check the component value against this limit. If the component value is less than the specified minimum, throw a ValidatorException containing a MINIMUM_MESSAGE_ID message.

For all of the above cases that cause a ValidatorException to be thrown, if there are parameters to the message that match up with validator parameters, the values of these parameters must be converted using the Converter registered in the application under the converter id javax.faces.Number. This allows the values to be localized according to the current Locale.

英文文档：

VALIDATOR_ID

public static final String VALIDATOR_ID

The standard converter id for this converter.

See Also:

Constant Field Values

英文文档：

MAXIMUM_MESSAGE_ID

public static final String MAXIMUM_MESSAGE_ID

The message identifier of the FacesMessage to be created if the maximum value check fails. The message format string for this message may optionally include the following placeholders:

• {0} replaced by the configured maximum value.
• {1} replaced by a String whose value is the label of the input component that produced this message.

See Also:

Constant Field Values

英文文档：

MINIMUM_MESSAGE_ID

public static final String MINIMUM_MESSAGE_ID

The message identifier of the FacesMessage to be created if the minimum value check fails. The message format string for this message may optionally include the following placeholders:

• {0} replaced by the configured minimum value.
• {1} replaced by a String whose value is the label of the input component that produced this message.

See Also:

Constant Field Values

英文文档：

NOT_IN_RANGE_MESSAGE_ID

public static final String NOT_IN_RANGE_MESSAGE_ID

The message identifier of the FacesMessage to be created if the maximum or minimum value check fails, and both the maximum and minimum values for this validator have been set. The message format string for this message may optionally include the following placeholders:

• {0} replaced by the configured minimum value.
• {1} replaced by the configured maximum value.
• {2} replaced by a String whose value is the label of the input component that produced this message.

See Also:

Constant Field Values

英文文档：

TYPE_MESSAGE_ID

public static final String TYPE_MESSAGE_ID

The message identifier of the FacesMessage to be created if the current value of this component is not of the correct type. The message format string for this message may optionally include a {0} placeholder that will be replaced by a String whose value is the label of the input component that produced this message.

See Also:

Constant Field Values

public LongRangeValidator()

构造没有预配置限制的 Validator。

英文文档：

LongRangeValidator

public LongRangeValidator()

Construct a Validator with no preconfigured limits.

public LongRangeValidator(long maximum)

构造具有指定预配置限制的 Validator。

maximum

允许的最大值

英文文档：

LongRangeValidator

public LongRangeValidator(long maximum)

Construct a Validator with the specified preconfigured limit.

Parameters:

maximum - Maximum value to allow

public LongRangeValidator(long maximum, long minimum)

构造具有指定预配置限制的 Validator。

maximum	允许的最大值
minimum	允许的最小值

英文文档：

LongRangeValidator

public LongRangeValidator(long maximum,
                          long minimum)

Construct a Validator with the specified preconfigured limits.

Parameters:

maximum - Maximum value to allow

minimum - Minimum value to allow

public long getMaximum()

返回此 Validator 强制执行的最大值。

英文文档：

getMaximum

public long getMaximum()

Return the maximum value to be enforced by this Validator.

public void setMaximum(long maximum)

设置此 Validator 强制执行的最大值。

maximum

新的最大值

英文文档：

setMaximum

public void setMaximum(long maximum)

Set the maximum value to be enforced by this Validator.

Parameters:

maximum - The new maximum value

public long getMinimum()

返回此 Validator 强制执行的最小值。

英文文档：

getMinimum

public long getMinimum()

Return the minimum value to be enforced by this Validator.

public void setMinimum(long minimum)

设置此 Validator 强制执行的最小值。

minimum

新的最小值

英文文档：

setMinimum

public void setMinimum(long minimum)

Set the minimum value to be enforced by this Validator.

Parameters:

minimum - The new minimum value

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

Throws	NullPointerException: NullPointerException 如果 context 或 component 为 null
Throws	ValidatorException: NullPointerException 如果验证失败

英文文档：

validate

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

Description copied from interface: Validator

Perform the correctness checks implemented by this Validator against the specified UIComponent. If any violations are found, a ValidatorException will be thrown containing the FacesMessage describing the failure.

Specified by:

validate in interface Validator

Parameters:

context - FacesContext for the request we are processing

component - UIComponent we are checking for correctness

value - the value to validate

Throws:

NullPointerException - if context or component is null

ValidatorException - if validation fails

public boolean equals(Object otherObj)

英文文档：

equals

public boolean equals(Object otherObj)

Overrides:

equals in class Object

public int hashCode()

英文文档：

hashCode

public int hashCode()

Overrides:

hashCode in class Object

public Object saveState(FacesContext context)

英文文档：

saveState

public Object saveState(FacesContext context)

Description copied from interface: StateHolder

Gets the state of the instance as a Serializable Object.

If the class that implements this interface has references to instances that implement StateHolder (such as a UIComponent with event handlers, validators, etc.) this method must call the StateHolder.saveState(javax.faces.context.FacesContext) method on all those instances as well. This method must not save the state of children and facets. That is done via the StateManager

This method must not alter the state of the implementing object. In other words, after executing this code:

 Object state = component.saveState(facesContext);
 

component should be the same as before executing it.

The return from this method must be Serializable

Specified by:

saveState in interface StateHolder

public void restoreState(FacesContext context,
                         Object state)

public boolean isTransient()

public void setTransient(boolean transientValue)