|
||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
java.lang.Objectjcmdline.AbstractParameter
jcmdline.DateParam
public class 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 ParametervalidateValue in class AbstractParametervalue - 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 ParametersetAcceptableValues in class AbstractParametervals - the new acceptable values
java.lang.UnsupportedOperationExceptionsetAcceptableDates(Date[]),
setAcceptableDates(Collection)public void setAcceptableValues(java.lang.String[] vals)
setAcceptableValues in interface ParametersetAcceptableValues in class AbstractParametervals - the new acceptable values
java.lang.UnsupportedOperationExceptionsetAcceptableDates(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 | |||||||||