JasperDesign (JasperReports 6.2.1 API)

java.lang.Object
- net.sf.jasperreports.engine.base.JRBaseReport
- - net.sf.jasperreports.engine.design.JasperDesign

All Implemented Interfaces:

Serializable, JRChangeEventsSupport, JRDefaultStyleProvider, JRIdentifiable, JRPropertiesHolder, JRReport
```
public class JasperDesign
extends JRBaseReport
```
JasperDesign is used for in-memory representation of a report design.
The class contains all report properties and report elements inherited from the JRReport interface in their design time state.
All its instances are subject to compilation before being used for filling and report generation. These instances are the raw material that the JasperReports library uses to generate reports. Such instances are usually obtained:
- by parsing the JRXML report template files using the library's internal XML-parsing utility classes.
- by applications that use JasperReports through API calls if working with JRXML files is not an option.
The first option for creating report designs relies on editing the JRXML files and using them with the JasperCompileManager in order to prepare them for filling with data. Because they are well structured and are validated against a public XSD when parsed, these files can be easily edited using simple editors or specialized XML editors.
The second option is recommended only in case the parent application that uses JasperReports inside the reporting module needs to create report templates at runtime. In most cases this is not needed because the report templates do not need to change with every report execution, and hence static report templates could be used. Only the data used to fill these static report templates is dynamic.
However, there are cases when the actual report template is the result of some user input. The parent application might supply its users with a set of options when launching the reports that might take the form of some simplified report designer or wizard. In such cases, the actual report layout is not known or is not complete at design time, and can only be put together after the user's input is received.
The most common use case scenario that requires dynamically built or ad hoc report templates (as we call them) is one in which the columns that are going to be present in a table-like report layout are not known at design time. Instead, the user will give the number of columns and their order inside the desired report at runtime.
Developers have to make sure that the applications they create really need ad hoc reports and cannot rely solely on static report templates. Since dynamically built report templates have to be compiled on the fly at runtime, they can result in a certain loss of performance.
Author:

Teodor Danciu (teodord@users.sourceforge.net)

See Also:
JRReport, JRBaseReport, JRXmlLoader, Serialized Form

Field Summary

Fields
Modifier and Type	Field and Description
`static String`	`EXCEPTION_MESSAGE_KEY_DUPLICATE_DATASET`
`static String`	`EXCEPTION_MESSAGE_KEY_DUPLICATE_REPORT_STYLE`
`static String`	`PROPERTY_BACKGROUND`
`static String`	`PROPERTY_BOTTOM_MARGIN`
`static String`	`PROPERTY_COLUMN_COUNT`
`static String`	`PROPERTY_COLUMN_DIRECTION`
`static String`	`PROPERTY_COLUMN_FOOTER`
`static String`	`PROPERTY_COLUMN_HEADER`
`static String`	`PROPERTY_COLUMN_SPACING`
`static String`	`PROPERTY_COLUMN_WIDTH`
`static String`	`PROPERTY_DATASETS`
`static String`	`PROPERTY_DEFAULT_FONT`
`static String`	`PROPERTY_DEFAULT_STLYE`
`static String`	`PROPERTY_DETAIL`
`static String`	`PROPERTY_FLOAT_COLUMN_FOOTER`
`static String`	`PROPERTY_FONTS`
`static String`	`PROPERTY_FORMAT_FACTORY_CLASS`
`static String`	`PROPERTY_IGNORE_PAGINATION`
`static String`	`PROPERTY_IMPORTS`
`static String`	`PROPERTY_LANGUAGE`
`static String`	`PROPERTY_LAST_PAGE_FOOTER`
`static String`	`PROPERTY_LEFT_MARGIN`
`static String`	`PROPERTY_MAIN_DATASET`
`static String`	`PROPERTY_NAME`
`static String`	`PROPERTY_NO_DATA`
`static String`	`PROPERTY_ORIENTATION`
`static String`	`PROPERTY_PAGE_FOOTER`
`static String`	`PROPERTY_PAGE_HEADER`
`static String`	`PROPERTY_PAGE_HEIGHT`
`static String`	`PROPERTY_PAGE_WIDTH`
`static String`	`PROPERTY_PRINT_ORDER`
`static String`	`PROPERTY_RIGHT_MARGIN`
`static String`	`PROPERTY_STYLES`
`static String`	`PROPERTY_SUMMARY`
`static String`	`PROPERTY_SUMMARY_NEW_PAGE`
`static String`	`PROPERTY_SUMMARY_WITH_PAGE_HEADER_AND_FOOTER`
`static String`	`PROPERTY_TEMPLATES`
`static String`	`PROPERTY_TITLE`
`static String`	`PROPERTY_TITLE_NEW_PAGE`
`static String`	`PROPERTY_TOP_MARGIN`

Fields inherited from class net.sf.jasperreports.engine.base.JRBaseReport
background, bottomMargin, columnCount, columnDirection, columnFooter, columnHeader, columnSpacing, columnWidth, datasets, defaultStyle, detailSection, formatFactoryClass, ignorePagination, importsSet, isFloatColumnFooter, isSummaryNewPage, isSummaryWithPageHeaderAndFooter, isTitleNewPage, language, lastPageFooter, leftMargin, mainDataset, name, noData, orientationValue, pageFooter, pageHeader, pageHeight, pageWidth, printOrderValue, PROPERTY_SECTION_TYPE, PROPERTY_WHEN_NO_DATA_TYPE, rightMargin, sectionType, styles, summary, templates, title, topMargin, whenNoDataTypeValue

Fields inherited from interface net.sf.jasperreports.engine.JRReport
LANGUAGE_GROOVY, LANGUAGE_JAVA

Constructor Summary

Constructors
Constructor and Description
`JasperDesign()` Constructs a JasperDesign object and fills it with the default variables and parameters.
`JasperDesign(JasperReportsContext context)`

Method Summary

Methods
Modifier and Type	Method and Description
`void`	`addDataset(int index, JRDesignDataset dataset)` Inserts a sub dataset at specified position into the report.
`void`	`addDataset(JRDesignDataset dataset)` Adds a sub dataset to the report.
`void`	`addField(JRField field)`
`void`	`addGroup(JRDesignGroup group)` Gets a map of report groups.
`void`	`addImport(String value)` Adds an import (needed if report expression require additional classes in order to compile).
`void`	`addParameter(JRParameter parameter)` Adds a report parameter.
`void`	`addScriptlet(JRScriptlet scriptlet)` Adds a report scriplet.
`void`	`addSortField(JRSortField sortField)`
`void`	`addStyle(int index, JRStyle style)` Inserts a report style, that can be referenced by report elements, at specified position.
`void`	`addStyle(JRStyle style)` Adds a report style, that can be referenced by report elements.
`void`	`addTemplate(int index, JRReportTemplate template)` Inserts a report template at specified position.
`void`	`addTemplate(JRReportTemplate template)` Adds a report template.
`void`	`addVariable(JRDesignVariable variable)`
`protected List<JRCrosstab>`	`getCrosstabs()`
`Map<String,JRDataset>`	`getDatasetMap()` Returns the sub datasets of the report indexed by name.
`JRDataset[]`	`getDatasets()` Returns the datasets of this report.
`List<JRDataset>`	`getDatasetsList()` Returns the list of report sub datasets.
`Collection<JRExpression>`	`getExpressions()` Returns a collection of all report expressions.
`List<JRField>`	`getFieldsList()` Gets a list of report fields.
`Map<String,JRField>`	`getFieldsMap()` Gets a map of report fields.
`JRExpression`	`getFilterExpression()` Returns the main dataset filter expression.
`List<JRGroup>`	`getGroupsList()` Gets an array of report groups.
`Map<String,JRGroup>`	`getGroupsMap()` Gets a list of report groups.
`JRDesignDataset`	`getMainDesignDataset()` Returns the main report dataset.
`List<JRParameter>`	`getParametersList()` Gets a list of report parameters (including built-in ones).
`Map<String,JRParameter>`	`getParametersMap()` Gets a map of report parameters (including built-in ones).
`List<JRScriptlet>`	`getScriptletsList()` Gets a list of report scriptlets (excluding the one specified by scriptletClass).
`Map<String,JRScriptlet>`	`getScriptletsMap()` Gets a map of report scriptlets (excluding the one specified by scriptletClass).
`List<JRSortField>`	`getSortFieldsList()` Gets a list of sort report fields.
`JRStyle[]`	`getStyles()` Gets an array of report level styles.
`List<JRStyle>`	`getStylesList()` Gets a list of report level styles.
`Map<String,JRStyle>`	`getStylesMap()`
`JRReportTemplate[]`	`getTemplates()` Returns the list of report templates.
`List<JRReportTemplate>`	`getTemplatesList()` Returns the list of report templates defined in the report.
`List<JRVariable>`	`getVariablesList()` Gets a list of report variables.
`Map<String,JRVariable>`	`getVariablesMap()` Gets a map of report variables.
`boolean`	`hasUUID()` Determines whether the report has an existing unique identifier.
`void`	`preprocess()` Performs preliminary processing and calculations prior to compilation.
`JRDataset`	`removeDataset(JRDataset dataset)` Removes a sub dataset from the report.
`JRDataset`	`removeDataset(String datasetName)` Removes a sub dataset from the report.
`JRField`	`removeField(JRField field)`
`JRField`	`removeField(String fieldName)`
`JRGroup`	`removeGroup(JRGroup group)`
`JRGroup`	`removeGroup(String groupName)` Removes a new group from the report design.
`void`	`removeImport(String value)` Removes an import.
`JRParameter`	`removeParameter(JRParameter parameter)` Removes a report parameter.
`JRParameter`	`removeParameter(String parameterName)` Removes a report parameter, based on its name.
`JRScriptlet`	`removeScriptlet(JRScriptlet scriptlet)` Removes a report scriptlet.
`JRScriptlet`	`removeScriptlet(String scriptletName)` Removes a report scriptlet, based on its name.
`JRSortField`	`removeSortField(JRSortField sortField)`
`JRSortField`	`removeSortField(String fieldName)` Deprecated. To be removed.
`JRStyle`	`removeStyle(JRStyle style)` Removes a report style from the list.
`JRStyle`	`removeStyle(String styleName)` Removes a report style from the list, based on the style name.
`boolean`	`removeTemplate(JRReportTemplate template)` Removes a report template.
`JRVariable`	`removeVariable(JRVariable variable)`
`JRVariable`	`removeVariable(String variableName)`
`void`	`resetDefaultStyle()`
`void`	`setBackground(JRBand background)` Sets the background band.
`protected void`	`setBandOrigin(JRBand band, BandTypeEnum type)`
`void`	`setBottomMargin(int bottomMargin)` Sets the top margin.
`void`	`setColumnCount(int columnCount)` Specifies the number of report columns.
`void`	`setColumnDirection(RunDirectionEnum columnDirection)` Sets the column direction.
`void`	`setColumnFooter(JRBand columnFooter)` Sets the column footer band.
`void`	`setColumnHeader(JRBand columnHeader)` Sets the column header band.
`void`	`setColumnSpacing(int columnSpacing)` Sets the spacing between columns.
`void`	`setColumnWidth(int columnWidth)` Sets the column width.
`void`	`setDefaultStyle(JRStyle style)`
`void`	`setFilterExpression(JRExpression expression)` Sets the main dataset filter expression.
`void`	`setFloatColumnFooter(boolean isFloatColumnFooter)` Flag used to specify if the column footer section should be printed at the bottom of the column or if it should immediately follow the last detail or group footer printed on the current column.
`void`	`setFormatFactoryClass(String formatFactoryClass)`
`void`	`setIgnorePagination(boolean ignorePagination)` Sets the value of the ignore pagination flag.
`void`	`setLanguage(String language)` Specifies the language used for report expressions (Java or Groovy).
`void`	`setLastPageFooter(JRBand lastPageFooter)` Sets the last page footer band.
`void`	`setLeftMargin(int leftMargin)` Sets the left margin.
`void`	`setMainDataset(JRDesignDataset dataset)` Sets the main report dataset.
`void`	`setName(String name)` Sets the report name.
`void`	`setNoData(JRBand noData)` Sets the noData band.
`void`	`setOrientation(OrientationEnum orientationValue)` Sets the report orientation.
`void`	`setPageFooter(JRBand pageFooter)` Sets the page footer band.
`void`	`setPageHeader(JRBand pageHeader)` Sets the page header band.
`void`	`setPageHeight(int pageHeight)` Sets page height (including margins etc.).
`void`	`setPageWidth(int pageWidth)` Sets page width (including margins etc.).
`void`	`setPrintOrder(PrintOrderEnum printOrderValue)` Sets the print order.
`void`	`setQuery(JRDesignQuery query)` Specifies the report query.
`void`	`setResourceBundle(String resourceBundle)` Sets the base name of the report associated resource bundle.
`void`	`setRightMargin(int rightMargin)` Sets the right margin.
`void`	`setScriptletClass(String scriptletClass)`
`protected void`	`setSectionOrigin(JRSection section, BandTypeEnum type)`
`void`	`setSummary(JRBand summary)` Sets the summary band.
`void`	`setSummaryNewPage(boolean isSummaryNewPage)` Flag used to specify if the summary section should be printed on a separate last page.
`void`	`setSummaryWithPageHeaderAndFooter(boolean isSummaryWithPageHeaderAndFooter)` Flag used to specify if the summary section should be accompanied by the page header and footer.
`void`	`setTitle(JRBand title)` Sets the title band.
`void`	`setTitleNewPage(boolean isTitleNewPage)` Flag used to specify if the title section should be printed on a separate initial page.
`void`	`setTopMargin(int topMargin)` Sets the top margin.
`void`	`setUUID(UUID uuid)` Sets the unique identifier for the report.

Methods inherited from class net.sf.jasperreports.engine.base.JRBaseReport
copyTemplates, getAllBands, getBackground, getBottomMargin, getColumnCount, getColumnDirection, getColumnFooter, getColumnHeader, getColumnSpacing, getColumnWidth, getDefaultStyle, getDetailSection, getEventSupport, getFields, getFormatFactoryClass, getGroups, getImports, getLanguage, getLastPageFooter, getLeftMargin, getMainDataset, getName, getNoData, getOrientationValue, getPageFooter, getPageHeader, getPageHeight, getPageWidth, getParameters, getParentProperties, getPrintOrderValue, getPropertiesMap, getProperty, getPropertyNames, getQuery, getResourceBundle, getRightMargin, getScriptletClass, getScriptlets, getSectionType, getSortFields, getSummary, getTitle, getTopMargin, getUUID, getVariables, getWhenNoDataTypeValue, getWhenResourceMissingTypeValue, hasProperties, isFloatColumnFooter, isIgnorePagination, isSummaryNewPage, isSummaryWithPageHeaderAndFooter, isTitleNewPage, removeProperty, setProperty, setSectionType, setWhenNoDataType, setWhenResourceMissingType

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - EXCEPTION_MESSAGE_KEY_DUPLICATE_DATASET
```
public static final String EXCEPTION_MESSAGE_KEY_DUPLICATE_DATASET
```
    See Also:
    Constant Field Values
  - EXCEPTION_MESSAGE_KEY_DUPLICATE_REPORT_STYLE
```
public static final String EXCEPTION_MESSAGE_KEY_DUPLICATE_REPORT_STYLE
```
    See Also:
    Constant Field Values
  - PROPERTY_BACKGROUND
```
public static final String PROPERTY_BACKGROUND
```
    See Also:
    Constant Field Values
  - PROPERTY_BOTTOM_MARGIN
```
public static final String PROPERTY_BOTTOM_MARGIN
```
    See Also:
    Constant Field Values
  - PROPERTY_COLUMN_COUNT
```
public static final String PROPERTY_COLUMN_COUNT
```
    See Also:
    Constant Field Values
  - PROPERTY_COLUMN_FOOTER
```
public static final String PROPERTY_COLUMN_FOOTER
```
    See Also:
    Constant Field Values
  - PROPERTY_COLUMN_HEADER
```
public static final String PROPERTY_COLUMN_HEADER
```
    See Also:
    Constant Field Values
  - PROPERTY_COLUMN_SPACING
```
public static final String PROPERTY_COLUMN_SPACING
```
    See Also:
    Constant Field Values
  - PROPERTY_COLUMN_WIDTH
```
public static final String PROPERTY_COLUMN_WIDTH
```
    See Also:
    Constant Field Values
  - PROPERTY_DATASETS
```
public static final String PROPERTY_DATASETS
```
    See Also:
    Constant Field Values
  - PROPERTY_DEFAULT_FONT
```
public static final String PROPERTY_DEFAULT_FONT
```
    See Also:
    Constant Field Values
  - PROPERTY_DEFAULT_STLYE
```
public static final String PROPERTY_DEFAULT_STLYE
```
    See Also:
    Constant Field Values
  - PROPERTY_DETAIL
```
public static final String PROPERTY_DETAIL
```
    See Also:
    Constant Field Values
  - PROPERTY_FLOAT_COLUMN_FOOTER
```
public static final String PROPERTY_FLOAT_COLUMN_FOOTER
```
    See Also:
    Constant Field Values
  - PROPERTY_FONTS
```
public static final String PROPERTY_FONTS
```
    See Also:
    Constant Field Values
  - PROPERTY_FORMAT_FACTORY_CLASS
```
public static final String PROPERTY_FORMAT_FACTORY_CLASS
```
    See Also:
    Constant Field Values
  - PROPERTY_IGNORE_PAGINATION
```
public static final String PROPERTY_IGNORE_PAGINATION
```
    See Also:
    Constant Field Values
  - PROPERTY_IMPORTS
```
public static final String PROPERTY_IMPORTS
```
    See Also:
    Constant Field Values
  - PROPERTY_LANGUAGE
```
public static final String PROPERTY_LANGUAGE
```
    See Also:
    Constant Field Values
  - PROPERTY_LAST_PAGE_FOOTER
```
public static final String PROPERTY_LAST_PAGE_FOOTER
```
    See Also:
    Constant Field Values
  - PROPERTY_LEFT_MARGIN
```
public static final String PROPERTY_LEFT_MARGIN
```
    See Also:
    Constant Field Values
  - PROPERTY_MAIN_DATASET
```
public static final String PROPERTY_MAIN_DATASET
```
    See Also:
    Constant Field Values
  - PROPERTY_NAME
```
public static final String PROPERTY_NAME
```
    See Also:
    Constant Field Values
  - PROPERTY_NO_DATA
```
public static final String PROPERTY_NO_DATA
```
    See Also:
    Constant Field Values
  - PROPERTY_ORIENTATION
```
public static final String PROPERTY_ORIENTATION
```
    See Also:
    Constant Field Values
  - PROPERTY_PAGE_FOOTER
```
public static final String PROPERTY_PAGE_FOOTER
```
    See Also:
    Constant Field Values
  - PROPERTY_PAGE_HEADER
```
public static final String PROPERTY_PAGE_HEADER
```
    See Also:
    Constant Field Values
  - PROPERTY_PAGE_HEIGHT
```
public static final String PROPERTY_PAGE_HEIGHT
```
    See Also:
    Constant Field Values
  - PROPERTY_PAGE_WIDTH
```
public static final String PROPERTY_PAGE_WIDTH
```
    See Also:
    Constant Field Values
  - PROPERTY_PRINT_ORDER
```
public static final String PROPERTY_PRINT_ORDER
```
    See Also:
    Constant Field Values
  - PROPERTY_COLUMN_DIRECTION
```
public static final String PROPERTY_COLUMN_DIRECTION
```
    See Also:
    Constant Field Values
  - PROPERTY_RIGHT_MARGIN
```
public static final String PROPERTY_RIGHT_MARGIN
```
    See Also:
    Constant Field Values
  - PROPERTY_STYLES
```
public static final String PROPERTY_STYLES
```
    See Also:
    Constant Field Values
  - PROPERTY_SUMMARY
```
public static final String PROPERTY_SUMMARY
```
    See Also:
    Constant Field Values
  - PROPERTY_SUMMARY_NEW_PAGE
```
public static final String PROPERTY_SUMMARY_NEW_PAGE
```
    See Also:
    Constant Field Values
  - PROPERTY_SUMMARY_WITH_PAGE_HEADER_AND_FOOTER
```
public static final String PROPERTY_SUMMARY_WITH_PAGE_HEADER_AND_FOOTER
```
    See Also:
    Constant Field Values
  - PROPERTY_TEMPLATES
```
public static final String PROPERTY_TEMPLATES
```
    See Also:
    Constant Field Values
  - PROPERTY_TITLE
```
public static final String PROPERTY_TITLE
```
    See Also:
    Constant Field Values
  - PROPERTY_TITLE_NEW_PAGE
```
public static final String PROPERTY_TITLE_NEW_PAGE
```
    See Also:
    Constant Field Values
  - PROPERTY_TOP_MARGIN
```
public static final String PROPERTY_TOP_MARGIN
```
    See Also:
    Constant Field Values
- Constructor Detail
  - JasperDesign
```
public JasperDesign()
```
    Constructs a JasperDesign object and fills it with the default variables and parameters.
  - JasperDesign
```
public JasperDesign(JasperReportsContext context)
```
- Method Detail
  - setName
```
public void setName(String name)
```
    Sets the report name. It is strongly recommended that the report name matches the .jrxml file name, since report compilers usually use this name for the compiled .jasper file.
  - setLanguage
```
public void setLanguage(String language)
```
    Specifies the language used for report expressions (Java or Groovy). The default is Java.
  - setColumnCount
```
public void setColumnCount(int columnCount)
```
    Specifies the number of report columns.
  - setPrintOrder
```
public void setPrintOrder(PrintOrderEnum printOrderValue)
```
    Sets the print order. In case of multiple column reports, the engine can perform vertical or horizontal fill.
    
    See Also:
    VERTICAL,, HORIZONTAL
  - setColumnDirection
```
public void setColumnDirection(RunDirectionEnum columnDirection)
```
    Sets the column direction.
  - setPageWidth
```
public void setPageWidth(int pageWidth)
```
    Sets page width (including margins etc.). Default is 595.
  - setPageHeight
```
public void setPageHeight(int pageHeight)
```
    Sets page height (including margins etc.). Default is 842.
  - setOrientation
```
public void setOrientation(OrientationEnum orientationValue)
```
    Sets the report orientation.
    
    See Also:
    ORIENTATION_PORTRAIT,, ORIENTATION_LANDSCAPE
  - setColumnWidth
```
public void setColumnWidth(int columnWidth)
```
    Sets the column width.
  - setColumnSpacing
```
public void setColumnSpacing(int columnSpacing)
```
    Sets the spacing between columns.
  - setLeftMargin
```
public void setLeftMargin(int leftMargin)
```
    Sets the left margin. The working space is calculated by subtracting the margins from the page width.
  - setRightMargin
```
public void setRightMargin(int rightMargin)
```
    Sets the right margin. The working space is calculated by subtracting the margins from the page width.
  - setTopMargin
```
public void setTopMargin(int topMargin)
```
    Sets the top margin. The working space is calculated by subtracting the margins from the page height.
  - setBottomMargin
```
public void setBottomMargin(int bottomMargin)
```
    Sets the top margin. The working space is calculated by subtracting the margins from the page height.
  - setBackground
```
public void setBackground(JRBand background)
```
    Sets the background band.
  - setTitle
```
public void setTitle(JRBand title)
```
    Sets the title band.
  - setTitleNewPage
```
public void setTitleNewPage(boolean isTitleNewPage)
```
    Flag used to specify if the title section should be printed on a separate initial page.
    
    Parameters:
    isTitleNewPage - true if the title section should be displayed on a separate initial page, false if it will be displayed on the first page along with other sections.
  - setSummary
```
public void setSummary(JRBand summary)
```
    Sets the summary band.
  - setNoData
```
public void setNoData(JRBand noData)
```
    Sets the noData band.
  - setSummaryNewPage
```
public void setSummaryNewPage(boolean isSummaryNewPage)
```
    Flag used to specify if the summary section should be printed on a separate last page.
    
    Parameters:
    isSummaryNewPage - true if the summary section should be displayed on a separate last page, false if it will be displayed on the last page along with other sections, if there is enough space.
  - setSummaryWithPageHeaderAndFooter
```
public void setSummaryWithPageHeaderAndFooter(boolean isSummaryWithPageHeaderAndFooter)
```
    Flag used to specify if the summary section should be accompanied by the page header and footer.
    
    Parameters:
    isSummaryWithPageHeaderAndFooter - true if the summary section should be displayed on pages that have the page header and footer, false if it will be displayed on pages without header and footer.
  - setFloatColumnFooter
```
public void setFloatColumnFooter(boolean isFloatColumnFooter)
```
    Flag used to specify if the column footer section should be printed at the bottom of the column or if it should immediately follow the last detail or group footer printed on the current column.
  - setPageHeader
```
public void setPageHeader(JRBand pageHeader)
```
    Sets the page header band.
  - setPageFooter
```
public void setPageFooter(JRBand pageFooter)
```
    Sets the page footer band.
  - setLastPageFooter
```
public void setLastPageFooter(JRBand lastPageFooter)
```
    Sets the last page footer band.
  - setColumnHeader
```
public void setColumnHeader(JRBand columnHeader)
```
    Sets the column header band.
  - setColumnFooter
```
public void setColumnFooter(JRBand columnFooter)
```
    Sets the column footer band.
  - setScriptletClass
```
public void setScriptletClass(String scriptletClass)
```
  - setFormatFactoryClass
```
public void setFormatFactoryClass(String formatFactoryClass)
```
  - setResourceBundle
```
public void setResourceBundle(String resourceBundle)
```
    Sets the base name of the report associated resource bundle.
  - addImport
```
public void addImport(String value)
```
    Adds an import (needed if report expression require additional classes in order to compile).
  - removeImport
```
public void removeImport(String value)
```
    Removes an import.
  - resetDefaultStyle
```
public void resetDefaultStyle()
```
  - setDefaultStyle
```
public void setDefaultStyle(JRStyle style)
```
  - getStyles
```
public JRStyle[] getStyles()
```
    Gets an array of report level styles. These styles can be referenced by report elements.
    
    Specified by:
    
    getStyles in interface JRReport
    
    Overrides:
    
    getStyles in class JRBaseReport
  - getStylesList
```
public List<JRStyle> getStylesList()
```
    Gets a list of report level styles. These styles can be referenced by report elements.
  - getStylesMap
```
public Map<String,JRStyle> getStylesMap()
```
  - addStyle
```
public void addStyle(JRStyle style)
              throws JRException
```
    Adds a report style, that can be referenced by report elements.
    
    Throws:
    
    JRException
  - addStyle
```
public void addStyle(int index,
            JRStyle style)
              throws JRException
```
    Inserts a report style, that can be referenced by report elements, at specified position.
    
    Throws:
    
    JRException
  - removeStyle
```
public JRStyle removeStyle(String styleName)
```
    Removes a report style from the list, based on the style name.
  - removeStyle
```
public JRStyle removeStyle(JRStyle style)
```
    Removes a report style from the list.
  - getScriptletsList
```
public List<JRScriptlet> getScriptletsList()
```
    Gets a list of report scriptlets (excluding the one specified by scriptletClass).
  - getScriptletsMap
```
public Map<String,JRScriptlet> getScriptletsMap()
```
    Gets a map of report scriptlets (excluding the one specified by scriptletClass).
  - addScriptlet
```
public void addScriptlet(JRScriptlet scriptlet)
                  throws JRException
```
    Adds a report scriplet.
    
    Throws:
    
    JRException
  - removeScriptlet
```
public JRScriptlet removeScriptlet(String scriptletName)
```
    Removes a report scriptlet, based on its name.
  - removeScriptlet
```
public JRScriptlet removeScriptlet(JRScriptlet scriptlet)
```
    Removes a report scriptlet.
  - getParametersList
```
public List<JRParameter> getParametersList()
```
    Gets a list of report parameters (including built-in ones).
  - getParametersMap
```
public Map<String,JRParameter> getParametersMap()
```
    Gets a map of report parameters (including built-in ones).
  - addParameter
```
public void addParameter(JRParameter parameter)
                  throws JRException
```
    Adds a report parameter.
    
    Throws:
    
    JRException
  - removeParameter
```
public JRParameter removeParameter(String parameterName)
```
    Removes a report parameter, based on its name.
  - removeParameter
```
public JRParameter removeParameter(JRParameter parameter)
```
    Removes a report parameter.
  - setQuery
```
public void setQuery(JRDesignQuery query)
```
    Specifies the report query.
  - getFieldsList
```
public List<JRField> getFieldsList()
```
    Gets a list of report fields.
  - getFieldsMap
```
public Map<String,JRField> getFieldsMap()
```
    Gets a map of report fields.
  - addField
```
public void addField(JRField field)
              throws JRException
```
    Throws:
    
    JRException
  - removeField
```
public JRField removeField(String fieldName)
```
  - removeField
```
public JRField removeField(JRField field)
```
  - getSortFieldsList
```
public List<JRSortField> getSortFieldsList()
```
    Gets a list of sort report fields.
  - addSortField
```
public void addSortField(JRSortField sortField)
                  throws JRException
```
    Throws:
    
    JRException
  - removeSortField
```
public JRSortField removeSortField(String fieldName)
```
    Deprecated. To be removed.
  - removeSortField
```
public JRSortField removeSortField(JRSortField sortField)
```
  - getVariablesList
```
public List<JRVariable> getVariablesList()
```
    Gets a list of report variables.
  - getVariablesMap
```
public Map<String,JRVariable> getVariablesMap()
```
    Gets a map of report variables.
  - addVariable
```
public void addVariable(JRDesignVariable variable)
                 throws JRException
```
    Throws:
    
    JRException
  - removeVariable
```
public JRVariable removeVariable(String variableName)
```
  - removeVariable
```
public JRVariable removeVariable(JRVariable variable)
```
  - getGroupsList
```
public List<JRGroup> getGroupsList()
```
    Gets an array of report groups.
  - getGroupsMap
```
public Map<String,JRGroup> getGroupsMap()
```
    Gets a list of report groups.
  - addGroup
```
public void addGroup(JRDesignGroup group)
              throws JRException
```
    Gets a map of report groups.
    
    Throws:
    
    JRException
  - removeGroup
```
public JRGroup removeGroup(String groupName)
```
    Removes a new group from the report design.
  - removeGroup
```
public JRGroup removeGroup(JRGroup group)
```
  - getExpressions
```
public Collection<JRExpression> getExpressions()
```
    Returns a collection of all report expressions.
  - getDatasets
```
public JRDataset[] getDatasets()
```
    Description copied from interface: JRReport
    
    Returns the datasets of this report.
    
    Specified by:
    
    getDatasets in interface JRReport
    
    Overrides:
    
    getDatasets in class JRBaseReport
    
    Returns:
    the datasets of this report
  - getDatasetsList
```
public List<JRDataset> getDatasetsList()
```
    Returns the list of report sub datasets.
    
    Returns:
    list of JRDesignDataset objects
  - getDatasetMap
```
public Map<String,JRDataset> getDatasetMap()
```
    Returns the sub datasets of the report indexed by name.
    
    Returns:
    the sub datasets of the report indexed by name
  - addDataset
```
public void addDataset(JRDesignDataset dataset)
                throws JRException
```
    Adds a sub dataset to the report.
    
    Parameters:
    dataset - the dataset
    
    Throws:
    
    JRException
  - addDataset
```
public void addDataset(int index,
              JRDesignDataset dataset)
                throws JRException
```
    Inserts a sub dataset at specified position into the report.
    
    Parameters:
    index - the position
    dataset - the dataset
    
    Throws:
    
    JRException
  - removeDataset
```
public JRDataset removeDataset(String datasetName)
```
    Removes a sub dataset from the report.
    
    Parameters:
    datasetName - the dataset name
    
    Returns:
    the removed dataset
  - removeDataset
```
public JRDataset removeDataset(JRDataset dataset)
```
    Removes a sub dataset from the report.
    
    Parameters:
    dataset - the dataset to be removed
    
    Returns:
    the dataset
  - getMainDesignDataset
```
public JRDesignDataset getMainDesignDataset()
```
    Returns the main report dataset.
    
    Returns:
    the main report dataset
  - setMainDataset
```
public void setMainDataset(JRDesignDataset dataset)
```
    Sets the main report dataset.
    This method can be used as an alternative to setting the parameters, fields, etc directly on the report.
    
    Parameters:
    dataset - the dataset
  - preprocess
```
public void preprocess()
```
    Performs preliminary processing and calculations prior to compilation.
  - getCrosstabs
```
protected List<JRCrosstab> getCrosstabs()
```
  - setIgnorePagination
```
public void setIgnorePagination(boolean ignorePagination)
```
    Sets the value of the ignore pagination flag.
    
    Parameters:
    ignorePagination - whether to ignore pagination when generating the report
    See Also:
    JRReport.isIgnorePagination()
  - getFilterExpression
```
public JRExpression getFilterExpression()
```
    Returns the main dataset filter expression.
    
    Returns:
    the main dataset filter expression
    See Also:
    JRDataset.getFilterExpression()
  - setFilterExpression
```
public void setFilterExpression(JRExpression expression)
```
    Sets the main dataset filter expression.
    
    Parameters:
    expression - the boolean expression to use as main dataset filter expression
    See Also:
    JRDesignDataset.setFilterExpression(JRExpression), JRDataset.getFilterExpression()
  - addTemplate
```
public void addTemplate(JRReportTemplate template)
```
    Adds a report template.
    
    Parameters:
    template - the template to add.
    See Also:
    getTemplates()
  - addTemplate
```
public void addTemplate(int index,
               JRReportTemplate template)
```
    Inserts a report template at specified position.
    
    Parameters:
    index - the template position.
    template - the template to insert.
    See Also:
    getTemplates()
  - removeTemplate
```
public boolean removeTemplate(JRReportTemplate template)
```
    Removes a report template.
    
    Parameters:
    template - the template to remove
    
    Returns:
    true if and only if the template has been found and removed
  - getTemplates
```
public JRReportTemplate[] getTemplates()
```
    Description copied from interface: JRReport
    Returns the list of report templates.
    A report template is an expression which resolves at runtime to a template. Templates include styles which can be used in the report.
    The order in which the templates are included in the report is important:
    - A style's parent must appear before the style itself.
    - A style overrides styles with the same name that are placed before it. Also, report styles override templates styles with the same name.
    Specified by:
    
    getTemplates in interface JRReport
    
    Overrides:
    
    getTemplates in class JRBaseReport
    
    Returns:
    the list of report templates, or null if none
    See Also:
    JRTemplate, JRParameter.REPORT_TEMPLATES
  - getTemplatesList
```
public List<JRReportTemplate> getTemplatesList()
```
    Returns the list of report templates defined in the report.
    
    Returns:
    the list of JRReportTemplate objects for the report
    See Also:
    getTemplates(), addTemplate(JRReportTemplate)
  - setBandOrigin
```
protected void setBandOrigin(JRBand band,
                 BandTypeEnum type)
```
  - setSectionOrigin
```
protected void setSectionOrigin(JRSection section,
                    BandTypeEnum type)
```
  - setUUID
```
public void setUUID(UUID uuid)
```
    Sets the unique identifier for the report.
    
    Parameters:
    uuid - the identifier
  - hasUUID
```
public boolean hasUUID()
```
    Determines whether the report has an existing unique identifier. Note that when no existing identifier is set, JRBaseReport.getUUID() would generate and return an identifier.
    
    Returns:
    whether the report has an externally set unique identifier
    See Also:
    setUUID(UUID)

Class JasperDesign

Field Summary

Fields inherited from class net.sf.jasperreports.engine.base.JRBaseReport

Fields inherited from interface net.sf.jasperreports.engine.JRReport

Constructor Summary

Method Summary

Methods inherited from class net.sf.jasperreports.engine.base.JRBaseReport

Methods inherited from class java.lang.Object

Field Detail

EXCEPTION_MESSAGE_KEY_DUPLICATE_DATASET

EXCEPTION_MESSAGE_KEY_DUPLICATE_REPORT_STYLE

PROPERTY_BACKGROUND

PROPERTY_BOTTOM_MARGIN

PROPERTY_COLUMN_COUNT

PROPERTY_COLUMN_FOOTER

PROPERTY_COLUMN_HEADER

PROPERTY_COLUMN_SPACING

PROPERTY_COLUMN_WIDTH

PROPERTY_DATASETS

PROPERTY_DEFAULT_FONT

PROPERTY_DEFAULT_STLYE

PROPERTY_DETAIL

PROPERTY_FLOAT_COLUMN_FOOTER

PROPERTY_FONTS

PROPERTY_FORMAT_FACTORY_CLASS

PROPERTY_IGNORE_PAGINATION

PROPERTY_IMPORTS

PROPERTY_LANGUAGE

PROPERTY_LAST_PAGE_FOOTER

PROPERTY_LEFT_MARGIN

PROPERTY_MAIN_DATASET

PROPERTY_NAME

PROPERTY_NO_DATA

PROPERTY_ORIENTATION

PROPERTY_PAGE_FOOTER

PROPERTY_PAGE_HEADER

PROPERTY_PAGE_HEIGHT

PROPERTY_PAGE_WIDTH

PROPERTY_PRINT_ORDER

PROPERTY_COLUMN_DIRECTION

PROPERTY_RIGHT_MARGIN

PROPERTY_STYLES

PROPERTY_SUMMARY

PROPERTY_SUMMARY_NEW_PAGE

PROPERTY_SUMMARY_WITH_PAGE_HEADER_AND_FOOTER

PROPERTY_TEMPLATES

PROPERTY_TITLE

PROPERTY_TITLE_NEW_PAGE

PROPERTY_TOP_MARGIN

Constructor Detail

JasperDesign

JasperDesign

Method Detail

setName

setLanguage

setColumnCount

setPrintOrder

setColumnDirection

setPageWidth

setPageHeight

setOrientation

setColumnWidth

setColumnSpacing

setLeftMargin

setRightMargin

setTopMargin

setBottomMargin

setBackground

setTitle

setTitleNewPage

setSummary

setNoData

setSummaryNewPage

setSummaryWithPageHeaderAndFooter

setFloatColumnFooter

setPageHeader

setPageFooter

setLastPageFooter

setColumnHeader

setColumnFooter