如何通过MyBatis返回以分类名为键的Map<String, List<Article>>数据？

问题根源 #

你当前的Mapper配置会生成Map<String, HashMap<String, List<Article>>>结构，和期望的Map<String, List<Article>>不符。原因是自定义的CategoryArticleMap将每条分组结果封装为HashMap，再配合@MapKey导致外层Map的value是嵌套HashMap而非直接的文章列表。

方案一：Service层手动分组（推荐） #

这种方式简洁直观，无需复杂的MyBatis映射配置。

1. 调整Article实体类 #

新增categoryName字段，用于接收查询返回的分类名：

public class Article {
    private String title;
    private String content;
    private Integer state;
    private String author;
    // 新增分类名字段，对应数据库的category_name
    private String categoryName;

    // 所有字段的getter、setter方法
}

2. 修改Mapper XML #

删除原有的CategoryArticleMap，保留文章基础映射，新增查询所有关联数据的语句：

<resultMap id="ArticleResultMap" type="com.toc.content.pojo.Article">
    <result column="title" property="title" />
    <result column="content" property="content" />
    <result column="state" property="state"/>
    <result column="author" property="author"/>
    <result column="category_name" property="categoryName"/>
</resultMap>

<select id="listCategoryArticles" resultMap="ArticleResultMap">
    select c.category_name, a.title, a.content, a.state, a.author
    from category c
    left join article a on c.id = a.category_id
    where c.category_name is not null
    order by c.category_name
</select>

3. 调整DAO层方法 #

// ArticleDao.java
List<Article> listCategoryArticles();

4. Service层分组处理 #

利用Java Stream将查询结果按分类名分组：

public Map<String, List<Article>> getCategoryArticlesMap() {
    List<Article> articles = articleDao.listCategoryArticles();
    return articles.stream()
            .collect(Collectors.groupingBy(Article::getCategoryName));
}

方案二：MyBatis映射直接分组 #

如果希望在DAO层直接返回目标结构，可通过以下配置实现：

1. 修改Mapper XML #

定义分组结果映射和查询语句：

<resultMap id="ArticleResultMap" type="com.toc.content.pojo.Article">
    <result column="title" property="title" />
    <result column="content" property="content" />
    <result column="state" property="state"/>
    <result column="author" property="author"/>
</resultMap>

<resultMap id="GroupedArticleResultMap" type="java.util.HashMap">
    <id column="category_name" property="categoryName"/>
    <collection property="articleList" ofType="com.toc.content.pojo.Article" resultMap="ArticleResultMap"/>
</resultMap>

<select id="getGroupedArticles" resultMap="GroupedArticleResultMap">
    select c.category_name, a.title, a.content, a.state, a.author
    from category c
    left join article a on c.id = a.category_id
    where c.category_name is not null
    group by c.category_name, a.id
    order by c.category_name
</select>

2. DAO层方法 #

// ArticleDao.java
@MapKey("categoryName")
Map<String, Map<String, Object>> getGroupedArticles();

3. 转换为目标结构 #

Map<String, List<Article>> resultMap = new HashMap<>();
Map<String, Map<String, Object>> groupedData = articleDao.getGroupedArticles();
for (Map.Entry<String, Map<String, Object>> entry : groupedData.entrySet()) {
    resultMap.put(entry.getKey(), (List<Article>) entry.getValue().get("articleList"));
}

最终效果 #

两种方案都能生成你期望的JSON结构：

{
  "art": [
    {"title":"xxx", "author":"yyy", "content":"xxx", "state":1},
    {"title":"ppp", "author":"ssy", "content":"ppp", "state":1}
  ]
}

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