基于MongoTemplate实现MongoDB嵌入式文档字段投影查询

嘿，针对你在Java应用里获取嵌入式文档指定字段的需求，结合你给出的POJO类，我整理了几种实用的实现方式，先把你的类定义规范格式化出来，再一步步讲怎么操作：

User类 #

public class User implements Comparable<User> {
    @Id
    private String username;
    private String ownerFirstname;
    private String ownerLastname;
    @DBRef
    @CascadeSave
    @JsonInclude(JsonInclude.Include.NON_NULL)
    private Role role;

    // 建议补充getter/setter，方便字段操作
    public String getUsername() {
        return username;
    }

    public void setUsername(String username) {
        this.username = username;
    }

    public String getOwnerFirstname() {
        return ownerFirstname;
    }

    public void setOwnerFirstname(String ownerFirstname) {
        this.ownerFirstname = ownerFirstname;
    }

    public String getOwnerLastname() {
        return ownerLastname;
    }

    public void setOwnerLastname(String ownerLastname) {
        this.ownerLastname = ownerLastname;
    }

    public Role getRole() {
        return role;
    }

    public void setRole(Role role) {
        this.role = role;
    }

    @Override
    public int compareTo(User o) {
        // 示例：按用户名排序，可根据业务调整
        return this.username.compareTo(o.getUsername());
    }
}

Role接口 #

@Document
@JsonDeserialize(using = RoleDeserializer.class)
public interface Role {
    String getId();
    void setId(String id);
    // 可补充业务需要的其他方法，比如getRoleName()
}

Society类（补全示例） #

@Document(collection = "societies") // 假设集合名为societies
public class Society {
    @Id
    private String id;
    private String societyName;
    private User representative; // 嵌入式User文档

    // getter/setter方法
    public String getId() {
        return id;
    }

    public void setId(String id) {
        this.id = id;
    }

    public String getSocietyName() {
        return societyName;
    }

    public void setSocietyName(String societyName) {
        this.societyName = societyName;
    }

    public User getRepresentative() {
        return representative;
    }

    public void setRepresentative(User representative) {
        this.representative = representative;
    }
}

方法1：使用Spring Data MongoDB投影接口 #

如果只想获取嵌入式User的ownerFirstname和role.id，可以定义嵌套投影接口来精准控制返回字段：

// 投影接口，仅暴露需要的字段
public interface SocietyProjection {
    String getSocietyName();

    // 嵌套投影User的指定字段
    interface UserProjection {
        String getOwnerFirstname();
        RoleProjection getRole();
    }

    // 嵌套投影Role的指定字段
    interface RoleProjection {
        String getId();
    }

    UserProjection getRepresentative();
}

然后在Repository中定义查询方法：

public interface SocietyRepository extends MongoRepository<Society, String> {
    List<SocietyProjection> findBySocietyName(String societyName);
}

调用该方法后，只会返回你指定的字段，避免加载整个文档，性能更优。

方法2：用@Query注解直接指定返回字段 #

在Repository方法上通过@Query的fields参数，用MongoDB的字段语法指定要返回的内容：

public interface SocietyRepository extends MongoRepository<Society, String> {
    @Query(
        value = "{ 'societyName' : ?0 }",
        fields = "{ 'societyName' : 1, 'representative.ownerFirstname' : 1, 'representative.role.id' : 1, '_id' : 0 }"
    )
    List<Society> findBySocietyNameWithSpecifiedFields(String societyName);
}

• 1表示包含该字段，0表示排除，_id默认会返回，这里手动排除了它。

方法3：手动构建Query对象（灵活度最高） #

在业务代码中通过MongoTemplate手动创建Query，精准控制查询条件和返回字段：

@Autowired
private MongoTemplate mongoTemplate;

public List<Society> getSocietyWithTargetFields(String societyName) {
    Query query = new Query(Criteria.where("societyName").is(societyName));
    // 指定要包含的字段
    query.fields()
         .include("societyName")
         .include("representative.ownerFirstname")
         .include("representative.role.id")
         .exclude("_id"); // 可选，排除_id字段
    
    return mongoTemplate.find(query, Society.class);
}

查询返回的Society对象中，只有指定字段会被赋值，其他字段因@JsonInclude(NON_NULL)注解，序列化时会自动忽略。

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