适配MongoDB 5.0的RestHeart版本选择及升级相关疑问咨询

1. 适配MongoDB 5.0的RestHeart版本选择 #

RestHeart 5.0及以上版本均支持MongoDB 5.0。考虑到你当前使用的是3.6版本，建议直接升级到最新稳定版7.x——该版本不仅兼容MongoDB 5.0，还提供了更完善的功能、性能优化及长期维护支持。

2. RestHeart 3.6升级至7.0的破坏性变更（除Hooks失效外） #

除了你提到的自定义bidclips.restheart.hooks无法使用外，还存在以下关键破坏性变更：

• 配置体系重构：原有的配置文件格式（如.properties或旧版YAML）完全替换为新的rhconfig.yml，配置项路径、结构及参数规则均有大幅调整，例如数据库连接、安全策略的配置逻辑完全不同。
• Java版本要求提升：RestHeart 7.x要求Java 11或更高版本，而3.6仅需Java 8，需同步升级运行环境。
• API接口调整：部分端点的路径、请求参数及响应格式发生变化，例如集合操作的过滤参数、认证端点的返回结构等，旧客户端请求可能需要适配。
• 插件系统彻底重写：旧版的Hook机制被全新的插件框架替代，所有自定义扩展（包括Hook）都需要基于新的插件接口重构。
• 认证授权体系变更：原有的安全管理模块被替换为更灵活的认证链机制，权限配置、角色管理的方式完全改变，旧的认证逻辑无法直接复用。
• 废弃功能移除：移除了3.x版本中标记为过时的API、端点及配置项，例如部分旧的查询语法、废弃的扩展点。

3. org.restheart.metadata.hooks.Hook的替代方案 #

在RestHeart 7.x中，原Hook的功能可通过拦截器（Interceptor）或自定义插件实现：

• 若需实现请求前后的逻辑处理（如参数校验、响应修改），可实现org.restheart.plugins.Interceptor接口，根据需求选择针对全局请求或特定资源/方法的拦截器，通过rhconfig.yml注册启用。
• 若需实现更复杂的业务逻辑扩展，可基于RestHeart的插件框架开发自定义插件，利用其提供的扩展点（如资源处理、事件监听等）完成原Hook的功能。

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