|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectjcmdline.AbstractParameter
jcmdline.DateParam
A parameter that accepts a date as its value.
The format for the date is taken from the strings
ResourceBundle.
Sample Usage:
DateParam startDateParam = new DateParam("startDate", "start date of report", DateParam.REQUIRED); DateParam endDateParam = new DateParam("endDate", "end date of report", DateParam.REQUIRED); // Time for startDate will be the beginning of the day by default. // Set the time for the end of the report to be the end of the day. endDateParam.setDefaultTime(23, 59, 58, 999); CmdLineHandler cl = new DefaultCmdLineHandler( "myreport", "report of activity over days", new Parameter[] {}, new Parameter[] { startDateParam, endDateParam }); cl.parse(); // Don't need to check isSet() because params are REQUIRED Date stDate = startDateParam.getDate(); Date enDate = endDateParam.getDate(); . .
DateTimeParam
,
TimeParam
Field Summary |
Fields inherited from class jcmdline.AbstractParameter |
acceptableValues, desc, hidden, ignoreRequired, multiValued, optional, optionLabel, set, tag, values |
Fields inherited from interface jcmdline.Parameter |
HIDDEN, MULTI_VALUED, OPTIONAL, PUBLIC, REQUIRED, SINGLE_VALUED |
Constructor Summary | |
DateParam(java.lang.String tag,
java.lang.String desc)
constructor - creates single-valued, optional, public parameter |
|
DateParam(java.lang.String tag,
java.lang.String desc,
boolean optional)
constructor - creates single-valued, public parameter which will will be either optional or required, as specified. |
|
DateParam(java.lang.String tag,
java.lang.String desc,
boolean optional,
boolean multiValued)
constructor - creates a public parameter which will will be either optional or required, and/or multi-valued, as specified. |
|
DateParam(java.lang.String tag,
java.lang.String desc,
boolean optional,
boolean multiValued,
boolean hidden)
constructor - creates a parameter which will will be either optional or required, single or multi-valued, and hidden or public as specified. |
|
DateParam(java.lang.String tag,
java.lang.String desc,
java.util.Date[] acceptableValues)
constructor - creates a single-valued, optional, public, number parameter whose value must be one of the specified values. |
|
DateParam(java.lang.String tag,
java.lang.String desc,
java.util.Date[] acceptableValues,
boolean optional)
constructor - creates a single-valued, public, number parameter whose value must be one of the specified values, and which is required or optional, as specified. |
|
DateParam(java.lang.String tag,
java.lang.String desc,
java.util.Date[] acceptableValues,
boolean optional,
boolean multiValued)
constructor - creates a public number parameter whose value must be one of the specified values, and which is required or optional and/or multi-valued, as specified. |
|
DateParam(java.lang.String tag,
java.lang.String desc,
java.util.Date[] acceptableValues,
boolean optional,
boolean multiValued,
boolean hidden)
constructor - creates a Parameter, all of whose options are specified. |
Method Summary | |
java.util.Date[] |
getAcceptableDates()
Gets the acceptable values as Date objects. |
java.util.Date |
getDate()
Returns the value of this Parameter as a java.util.Date object. |
java.util.Date[] |
getDates()
Returns the values of this Parameter as java.util.Date objects. |
int[] |
getDefaultTime()
Gets default values for the time component used to generate the Date value. |
static java.lang.String |
getParseFormat()
Gets the format used to parse the date/time values. |
void |
setAcceptableDates(java.util.Collection vals)
Sets acceptable values for this Parameter from a Collection of Date objects. |
void |
setAcceptableDates(java.util.Date[] dates)
Sets the values that will be acceptable for this Parameter using Date objects. |
void |
setAcceptableValues(java.util.Collection vals)
Unsupported. |
void |
setAcceptableValues(java.lang.String[] vals)
Unsupported. |
void |
setDefaultTime(int h,
int m,
int s,
int ms)
Sets default values for the time component used to generate the Date value. |
void |
validateValue(java.lang.String val)
Verifies that value is valid for this entity - called by
add/setValue(s)(). |
Methods inherited from class jcmdline.AbstractParameter |
addValue, getAcceptableValues, getDesc, getIgnoreRequired, getOptionLabel, getTag, getValue, getValues, isHidden, isMultiValued, isOptional, isSet, setDesc, setHidden, setIgnoreRequired, setMultiValued, setOptional, setOptionLabel, setTag, setValue, setValues, setValues |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
public DateParam(java.lang.String tag, java.lang.String desc)
tag
- a unique identifier for this parameterdesc
- a description of the parameter, suitable for display
in a usage statement
java.lang.IllegalArgumentException
- if tag
or setTag()
,
setDesc()
public DateParam(java.lang.String tag, java.lang.String desc, boolean optional)
tag
- a unique identifier for this parameterdesc
- a description of the parameter, suitable for display
in a usage statementoptional
- OPTIONAL
if
optional,
REQUIRED
if required
java.lang.IllegalArgumentException
- if any of the specified
parameters are invalid.setTag()
,
setDesc()
public DateParam(java.lang.String tag, java.lang.String desc, boolean optional, boolean multiValued)
tag
- a unique identifier for this parameterdesc
- a description of the parameter, suitable for display
in a usage statementoptional
- OPTIONAL
if
optional,
REQUIRED
if requiredmultiValued
- MULTI_VALUED
if
the parameter can accept multiple values,
SINGLE_VALUED
if the parameter can contain only a single value
java.lang.IllegalArgumentException
- if any of the specified
parameters are invalid.setTag()
,
setDesc()
,
SINGLE_VALUED
,
MULTI_VALUED
public DateParam(java.lang.String tag, java.lang.String desc, boolean optional, boolean multiValued, boolean hidden)
tag
- a unique identifier for this parameterdesc
- a description of the parameter, suitable for display
in a usage statementoptional
- OPTIONAL
if
optional,
REQUIRED
if requiredmultiValued
- MULTI_VALUED
if
the parameter can accept multiple values,
SINGLE_VALUED
if the parameter can contain only a single valuehidden
- HIDDEN
if parameter is
not to be listed in the usage,
PUBLIC
otherwise.
java.lang.IllegalArgumentException
- if any of the specified
parameters are invalid.setTag()
,
setDesc()
,
SINGLE_VALUED
,
MULTI_VALUED
,
HIDDEN
,
PUBLIC
public DateParam(java.lang.String tag, java.lang.String desc, java.util.Date[] acceptableValues)
tag
- the tag associated with this parameterdesc
- a description of the parameter, suitable for display
in a usage statementacceptableValues
- the acceptable values for the parameter
java.lang.IllegalArgumentException
- if any parameter is
invalid.setTag()
,
setDesc()
,
setAcceptableDates()
public DateParam(java.lang.String tag, java.lang.String desc, java.util.Date[] acceptableValues, boolean optional)
tag
- the tag associated with this parameterdesc
- a description of the parameter, suitable for display
in a usage statementacceptableValues
- the acceptable values for the parameteroptional
- OPTIONAL
if
optional,
REQUIRED
if required
java.lang.IllegalArgumentException
- if any parameter is
invalid.setTag()
,
setDesc()
,
setAcceptableDates()
,
OPTIONAL
,
REQUIRED
public DateParam(java.lang.String tag, java.lang.String desc, java.util.Date[] acceptableValues, boolean optional, boolean multiValued)
tag
- the tag associated with this parameterdesc
- a description of the parameter, suitable for display
in a usage statementacceptableValues
- the acceptable values for the parameteroptional
- OPTIONAL
if
optional,
REQUIRED
if requiredmultiValued
- MULTI_VALUED
if
the parameter can accept multiple values,
SINGLE_VALUED
if the parameter can contain only a single value
java.lang.IllegalArgumentException
- if any parameter is
invalid.setTag()
,
setDesc()
,
setAcceptableDates()
,
OPTIONAL
,
REQUIRED
,
SINGLE_VALUED
,
MULTI_VALUED
public DateParam(java.lang.String tag, java.lang.String desc, java.util.Date[] acceptableValues, boolean optional, boolean multiValued, boolean hidden)
tag
- the tag associated with this parameterdesc
- a description of the parameter, suitable for display
in a usage statementacceptableValues
- the acceptable values for the parameteroptional
- OPTIONAL
if
optional,
REQUIRED
if requiredmultiValued
- MULTI_VALUED
if
the parameter can accept multiple values,
SINGLE_VALUED
if the parameter can contain only a single valuehidden
- HIDDEN
if parameter is
not to be listed in the usage,
PUBLIC
otherwise.
java.lang.IllegalArgumentException
- if any parameter is
invalid.setTag()
,
setDesc()
,
setAcceptableDates()
,
OPTIONAL
,
REQUIRED
,
SINGLE_VALUED
,
MULTI_VALUED
,
HIDDEN
,
PUBLIC
Method Detail |
public void validateValue(java.lang.String val) throws CmdLineException
value
is valid for this entity - called by
add/setValue(s)().
validateValue
in interface Parameter
validateValue
in class AbstractParameter
val
- the value to be validated
CmdLineException
- if value
is not valid.public java.util.Date getDate()
public java.util.Date[] getDates()
public static java.lang.String getParseFormat()
public void setAcceptableDates(java.util.Date[] dates)
dates
- an array of acceptable datespublic java.util.Date[] getAcceptableDates()
public void setAcceptableDates(java.util.Collection vals)
vals
- a Collection of java.util.Date objects representing
the acceptable values.
java.lang.ClassCastException
- if any member of vals
is not
a Date object.public void setAcceptableValues(java.util.Collection vals)
setAcceptableValues
in interface Parameter
setAcceptableValues
in class AbstractParameter
vals
- the new acceptable values
java.lang.UnsupportedOperationException
setAcceptableDates(Date[])
,
setAcceptableDates(Collection)
public void setAcceptableValues(java.lang.String[] vals)
setAcceptableValues
in interface Parameter
setAcceptableValues
in class AbstractParameter
vals
- the new acceptable values
java.lang.UnsupportedOperationException
setAcceptableDates(Date[])
,
setAcceptableDates(Collection)
public void setDefaultTime(int h, int m, int s, int ms)
h
- the hours - 0-23 - defaults to 0m
- the minutes - 0-59 - defaults to 0s
- the seconds - 0-59 - defaults to 0ms
- the milliseconds - 0-999 - defaults to 0
java.lang.IllegalArgumentException
- if any of the parameters are in
error.public int[] getDefaultTime()
int
array, where the elements are
the default hours, minutes, seconds, and milliseconds, in
that order
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |