一、项目背景
本项目采用 Spring Boot 框架进行搭建,数据库操作层面选用了 MyBatis ORM 框架,数据库管理系统为 MySQL。
二、需求背景
1. 动态表结构需求
在项目中,存在一种特殊需求,即需要根据用户提交的表单动态创建数据库表 t_table
。这意味着该表的字段(如列名、数据类型等)不是预定义的,而是根据表单的内容动态生成的。这种设计在需要高度灵活性和自定义化的应用中非常有用,如用户自定义报告、数据收集平台等。
2. 查询动态表并返回 Map 集合
由于表结构是动态生成的,因此在查询这些数据时,很难事先定义一个固定的 Java 对象来接收查询结果。因此,选择使用 Map 集合来接收每行的数据,其中 Map 的键为列名,值为对应的列值。这种方式可以灵活地处理未知或动态变化的列结构。
3. 解决“@MapKey is required”问题
在 MyBatis 的 Mapper 层编写查询方法,并希望以 Map 集合的形式接收返回结果时,如果直接使用 Map 作为返回值,并且期望 Map 的键具有某种特定的含义(比如行ID或特定列作为键),可能会遇到“@MapKey is required”的提示。这是因为 MyBatis 需要明确知道如何构建 Map 的键。
三、解决方案
1.使用 MapKey 注解
Map<Long, Map<String, String>>。范型类型可以修改。
- Map的key:一般存储每条记录的主键,也可以用其他值表示,主要取决于Dao层@MapKey注解后面的字段(如@MapKey("id"));
- Map的value:也是一个Map,表示查询出这条记录的每个字段的字段名称和字段值。
2.返回 List<Map<String, Object>>
在大多数情况下,直接返回 List<Map<String, Object>>
更为直接和简单。这样每个 Map 代表一行数据,Map 的键是列名,值是对应的数据。这种方式不需要 @MapKey
注解,因为 Map 的键已经由列名自然形成。