JasperReports 子报表subreport

子报表是 JasperReports 的一项不错的功能。此功能允许将一个报表合并到另一个报表中，即一个报表可以是另一个报表的子报表。子报表帮助我们保持报表设计简单，因为我们可以创建许多简单的报表并将它们封装到主报表中。子报告的编译和填充就像普通报告一样。当合并到另一个报告模板中时，任何报告模板都可以用作子报告，（报告模板的）内部没有任何更改。

子报表就像普通的报表模板。它们实际上是net.sf.jasperreports.engine.JasperReport对象，它们是在编译net.sf.jasperreports.engine.design.JasperDesign 对象后获得的。

JasperReports <subreport>元素

<subreport> 元素在将子报告引入主报告时使用。下面是 <subreport> JRXML 元素中的子元素列表。

• <reportElement>

• <parametersMapExpression> ： 用于将包含报告参数的地图传递给子报告。映射通常从主报表中的参数获取，或者通过使用内置的 REPORTS_PARAMETERS_MAP 参数将父报表的参数传递给子报表。此表达式应始终返回一个java.util.Map对象，其中的键是参数名称。

• <subreportParameter> ： 此元素用于将参数传递给子报表。它有一个属性name，这是强制性的。

• <connectionExpression > ： 用于将java.sql.Connection传递给子报表。仅当子报表模板在报表填写阶段需要数据库连接时使用。

• <dataSourceExpression> ： 用于将数据源传递给子报表。此数据源通常从主报表中的参数获取，或通过使用内置 REPORT_DATA_SOURCE 参数将父报表的数据源传递给子报表。

• 元素（connectionExpression 和 dataSourceExpression）不能同时出现在 <subreport> 元素声明中。这是因为我们不能同时提供数据源和到子报表的连接。我们必须决定其中之一并坚持下去。

• <returnValue> ： 用于将子报表变量之一的值分配给主报表变量之一。此子元素具有以下属性 -

  • subreportVariable ： 此属性指定要返回其值的子报表变量的名称。

  • toVariable ： 此属性指定父报告变量的名称，其值将与子报告中的值一起复制/递增。

  • calculation ：此属性可以取值：Nothing、Count、DistinctCount、Sum、Average、Lowest、Highest、StandardDeviation、Variance。属性计算的默认值为“Nothing”。

  • incrementerFactoryClass ： 此属性指定用于创建增量器实例的工厂类。

• <subreportExpression> ： 这表明在哪里可以找到子报告的编译报告模板。这个元素有一个类属性。在类属性可以采取的任何值：java.lang.String中，java.io.File中，java.net.URL中，java.io.InputStream中，net.sf.jasperreports.engine.JasperReport。默认值为java.lang.String。

• isUsingCache ： 这是 <subreport> 元素的一个属性。这是一个布尔值，当设置为true 时，报告引擎将尝试使用它们指定的源识别先前加载的子报告模板对象。此缓存功能仅适用于具有返回 java.lang.String 对象作为子报表模板源的表达式的子报表元素，表示文件名、URL 或类路径资源。