public class ParamDesc
extends java.lang.Object
implements java.io.Serializable
Modifier and Type | Field and Description |
---|---|
static int |
ADOPT_DIRECTLY |
static int |
AUTO |
static int |
CACHE_CASCADING_ALL |
static int |
CACHE_CASCADING_FALSE |
static int |
CACHE_CASCADING_NONE |
static int |
CACHE_CASCADING_TRUE |
static java.lang.String |
DATEFMT |
static int |
dateStyle
The default style of the date & time format of the Date type parameter and the DateTime type parameter.
|
static java.lang.String |
DATETIMEFMT |
Definition |
def |
static java.util.Locale |
defaultLocale
The default locale.
|
static int |
GROUPSORT
This type indicates that the current parameter is used with Dynamic Group/Sort feature.
|
static int |
IMPORT |
boolean |
isStringNull |
java.lang.String |
name
The name of a parameter.
|
static int |
NORMAL
This type indicates that the current parameter does not associate with a column list.
|
java.lang.String |
promptText
The prompt of a parameter.
|
static int |
PSEUDO
This type indicates that the current parameter is used with BindParameter feature.
|
ParameterRuntime |
rt |
static int |
SORTORDER
This type indicates that the current parameter is used with SortOrderByParameter feature.
|
java.lang.String |
stringFormat |
static int |
timeStyle |
java.lang.String |
type
The data type of a parameter.
|
static java.lang.String |
TYPE_BOOLEAN |
static java.lang.String |
TYPE_CURRENCY |
static java.lang.String |
TYPE_DATE |
static java.lang.String |
TYPE_DATETIME |
static java.lang.String |
TYPE_INTEGER
The data type constants of parameter.
|
static java.lang.String |
TYPE_NUMBER |
static java.lang.String |
TYPE_PARAMETER
The constant of a parameter's data type supports nested parameter.
|
static java.lang.String |
TYPE_PARAMETER_SEPARATOR1 |
static java.lang.String |
TYPE_PARAMETER_SEPARATOR2 |
static java.lang.String |
TYPE_STRING |
static java.lang.String |
TYPE_TIME |
static int |
USE_DEFAULT |
static int |
WARN |
Constructor and Description |
---|
ParamDesc() |
ParamDesc(java.lang.String name,
java.lang.String type,
java.lang.String prompt,
java.util.Vector vStrLimit,
java.util.Vector vStrValue,
java.lang.String strFormat,
int operator,
int index)
Creates a parameter.
|
ParamDesc(java.lang.String name,
java.lang.String type,
java.lang.String prompt,
java.util.Vector vStrLimit,
java.util.Vector vStrValue,
java.lang.String strFormat,
int operator,
int index,
boolean isMultipleValue)
Creates a parameter.
|
ParamDesc(java.lang.String strName,
java.lang.String strType,
java.lang.String prompt,
java.util.Vector vStrLimit,
java.util.Vector vStrValue,
java.lang.String strFormat,
int operator,
int intdex,
int isColumn)
Constructs a ParamDesc which will not be parsed.
|
ParamDesc(java.lang.String strName,
java.lang.String strType,
java.lang.String prompt,
java.util.Vector vStrLimit,
java.util.Vector vStrValue,
java.lang.String strFormat,
int operator,
int intdex,
int isColumn,
boolean isMultipleValue)
Constructs a ParamDesc which will not be parsed.
|
ParamDesc(java.lang.String strName,
java.lang.String strType,
java.lang.String prompt,
java.util.Vector vStrLimit,
java.util.Vector vStrValue,
java.lang.String strFormat,
int operator,
int intdex,
int isColumn,
java.lang.String column,
java.util.Vector columns,
java.util.Vector vShowValue,
java.lang.String binding)
Constructs a ParamDesc which will not be parsed.
|
ParamDesc(java.lang.String strName,
java.lang.String strType,
java.lang.String prompt,
java.util.Vector vStrLimit,
java.util.Vector vStrValue,
java.lang.String strFormat,
int operator,
int intdex,
int isColumn,
java.lang.String column,
java.util.Vector columns,
java.util.Vector vShowValue,
java.lang.String binding,
boolean isMultipleValue)
Constructs a ParamDesc which will not be parsed.
|
ParamDesc(java.lang.String strName,
java.lang.String strType,
java.lang.String prompt,
java.util.Vector vStrLimit,
java.util.Vector vStrValue,
java.lang.String strFormat,
int operator,
int intdex,
int isColumn,
java.lang.String column,
java.util.Vector columns,
java.util.Vector vShowValue,
java.lang.String binding,
boolean isDis,
boolean isReq)
Construcing column, t a ParamDesc which not be parsed.
|
ParamDesc(java.lang.String strName,
java.lang.String strType,
java.lang.String prompt,
java.util.Vector vStrLimit,
java.util.Vector vStrValue,
java.lang.String strFormat,
int operator,
int intdex,
int isColumn,
java.lang.String column,
java.util.Vector columns,
java.util.Vector vShowValue,
java.lang.String binding,
boolean isDis,
boolean isReq,
boolean isMultipleValue) |
ParamDesc(java.lang.String strName,
java.lang.String strType,
java.lang.String prompt,
java.util.Vector vStrLimit,
java.util.Vector vStrValue,
java.lang.String strFormat,
int operator,
int index,
int isColumn,
java.lang.String column,
java.util.Vector columns,
java.util.Vector vShowValue,
java.lang.String binding,
boolean isDis,
boolean isReq,
boolean isMultipleValue,
boolean isStringNull,
java.lang.String[] formatFromConnection)
Construcing column, t a ParamDesc which not be parsed.
|
ParamDesc(java.lang.String strName,
java.lang.String strType,
java.lang.String prompt,
java.util.Vector vStrLimit,
java.util.Vector vStrValue,
java.lang.String strFormat,
int operator,
int intdex,
java.lang.String binding)
Constructs a ParamDesc which will not be parsed.
|
ParamDesc(java.lang.String strName,
java.lang.String strType,
java.lang.String prompt,
java.util.Vector vStrLimit,
java.util.Vector vStrValue,
java.lang.String strFormat,
int operator,
int intdex,
java.lang.String binding,
boolean isMultipleValue)
Constructs a ParamDesc which will not be parsed.
|
Modifier and Type | Method and Description |
---|---|
void |
addReferParamToVsortParams(java.util.Hashtable allParam,
java.util.Hashtable curParamDescs,
java.util.Vector sortParam) |
boolean |
allowToShowUnencryptedValue() |
boolean |
allowUseExpression() |
static java.util.Vector |
changedHashToVector(java.util.Hashtable hash) |
static java.util.Hashtable |
changedVectorToHash(java.util.Vector v) |
void |
check(java.lang.String value,
java.util.Locale locale)
Checks the value validation.
|
void |
clearCache() |
void |
clearMem() |
void |
clearReferedBy() |
java.lang.Object |
clone()
This method is used to create source code of clone() method which does not
rely on reflection of JDK.
|
void |
copy(ParamDesc that)
Copy the current value, value list of specified (that) parameter to this parameter without
checking the value is out of range or not.
|
java.lang.String[] |
detectInvalidValues(java.lang.String[] target,
java.util.Locale locale)
Deprecated.
setValue method will do the outOfRange check, this method is useless now |
boolean |
equals(ParamDesc param)
Does not compare name.
|
java.lang.String |
format(DbValue v,
java.lang.String pattern,
java.util.Locale l,
java.util.TimeZone z)
FeatureImplement #118058 FeatureImplement_NLS enhancement
|
java.lang.String[] |
formatMultiple(fArray v,
java.lang.String pattern,
java.util.Locale l,
java.util.TimeZone z) |
static void |
getAllRelatedParamByValue(java.util.Hashtable allPara,
java.util.Vector referPara,
ParamDesc param,
java.lang.Object value)
If a parameter's type is parameters, gets all related parameters according to the value.
|
int |
getAllType() |
int |
getBeColumn() |
java.lang.String |
getBinding()
This method is associated with DynamicSortOrder feature.
|
java.lang.String[][] |
getBooleanLiteral() |
java.lang.String |
getBVName() |
int |
getCacheDataValue()
get cache data property value
|
DataResult |
getCachedDataResult(ParameterValueList pvl) |
int |
getCacheOptionValue()
get first level option value for cache cascading parameter.
|
java.lang.String |
getChainID() |
DbColDesc |
getColDesc() |
java.lang.String |
getColumn()
This method is associated with BindParameter feature.
|
java.util.Vector |
getColumns()
This method is associated with BindParameter feature.
|
java.lang.String |
getConnDataCacheKey() |
java.lang.String |
getDataSource()
Returns the data source name of
1) when this paramDesc is type in NON dynamic parameter, the return value is
the data source name in which this parameter is defined
2) bind column parameter (include cascading) and not dynamic parameter, returns the data source name of
the columns bind to this parameter
3) when this paramDesc is type is dynamic parameter, the return value is uncertain
4) when this paramDesc is type is bind column parameter (include cascading) dynamic parameter,
returns the data source name of the BV whose elements are bound to this parameter
|
java.lang.String |
getDefaultDateFormat(java.util.Locale loc)
This method can only be called when no user format is defined.
|
int |
getDefaultIndex()
Returns the index of the current value in the value list.
|
java.lang.String |
getDefaultValue()
Returns the nth item in the value list which corresponds to the current value of this parameter.
|
java.util.Vector |
getDefaultValues()
Gets all the default values' strings which do not caring format and locale.
|
Definition |
getDefinition()
returns the Definition object of the parameter
|
java.util.Vector |
getDisplayLimit(java.util.Locale locale)
Returns the limit values, caring the format.
|
java.lang.String |
getDisplayValue(DbValue paramvalue,
java.util.Locale locale)
Gets the display string based on the locale of the string saved in the catalog.
|
java.lang.String |
getDisplayValue(DbValue paramvalue,
java.util.Locale locale,
java.util.TimeZone z) |
java.util.Vector |
getDisplayValues(java.util.Locale locale)
Formats all the values in the value list.
|
java.lang.String |
getDynamicTemplate() |
DbValue |
getDynamicValue(long dynamicValue,
java.util.Locale local)
Gets a dynamic value[Date, Time, DateTime] base on a dynamic
template and input the long time, and the local.
|
static void |
getFirstLevelParam(java.util.Hashtable allPara) |
static java.util.Vector |
getFirstLevelRelatedParamByValue(java.util.Hashtable allPara,
ParamDesc param,
java.lang.Object value)
This meyhod is for server, which gets the related paramDesc according to the parameter's value, and only one level.
|
static void |
getFirstShowParamDescs(java.util.Hashtable allPara,
java.util.Vector referPara,
ParamDesc param,
java.lang.Object value)
If a parameter's type is parameters,
If this value's corresponding parameter type is parameters, gets the corresponding parameter of this parameter default value.
|
java.lang.String |
getFormat()
Returns the format.
|
java.util.Vector |
getImportParams() |
java.lang.String |
getImportSql() |
SymbolInfo |
getInfo() |
DbValue |
getInitialValue() |
java.lang.String |
getInternalValue() |
java.util.Vector |
getLimit()
Returns the limit values, not caring the format.
|
java.lang.String |
getLocalizedUserFormat(java.util.Locale locale) |
java.lang.String[] |
getMultiDisplayValue(fArray paramvalue,
java.util.Locale locale) |
java.lang.String[] |
getMultiDisplayValue(fArray paramvalue,
java.util.Locale locale,
java.util.TimeZone z) |
java.lang.String[] |
getMultiStrValue() |
java.lang.String |
getName()
Returns the parameter name.
|
java.lang.String |
getNextLevel() |
ParamDesc |
getNextLevelParamDesc() |
int |
getOperation()
Returns the operation used in the limitation.
|
java.util.Vector<ValueListItem> |
getPagedValueList(java.util.Locale l,
boolean needTranslate,
int sortType,
java.lang.String searchStr,
int pointer,
int recordNumber)
FS 191809 Performance enhancement for loading large number of parameter records
|
java.util.Vector<ValueListItem> |
getPagedValueList(java.util.Locale l,
java.util.TimeZone z,
boolean needTranslate,
int sortType,
java.lang.String searchStr,
int pointer,
int recordNumber) |
PagingParameterInfo |
getPagingParamInfo() |
java.util.Vector<ValueListItem> |
getPagingValues(PagingParameterInfo ppi) |
ParameterRuntime |
getParameterRuntime()
Returns the runtime object of the parameter.
|
java.lang.String |
getPreviousLevel() |
java.lang.String |
getPrompt()
Returns the prompt of the parameter.
|
java.lang.String |
getQueryName() |
java.util.Vector |
getReferedBy() |
static java.util.Vector |
getReferPara(java.util.Hashtable allPara)
Gets all parameters which is referenced by other parameters.
|
static void |
getRelatedParamDescsByParam(java.util.Hashtable allPara,
java.util.Vector referPara,
ParamDesc param)
If a parameter's type is Parameters, this method can be used to get all related parameter desc.
|
java.lang.String |
getSecurityEntry() |
java.util.Vector |
getSelectedValues() |
DbColDesc |
getShowColDesc() |
DbValue |
getShowValue(boolean needNLS,
java.util.Locale l)
Return the show value of current parameter value.
|
java.util.Vector |
getShowValues()
Gets the value list of a bind type parameter.
|
java.lang.String |
getStrValue() |
java.lang.String |
getType()
Gets the parameter type
|
java.util.Vector<ParamDesc> |
getUpperLevels() |
DbValue |
getValue()
Returns the current value of the parameter.
|
java.util.Vector[] |
getValueList() |
java.util.Vector<ValueListItem> |
getValueList(java.util.Locale l) |
java.util.Vector<ValueListItem> |
getValueList(java.util.Locale l,
boolean needTranslate)
For FS #118058 FeatureImplement_NLS enhancement
This method can translate each item of a parameter value list into another language.
|
java.util.Vector<ValueListItem> |
getValueList(java.util.Locale l,
boolean needTranslate,
int maxItemCnt) |
java.util.Vector<ValueListItem> |
getValueList(java.util.Locale l,
boolean needTranslate,
int maxItemCnt,
java.util.TimeZone z) |
java.util.Vector<ValueListItem> |
getValueList(java.util.Locale l,
java.util.TimeZone z) |
java.lang.String |
getValueMeaning()
Gets the current string value meaning of the parameter based on the current locale and format.
|
java.util.Vector |
getValues()
Gets all the values, not caring the format.
|
java.util.Vector |
getValues(java.util.Locale loc) |
java.util.Vector |
getValues(java.util.Locale loc,
java.util.TimeZone z)
Returns the all value list of a parameter.
|
DbValue |
getValueWithContraint()
mainly for FS165419
|
int |
getWhenOutOfRange() |
static boolean |
hasImportParam(java.util.Vector allPara)
If a parameter has import SQL and uses other parameters, returns true, else returns false.
|
boolean |
hasLimit()
For FS165419
|
static boolean |
hasNestedPara(java.util.Hashtable allPara)
This method checks whether the parameter's type is parameters or not for all parameters.
|
void |
initParam(java.util.Locale locale)
Initializes the defalut value, and parse it.
|
boolean |
isAllowAll() |
boolean |
isAllowTypeIn() |
boolean |
isAllSelected() |
boolean |
isBindColumn() |
boolean |
isCascading()
This flag must be set by calling setBeColumn(ParamDesc.CASCADING).
|
boolean |
isColumn()
Checks whether the parameter is bound with a column.
|
boolean |
isColumnCal() |
boolean |
isDistinct() |
boolean |
isDynamicParam() |
boolean |
isForAllValue() |
boolean |
isGetValueFromAPI() |
boolean |
isHideParameterWhenSingleValueReturn() |
static boolean |
isImportByPara(ParamDesc param,
ParamDesc curParam,
java.util.Vector paramDescs) |
boolean |
isMultipleValue() |
boolean |
IsParameters() |
boolean |
isReferedBy()
Checks whether this paramDesc refers to by other paramDesc no matter through
old(or new)cascading or by query.
|
boolean |
isReferOther()
Checks whether this paramDesc refers to other paramDesc no matter through
old(or new)cascading or by query.
|
boolean |
isRequired()
Whether this parameter is required or can be ignored.
|
boolean |
isSameSqlType() |
boolean |
isSameValShowColum() |
boolean |
isSetAsParameter() |
boolean |
isSimilar(ParamDesc param)
Judges whether the parameter specified is similar to this one.
|
boolean |
isTopLevel() |
boolean |
isUseCurrentDate()
If returnS true, the parameter is a dynamic date parameter.
|
boolean |
isUseCurrentDateWhenBlank()
If returns true, the parameter will return the current date when the
parameter is blank.
|
boolean |
isUsingShowValue() |
boolean |
isValuesNotEmpty() |
boolean |
needEncryptValue() |
boolean |
needLoadValueList() |
DbValue |
parseInternalValue(java.lang.String inValue)
Checks whether the internal string (saved in the catalog) is OK.
|
DbValue |
parseValue(java.lang.String val,
java.util.Locale locale,
boolean isExternal) |
DbValue |
parseValue(java.lang.String val,
java.util.Locale locale,
java.util.TimeZone z,
boolean isExternal) |
void |
resetTimeBaseLine(java.sql.Timestamp timeBaseLine) |
void |
set(DbValue v) |
void |
setAllowAll(boolean allow) |
void |
setAllowToShowUnencryptedValue(boolean allowToShowUnencryptedValue) |
void |
setAllowTypeIn(boolean allowTypeIn) |
void |
setAllowUseExpression(boolean allowUseExpression) |
void |
setAllSelected(boolean isAllSelected) |
void |
setAllType(int selectAllOption) |
void |
setBeColumn(int b) |
void |
setBinding(java.lang.String binding) |
void |
setBVName(java.lang.String bvName) |
void |
setCacheDataValue(int cdv)
set cache data property value to here
|
void |
setCachedDataResult(ParameterValueList pvl,
DataResult drst) |
void |
setCacheOptionValue(int cov)
set first level option value for cache cascading parameter.
|
void |
setCascadingInfo(java.lang.String chainID,
java.lang.String previousLevel,
java.lang.String nextLevel,
boolean isSetAsParameter) |
void |
setColumn(java.lang.String column) |
void |
setColumns(java.util.Vector v) |
void |
setConnDataCacheKey(java.lang.String cKey) |
void |
setDatamapping(java.lang.String dataMapping) |
void |
setDataMappingFile(java.lang.String dataMapping) |
void |
setDataSource(java.lang.String sourceName) |
void |
setDefaultIndex(int i)
Selects the nth value in the value list as the current value.
|
void |
setDefaultValue(int index) |
void |
setDistinct(boolean isDis) |
boolean |
setDynamicTemplate(java.lang.String dynamicTemplate)
If the set dynamicTemplate is legal, replaces previous the dynamicTemplate
with the currently set dynamicTemplate, and returns true.
|
void |
setEncoding(java.lang.String encoding) |
void |
setFormat(java.lang.String str)
Sets the format or sets the encoding of a string type parameter.
|
void |
setGetValueFromAPI(boolean b) |
void |
setHideParameterWhenSingleValueReturn(boolean isHideParameterWhenSingleValueReturn) |
void |
setImportParams(java.util.Vector importParams) |
void |
setImportSql(java.lang.String importSql) |
void |
setInformationBusManager(InformationBusManager ibm) |
void |
setInitialValue()
If the initial value is null, apply the current value to initial value.
|
void |
setInitialValue(DbValue initialVal) |
void |
setIsCascading(boolean isCascading) |
void |
setIsDynamicParam(boolean isDynamicParam) |
void |
setIsMultipleValue(boolean isMultipleValue) |
void |
setLimit(java.lang.String lim,
java.util.Locale locale,
int indexLimit)
Sets one limination value, and the indexLimit is from 0 to the vDbLimit.size() - 1.
|
void |
setLimit(java.util.Vector vStrLimit,
java.util.Locale locale)
Sets the limination, and does not recheck whether all the values in the value list are valid based on the new limination.
|
void |
setNeedEncryptValue(boolean needEncryptValue) |
void |
setNLSApplyParam(NLSApplyParam nls) |
void |
setPrompt(java.lang.String str) |
void |
setQueryName(java.lang.String queryName) |
void |
setRequired(boolean isReq) |
void |
setSecurityEntry(java.lang.String entry) |
void |
setSelectedValues(java.util.Vector selectedValues) |
void |
setShowColDesc(DbColDesc dcd) |
void |
setShowValues(java.util.Vector values) |
boolean |
setUseCurrentDate(boolean useCurrentDate)
Sets the parameter whether it is a dynamic date parameter or not.
|
boolean |
setUseCurrentDateWhenBlank(boolean useCurrentDateWhenBlank)
Sets the parameter if the parameter will return the current date when the
parameter is blank.
|
java.lang.String |
setValue(DbValue val,
java.util.Locale locale)
Sets the user input value, and returns the display value based on the locale.
|
java.lang.String[] |
setValue(fArray val,
java.util.Locale locale) |
java.lang.String[] |
setValue(java.lang.String[] inputValues,
java.util.Locale locale)
Deprecated.
Replaced by
setValue(UserInput[], Timestamp, Locale) |
java.lang.String |
setValue(java.lang.String outVal,
java.util.Locale locale)
Deprecated.
Replaced by
setValue(UserInput, Timestamp, Locale) |
void |
setValue(UserInput[] input,
java.sql.Timestamp timeBaseLine,
java.util.Locale locale) |
void |
setValue(UserInput[] input,
java.sql.Timestamp timeBaseLine,
java.util.Locale locale,
java.util.TimeZone z)
Set the user inputs to parameter when parameter is multiple value.
|
void |
setValue(UserInput input,
java.sql.Timestamp timeBaseLine,
java.util.Locale locale) |
void |
setValue(UserInput input,
java.sql.Timestamp timeBaseLine,
java.util.Locale locale,
java.util.TimeZone z)
Set the user input to parameter.
|
void |
setValueList(java.util.Vector values)
Deprecated.
|
void |
setValueList(java.util.Vector values,
java.util.Vector showValues) |
void |
setValues(java.util.Vector vStrValue,
java.util.Locale locale)
Sets(or changes) the value list of this parameter.
|
void |
setValues(java.util.Vector vStrValue,
java.util.Locale locale,
DbValue currentValue) |
void |
setWhenOutOfRange(int whenOutOfRange) |
static java.lang.String[] |
splitValue(java.lang.String value) |
java.lang.String |
toString() |
void |
transferValues(ParamDesc param) |
public static final java.lang.String TYPE_INTEGER
public static final java.lang.String TYPE_NUMBER
public static final java.lang.String TYPE_STRING
public static final java.lang.String TYPE_CURRENCY
public static final java.lang.String TYPE_BOOLEAN
public static final java.lang.String TYPE_DATE
public static final java.lang.String TYPE_TIME
public static final java.lang.String TYPE_DATETIME
public static final java.lang.String TYPE_PARAMETER
public static final java.lang.String TYPE_PARAMETER_SEPARATOR1
public static final java.lang.String TYPE_PARAMETER_SEPARATOR2
public java.lang.String type
public static final java.util.Locale defaultLocale
public static final int dateStyle
java.text.DateFormat.LONG
,
Constant Field Valuespublic static final int timeStyle
public static final java.lang.String DATETIMEFMT
public static final java.lang.String DATEFMT
public static final int NORMAL
public static final int GROUPSORT
public static final int AUTO
public static final int IMPORT
public static final int PSEUDO
public static final int SORTORDER
public java.lang.String name
public java.lang.String promptText
public boolean isStringNull
public java.lang.String stringFormat
public static final int CACHE_CASCADING_TRUE
public static final int CACHE_CASCADING_FALSE
public static final int CACHE_CASCADING_NONE
public static final int CACHE_CASCADING_ALL
public final Definition def
public final ParameterRuntime rt
public static final int ADOPT_DIRECTLY
public static final int USE_DEFAULT
public static final int WARN
public ParamDesc()
public ParamDesc(java.lang.String name, java.lang.String type, java.lang.String prompt, java.util.Vector vStrLimit, java.util.Vector vStrValue, java.lang.String strFormat, int operator, int index)
name
- The name of the parameter.type
- The type of the parameter.prompt
- The prompt string of the parameter.vStrLimit
- The value limitation vector of the parameter, not caring display format.vStrValue
- The initial value vector of the parameter, not caring display format.strFormat
- The format which is used to display the parameter's value.operator
- Now the value is jet.api.ParameterInfo.BETWEEN or jet.api.ParameterInfo.UNKNOWN.index
- The default value index in the vStrValue.public ParamDesc(java.lang.String strName, java.lang.String strType, java.lang.String prompt, java.util.Vector vStrLimit, java.util.Vector vStrValue, java.lang.String strFormat, int operator, int intdex, java.lang.String binding)
public ParamDesc(java.lang.String strName, java.lang.String strType, java.lang.String prompt, java.util.Vector vStrLimit, java.util.Vector vStrValue, java.lang.String strFormat, int operator, int intdex, int isColumn)
public ParamDesc(java.lang.String strName, java.lang.String strType, java.lang.String prompt, java.util.Vector vStrLimit, java.util.Vector vStrValue, java.lang.String strFormat, int operator, int intdex, int isColumn, java.lang.String column, java.util.Vector columns, java.util.Vector vShowValue, java.lang.String binding)
public ParamDesc(java.lang.String strName, java.lang.String strType, java.lang.String prompt, java.util.Vector vStrLimit, java.util.Vector vStrValue, java.lang.String strFormat, int operator, int intdex, int isColumn, java.lang.String column, java.util.Vector columns, java.util.Vector vShowValue, java.lang.String binding, boolean isDis, boolean isReq)
public ParamDesc(java.lang.String name, java.lang.String type, java.lang.String prompt, java.util.Vector vStrLimit, java.util.Vector vStrValue, java.lang.String strFormat, int operator, int index, boolean isMultipleValue)
name
- The name of the parameter.type
- The type of the parameter.prompt
- The prompt string of the parameter.vStrLimit
- The value limitation vector of pthe arameter, not caring display format.vStrValue
- The initial value vector of the parameter, not carinf display format.strFormat
- The format which is used to display the parameter's value.operator
- Now the value is jet.api.ParameterInfo.BETWEEN or jet.api.ParameterInfo.UNKNOWN.index
- The default value index in the vStrValue.public ParamDesc(java.lang.String strName, java.lang.String strType, java.lang.String prompt, java.util.Vector vStrLimit, java.util.Vector vStrValue, java.lang.String strFormat, int operator, int intdex, java.lang.String binding, boolean isMultipleValue)
public ParamDesc(java.lang.String strName, java.lang.String strType, java.lang.String prompt, java.util.Vector vStrLimit, java.util.Vector vStrValue, java.lang.String strFormat, int operator, int intdex, int isColumn, boolean isMultipleValue)
public ParamDesc(java.lang.String strName, java.lang.String strType, java.lang.String prompt, java.util.Vector vStrLimit, java.util.Vector vStrValue, java.lang.String strFormat, int operator, int intdex, int isColumn, java.lang.String column, java.util.Vector columns, java.util.Vector vShowValue, java.lang.String binding, boolean isMultipleValue)
public ParamDesc(java.lang.String strName, java.lang.String strType, java.lang.String prompt, java.util.Vector vStrLimit, java.util.Vector vStrValue, java.lang.String strFormat, int operator, int intdex, int isColumn, java.lang.String column, java.util.Vector columns, java.util.Vector vShowValue, java.lang.String binding, boolean isDis, boolean isReq, boolean isMultipleValue)
public ParamDesc(java.lang.String strName, java.lang.String strType, java.lang.String prompt, java.util.Vector vStrLimit, java.util.Vector vStrValue, java.lang.String strFormat, int operator, int index, int isColumn, java.lang.String column, java.util.Vector columns, java.util.Vector vShowValue, java.lang.String binding, boolean isDis, boolean isReq, boolean isMultipleValue, boolean isStringNull, java.lang.String[] formatFromConnection)
public java.lang.String getInternalValue()
public void setSecurityEntry(java.lang.String entry)
public java.lang.String getSecurityEntry()
public Definition getDefinition()
public ParameterRuntime getParameterRuntime()
public void setCacheOptionValue(int cov)
cov
- value must be among ParamDesc.CACHE_CASCADING_TRUE, ParamDesc.CACHE_CASCADING_FALSE,
ParamDesc.CACHE_CASCADING_NONE and ParamDesc.CACHE_CASCADING_ALL. It's default value is ParamDesc.CACHE_CASCADING_FALSE.public int getCacheOptionValue()
public void setCacheDataValue(int cdv)
cdv
- value must be among CACHE_CASCADING_DEFAULT,CACHE_CASCADING_TRUE and CACHE_CASCADING_FALSE in EnumerationConstant
TODOpublic int getCacheDataValue()
public java.util.Vector getDefaultValues()
public SymbolInfo getInfo()
public DbValue getValue()
public DbValue getValueWithContraint()
public int getAllType()
public void setAllType(int selectAllOption)
public java.lang.String getStrValue()
public void set(DbValue v) throws InvalidParameterException
InvalidParameterException
public java.lang.String getValueMeaning()
If no value, returns null string.
public DbColDesc getColDesc()
public void initParam(java.util.Locale locale) throws InvalidParameterException
InvalidParameterException
public void setBeColumn(int b)
public int getBeColumn()
public boolean isColumn()
public boolean isColumnCal()
public void setLimit(java.util.Vector vStrLimit, java.util.Locale locale) throws InvalidParameterException
InvalidParameterException
public void setLimit(java.lang.String lim, java.util.Locale locale, int indexLimit) throws InvalidParameterException
InvalidParameterException
public boolean hasLimit()
public java.lang.String[][] getBooleanLiteral()
public void clearMem()
public DbValue parseValue(java.lang.String val, java.util.Locale locale, java.util.TimeZone z, boolean isExternal) throws InvalidParameterException
InvalidParameterException
public DbValue parseValue(java.lang.String val, java.util.Locale locale, boolean isExternal) throws InvalidParameterException
InvalidParameterException
public java.lang.String getDefaultValue()
public java.lang.String getDisplayValue(DbValue paramvalue, java.util.Locale locale)
If no value, returns null string.
public java.lang.String getDisplayValue(DbValue paramvalue, java.util.Locale locale, java.util.TimeZone z)
public java.util.Vector getDisplayValues(java.util.Locale locale)
public boolean needLoadValueList()
public boolean isBindColumn()
public boolean isForAllValue()
public java.util.Vector getValues()
getShowValues
.
NOTE: the values are formatted by "yyyy-MM-dd HH:mm:ss.SSS" and timezone "GMT".
It's highly recommanded to call getDisplayValues(Locale) instead.After check with server, ria and designer parts which use this method, they really do not use the values return by this methods.
This method only use to drive load value list from database when it is needed.
So, we do some the following adjustment.
When bind column and display column are different, we will return display column value by string vector directly.
Otherwise, we will return string value vector which max data number is 100 for a better performance.
public java.util.Vector getValues(java.util.Locale loc, java.util.TimeZone z)
UserInput
object.
If an element is not an expression, its getUserInput()
method will
return a same string as getDisplayValue(Locale)
.
But if the loc is null, these non-expression elements will be same as getValues().loc
- public java.util.Vector getValues(java.util.Locale loc)
public boolean isValuesNotEmpty()
public java.lang.String getType()
public java.lang.String getName()
public java.lang.String getPrompt()
public java.util.Vector getLimit()
public java.util.Vector getDisplayLimit(java.util.Locale locale)
public java.lang.String getFormat()
public java.lang.String getDefaultDateFormat(java.util.Locale loc)
loc
- public int getDefaultIndex()
public int getOperation()
jet.api.ParameterInfo.#UNKNOWN
,
jet.api.ParameterInfo.#BETWEEN
public void setFormat(java.lang.String str)
public void setPrompt(java.lang.String str)
public void setValues(java.util.Vector vStrValue, java.util.Locale locale) throws InvalidParameterException
vStrValue
- The value list to be set for the parameter.
Elements are strings or UserInput
.locale
- The locale used to parse the non-expression elements.
If the locale is null, default locale is used.InvalidParameterException
public void setValues(java.util.Vector vStrValue, java.util.Locale locale, DbValue currentValue) throws InvalidParameterException
InvalidParameterException
public void setDefaultValue(int index)
public void setShowValues(java.util.Vector values)
public java.util.Vector getShowValues()
public void clearCache()
public java.lang.Object clone()
clone
in class java.lang.Object
public void setDefaultIndex(int i)
public boolean equals(ParamDesc param)
public DbValue parseInternalValue(java.lang.String inValue) throws InvalidParameterException
InvalidParameterException
public java.lang.String setValue(java.lang.String outVal, java.util.Locale locale) throws InvalidParameterException
setValue(UserInput, Timestamp, Locale)
InvalidParameterException
public java.lang.String setValue(DbValue val, java.util.Locale locale) throws InvalidParameterException
InvalidParameterException
public DbValue getShowValue(boolean needNLS, java.util.Locale l)
public void resetTimeBaseLine(java.sql.Timestamp timeBaseLine)
public void setValue(UserInput input, java.sql.Timestamp timeBaseLine, java.util.Locale locale, java.util.TimeZone z) throws InvalidParameterException
UserInput
object whose isExpression()
will indicate
it's a constant string or a expression.input
- timeBaseLine
- expressions such as currentTime() will use this value as return valuelocale
- ExecFormulaFailedException
ParseFormulaFailedException
InvalidParameterException
public void setValue(UserInput input, java.sql.Timestamp timeBaseLine, java.util.Locale locale) throws InvalidParameterException
InvalidParameterException
public void setValue(UserInput[] input, java.sql.Timestamp timeBaseLine, java.util.Locale locale, java.util.TimeZone z) throws InvalidParameterException
UserInput
object whose isExpression()
will indicate
it's a constant string or a expression.inputs
- timeBaseLine
- expressions such as currentTime() will use this value as return valuelocale
- InvalidParameterException
public void setValue(UserInput[] input, java.sql.Timestamp timeBaseLine, java.util.Locale locale) throws InvalidParameterException
InvalidParameterException
public void check(java.lang.String value, java.util.Locale locale) throws InvalidParameterException
InvalidParameterException
public boolean isSimilar(ParamDesc param)
public java.lang.String getBinding()
public void setBinding(java.lang.String binding)
public java.lang.String getColumn()
public java.util.Vector getColumns()
public void setColumn(java.lang.String column)
public void setColumns(java.util.Vector v)
public void setDistinct(boolean isDis)
public boolean isDistinct()
public void setEncoding(java.lang.String encoding)
public void setRequired(boolean isReq)
public boolean isRequired()
public void setDataSource(java.lang.String sourceName)
sourceName
- 1) the data source name where this parameter is defined in for type in NON dynamic parameter
2) the data source name of the value/show value columns which are bound to this bind column(include cascading) NON dynamic parameter
3) the data source name of the BV whose elements are bound to this bind column(include cascading) dynamic parameter
NOTE: When this parameter is a type-in dynamic parameter, the data source of it is uncertain, no one know what to set. Generally, this method won't be called
under this situation.public java.lang.String getDataSource()
public java.lang.String getImportSql()
public void setImportSql(java.lang.String importSql)
importSql
- The importSql to be set.public static void getRelatedParamDescsByParam(java.util.Hashtable allPara, java.util.Vector referPara, ParamDesc param)
referPara:
- ParamDesc collection.para:
- current parameter desc.public static java.util.Vector getFirstLevelRelatedParamByValue(java.util.Hashtable allPara, ParamDesc param, java.lang.Object value)
allPara
- param
- value
- public static void getFirstShowParamDescs(java.util.Hashtable allPara, java.util.Vector referPara, ParamDesc param, java.lang.Object value)
referPara
- : paraDesc collection.para
- : current para.public static void getFirstLevelParam(java.util.Hashtable allPara)
public static void getAllRelatedParamByValue(java.util.Hashtable allPara, java.util.Vector referPara, ParamDesc param, java.lang.Object value)
referPara
- : ParamDesc collection.param
- : current parameter.value:
- current parameter's value.public static boolean hasNestedPara(java.util.Hashtable allPara)
allPara
- public static java.util.Vector getReferPara(java.util.Hashtable allPara)
public static java.lang.String[] splitValue(java.lang.String value)
public boolean IsParameters()
public java.util.Vector getImportParams()
public void setImportParams(java.util.Vector importParams)
importParams
- The importParams to be set.public static boolean hasImportParam(java.util.Vector allPara)
allPara
- public static boolean isImportByPara(ParamDesc param, ParamDesc curParam, java.util.Vector paramDescs)
public java.util.Vector getReferedBy()
public java.util.Vector<ParamDesc> getUpperLevels()
public boolean isReferedBy()
public void clearReferedBy()
public boolean isReferOther()
public void addReferParamToVsortParams(java.util.Hashtable allParam, java.util.Hashtable curParamDescs, java.util.Vector sortParam)
public static java.util.Vector changedHashToVector(java.util.Hashtable hash)
public static java.util.Hashtable changedVectorToHash(java.util.Vector v)
public void transferValues(ParamDesc param)
public java.lang.String toString()
toString
in class java.lang.Object
public boolean isUseCurrentDate()
public boolean setUseCurrentDate(boolean useCurrentDate)
useCurrentDate.
- public boolean isUseCurrentDateWhenBlank()
public boolean setUseCurrentDateWhenBlank(boolean useCurrentDateWhenBlank)
useCurrentDateWhenBlank.
- public DbValue getDynamicValue(long dynamicValue, java.util.Locale local)
dynamicValue.
- local.
- public boolean setDynamicTemplate(java.lang.String dynamicTemplate)
dynamicTemplate.
- public java.lang.String getDynamicTemplate()
public void setHideParameterWhenSingleValueReturn(boolean isHideParameterWhenSingleValueReturn)
isHideParameterWhenSingleValueReturn
- is a boolean value.
If the parameter value is true, the parameter maybe be hidden when a single
value is returned, else doesn't hide the parameter.public boolean isHideParameterWhenSingleValueReturn()
public void setIsMultipleValue(boolean isMultipleValue)
isMultipleValue
- public boolean isMultipleValue()
public java.lang.String[] getMultiDisplayValue(fArray paramvalue, java.util.Locale locale, java.util.TimeZone z)
paramvalue
- locale
- public java.lang.String[] getMultiDisplayValue(fArray paramvalue, java.util.Locale locale)
public java.lang.String[] setValue(java.lang.String[] inputValues, java.util.Locale locale) throws InvalidParameterException
setValue(UserInput[], Timestamp, Locale)
inputValues
- locale
- InvalidParameterException
public java.lang.String[] setValue(fArray val, java.util.Locale locale) throws InvalidParameterException
val
- locale
- InvalidParameterException
public java.lang.String[] getMultiStrValue()
public void setSelectedValues(java.util.Vector selectedValues)
public java.util.Vector getSelectedValues()
public boolean isCascading()
public void setIsCascading(boolean isCascading)
public void setCascadingInfo(java.lang.String chainID, java.lang.String previousLevel, java.lang.String nextLevel, boolean isSetAsParameter)
public java.lang.String getChainID()
public java.lang.String getPreviousLevel()
public java.lang.String getNextLevel()
public ParamDesc getNextLevelParamDesc()
public boolean isSetAsParameter()
public void setAllSelected(boolean isAllSelected)
public boolean isAllSelected()
public void setAllowAll(boolean allow)
public boolean isAllowAll()
public void setAllowTypeIn(boolean allowTypeIn)
public boolean isAllowTypeIn()
public void setWhenOutOfRange(int whenOutOfRange)
public int getWhenOutOfRange()
public void setValueList(java.util.Vector values) throws InvalidParameterException
InvalidParameterException
public boolean isSameValShowColum()
public boolean isSameSqlType()
public void setValueList(java.util.Vector values, java.util.Vector showValues)
public java.lang.String[] detectInvalidValues(java.lang.String[] target, java.util.Locale locale) throws InvalidParameterException
setValue
method will do the outOfRange check, this method is useless nowInvalidParameterException
public void setAllowUseExpression(boolean allowUseExpression)
public boolean allowUseExpression()
public java.lang.String getLocalizedUserFormat(java.util.Locale locale)
public java.util.Vector[] getValueList()
public boolean isGetValueFromAPI()
public void setGetValueFromAPI(boolean b)
public void copy(ParamDesc that)
that
- public void setIsDynamicParam(boolean isDynamicParam)
public boolean isDynamicParam()
public void setBVName(java.lang.String bvName)
public java.lang.String getBVName()
public void setDataMappingFile(java.lang.String dataMapping)
public void setQueryName(java.lang.String queryName)
public java.lang.String getQueryName()
public java.lang.String format(DbValue v, java.lang.String pattern, java.util.Locale l, java.util.TimeZone z)
v
- pattern
- l
- z
- public java.lang.String[] formatMultiple(fArray v, java.lang.String pattern, java.util.Locale l, java.util.TimeZone z)
public void setNLSApplyParam(NLSApplyParam nls)
public java.util.Vector<ValueListItem> getPagingValues(PagingParameterInfo ppi)
public PagingParameterInfo getPagingParamInfo()
public java.util.Vector<ValueListItem> getValueList(java.util.Locale l, boolean needTranslate, int maxItemCnt, java.util.TimeZone z)
l
- needTranslate
- maxItemCnt
- how many values can be contained in the returned value list.
If this value is less than 0, means return total items got from DB.public java.util.Vector<ValueListItem> getValueList(java.util.Locale l, boolean needTranslate, int maxItemCnt)
public void setDatamapping(java.lang.String dataMapping)
public java.util.Vector<ValueListItem> getValueList(java.util.Locale l, boolean needTranslate)
setValues(Vector, Locale)
or similar method
3) when this parameter is created with default values defined
4) when this parameter has been inputed some value, the last inputed value maybe hold in value list of this parameter
This method does not concern about what the language source and target language is. It just calls translate tool(JFieldValueNLSManager or MetaNLSKit)
to get a translated string.l
- needTranslate
- should translate the value list item to another language or notpublic java.util.Vector<ValueListItem> getValueList(java.util.Locale l)
l
- public java.util.Vector<ValueListItem> getValueList(java.util.Locale l, java.util.TimeZone z)
public boolean needEncryptValue()
public void setNeedEncryptValue(boolean needEncryptValue)
public boolean allowToShowUnencryptedValue()
public void setAllowToShowUnencryptedValue(boolean allowToShowUnencryptedValue)
public DbValue getInitialValue()
public void setInitialValue(DbValue initialVal)
public void setInitialValue()
setInitialValue(DbValue)
or setInitialValue()
public void setShowColDesc(DbColDesc dcd)
public DbColDesc getShowColDesc()
public java.util.Vector<ValueListItem> getPagedValueList(java.util.Locale l, boolean needTranslate, int sortType, java.lang.String searchStr, int pointer, int recordNumber)
ppi
- public java.util.Vector<ValueListItem> getPagedValueList(java.util.Locale l, java.util.TimeZone z, boolean needTranslate, int sortType, java.lang.String searchStr, int pointer, int recordNumber)
public boolean isUsingShowValue()
public void setInformationBusManager(InformationBusManager ibm)
public DataResult getCachedDataResult(ParameterValueList pvl)
public void setCachedDataResult(ParameterValueList pvl, DataResult drst)
public java.lang.String getConnDataCacheKey()
public void setConnDataCacheKey(java.lang.String cKey)
public boolean isTopLevel()