ContentGrabbingJi/ContentGrabbingJi-framework-api
LamGC 4492287632
[Document] Framework-API 补充 content 文档;
[Document] AbstractMessageEvent 补充 content 文档;
2021-03-14 19:36:28 +08:00
..
src [Document] Framework-API 补充 content 文档; 2021-03-14 19:36:28 +08:00
pom.xml [Move] Core, Event-API(Event), Framework-API, Template-API(Template) 更改模块名以规范命名; 2021-02-13 13:09:16 +08:00
Quick-Start.md [Add][Update][Document] Framework-API, Project 更新Readme文档内容; 2020-12-19 14:08:27 +08:00
Readme.md [Add][Update][Document] Framework-API, Project 更新Readme文档内容; 2020-12-19 14:08:27 +08:00
StandardPlatform.md [Add] Framework-API 增加内置标准化 Platform Enum, 添加标准化平台信息文档; 2021-03-01 09:08:48 +08:00

ContentGrabbingJi-framework-api

为了确保 ContentGrabbingJi 能够为多个平台的用户提供服务, 我为 ContentGrabbingJi 设计了一套框架抽象层Framework Abstraction Layer,简称 FAL)。
FAL 用于为各个平台的框架提供统一的接口,保证了 ContentGrabbingJi 对各个平台框架的兼容性, 并由 ContentGrabbingJi 统一管理其生命周期

备注:当 QQ 机器人发生大动摇CoolQ 机器人因特别原因关闭,导致大量机器人平台接连关闭)的时候, 我更加确信了创建 FAL 的决定是正确的。

开始开发一个框架组件: Quick-Start

框架的生命周期

ContentGrabbingJi 的框架系统基于 Pf4j
框架的生命周期将由 ContentGrabbingJi 管理。
由于框架系统基于 Pf4j所以框架拥有以下生命周期

  • CREATED:框架已被识别并确定可以进行加载(此时框架文件已被读取并成功解析了 FrameworkDescriptor
  • DISABLED:框架虽然被加载,但由于某些原因(例如不符合系统最低版本要求,被手动禁用)而被禁用。
  • RESOLVED:框架已经成功加载并做好了启动的准备,此时框架已经初始化完成。
  • STARTED:框架的 start() 被成功调用,视为已启动,此时框架可开始接收处理用户的使用请求。
  • STOPPED:框架的 stop() 被成功调用,视为已停止, 此时框架应该停止接收处理请求,关闭与处理相关的功能(例如断开平台连接,停止与第三方机器人平台的通讯等)。
  • FAILED:框架启动时出错。

由于 ContentGrabbingJi 并不能完全控制框架的运行和启停, 因此希望框架能够遵守生命周期(如果平台的连接无法关闭,或关闭后重新连接会很麻烦,那么你可以停止向框架投递事件,以达到停止工作的效果)。