org.zkoss.zul

Class AbstractSimpleDateTimeConstraint<T extends Comparable<? super T>>

java.lang.Object

org.zkoss.zul.SimpleConstraint

org.zkoss.zul.AbstractSimpleDateTimeConstraint<T>

All Implemented Interfaces:

Serializable, ClientConstraint, Constraint

Direct Known Subclasses:

SimpleDateConstraint, SimpleLocalDateConstraint, SimpleLocalTimeConstraint

public abstract class AbstractSimpleDateTimeConstraint<T extends Comparable<? super T>>
extends SimpleConstraint

A skeleton of simple date/time constraint.

Since:

9.0.0

Author:

rudyhuang

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
protected T	_beg
protected T	_end
protected TimeZone	_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
AbstractSimpleDateTimeConstraint(int flags) Constraints a constraint.
AbstractSimpleDateTimeConstraint(int flags, Pattern regex, String errmsg) Constructs a constraint combining regular expression.
AbstractSimpleDateTimeConstraint(int flags, String errmsg) Constraints a constraint.
AbstractSimpleDateTimeConstraint(int flags, String regex, String errmsg) Deprecated. As of release 8.0.1, replaced with AbstractSimpleDateTimeConstraint(int, Pattern, String)
AbstractSimpleDateTimeConstraint(Pattern regex, String errmsg) Constructs a regular-expression constraint.
AbstractSimpleDateTimeConstraint(String constraint) Constructs a constraint with a list of constraints separated by comma.
AbstractSimpleDateTimeConstraint(String regex, String errmsg) Deprecated. As of release 8.0.1, replaced with AbstractSimpleDateTimeConstraint(int, Pattern, String)

Method Summary

Modifier and Type	Method and Description
protected abstract void	fixConstraint()
T	getBeginDate() Returns the beginning date, or null if there is no constraint of the beginning date.
T	getEndDate() Returns the ending date, or null if there is no constraint of the ending date.
protected int	parseConstraint(String constraint) Parses a constraint into an integer value.
protected abstract T	parseFrom(String val)
void	setTimeZone(TimeZone tzone) Sets time zone that this date constraint belongs to
void	validate(org.zkoss.zk.ui.Component comp, Object value) Verifies whether the value is acceptable.
protected void	validate0(org.zkoss.zk.ui.Component comp, T value)
protected abstract String	valueToString(org.zkoss.zk.ui.Component comp, T value)

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

Field Detail

_beg

protected T extends Comparable<? super T> _beg

_end

protected T extends Comparable<? super T> _end

_tzone

protected TimeZone _tzone

Constructor Detail

AbstractSimpleDateTimeConstraint

public AbstractSimpleDateTimeConstraint(int flags)

Constraints a constraint.

Parameters:

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

AbstractSimpleDateTimeConstraint

public AbstractSimpleDateTimeConstraint(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.

AbstractSimpleDateTimeConstraint

@Deprecated
public AbstractSimpleDateTimeConstraint(String regex,
                                                    String errmsg)

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

Constructs a constraint combining regular expression.

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.

AbstractSimpleDateTimeConstraint

public AbstractSimpleDateTimeConstraint(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.

AbstractSimpleDateTimeConstraint

@Deprecated
public AbstractSimpleDateTimeConstraint(int flags,
                                                    String regex,
                                                    String errmsg)

Deprecated. As of release 8.0.1, replaced with AbstractSimpleDateTimeConstraint(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.

AbstractSimpleDateTimeConstraint

public AbstractSimpleDateTimeConstraint(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.

AbstractSimpleDateTimeConstraint

public AbstractSimpleDateTimeConstraint(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 abstract void fixConstraint()

getBeginDate

public T getBeginDate()

Returns the beginning date, or null if there is no constraint of the beginning date.

getEndDate

public T getEndDate()

Returns the ending date, or null if there is no constraint of the ending date.

setTimeZone

public void setTimeZone(TimeZone tzone)

Sets time zone that this date constraint belongs to

parseConstraint

protected int parseConstraint(String constraint)
                       throws org.zkoss.zk.ui.UiException

Description copied from class: SimpleConstraint

Parses a constraint into an integer value. For example, "no positive" is parsed to SimpleConstraint.NO_POSITIVE.

Deriving classes might override this to provide more constraints.

Overrides:

parseConstraint in class SimpleConstraint

Throws:

org.zkoss.zk.ui.UiException

parseFrom

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

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 SimpleConstraint

Parameters:

comp - the component being validated

Throws:

org.zkoss.zk.ui.WrongValueException

validate0

protected void validate0(org.zkoss.zk.ui.Component comp,
                         T value)
                  throws org.zkoss.zk.ui.WrongValueException

Throws:

org.zkoss.zk.ui.WrongValueException

valueToString

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