LamGC/ContentGrabbingJi
1
0
Fork 0
mirror of https://github.com/LamGC/ContentGrabbingJi.git synced 2025-04-29 22:27:33 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity
ed8e4701e8
ContentGrabbingJi/ContentGrabbingJi-framework-api
History
LamGC 4c384cc991
[Add][Update][Document] Framework-API, Project 更新Readme文档内容; 
[Update] Project/README.md 更新一些贡献内容, 修正文档问题;
[Update] Framework-API/Readme.md 补充框架生命周期内容;
[Add] Framework-API/Quick-Start.md 添加尚未完成的快速开始教程文档, 计划在 3.0.0 正式版发布时完成;
2020-12-19 14:08:27 +08:00
..
src [Add] Framework-API 添加 BotCodeFunction 用于描述 BotCode; 2020-12-18 20:06:43 +08:00
pom.xml [Update][Dependency] Framework-API 更新 Pf4j 版本; 2020-11-22 11:00:00 +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

Readme.md

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 并不能完全控制框架的运行和启停， 因此希望框架能够遵守生命周期（如果平台的连接无法关闭，或关闭后重新连接会很麻烦，那么你可以停止向框架投递事件，以达到停止工作的效果）。