Spring Data JPA中如何按关联表index字段排序多对多关联的Client列表

标准的@ManyToMany映射会忽略中间表的额外字段（比如你的rel_client_group.index），所以要实现按中间表字段排序，必须把中间表转为实体，用一对多关系替代多对多。以下是具体实现步骤：

1. 创建中间表实体及复合主键 #

首先把rel_client_group表映射为实体，它的主键是client_id和group_id的复合键：

复合主键类 #

@Embeddable
public class RelClientGroupId implements Serializable {
    @Column(name = "client_id")
    private Long clientId;

    @Column(name = "group_id")
    private Long groupId;

    // 必须重写equals和hashCode，用于JPA识别主键
    @Override
    public boolean equals(Object o) {
        if (this == o) return true;
        if (o == null || getClass() != o.getClass()) return false;
        RelClientGroupId that = (RelClientGroupId) o;
        return Objects.equals(clientId, that.clientId) && Objects.equals(groupId, that.groupId);
    }

    @Override
    public int hashCode() {
        return Objects.hash(clientId, groupId);
    }

    // getter、setter方法
}

中间表实体 #

@Entity
@Table(name = "rel_client_group")
public class RelClientGroup {
    @EmbeddedId
    private RelClientGroupId id;

    @Column(name = "index")
    private Integer index;

    @ManyToOne(fetch = FetchType.LAZY)
    @MapsId("clientId") // 关联复合主键中的clientId字段
    @JoinColumn(name = "client_id")
    private Client client;

    @ManyToOne(fetch = FetchType.LAZY)
    @MapsId("groupId") // 关联复合主键中的groupId字段
    @JoinColumn(name = "group_id")
    private Group group;

    // 构造方法、getter、setter方法
}

2. 修改Group和Client实体 #

把原来的@ManyToMany替换为@OneToMany关联中间表实体，并在Group中配置排序：

Group实体 #

@Entity
@Table(name = "group")
public class Group {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long groupId;

    // 关联中间表实体，同时按index字段升序排序
    @OneToMany(mappedBy = "group", cascade = CascadeType.ALL, orphanRemoval = true)
    @OrderBy("index ASC")
    private List<RelClientGroup> clientRelations;

    // 可选：添加临时方法，直接返回排序后的Client列表（不持久化到数据库）
    @Transient
    public List<Client> getClients() {
        return clientRelations.stream()
                .sorted(Comparator.comparingInt(RelClientGroup::getIndex))
                .map(RelClientGroup::getClient)
                .collect(Collectors.toList());
    }

    // 其他业务字段、getter、setter方法
}

Client实体 #

@Entity
@Table(name = "client")
public class Client {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long clientId;

    @OneToMany(mappedBy = "client", cascade = CascadeType.ALL, orphanRemoval = true)
    private List<RelClientGroup> groupRelations;

    // 其他业务字段、getter、setter方法
}

3. 数据查询 #

现在调用groupRepository.findAll()时，每个Group的clientRelations列表会自动按rel_client_group.index排序，通过getClients()方法就能直接拿到排序后的Client列表。

备选方案：自定义JPQL查询（不修改实体结构） #

如果不想调整实体关系，也可以通过自定义JPQL查询实现排序，但这种方式可能返回重复的Group对象，需要配合DISTINCT：

public interface GroupRepository extends JpaRepository<Group, Long> {
    @Query("SELECT DISTINCT g FROM Group g " +
           "JOIN FETCH g.clients c " +
           "JOIN rel_client_group r ON c.clientId = r.clientId AND g.groupId = r.groupId " +
           "ORDER BY r.index ASC")
    List<Group> findAllWithClientsSortedByIndex();
}

不过这种方式的可维护性不如实体化中间表的方案，推荐优先使用第一种方法。

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