|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectnet.sf.jasperreports.engine.fill.JRFillDataset
public class JRFillDataset
Nested Class Summary | |
---|---|
protected static class |
JRFillDataset.VariableCalculationReq
Class used to hold expression calculation requirements. |
Field Summary | |
---|---|
protected JRCalculator |
calculator
The calculator used by the dataset. |
protected JRDataSource |
dataSource
The data source. |
protected JRFillElementDataset[] |
elementDatasets
The element datasets. |
protected JRFillField[] |
fields
The dataset fields. |
protected java.util.Map |
fieldsMap
The dataset fields indexed by name. |
protected JRFillGroup[] |
groups
The dataset groups. |
protected java.util.Locale |
locale
The Locale to be used by the dataset. |
protected JRFillElementDataset[] |
origElementDatasets
Used to save the original element datasets when filterElementDatasets is called. |
protected JRFillParameter[] |
parameters
The dataset parameter. |
protected java.util.Map |
parametersMap
The dataset parameters indexed by name. |
protected JRQuery |
query
The dataset query. |
protected int |
reportCount
The cursor used when iterating the data source. |
protected java.lang.Integer |
reportMaxCount
The value of the max count parameter. |
protected java.util.ResourceBundle |
resourceBundle
The loaded resource bundle. |
protected java.lang.String |
resourceBundleBaseName
The resource bundle base name. |
protected JRAbstractScriptlet |
scriptlet
The scriptlet used by the dataset. |
protected java.lang.String |
scriptletClassName
The scriptlet class name. |
protected java.util.TimeZone |
timeZone
The TimeZone to be used by the dataset. |
protected java.util.Set |
variableCalculationReqs
Set of VariableCalculationReq objects. |
protected JRFillVariable[] |
variables
The dataset variables. |
protected java.util.Map |
variablesMap
The dataset variables indexed by name. |
protected byte |
whenResourceMissingType
The resource missing handle type. |
Fields inherited from interface net.sf.jasperreports.engine.JRDataset |
---|
WHEN_RESOURCE_MISSING_TYPE_EMPTY, WHEN_RESOURCE_MISSING_TYPE_ERROR, WHEN_RESOURCE_MISSING_TYPE_KEY, WHEN_RESOURCE_MISSING_TYPE_NULL |
Constructor Summary | |
---|---|
protected |
JRFillDataset(JRBaseFiller filler,
JRDataset dataset,
JRFillObjectFactory factory)
Creates a fill dataset object. |
Method Summary | |
---|---|
protected void |
addVariableCalculationReq(java.lang.String variableName,
byte calculation)
Adds a variable calculation requirement. |
protected boolean |
advanceDataSource()
|
protected void |
checkVariableCalculationReqs(JRFillObjectFactory factory)
Checks if there are variable calculation requirements and creates the required variables. |
java.lang.Object |
clone()
|
protected void |
closeDatasource()
|
protected void |
createCalculator(JasperReport jasperReport)
Creates the calculator |
protected static JRCalculator |
createCalculator(JasperReport jasperReport,
JRDataset dataset)
|
protected JRAbstractScriptlet |
createScriptlet()
Creates the scriptlet. |
protected void |
filterElementDatasets(JRFillElementDataset elementDataset)
Filters the element datasets, leaving only one. |
JRField[] |
getFields()
Returns the dataset's fields. |
java.lang.Object |
getFieldValue(java.lang.String fieldName)
Returns the value of a field. |
JRExpression |
getFilterExpression()
Returns the dataset filter expression. |
JRGroup[] |
getGroups()
Returns the dataset's groups. |
java.lang.String |
getName()
Returns the dataset name. |
JRParameter[] |
getParameters()
Returns the dataset's parameters. |
java.util.Map |
getParametersMap()
|
java.lang.Object |
getParameterValue(java.lang.String parameterName)
Returns the value of a parameter. |
java.lang.Object |
getParameterValue(java.lang.String parameterName,
boolean ignoreMissing)
Returns the value of a parameter. |
JRPropertiesHolder |
getParentProperties()
Returns the parent properties holder, whose properties are used as defaults for this object. |
JRPropertiesMap |
getPropertiesMap()
Returns this object's properties map. |
JRQuery |
getQuery()
Returns the query of the dataset. |
java.lang.String |
getResourceBundle()
Returns the resource bundle base name. |
java.lang.String |
getScriptletClass()
The name of the scriptlet class to be used when iterating this dataset. |
JRSortField[] |
getSortFields()
Returns the dataset's sort fields. |
JRVariable[] |
getVariables()
Returns the dataset's variables. |
java.lang.Object |
getVariableValue(java.lang.String variableName)
Returns the value of a variable. |
byte |
getWhenResourceMissingType()
Returns the resource missing handling type. |
boolean |
hasProperties()
Checks whether the object has any properties. |
protected void |
inheritFromMain()
Inherits properties from the report. |
protected void |
initCalculator()
Initializes the calculator. |
protected void |
initDatasource()
|
protected void |
initElementDatasets(JRFillObjectFactory factory)
Initializes the element datasets. |
boolean |
isMainDataset()
Decides whether this dataset is the main report dataset or a sub dataset. |
protected java.util.ResourceBundle |
loadResourceBundle()
Loads the resource bundle corresponding to the resource bundle base name and locale. |
protected boolean |
next()
Moves to the next record in the data source. |
protected void |
reset()
|
protected void |
restoreElementDatasets()
Restores the original element datasets. |
protected void |
revertToOldValues()
|
protected void |
setCalculator(JRCalculator calculator)
|
protected void |
setConnectionParameterValue(java.util.Map parameterValues,
java.sql.Connection conn)
Sets the JDBC connection to be used. |
protected void |
setDatasourceParameterValue(java.util.Map parameterValues,
JRDataSource ds)
Sets the data source to be used. |
protected void |
setOldValues()
|
protected void |
setParameter(JRFillParameter parameter,
java.lang.Object value)
Sets the value of the parameter. |
protected void |
setParameter(java.lang.String parameterName,
java.lang.Object value)
Sets the value of a parameter. |
protected void |
setParameterValues(java.util.Map parameterValues)
Reads built-in parameter values from the value map. |
void |
setWhenResourceMissingType(byte whenResourceMissingType)
Sets the resource missing handling type. |
protected void |
start()
Starts the iteration on the data source. |
Methods inherited from class java.lang.Object |
---|
equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
---|
protected JRQuery query
protected JRFillParameter[] parameters
protected java.util.Map parametersMap
protected JRFillField[] fields
protected java.util.Map fieldsMap
protected JRFillVariable[] variables
protected java.util.Map variablesMap
protected java.util.Set variableCalculationReqs
VariableCalculationReq
objects.
protected JRFillElementDataset[] elementDatasets
protected JRFillElementDataset[] origElementDatasets
filterElementDatasets
is called.
protected JRFillGroup[] groups
protected java.lang.String resourceBundleBaseName
protected byte whenResourceMissingType
protected java.lang.String scriptletClassName
protected JRDataSource dataSource
protected java.util.Locale locale
Locale
to be used by the dataset.
protected java.util.ResourceBundle resourceBundle
protected java.util.TimeZone timeZone
TimeZone
to be used by the dataset.
protected int reportCount
protected JRCalculator calculator
protected JRAbstractScriptlet scriptlet
protected java.lang.Integer reportMaxCount
max count
parameter.
Constructor Detail |
---|
protected JRFillDataset(JRBaseFiller filler, JRDataset dataset, JRFillObjectFactory factory)
filler
- the filelrdataset
- the template datasetfactory
- the fill object factoryMethod Detail |
---|
protected void createCalculator(JasperReport jasperReport) throws JRException
jasperReport
- the report
JRException
protected void setCalculator(JRCalculator calculator)
protected static JRCalculator createCalculator(JasperReport jasperReport, JRDataset dataset) throws JRException
JRException
protected void initCalculator() throws JRException
JRException
protected void inheritFromMain()
protected JRAbstractScriptlet createScriptlet() throws JRException
JRException
protected void initElementDatasets(JRFillObjectFactory factory)
factory
- the fill object factory used by the fillerprotected void filterElementDatasets(JRFillElementDataset elementDataset)
This method is used when a dataset is instantiated by a chart or crosstab.
elementDataset
- the element dataset that should remainprotected void restoreElementDatasets()
This method should be called after filterElementDatasets
.
protected java.util.ResourceBundle loadResourceBundle()
protected void setParameterValues(java.util.Map parameterValues) throws JRException
parameterValues
- the parameter values
JRException
protected void initDatasource() throws JRException
JRException
protected void reset()
protected void setDatasourceParameterValue(java.util.Map parameterValues, JRDataSource ds)
parameterValues
- the parameter valuesds
- the data sourceprotected void setConnectionParameterValue(java.util.Map parameterValues, java.sql.Connection conn)
parameterValues
- the parameter valuesconn
- the connectionprotected void closeDatasource()
protected void start()
protected boolean next() throws JRException
true
if the data source was not exhausted
JRException
protected void setOldValues() throws JRException
JRException
protected void revertToOldValues()
protected boolean advanceDataSource() throws JRException
JRException
protected void setParameter(java.lang.String parameterName, java.lang.Object value) throws JRException
parameterName
- the parameter namevalue
- the value
JRException
protected void setParameter(JRFillParameter parameter, java.lang.Object value) throws JRException
parameter
- the parametervalue
- the value
JRException
public java.lang.Object getVariableValue(java.lang.String variableName)
variableName
- the variable name
public java.lang.Object getParameterValue(java.lang.String parameterName)
parameterName
- the parameter name
public java.lang.Object getParameterValue(java.lang.String parameterName, boolean ignoreMissing)
parameterName
- the parameter nameignoreMissing
- if set, null
will be returned for inexisting parameters
public java.lang.Object getFieldValue(java.lang.String fieldName)
fieldName
- the field name
protected void addVariableCalculationReq(java.lang.String variableName, byte calculation)
variableName
- the variable namecalculation
- the required calculationprotected void checkVariableCalculationReqs(JRFillObjectFactory factory)
factory
- the fill object factorypublic java.lang.String getName()
JRDataset
getName
in interface JRDataset
public java.lang.String getScriptletClass()
JRDataset
getScriptletClass
in interface JRDataset
public JRParameter[] getParameters()
JRDataset
getParameters
in interface JRDataset
public java.util.Map getParametersMap()
public JRQuery getQuery()
JRDataset
The query is used by passing a connection is passed to the dataset when instantiating.
getQuery
in interface JRDataset
public JRField[] getFields()
JRDataset
getFields
in interface JRDataset
public JRSortField[] getSortFields()
JRDataset
getSortFields
in interface JRDataset
public JRVariable[] getVariables()
JRDataset
getVariables
in interface JRDataset
public JRGroup[] getGroups()
JRDataset
getGroups
in interface JRDataset
public boolean isMainDataset()
JRDataset
isMainDataset
in interface JRDataset
true
iff this dataset is the main report datasetpublic java.lang.String getResourceBundle()
JRDataset
The resource bundle is used when evaluating expressions.
getResourceBundle
in interface JRDataset
public byte getWhenResourceMissingType()
JRDataset
getWhenResourceMissingType
in interface JRDataset
public void setWhenResourceMissingType(byte whenResourceMissingType)
JRDataset
setWhenResourceMissingType
in interface JRDataset
whenResourceMissingType
- the resource missing handling typepublic boolean hasProperties()
JRPropertiesHolder
hasProperties
in interface JRPropertiesHolder
public JRPropertiesMap getPropertiesMap()
JRPropertiesHolder
getPropertiesMap
in interface JRPropertiesHolder
public JRPropertiesHolder getParentProperties()
JRPropertiesHolder
getParentProperties
in interface JRPropertiesHolder
null
if no parentpublic JRExpression getFilterExpression()
JRDataset
This expression is used to filter the rows of the
data source
that this dataset will iterate on.
This expression (if not null) is evaluated immediately after a new row is
produced
by the data source.
The evaluation is performed using field and variable values corresponding to the new row.
When the result of the evaluation is Boolean.TRUE
the row gets processed by the report
filling engine.
When the result is null or Boolean.FALSE
, the current row will be skipped and the datasource will be asked for the next row.
getFilterExpression
in interface JRDataset
public java.lang.Object clone()
clone
in interface JRCloneable
clone
in class java.lang.Object
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |