Class DataSetParameter
- java.lang.Object
-
- org.eclipse.birt.report.model.core.Structure
-
- org.eclipse.birt.report.model.core.PropertyStructure
-
- org.eclipse.birt.report.model.api.elements.structures.DataSetParameter
-
- All Implemented Interfaces:
java.lang.Cloneable,IStructure,org.eclipse.birt.report.model.core.IPropertySet
- Direct Known Subclasses:
OdaDataSetParameter
public class DataSetParameter extends org.eclipse.birt.report.model.core.PropertyStructureRepresents the parameter for ODA drivers. The parameter is the part of the data set definition, if defined. A parameter can be an input or output parameter. A parameter can also be input and output parameter. Each data set parameter has the following properties:- Name
- a data set parameter has a required name.
- Position
- a data set parameter has an optional position for it.
- Data Type
- a data set parameter has a choice data type: any, integer, string, data time, decimal, float, structure or table.
- Is optional
- whether this parameter is optional.
- Allow Null
- whether the value of this parameter can be nullable.
- Is Input
- whether this parameter is an input parameter.
- Is Output
- whether this parameter is an output parameter.
-
-
Field Summary
Fields Modifier and Type Field Description static java.lang.StringALLOW_NULL_MEMBERName of the member indicating that whether the value of this parameter can benull.static java.lang.StringDATA_TYPE_MEMBERName of the parameter data type member.static java.lang.StringDEFAULT_VALUE_MEMBERName of the parameter default value member.static java.lang.StringDESCRIPTION_ID_MEMBERName of the member indicating the description id of the parameterstatic java.lang.StringDESCRIPTION_MEMBERName of the member indicating the description of the parameterstatic java.lang.StringDISPLAY_NAME_ID_MEMBERName of the member indicating the display name id of the parameterstatic java.lang.StringDISPLAY_NAME_MEMBERName of the member indicating the display name of the parameterstatic java.lang.StringHEADING_ID_MEMBERName of the member indicating the heading id of the parameterstatic java.lang.StringHEADING_MEMBERName of the member indicating the heading of the parameterstatic java.lang.StringHELP_TEXT_ID_MEMBERName of the member indicating the help text id of the parameterstatic java.lang.StringHELP_TEXT_MEMBERName of the member indicating the help text of the parameterstatic java.lang.StringIS_INPUT_MEMBERName of the member indicating that whether this is an input parameter.static java.lang.StringIS_NULLABLE_MEMBERDeprecated.static java.lang.StringIS_OPTIONAL_MEMBERName of the member indicating that whether the report must provide a value for this parameter.static java.lang.StringIS_OUTPUT_MEMBERName of the member indicating that whether this is an output parameter.static java.lang.StringNAME_MEMBERName of the parameter name member.static java.lang.StringNATIVE_DATA_TYPE_MEMBERName of the member indicating the native (database) data type code.static java.lang.StringPOSITION_MEMBERName of the position member.static java.lang.StringSTRUCT_NAMEName of this structure.
-
Constructor Summary
Constructors Constructor Description DataSetParameter()
-
Method Summary
All Methods Instance Methods Concrete Methods Deprecated Methods Modifier and Type Method Description booleanallowNull()Checks whether the value of this parameter can benull.java.lang.StringgetDataType()Returns the parameter data type.java.lang.StringgetDefaultValue()Gets the default value of the input parameter.java.lang.StringgetDescription()Gets the description of this parameter.java.lang.StringgetDescriptionKey()Gets the resource key of the description of this parameter.java.lang.StringgetDisplayName()Gets the display name of this parameter.java.lang.StringgetDisplayNameKey()Gets the resource key of the display name of this parameter.java.lang.StringgetHeading()Gets the heading of this parameter.java.lang.StringgetHeadingKey()Gets the resource key of the heading of this parameter.java.lang.StringgetHelpText()Gets the help text of this parameter.java.lang.StringgetHelpTextKey()Gets the resource key of the help text of this parameter.java.lang.StringgetName()Returns the parameter name.java.lang.IntegergetNativeDataType()Returns the native data type.java.lang.StringgetParameterDataType()Returns the data type in parameter type choices of this parameter.java.lang.IntegergetPosition()Returns the position of this parameter.java.lang.StringgetStructName()Returns the name of the structure definition.StructureHandlehandle(SimpleValueHandle valueHandle, int index)Creates the specific handle of this structure.booleanisInput()Checks whether this parameter is an input parameter.booleanisNullable()Deprecated.UseallowNull()booleanisOptional()Whether the parameter is optional.booleanisOutput()Checks whether this parameter is an output parameter.voidsetAllowNull(boolean allowNull)Sets whether the value of this parameter can benull.voidsetDataType(java.lang.String dataType)Sets the parameter data type.voidsetDefaultValue(java.lang.String expr)Sets the default value of the input parameter.voidsetDescription(java.lang.String description)Sets the description of this parameter.voidsetDescriptionKey(java.lang.String descriptionID)Sets the resource key of the description of this parameter.voidsetDisplayName(java.lang.String displayName)Sets the display name of this parameter.voidsetDisplayNameKey(java.lang.String displayNameID)Sets the resource key of the display name id of this parameter.voidsetHeading(java.lang.String heading)Sets the heading of this parameter.voidsetHeadingKey(java.lang.String headingID)Sets the resource key of the heading of this parameter.voidsetHelpText(java.lang.String helpText)Sets the help text of this parameter.voidsetHelpTextKey(java.lang.String helpTextID)Sets the resource key of the help text of this parameter.voidsetIsInput(boolean isInput)Sets whether this parameter is an input parameter.voidsetIsNullable(boolean isNullable)Deprecated.UsesetAllowNull(boolean)voidsetIsOptional(boolean value)Sets whether the parameter is optional.voidsetIsOutput(boolean isOutput)Sets whether this parameter is an output parameter.voidsetName(java.lang.String name)Sets the parameter name.voidsetNativeDataType(java.lang.Integer dataType)Sets the parameter native data type.voidsetParameterDataType(java.lang.String dataType)Sets the data type in parameter type choices to this parameter.voidsetPosition(java.lang.Integer position)Sets the position of this parameter.java.util.Listvalidate(org.eclipse.birt.report.model.core.Module module, org.eclipse.birt.report.model.core.DesignElement element)Validate whether this structure is valid.-
Methods inherited from class org.eclipse.birt.report.model.core.PropertyStructure
clone, getIntrinsicProperty, getLocalProperty, getLocalProperty, setIntrinsicProperty, setProperty
-
Methods inherited from class org.eclipse.birt.report.model.core.Structure
checkStringMember, copy, equals, getCompatibleValue, getContext, getDefn, getElement, getExpressionProperty, getHandle, getHandle, getMemberDefn, getObjectDefn, getProperty, getProperty, getReferencableProperty, getStringProperty, isDesignTime, isReferencable, setContext, setExpressionProperty, setProperty, setupContext, updateReference
-
-
-
-
Field Detail
-
STRUCT_NAME
public static final java.lang.String STRUCT_NAME
Name of this structure. Matches the definition in the meta-data dictionary.- See Also:
- Constant Field Values
-
POSITION_MEMBER
public static final java.lang.String POSITION_MEMBER
Name of the position member.- See Also:
- Constant Field Values
-
NAME_MEMBER
public static final java.lang.String NAME_MEMBER
Name of the parameter name member.- See Also:
- Constant Field Values
-
DATA_TYPE_MEMBER
public static final java.lang.String DATA_TYPE_MEMBER
Name of the parameter data type member.- See Also:
- Constant Field Values
-
IS_OPTIONAL_MEMBER
public static final java.lang.String IS_OPTIONAL_MEMBER
Name of the member indicating that whether the report must provide a value for this parameter.- See Also:
- Constant Field Values
-
DEFAULT_VALUE_MEMBER
public static final java.lang.String DEFAULT_VALUE_MEMBER
Name of the parameter default value member.- See Also:
- Constant Field Values
-
IS_NULLABLE_MEMBER
@Deprecated public static final java.lang.String IS_NULLABLE_MEMBER
Deprecated.Name of the member indicating that whether the value of this parameter can benull.- See Also:
- Constant Field Values
-
ALLOW_NULL_MEMBER
public static final java.lang.String ALLOW_NULL_MEMBER
Name of the member indicating that whether the value of this parameter can benull.- See Also:
- Constant Field Values
-
IS_INPUT_MEMBER
public static final java.lang.String IS_INPUT_MEMBER
Name of the member indicating that whether this is an input parameter.- See Also:
- Constant Field Values
-
IS_OUTPUT_MEMBER
public static final java.lang.String IS_OUTPUT_MEMBER
Name of the member indicating that whether this is an output parameter.- See Also:
- Constant Field Values
-
NATIVE_DATA_TYPE_MEMBER
public static final java.lang.String NATIVE_DATA_TYPE_MEMBER
Name of the member indicating the native (database) data type code.- See Also:
- Constant Field Values
-
DISPLAY_NAME_MEMBER
public static final java.lang.String DISPLAY_NAME_MEMBER
Name of the member indicating the display name of the parameter- See Also:
- Constant Field Values
-
DISPLAY_NAME_ID_MEMBER
public static final java.lang.String DISPLAY_NAME_ID_MEMBER
Name of the member indicating the display name id of the parameter- See Also:
- Constant Field Values
-
HEADING_MEMBER
public static final java.lang.String HEADING_MEMBER
Name of the member indicating the heading of the parameter- See Also:
- Constant Field Values
-
HEADING_ID_MEMBER
public static final java.lang.String HEADING_ID_MEMBER
Name of the member indicating the heading id of the parameter- See Also:
- Constant Field Values
-
HELP_TEXT_MEMBER
public static final java.lang.String HELP_TEXT_MEMBER
Name of the member indicating the help text of the parameter- See Also:
- Constant Field Values
-
HELP_TEXT_ID_MEMBER
public static final java.lang.String HELP_TEXT_ID_MEMBER
Name of the member indicating the help text id of the parameter- See Also:
- Constant Field Values
-
DESCRIPTION_MEMBER
public static final java.lang.String DESCRIPTION_MEMBER
Name of the member indicating the description of the parameter- See Also:
- Constant Field Values
-
DESCRIPTION_ID_MEMBER
public static final java.lang.String DESCRIPTION_ID_MEMBER
Name of the member indicating the description id of the parameter- See Also:
- Constant Field Values
-
-
Method Detail
-
getStructName
public java.lang.String getStructName()
Description copied from interface:IStructureReturns the name of the structure definition. The name is the one used to define the structure in the meta-data dictionary.- Returns:
- the internal name of the structure a defined in the meta-data dictionary.
-
isOptional
public boolean isOptional()
Whether the parameter is optional.- Returns:
- whether the parameter is optional
-
setIsOptional
public void setIsOptional(boolean value)
Sets whether the parameter is optional.- Parameters:
value- the value to set
-
setDefaultValue
public void setDefaultValue(java.lang.String expr)
Sets the default value of the input parameter.- Parameters:
expr- the default value
-
getDefaultValue
public java.lang.String getDefaultValue()
Gets the default value of the input parameter.- Returns:
- the default value
-
isInput
public boolean isInput()
Checks whether this parameter is an input parameter.- Returns:
trueif it is an input parameter. Otherwisefalse.
-
setIsInput
public void setIsInput(boolean isInput)
Sets whether this parameter is an input parameter.- Parameters:
isInput-trueif it is an input parameter. Otherwisefalse.
-
isNullable
@Deprecated public boolean isNullable()
Deprecated.UseallowNull()Checks whether the value of this parameter can benull.- Returns:
trueif the value can benull. Otherwisefalse.
-
setIsNullable
@Deprecated public void setIsNullable(boolean isNullable)
Deprecated.UsesetAllowNull(boolean)Sets whether the value of this parameter can benull.- Parameters:
isNullable-trueif the value can benull. Otherwisefalse.
-
allowNull
public boolean allowNull()
Checks whether the value of this parameter can benull.- Returns:
trueif the value can benull. Otherwisefalse.
-
setAllowNull
public void setAllowNull(boolean allowNull)
Sets whether the value of this parameter can benull.- Parameters:
allowNull-trueif the value can benull. Otherwisefalse.
-
isOutput
public boolean isOutput()
Checks whether this parameter is an output parameter.- Returns:
trueif it is an output parameter. Otherwisefalse.
-
setIsOutput
public void setIsOutput(boolean isOutput)
Sets whether this parameter is an output parameter.- Parameters:
isOutput-trueif it is an output parameter. Otherwisefalse.
-
getDataType
public java.lang.String getDataType()
Returns the parameter data type.- Returns:
- the parameter dataType
-
setDataType
public void setDataType(java.lang.String dataType)
Sets the parameter data type.- Parameters:
dataType- the data type to set
-
getName
public java.lang.String getName()
Returns the parameter name.- Returns:
- the parameter name
-
setName
public void setName(java.lang.String name)
Sets the parameter name.- Parameters:
name- the name to set
-
getPosition
public java.lang.Integer getPosition()
Returns the position of this parameter.- Returns:
- the position of this parameter
-
setPosition
public void setPosition(java.lang.Integer position)
Sets the position of this parameter.- Parameters:
position- the position to set
-
handle
public StructureHandle handle(SimpleValueHandle valueHandle, int index)
Description copied from class:org.eclipse.birt.report.model.core.StructureCreates the specific handle of this structure. This handle is always created.- Specified by:
handlein classorg.eclipse.birt.report.model.core.Structure- Parameters:
valueHandle- the value handle of this structure list property this structure is inindex- the position of this structure in structure list- Returns:
- the handle of this structure.
-
validate
public java.util.List validate(org.eclipse.birt.report.model.core.Module module, org.eclipse.birt.report.model.core.DesignElement element)Description copied from class:org.eclipse.birt.report.model.core.StructureValidate whether this structure is valid. The derived class should override this method if semantic check is needed. The each error is the instance ofPropertyValueException.- Overrides:
validatein classorg.eclipse.birt.report.model.core.Structure- Parameters:
module- the moduleelement- the element contains this structure- Returns:
- the semantic error list
-
getNativeDataType
public java.lang.Integer getNativeDataType()
Returns the native data type.- Returns:
- the parameter native data type.
-
setNativeDataType
public void setNativeDataType(java.lang.Integer dataType)
Sets the parameter native data type.- Parameters:
dataType- the native data type to set.
-
getParameterDataType
public java.lang.String getParameterDataType()
Returns the data type in parameter type choices of this parameter. The possible values are:- PARAM_TYPE_ANY
- PARAM_TYPE_INTEGER
- PARAM_TYPE_STRING
- PARAM_TYPE_DATETIME
- PARAM_TYPE_DECIMAL
- PARAM_TYPE_FLOAT
- PARAM_TYPE_BOOLEAN
- Returns:
- the data type of this parameter.
-
setParameterDataType
public void setParameterDataType(java.lang.String dataType)
Sets the data type in parameter type choices to this parameter. The allowed values are:- PARAM_TYPE_ANY
- PARAM_TYPE_INTEGER
- PARAM_TYPE_STRING
- PARAM_TYPE_DATETIME
- PARAM_TYPE_DECIMAL
- PARAM_TYPE_FLOAT
- PARAM_TYPE_BOOLEAN
- Parameters:
dataType- the data type to set- Throws:
SemanticException- if the value is not in the above list.
-
getDisplayName
public java.lang.String getDisplayName()
Gets the display name of this parameter.- Returns:
- the display name of this parameter
-
setDisplayName
public void setDisplayName(java.lang.String displayName)
Sets the display name of this parameter.- Parameters:
displayName- the new display name of this parameter
-
getDisplayNameKey
public java.lang.String getDisplayNameKey()
Gets the resource key of the display name of this parameter.- Returns:
- the resource key of the display name
-
setDisplayNameKey
public void setDisplayNameKey(java.lang.String displayNameID)
Sets the resource key of the display name id of this parameter.- Parameters:
displayNameID- the new resource key of the display name
-
getHeading
public java.lang.String getHeading()
Gets the heading of this parameter.- Returns:
- the heading of this parameter
-
setHeading
public void setHeading(java.lang.String heading)
Sets the heading of this parameter.- Parameters:
heading- the new heading of this parameter
-
getHeadingKey
public java.lang.String getHeadingKey()
Gets the resource key of the heading of this parameter.- Returns:
- the resource key of the heading
-
setHeadingKey
public void setHeadingKey(java.lang.String headingID)
Sets the resource key of the heading of this parameter.- Parameters:
headingID- the new resource key of the heading
-
getHelpText
public java.lang.String getHelpText()
Gets the help text of this parameter.- Returns:
- the help text of this parameter
-
setHelpText
public void setHelpText(java.lang.String helpText)
Sets the help text of this parameter.- Parameters:
helpText- the new help text of this parameter
-
getHelpTextKey
public java.lang.String getHelpTextKey()
Gets the resource key of the help text of this parameter.- Returns:
- the resource key of the help text
-
setHelpTextKey
public void setHelpTextKey(java.lang.String helpTextID)
Sets the resource key of the help text of this parameter.- Parameters:
helpTextID- the new resource key of the heading
-
getDescription
public java.lang.String getDescription()
Gets the description of this parameter.- Returns:
- the description of this parameter
-
setDescription
public void setDescription(java.lang.String description)
Sets the description of this parameter.- Parameters:
description- the new description of this parameter
-
getDescriptionKey
public java.lang.String getDescriptionKey()
Gets the resource key of the description of this parameter.- Returns:
- the resource key
-
setDescriptionKey
public void setDescriptionKey(java.lang.String descriptionID)
Sets the resource key of the description of this parameter.- Parameters:
descriptionID- the new resource key of the description
-
-