Package 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	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	Description
AbstractSimpleDateTimeConstraint(int flags)	Constraints a constraint.
AbstractSimpleDateTimeConstraint(int flags, String errmsg)	Constraints a constraint.
AbstractSimpleDateTimeConstraint(int flags, Pattern regex, String errmsg)	Constructs a constraint combining regular expression.
AbstractSimpleDateTimeConstraint(String constraint)	Constructs a constraint with a list of constraints separated by comma.
AbstractSimpleDateTimeConstraint(Pattern regex, String errmsg)	Constructs a regular-expression constraint.

Method Summary

Modifier and Type	Method	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, getRawValue

Methods inherited from class java.lang.Object

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

Field Details

_beg

protected T extends Comparable<? super T> _beg

_end

protected T extends Comparable<? super T> _end

_tzone

protected TimeZone _tzone

Constructor Details

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

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

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 Details

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)