如何基于Spring Boot实现MySQL Document Store文档实体存取？

实体类定义规则 #

• 无传统关系型ORM注解依赖：实体为标准POJO类，不需要添加@Table、@Column这类与关系表结构绑定的注解，仅要求类字段名与文档JSON的字段名一一对应，支持嵌套对象、集合、枚举值等复杂结构，序列化/反序列化逻辑直接复用项目全局的Jackson ObjectMapper配置即可
• 主键字段约定：文档的默认主键为_id，实体类中声明String类型的id字段做映射，写入操作时不需要手动赋值，MySQL会自动为新文档生成全局唯一的UUID格式主键
• 索引配置与实体解耦：针对需要做快速查询的文档二级索引，不需要在实体类上加索引注解，在Collection初始化阶段通过API直接指定索引名称、对应JSON路径即可，不会侵入实体类定义

业务服务层开发实现方案 #

• 连接配置复用：已完成MySQL 8基础连接配置的前提下，仅需补充X协议端口（默认33060）的连接参数即可复用现有账号权限，不需要额外搭建独立的文档存储数据源
• 容器Bean初始化：在Spring配置类中初始化X DevAPI的Session实例，绑定指定的业务schema名，将Session注册为容器单例Bean
• 文档存取操作逻辑：
  • 写入流程：从Session句柄获取对应业务的文档Collection实例，直接将POJO对象传入add()方法，驱动会自动完成对象到BSON格式的序列化，完成文档持久化，不需要手动拼接JSON字符串
  • 查询流程：基于Collection的find()方法构建匹配条件，支持普通字段过滤、嵌套字段匹配、分页、排序等能力，查询返回的结果集可直接通过内置映射器转换为对应实体类对象，不需要手动解析JSON结构
  • 更新/删除流程：先通过查询条件定位到目标文档集，全量更新使用replace()方法传入更新后的实体对象，局部字段修改使用modify()方法指定要修改的JSON路径和新值，删除操作使用remove()方法传入匹配条件即可完成，操作粒度和原生NoSQL数据库完全一致

注意事项：若实体类包含日期、大数字等特殊类型字段，需要提前对齐全局Jackson的序列化规则，避免写入的文档字段格式与查询时的解析规则不匹配

内容的提问来源于stack exchange，提问作者Juan M.