Jasper Reports问题：实现单值单行展示而非数组值输出

一、数据行展示问题修复 #

当前问题核心是data为数组类型，直接引用data.ref会输出整个数组的值，需让Jasper遍历数组生成单条数据行，以下是两种实用方案：

方案1：修改JSON查询直接遍历数组 #

调整<queryString>指向data数组，Jasper会自动遍历每条数据：

<queryString language="json"><![CDATA[.data]]></queryString>

同时修改字段定义，去掉data.前缀：

<field name="ref" class="java.lang.String"/>
<field name="station" class="java.lang.String"/>
<field name="name" class="java.lang.String"/>
<field name="effectiveOn" class="java.lang.String"/>
<field name="quantity" class="java.lang.String"/>
<field name="costPerUnit" class="java.lang.String"/>
<field name="discountAmount" class="java.lang.String"/>
<field name="totalCost" class="java.lang.String"/>

最后更新detail band中的文本框表达式，比如将$F{data.ref}改为$F{ref}。

方案2：使用列表组件遍历数组（保留原查询结构） #

如果需要维持原数据结构，可通过List组件绑定data数组：

1. 定义子数据集：

<subDataset name="DataSubDataset">
    <field name="ref" class="java.lang.String"/>
    <field name="station" class="java.lang.String"/>
    <field name="name" class="java.lang.String"/>
    <field name="effectiveOn" class="java.lang.String"/>
    <field name="quantity" class="java.lang.String"/>
    <field name="costPerUnit" class="java.lang.String"/>
    <field name="discountAmount" class="java.lang.String"/>
    <field name="totalCost" class="java.lang.String"/>
</subDataset>

2. 在detail band中添加List组件，绑定子数据集并传入data数组：

<componentElement>
    <reportElement x="-20" y="0" width="530" height="10"/>
    <jr:list xmlns:jr="http://jasperreports.sourceforge.net/jasperreports/components" xsi:schemaLocation="http://jasperreports.sourceforge.net/jasperreports/components http://jasperreports.sourceforge.net/xsd/components.xsd">
        <datasetRun subDataset="DataSubDataset">
            <dataSourceExpression><![CDATA[new net.sf.jasperreports.engine.data.JsonDataSource(new ByteArrayInputStream($F{data}.toString().getBytes()), "")]]></dataSourceExpression>
        </datasetRun>
        <jr:listContents height="10" width="530">
            <!-- 此处放置原detail band中的所有文本框，表达式替换为子数据集字段，如$F{ref} -->
        </jr:listContents>
    </jr:list>
</componentElement>

二、模板可读性提升建议 #

• 强化样式复用：将通用字体、对齐规则抽离为基础样式，减少重复代码：

<style name="BaseStyle" fontName="Arial" fontSize="8" />
<style name="Headers" extends="BaseStyle" mode="Opaque" backcolor="#FFFFFF">
    <!-- 边框定义 -->
</style>

• 添加分组注释：用注释区分表头字段、数据字段，便于快速定位：

<!-- 报表表头字段 -->
<field name="headers.ref" class="java.lang.String"/>
<!-- 数据行字段 -->
<field name="ref" class="java.lang.String"/>

• 统一布局规范：使用Jaspersoft Studio的对齐工具批量调整文本框坐标，保持x/y值的规律性，避免零散数值。
• 优化命名规则：模板名称、样式名称、字段名采用有意义的命名，比如将manual-lines改为SalesDocumentReport，避免无意义缩写。
• 移除冗余属性：删除不需要的splitType="Stretch"（无内容拉伸需求时）、重复的字体设置（通过样式复用替代）。
• 拆分复杂结构：后续报表扩展时，可将表头、数据行拆分为独立模板片段，通过<subreport>引用，降低主模板复杂度。

内容的提问来源于stack exchange，提问作者ethicnology