插件开发

快速开始

目的

所有功能都可以以插件的形式扩展,常见的场景用插件组合的方式但可完成基础搭建。通过扩展插件的形式降低了模块之间的耦合度,提高了复用率

扩展能力

模块分布:服务端、客户端

  • 服务端
    数据表和字段
    资源和操作
    中间件
    事件
    自定义命令行
    国际化

  • 客户端
    路由管理和插件配置页
    样式和主题
    Provider 和上下文
    UI Schema
    国际化

服务端

一、生命周期
image.png
二、数据表和字段
2.1 核心概念
  • Collection「数据表」
  • Collection Field 字段
  • Field Type 字段类型
    Field Type 包括 Attribute Type 和 Association Type 两类
  • Field Component
  • Field Interface
    Basic、Choices、Media、Date & Time、Relation、Advanced、System info
2.2 Collection 协议

Collection 是 NocoBase 的中枢,是一种用于描述数据结构(数据表和字段)的协议


image.png

Collection 协议主要包括 CollectionOptions 和 FieldOptions 两部分

  • FieldOptions
    通用的字段参数
interface FieldOptions {
  name: string;
  type: string;
  hidden?: boolean;
  index?: boolean;
  interface?: string;
  uiSchema?: ISchema;
}
2.3如何配置数据表?

有三种方式配置数据表


image.png
  • 通过界面配置数据表
    业务数据一般建议使用界面配置,NocoBase 平台提供了常规的表格界面和图形化配置界面
  • 在插件代码里定义
  • 通过 REST API 管理数据表
2.4 关系字段配置
2.5 字段扩展
2.6 Collection 模板
三、资源与操作

与 RESTful 中资源的概念相同,是系统中对外提供的可操作的对象,可以是数据表、文件、和其他自定义的对象。

1、 数据表自动映射为资源
2、 内置默认的资源操作
3、 对资源自定义操作
4、 操作的参数合并顺序与策略

  • 简单数据资源的默认操作:
  • list:查询数据表中的数据列表
  • get:查询数据表中的单条数据
  • create:对数据表创建单条数据
  • update:对数据表更新单条数据
  • destroy:对数据表删除单条数据
  • 关系资源除了简单的 CRUD 操作,还有默认的关系操作:
  • add:对数据添加关联
  • remove:对数据移除关联
  • set:对数据设置关联
  • toggle:对数据添加或移除关联
  • 自定义 Action

  • Action 参数(参数主要有三个来源)
    1、Action 定义时默认参数
    2、客户端请求携带
    3、其他中间件预处理

  • 自定义资源
    数据型的资源还分为独立资源和关系资源:
    1、独立资源:<collection>
    2、关系资源:<collection>.<association>

三、客户端

一、生命周期
image.png
  • 页面路由及扩展
  • 样式和主题
  • HTTP 请求
  • Provider 组件
  • UI Schema
    — UI Schema
    — Schema渲染
    — 扩展Schema 组件
    — Schema组件库
    — Designable 设计器
    — SchemaToolbar 工具栏
    — Schemalnitializer 初始化器
    — SchemaSettings 设置器
内置的初始化器
image.png
内置的设置器
image.png

四、其他

  • 构建(自定义打包配置)
  • 语言列表
  • 依赖管理
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 217,826评论 6 506
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 92,968评论 3 395
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 164,234评论 0 354
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 58,562评论 1 293
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 67,611评论 6 392
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 51,482评论 1 302
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,271评论 3 418
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 39,166评论 0 276
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,608评论 1 314
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,814评论 3 336
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,926评论 1 348
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,644评论 5 346
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 41,249评论 3 329
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,866评论 0 22
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,991评论 1 269
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 48,063评论 3 370
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,871评论 2 354

推荐阅读更多精彩内容