Class AbstractScalarParameterHandleImpl
- java.lang.Object
-
- org.eclipse.birt.report.model.api.DesignElementHandle
-
- org.eclipse.birt.report.model.api.ReportElementHandle
-
- org.eclipse.birt.report.model.api.ParameterHandle
-
- org.eclipse.birt.report.model.api.AbstractScalarParameterHandleImpl
-
- All Implemented Interfaces:
org.eclipse.birt.report.model.elements.interfaces.IAbstractScalarParameterModel
,org.eclipse.birt.report.model.elements.interfaces.IDesignElementModel
,org.eclipse.birt.report.model.elements.interfaces.IInternalAbstractScalarParameterModel
,org.eclipse.birt.report.model.elements.interfaces.IParameterModel
- Direct Known Subclasses:
AbstractScalarParameterHandle
public abstract class AbstractScalarParameterHandleImpl extends ParameterHandle implements org.eclipse.birt.report.model.elements.interfaces.IAbstractScalarParameterModel
Represents the abstract scalar parameter types.- See Also:
AbstractScalarParameter
-
-
Field Summary
-
Fields inherited from class org.eclipse.birt.report.model.api.ReportElementHandle
element
-
Fields inherited from class org.eclipse.birt.report.model.api.DesignElementHandle
module
-
Fields inherited from interface org.eclipse.birt.report.model.elements.interfaces.IDesignElementModel
COMMENTS_PROP, CUSTOM_XML_PROP, DISPLAY_NAME_ID_PROP, DISPLAY_NAME_PROP, EVENT_HANDLER_CLASS_PROP, EXTENDS_PROP, FULL_LABEL, ID_SUFFIX, NAME_PROP, NEW_HANDLER_ON_EACH_EVENT_PROP, NO_SLOT, PROPERTY_MASKS_PROP, REF_TEMPLATE_PARAMETER_PROP, SHORT_LABEL, USER_LABEL, USER_PROPERTIES_PROP, VIEW_ACTION_PROP
-
Fields inherited from interface org.eclipse.birt.report.model.elements.interfaces.IInternalAbstractScalarParameterModel
CONTROL_TYPE_PROP, DATA_TYPE_PROP, DATASET_NAME_PROP, DEFAULT_VALUE_PROP, DISTINCT_PROP, IS_REQUIRED_PROP, LABEL_EXPR_PROP, LIST_LIMIT_PROP, SELECTION_LIST_PROP, SORT_BY_COLUMN_PROP, SORT_BY_PROP, SORT_DIRECTION_PROP, VALUE_EXPR_PROP, VALUE_TYPE_PROP
-
-
Constructor Summary
Constructors Constructor Description AbstractScalarParameterHandleImpl(org.eclipse.birt.report.model.core.Module module, org.eclipse.birt.report.model.core.DesignElement element)
Constructor.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description java.util.Iterator
choiceIterator()
Returns the iterator for the static selection list defined on this scalar parameter.boolean
distinct()
Checks whether duplicate values should be shown when preview.DataSetHandle
getDataSet()
Returns the handle for the data set defined on the parameter.java.lang.String
getDataSetName()
Returns the data set name of the dynamic list for this parameter.java.lang.String
getDataType()
Returns the data type for this parameter.java.util.List
getDefaultValueList()
Returns the default value list of the parameter.java.lang.String
getLabelExpr()
Returns an expression on the data row from the dynamic list data set that returns the prompt for the choice.int
getListlimit()
get the list limited number.java.lang.String
getSortBy()
Gets the sort key for parameter values when preview.java.lang.String
getSortByColumn()
Gets the expression by which the result sorts.java.lang.String
getSortDirection()
Gets the sort order for parameter values when preview.java.lang.String
getValueExpr()
Returns an expression on the data row from the dynamic list data set that returns the value for the choice.java.lang.String
getValueType()
Returns the parameter type for this scalar parameter.boolean
isRequired()
Tests whether the string value of the parameter is required.void
setDataSet(DataSetHandle handle)
Sets the data set of the report item.void
setDataSetName(java.lang.String dataSetName)
Sets the data set name of the dynamic list for this parameter.void
setDataType(java.lang.String type)
Sets the data type for this parameter.void
setDefaultValueList(java.util.List<? extends java.lang.Object> defaultValueList)
Sets the default value list of the parameter.void
setDistinct(boolean distinct)
Sets the flag that indicates whether duplicate values should be shown when preview.void
setIsRequired(boolean isRequired)
Sets the flag that indicates whether the value of the parameter is required.void
setLabelExpr(java.lang.String labelExpr)
Sets an expression on the data row from the dynamic list data set that returns the prompt for the choice.void
setListlimit(int listLimit)
Set the value for the list limitation number.void
setSortBy(java.lang.String sortValue)
Sets the sort key for parameter values when preview.void
setSortByColumn(java.lang.String sortByColumn)
Sets the expression by which the result sorts.void
setSortDirection(java.lang.String direction)
Sets the sort order for parameter values when preview.void
setValueExpr(java.lang.String valueExpr)
Sets an expression on the data row from the dynamic list data set that returns the value for the choice.void
setValueType(java.lang.String type)
Sets the parameter value type for this scalar parameter.-
Methods inherited from class org.eclipse.birt.report.model.api.ParameterHandle
getDisplayPromptText, getHelpText, getHelpTextKey, getPromptText, getPromptTextID, getValidate, isHidden, setHelpText, setHelpTextKey, setHidden, setPromptText, setPromptTextID, setValidate
-
Methods inherited from class org.eclipse.birt.report.model.api.ReportElementHandle
getComments, getCustomXml, getDisplayName, getDisplayNameKey, getElement, getPropertyMask, isValidLayoutForCompoundElement, isValidReferenceForCompoundElement, propertyMaskIterator, setComments, setCustomXml, setDisplayName, setDisplayNameKey, setPropertyMask
-
Methods inherited from class org.eclipse.birt.report.model.api.DesignElementHandle
add, add, addElement, addElement, addListener, addUserPropertyDefn, cachePropertyHandles, canContain, canContain, canContain, canContain, canDrop, canEdit, canTransformToTemplate, clearAllProperties, clearContents, clearProperty, clientsIterator, copy, copyPropertyTo, createTemplateElement, derivedIterator, doSort, drop, drop, drop, dropAndClear, dropAndClear, dropAndClear, dropUserPropertyDefn, findContentSlot, getBooleanProperty, getChoices, getColorProperty, getContainer, getContainerPropertyHandle, getContainerSlotHandle, getContent, getContentCount, getContents, getDefn, getDesign, getDesignHandle, getDimensionProperty, getDisplayLabel, getDisplayLabel, getDisplayProperty, getEffectiveModule, getElementFactory, getElementProperty, getEventHandlerClass, getExpressionProperty, getExtends, getExternalizedValue, getExternalizedValue, getExternalizedValue, getFactoryElementHandle, getFactoryPropertyHandle, getFloatProperty, getFontProperty, getFullName, getHostViewHandle, getID, getIndex, getIntProperty, getListProperty, getListProperty, getMethods, getModule, getModuleHandle, getName, getNumberProperty, getPrivateStyle, getProperty, getPropertyBinding, getPropertyBindingExpression, getPropertyBindings, getPropertyDefn, getPropertyHandle, getPropertyIterator, getQualifiedName, getRoot, getSemanticErrors, getSlot, getStringProperty, getStyle, getUserProperties, getUserPropertyDefnHandle, getXPath, hasLocalProperties, hasSemanticError, initializeSlotHandles, isDirectionRTL, isInTemplateParameter, isTemplateParameterValue, isValid, localize, move, move, moveTo, moveTo, moveTo, moveTo, newHandlerOnEachEvent, paste, paste, paste, paste, removeListener, revertToReportItem, revertToTemplate, semanticCheck, setBooleanProperty, setEncryption, setEventHandlerClass, setExpressionProperty, setExtends, setExtendsElement, setExtendsName, setFloatProperty, setIntProperty, setName, setNewHandlerOnEachEvent, setNumberProperty, setProperties, setProperty, setPropertyBinding, setPropertyBinding, setStringProperty, setStyle, setStyleElement, setStyleName, setValid, shift, showError, slotsIterator
-
-
-
-
Method Detail
-
setIsRequired
public void setIsRequired(boolean isRequired) throws SemanticException
Sets the flag that indicates whether the value of the parameter is required. For string type parameter, if the value is required, it cannot benull
or empty. For other type parameters, required value cannot benull
.- Parameters:
isRequired
-true
if the value is required. Otherwisefalse
.- Throws:
SemanticException
- if the property is locked.
-
isRequired
public boolean isRequired()
Tests whether the string value of the parameter is required. For string type parameter, if the value is required, it cannot benull
or empty. For other type parameters, required value cannot benull
.- Returns:
true
if the value is required. Otherwisefalse
.
-
setSortByColumn
public void setSortByColumn(java.lang.String sortByColumn) throws SemanticException
Sets the expression by which the result sorts.- Parameters:
sortByColumn
- expression by which the result sorts- Throws:
SemanticException
-
getSortByColumn
public java.lang.String getSortByColumn()
Gets the expression by which the result sorts.- Returns:
- the expression by which the result sorts
-
setSortDirection
public void setSortDirection(java.lang.String direction) throws SemanticException
Sets the sort order for parameter values when preview. The input argument can be- DesignChoiceConstants.SORT_DIRECTION_ASC
- DesignChoiceConstants.SORT_DIRECTION_DESC
null
- Parameters:
direction
-- Throws:
SemanticException
- if the property is locked.
-
getSortDirection
public java.lang.String getSortDirection()
Gets the sort order for parameter values when preview. The return value can be- DesignChoiceConstants.SORT_DIRECTION_ASC
- DesignChoiceConstants.SORT_DIRECTION_DESC
null
- Returns:
- the sort order for parameter values
-
setSortBy
public void setSortBy(java.lang.String sortValue) throws SemanticException
Sets the sort key for parameter values when preview. The input argument can be- DesignChoiceConstants.PARAM_SORT_VALUES_VALUE
- DesignChoiceConstants.PARAM_SORT_VALUES_LABEL
- Parameters:
sortValue
-- Throws:
SemanticException
- if the property is locked.
-
getSortBy
public java.lang.String getSortBy()
Gets the sort key for parameter values when preview. The return value can be- DesignChoiceConstants.PARAM_SORT_VALUES_VALUE
- DesignChoiceConstants.PARAM_SORT_VALUES_LABEL
- Returns:
- the sort key for parameter values
-
getValueType
public java.lang.String getValueType()
Returns the parameter type for this scalar parameter. Types are defined inDesignChoiceConstants
can be one of the followings:PARAM_VALUE_TYPE_STATIC
PARAM_VALUE_TYPE_DYNAMIC
- Returns:
- the type for the scalar parameter
- See Also:
setValueType(String)
,DesignChoiceConstants
-
setValueType
public void setValueType(java.lang.String type) throws SemanticException
Sets the parameter value type for this scalar parameter. Types are defined inDesignChoiceConstants
can be one of the followings:PARAM_TYPE_STATIC
PARAM_TYPE_DYNAMIC
- Parameters:
type
- the type for the scalar parameter- Throws:
SemanticException
- if the input type is not one of above choices.- See Also:
getValueType()
,DesignChoiceConstants
-
setListlimit
public void setListlimit(int listLimit) throws SemanticException
Set the value for the list limitation number. This property is used to limit the parameter display list.- Parameters:
listLimit
- The limited number.- Throws:
SemanticException
-
getListlimit
public int getListlimit()
get the list limited number.- Returns:
- the display prompt.
-
getValueExpr
public java.lang.String getValueExpr()
Returns an expression on the data row from the dynamic list data set that returns the value for the choice.- Returns:
- the expression that returns the parameter value for each row in the dynamic list.
-
setValueExpr
public void setValueExpr(java.lang.String valueExpr) throws SemanticException
Sets an expression on the data row from the dynamic list data set that returns the value for the choice.- Parameters:
valueExpr
- the expression that returns the parameter value for each row in the dynamic list.- Throws:
SemanticException
- if the property is locked.
-
getLabelExpr
public java.lang.String getLabelExpr()
Returns an expression on the data row from the dynamic list data set that returns the prompt for the choice.- Returns:
- an expression that returns the display value for each row in the dynamic list.
-
setLabelExpr
public void setLabelExpr(java.lang.String labelExpr) throws SemanticException
Sets an expression on the data row from the dynamic list data set that returns the prompt for the choice.- Parameters:
labelExpr
- an expression that returns the display value for each row in the dynamic list.- Throws:
SemanticException
- if the property is locked.
-
setDataSetName
public void setDataSetName(java.lang.String dataSetName) throws SemanticException
Sets the data set name of the dynamic list for this parameter.- Parameters:
dataSetName
- the data set name of the dynamic list- Throws:
SemanticException
- if the property is locked.
-
setDataSet
public void setDataSet(DataSetHandle handle) throws SemanticException
Sets the data set of the report item.- Parameters:
handle
- the handle of the data set, ifhandle
is null, data set property will be cleared.- Throws:
SemanticException
- if the property is locked.
-
choiceIterator
public java.util.Iterator choiceIterator()
Returns the iterator for the static selection list defined on this scalar parameter. Each element in the iterator is the an instance ofSelectionChoiceHandle
.- Returns:
- the iterator for selection list defined on this scalar parameter.
- See Also:
SelectionChoice
-
getDataSetName
public java.lang.String getDataSetName()
Returns the data set name of the dynamic list for this parameter.- Returns:
- the data set name of the dynamic list
-
getDataSet
public DataSetHandle getDataSet()
Returns the handle for the data set defined on the parameter. If the parameter do not define the data set name or if the data set is not defined in the design/library scope, returnnull
.- Returns:
- the handle to the data set
-
setDefaultValueList
public void setDefaultValueList(java.util.List<? extends java.lang.Object> defaultValueList) throws SemanticException
Sets the default value list of the parameter. Each item in the list can be an expression, but cannot reference any other parameters.- Parameters:
defaultValueList
- the default value for the parameter- Throws:
SemanticException
- if the property is locked.
-
getDefaultValueList
public java.util.List getDefaultValueList()
Returns the default value list of the parameter. Each item in this list can be an expression, but cannot reference any other parameters.- Returns:
- the default value
-
getDataType
public java.lang.String getDataType()
Returns the data type for this parameter. The data type controls how the requester formats, parses and validates the parameter. Types are defined inDesignChoiceConstants
can be one of the followings:PARAM_TYPE_STRING
PARAM_TYPE_FLOAT
PARAM_TYPE_DECIMAL
PARAM_TYPE_INTEGER
PARAM_TYPE_DATETIME
PARAM_TYPE_DATE
PARAM_TYPE_TIME
PARAM_TYPE_BOOLEAN
- Returns:
- the type for the parameter
- See Also:
setDataType(String)
,DesignChoiceConstants
-
setDataType
public void setDataType(java.lang.String type) throws SemanticException
Sets the data type for this parameter. The data type controls how the Requester formats, parses and validates the parameter. Types are defined inDesignChoiceConstants
can be one of the followings:PARAM_TYPE_STRING
PARAM_TYPE_FLOAT
PARAM_TYPE_DECIMAL
PARAM_TYPE_INTEGER
PARAM_TYPE_DATETIME
PARAM_TYPE_DATE
PARAM_TYPE_TIME
PARAM_TYPE_BOOLEAN
- Parameters:
type
- the type for the parameter- Throws:
SemanticException
- if the input type is not one of above choices.- See Also:
getDataType()
,DesignChoiceConstants
-
setDistinct
public void setDistinct(boolean distinct) throws SemanticException
Sets the flag that indicates whether duplicate values should be shown when preview.- Parameters:
distinct
-true
if duplicate values only show once. Otherwisefalse
.- Throws:
SemanticException
- if the property is locked.
-
distinct
public boolean distinct()
Checks whether duplicate values should be shown when preview.- Returns:
true
if duplicate values only show once. Otherwisefalse
.
-
-