编辑“︁Spring Data MongoDB”︁（章节）

= Spring Data MongoDB =

'''Spring Data MongoDB''' 是 [[Spring Data]] 项目的一部分，它为 [[MongoDB]] 文档数据库提供了简化的数据访问层。通过 Spring Data MongoDB，开发者可以使用熟悉的 Spring 编程模型来操作 MongoDB，而无需编写大量的模板代码。它支持基于注解的映射、自动化的仓库接口以及丰富的查询功能。

== 核心概念 ==

=== 文档映射 (Document Mapping) ===
Spring Data MongoDB 使用注解将 Java 对象映射到 MongoDB 的文档。主要注解包括：
* <code>@Document</code>：标记一个类为 MongoDB 文档。
* <code>@Id</code>：标记文档的唯一标识字段。
* <code>@Field</code>：自定义字段在文档中的名称。

<syntaxhighlight lang="java">
@Document(collection = "users")
public class User {
    @Id
    private String id;
    
    @Field("username")
    private String name;
    
    private int age;
    
    // Getters and setters
}
</syntaxhighlight>

=== 仓库接口 (Repository) ===
Spring Data MongoDB 提供了 <code>MongoRepository</code> 接口，支持常见的 CRUD 操作和自定义查询方法。

<syntaxhighlight lang="java">
public interface UserRepository extends MongoRepository<User, String> {
    List<User> findByAgeGreaterThan(int age);
}
</syntaxhighlight>

=== 查询方法 (Query Methods) ===
方法名遵循特定的命名约定，Spring Data 会自动生成查询逻辑。例如：
* <code>findByAgeGreaterThan</code> 会生成查询条件 <code>{ "age": { "$gt": age } }</code>。

== 实际应用示例 ==

=== 配置 MongoDB 连接 ===
在 <code>application.properties</code> 中配置 MongoDB 连接：
<syntaxhighlight lang="properties">
spring.data.mongodb.uri=mongodb://localhost:27017/mydatabase
</syntaxhighlight>

=== 插入和查询数据 ===
<syntaxhighlight lang="java">
@SpringBootApplication
public class MongoDemoApplication implements CommandLineRunner {
    
    @Autowired
    private UserRepository userRepository;
    
    public static void main(String[] args) {
        SpringApplication.run(MongoDemoApplication.class, args);
    }
    
    @Override
    public void run(String... args) {
        // 插入数据
        User user = new User();
        user.setName("Alice");
        user.setAge(25);
        userRepository.save(user);
        
        // 查询数据
        List<User> users = userRepository.findByAgeGreaterThan(20);
        users.forEach(u -> System.out.println(u.getName()));
    }
}
</syntaxhighlight>

=== 输出示例 ===
<pre>
Alice
</pre>

== 高级功能 ==

=== 聚合框架 (Aggregation Framework) ===
Spring Data MongoDB 支持 MongoDB 的聚合操作，如分组、筛选和计算。

<syntaxhighlight lang="java">
Aggregation aggregation = Aggregation.newAggregation(
    Aggregation.group("name").count().as("count")
);
AggregationResults<GroupCount> results = mongoTemplate.aggregate(
    aggregation, "users", GroupCount.class
);
</syntaxhighlight>

=== 索引管理 ===
可以通过注解或编程方式创建索引：
<syntaxhighlight lang="java">
@Document
@CompoundIndex(def = "{'name': 1, 'age': -1}")
public class User {
    // ...
}
</syntaxhighlight>

== 实际案例：电商用户分析 ==

假设我们需要统计用户年龄分布：
<syntaxhighlight lang="java">
Aggregation aggregation = Aggregation.newAggregation(
    Aggregation.group("age").count().as("count"),
    Aggregation.sort(Sort.Direction.ASC, "age")
);
</syntaxhighlight>

== 性能优化 ==

* 使用索引加速查询。
* 批量操作减少网络开销。
* 合理设计文档结构避免嵌套过深。

== 总结 ==

Spring Data MongoDB 极大简化了 Java 应用与 MongoDB 的交互，提供了：
* 面向对象的文档映射。
* 自动化的仓库接口。
* 灵活的查询和聚合功能。

通过结合 Spring 生态的其他组件（如 Spring Boot），开发者可以快速构建高效的 MongoDB 应用。

<mermaid>
graph TD
    A[Spring Data MongoDB] --> B[文档映射]
    A --> C[仓库接口]
    A --> D[查询方法]
    B --> E[@Document, @Id, @Field]
    C --> F[CRUD操作]
    D --> G[方法名约定]
</mermaid>

[[Category:后端框架]]
[[Category:Spring]]
[[Category:Spring数据]]