org.zkoss.zul

Class SimpleDateConstraint

java.lang.Object

org.zkoss.zul.SimpleConstraint

org.zkoss.zul.AbstractSimpleDateTimeConstraint<Date>

org.zkoss.zul.SimpleDateConstraint

All Implemented Interfaces:

Serializable, ClientConstraint, Constraint

public class SimpleDateConstraint
extends AbstractSimpleDateTimeConstraint<Date>

A simple date constraint.

Since:

3.0.2

Author:

tomyeh

See Also:

Serialized Form

Field Summary

Fields inherited from class org.zkoss.zul.AbstractSimpleDateTimeConstraint

_beg, _end, _tzone

Fields inherited from class org.zkoss.zul.SimpleConstraint

_finishParseCst, _flags, AFTER_END, AFTER_POINTER, AFTER_START, AT_POINTER, BEFORE_END, BEFORE_START, END_AFTER, END_BEFORE, NO_EMPTY, NO_FUTURE, NO_NEGATIVE, NO_PAST, NO_POSITIVE, NO_TODAY, NO_ZERO, OVERLAP, OVERLAP_AFTER, OVERLAP_BEFORE, OVERLAP_END, SERVER, START_AFTER, START_BEFORE, STRICT

Constructor Summary

Constructors

Constructor and Description
SimpleDateConstraint(int flags)
SimpleDateConstraint(int flags, Date begin, Date end, String errmsg) Constructs a constraint with beginning and ending date.
SimpleDateConstraint(int flags, Pattern regex, String errmsg) Constructs a constraint combining regular expression.
SimpleDateConstraint(int flags, String errmsg) Constraints a constraint.
SimpleDateConstraint(int flags, String regex, String errmsg) Deprecated. As of release 8.0.1, replaced with SimpleDateConstraint(int, Pattern, String)
SimpleDateConstraint(Pattern regex, String errmsg) Constructs a regular-expression constraint.
SimpleDateConstraint(String constraint) Constructs a constraint with a list of constraints separated by comma.
SimpleDateConstraint(String regex, String errmsg) Deprecated. As of release 8.0.1, replaced with SimpleDateConstraint(Pattern, String)

Method Summary

Modifier and Type	Method and Description
protected void	fixConstraint()
protected Date	parseFrom(String val)
void	validate(org.zkoss.zk.ui.Component comp, Object value) Verifies whether the value is acceptable.
protected String	valueToString(org.zkoss.zk.ui.Component comp, Date value)

Methods inherited from class org.zkoss.zul.AbstractSimpleDateTimeConstraint

getBeginDate, getEndDate, parseConstraint, setTimeZone, validate0

Methods inherited from class org.zkoss.zul.SimpleConstraint

getClientConstraint, getClientPackages, getErrorMessage, getFlags, getInstance

Methods inherited from class java.lang.Object

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

Constructor Detail

SimpleDateConstraint

public SimpleDateConstraint(int flags)

SimpleDateConstraint

public SimpleDateConstraint(int flags,
                            String errmsg)

Constraints a constraint.

Parameters:

flags - a combination of SimpleConstraint.NO_POSITIVE, SimpleConstraint.NO_NEGATIVE, SimpleConstraint.NO_ZERO, and so on.

errmsg - the error message to display. Ignored if null or empty.

SimpleDateConstraint

public SimpleDateConstraint(String regex,
                            String errmsg)

Deprecated. As of release 8.0.1, replaced with SimpleDateConstraint(Pattern, String)

Constructs a regular-expression constraint.

Parameters:

regex - ignored if null or empty. Unlike constraint, the regex doesn't need to enclose with '/'.

errmsg - the error message to display. Ignored if null or empty.

SimpleDateConstraint

public SimpleDateConstraint(Pattern regex,
                            String errmsg)

Constructs a regular-expression constraint.

Parameters:

regex - ignored if null or empty

errmsg - the error message to display. Ignored if null or empty.

Since:

8.0.1

SimpleDateConstraint

public SimpleDateConstraint(int flags,
                            String regex,
                            String errmsg)

Deprecated. As of release 8.0.1, replaced with SimpleDateConstraint(int, Pattern, String)

Constructs a constraint combining regular expression.

Parameters:

flags - a combination of SimpleConstraint.NO_POSITIVE, SimpleConstraint.NO_NEGATIVE, SimpleConstraint.NO_ZERO, and so on.

regex - ignored if null or empty. Unlike constraint, the regex doesn't need to enclose with '/'.

errmsg - the error message to display. Ignored if null or empty.

SimpleDateConstraint

public SimpleDateConstraint(int flags,
                            Pattern regex,
                            String errmsg)

Constructs a constraint combining regular expression.

Parameters:

flags - a combination of SimpleConstraint.NO_POSITIVE, SimpleConstraint.NO_NEGATIVE, SimpleConstraint.NO_ZERO, and so on.

regex - ignored if null or empty

errmsg - the error message to display. Ignored if null or empty.

Since:

8.0.1

SimpleDateConstraint

public SimpleDateConstraint(int flags,
                            Date begin,
                            Date end,
                            String errmsg)

Constructs a constraint with beginning and ending date.

Parameters:

flags - a combination of SimpleConstraint.NO_POSITIVE, SimpleConstraint.NO_NEGATIVE, SimpleConstraint.NO_ZERO, and so on.

begin - the beginning date, or null if no constraint at the beginning date.

end - the ending date, or null if no constraint at the ending date.

errmsg - the error message to display. Ignored if null or empty.

SimpleDateConstraint

public SimpleDateConstraint(String constraint)

Constructs a constraint with a list of constraints separated by comma.

Parameters:

constraint - a list of constraints separated by comma. Example: "between 20071012 and 20071223", "before 20080103"

Method Detail

fixConstraint

protected void fixConstraint()

Specified by:

fixConstraint in class AbstractSimpleDateTimeConstraint<Date>

parseFrom

protected Date parseFrom(String val)
                  throws org.zkoss.zk.ui.UiException

Specified by:

parseFrom in class AbstractSimpleDateTimeConstraint<Date>

Throws:

org.zkoss.zk.ui.UiException

validate

public void validate(org.zkoss.zk.ui.Component comp,
                     Object value)
              throws org.zkoss.zk.ui.WrongValueException

Description copied from interface: Constraint

Verifies whether the value is acceptable.

Specified by:

validate in interface Constraint

Overrides:

validate in class AbstractSimpleDateTimeConstraint<Date>

Parameters:

comp - the component being validated

Throws:

org.zkoss.zk.ui.WrongValueException

valueToString

protected String valueToString(org.zkoss.zk.ui.Component comp,
                               Date value)

Specified by:

valueToString in class AbstractSimpleDateTimeConstraint<Date>