问题：润乾报表 Param 参数类如何正确传递数组参数？

Question

在使用润乾报表时，如何通过 Param 参数类正确传递数组参数是一个常见且关键的技术问题。许多开发者在实际应用中遇到参数传递失败、数据无法正确解析等问题，主要原因是对 Param 类的数组参数格式和使用方式不够清晰。正确的方式是将数组参数以特定的字符串格式（如逗号分隔）传入，并在报表端使用相应的函数进行解析。此外，还需注意参数类型设置为字符串或对象数组，确保前后端数据格式一致。掌握 Param 参数类对数组的处理机制，有助于提升报表开发效率和稳定性。

Answer 1

一、Param 参数类与数组传递的基本概念

在润乾报表开发中，Param 参数类用于在程序端向报表传递参数。当需要传递数组类型的数据时，开发者常遇到参数无法识别或解析失败的问题。这是因为 Param 类默认不支持直接传递数组对象，必须通过特定格式的字符串进行编码。

例如，若要传递多个地区名称作为筛选条件，正确的做法是将数组转换为逗号分隔的字符串：

String regions = "北京,上海,广州";

然后通过 Param 类设置参数值：

params.put("region", regions);

二、数组参数的解析机制与函数使用

在润乾报表的设计端，接收到的字符串参数需要通过内置函数进行解析，才能还原为数组形式用于数据过滤或展示。常用的函数包括：split() 和 in()。

示例：在数据集 SQL 中使用如下语句：

SELECT * FROM sales WHERE region IN (split(${region}, ','))

其中 split() 函数将逗号分隔的字符串拆分为数组，IN 语句则用于匹配数组中的多个值。

三、参数类型设置与前后端一致性

在使用 Param 类传递数组时，参数类型设置至关重要。建议将参数类型设置为 String 或 Object[]（对象数组），以确保前后端的数据格式一致。

参数类型	适用场景	注意事项
String	传递简单数组，如字符串、数字等	需手动解析字符串为数组
Object[]	传递复杂对象数组，如自定义类实例	需确保类定义一致，避免反序列化失败

四、常见问题分析与解决方案

以下是开发者在使用 Param 类传递数组时常见的问题及解决办法：

• 问题1： 参数传递后在报表中无效。

• 原因：未正确设置参数类型或未解析字符串。

  解决方案：确认参数类型为 String，使用 split() 函数解析。

• 问题2： 数组中包含特殊字符（如逗号）导致解析错误。

• 原因：使用逗号作为分隔符，但原始数据中包含逗号。

  解决方案：使用其他符号（如竖线 |）作为分隔符，并在 split() 函数中指定。

• 问题3： 传递对象数组时反序列化失败。

• 原因：前后端类定义不一致或未实现 Serializable 接口。

  解决方案：确保类结构一致，实现 Serializable 接口。

五、流程图：Param 类处理数组参数的全过程

            graph TD
                A[前端构建数组] --> B[转换为字符串]
                B --> C[通过 Param 类传递]
                C --> D[报表接收参数]
                D --> E{参数类型是否为 String?}
                E -->|是| F[使用 split() 解析]
                E -->|否| G[检查 Object[] 反序列化]
                F --> H[使用 in() 或其他函数处理数组]
                G --> H
                H --> I[执行数据查询]