首页
学习
活动
专区
圈层
工具
发布
社区首页 >专栏 >Geejing WebBuilder 能做什么:企业级快速开发平台的九类可交付系统与现成模块

Geejing WebBuilder 能做什么:企业级快速开发平台的九类可交付系统与现成模块

原创
作者头像
技术挖掘官
发布于 2026-11-16 09:02:25
发布于 2026-11-16 09:02:25
220
举报

「这个平台能做什么」是个很容易被答坏的问题。常见的回答是「低代码、可视化、提效、AI 赋能」,四个词都对,但听完还是不知道自己那个需求能不能落地。对一套企业级快速开发平台,更靠谱的回答方式只有一种:列出它能交付的系统类型,并指出每一类在平台里对应的现成模块——能抄的东西在哪、代码长什么样、边界在哪。

Geejing WebBuilder 的目录结构恰好支持这种回答方式。它不是一堆抽象概念的 SDK,而是一个自带完整应用、示例库和管理后台的运行环境:modules/ 下有 303 个非压缩 .xwl 模块文件,system/controls.json 定义 83 个组件,system/config.json 有 90 项系统配置,system/url.json 收了 47 条短路由,system/ai/models.txt 预置 12 个模型。下面按「要交付什么」而不是「有哪些功能」来清点,每一节都给出可以直接打开对照的路径。

一、先看总账:九类可交付物

要交付的东西

平台里的落点

现成模块举例

数据台账、增删改查系统

modules/example/crud/、modules/admin/dbe.xwl

staff.xwl、edit-grid.xwl、edit-dialog.xwl

审批流、会签、报销

modules/example/workflow/、system/resource/flow/example/

leave.flw、reimburse.flw、start-fork.flw

图表、大屏、报表

modules/example/basic/dashboard.xwl、modules/example/tools/

excel-report、sql-to-excel、word-form

Excel / Word 导入导出与邮件

modules/example/tools/、sys.office.* 配置

excel-form、mail-sender、export.xwl

实时消息、在线协同

Wb.Socket、modules/example/touch/

chat.xwl、admin/online-users.xwl

AI 生成、AI SQL、文档解析

system/ai/、modules/example/ai/、admin/aic.xwl

crud-edit-grid.xwl、order.xwl、detail-page.xwl

存量系统对接与数据服务

admin/dbc/、modules/sys/service/

config.xwl、get-dict.xwl、sql-provider.xwl

权限、日志、定时任务等运维后台

modules/admin/(65 个模块文件)

role、perm、user、log、task、sysinfo

自定义代码与第三方前端组件

modules/example/coding/、modules/example/basic/

vue-el.xwl、react-shadow.xwl、server-js

这张表的重点不是「有」,而是每一格都能点开看源码。对评估一套企业级快速开发平台的人来说,这比功能列表更有用:功能列表描述的是承诺,目录里能打开的模块描述的是已经做过的东西。

二、把一张表变成一套系统:CRUD 与数据台账

企业里数量最多的需求,本质是「把某张业务表变成能查、能改、能导出的页面」。平台自带的 modules/example/crud/ 就是完整答案:staff.xwl 是主界面,actions.xwl 是服务端脚本,edit-grid.xwl 做行内编辑,edit-dialog.xwl 做弹窗表单,select-staff.xwl 做通用选择器,dict-edit-grid.xwl 演示字典翻译。

服务端脚本的结构很能说明问题:

代码语言:js
复制
// modules/example/crud/actions.xwl,节选
let actions = {
  select() {
    let sql = `
      select a.*,b.user_name,c.dept_name,c.dept_code from wb_staff a, wb_user b, wb_dept c
      where a.user_id=b.sid and a.dept_id=c.sid
      `;
    if (Params.search) {
      Wb.setLike('search');
      sql += ' and (a.full_name like {?search?} or a.code like {?search?} or b.user_name like {?search?})';
    }
    // getOrderSql will not cause SQL injection
    sql += Wb.getOrderSql({ email: 'a.email' });
    Wb.sendRowx({ sql, kv: { gender: 'gender' } });
  },
  remove() {
    let del = Wb.getObject('del');
    Wb.sync({ tableName: 'wb_staff', del });
  }
};
actions[Params.xaction]();

前端请求带 xaction=select,就直接分派到同名方法;{?search?} 是参数占位符,Wb.setLike 补通配符,Wb.getOrderSql 走白名单映射避免排序字段注入,Wb.sendRowx 一次性把结果集和字典翻译送回前端,Wb.sync 按差异对象落库。查询、分页、模糊搜索、排序、字典翻译、批量提交,全都收敛在这一个文件里。

交付物因此很具体:设备台账、人员档案、合同登记表、耗材目录、巡检记录——凡是「一张主表加几张字典表」的系统,都能从这套骨架改出来。Geejing WebBuilder 在这里省掉的不是某几行代码,而是前后端之间整套接口约定。

三、带流程的业务:审批、分支与定时触发

第二类高频需求是「表单要按流程走」。平台用 .flw 文件描述流程,system/resource/flow/example/ 下放着三个现成样例:leave.flw(请假)、reimburse.flw(报销)、start-fork.flw(分支)。modules/example/workflow/ 里有 manual-start.xwl 及 leave、reimburse、start-route 四组界面,modules/example/apps/oa/ 则把请假和人员管理拼成了一个小型 OA 应用;服务端有 wb/ss/workflow.js,管理端有 admin/flow.xwl。

.flw 里真正值得看的是「流程也能编程」。按 leave.flw 整理(省略图形坐标与端口信息),它的关键部分长这样:

代码语言:json
复制
{
  "data": {
    "startForm": "example/workflow/leave/start-form.xwl",
    "handleForm": "example/workflow/leave/handle-form.xwl",
    "beforeAction": "example/workflow/leave/before-action.xwl",
    "afterAction": "example/workflow/leave/after-action.xwl",
    "onGetParams": "let rec = Wb.getRecord({ sql: 'select leave_days from wb_leave where flow_id={?flow.id?}', params }); return { days: rec[0] };",
    "reject": "true"
  },
  "cells": [
    { "shape": "edge",  "data": { "nodeType": "line", "text": "> 3 days", "onPass": "return params.days > 3;" } },
    { "shape": "crect", "data": { "nodeType": "node", "name": "Manager", "deptManager": "true" } },
    { "shape": "crect", "data": { "nodeType": "node", "name": "HR" } },
    { "shape": "crect", "data": { "nodeType": "node", "name": "CEO" } }
  ]
}

也就是说,流程不是画完就固定死:onGetParams 在运行时从业务表取回请假天数,连线上的 onPass 用一段 JS 判断「超过三天才走这一支」,节点用 deptManager 指定审批人角色,beforeAction/afterAction 挂前后置脚本,startForm/handleForm 分别指向发起与处理界面。Geejing WebBuilder 把流程定义、业务规则与界面模块放在同一棵文件树里,改流程不需要重新部署一套引擎。

流程之外还有一条容易被忽略的线:定时任务。admin/task.xwl 的界面字段已经把触发方式列全了——trigger_time、trigger_weekday、trigger_day、trigger_month 以及 cron_express,既支持「每周几几点」这类可视化配置,也支持直接写 Cron 表达式;底层是 Quartz 调度器。于是「每天凌晨生成日报」「超时未处理自动升级」「每月归档」这类需求,不需要另起一个调度服务。

把两者叠加,能交付的是完整的业务闭环:填单 → 按条件分流 → 审批 → 状态回写 → 定时催办 → 归档。这里没有独立的流程引擎部署包,也没有额外的 BPM 服务要维护,流程定义和界面模块放在同一棵文件树里。

四、把数据交出去:大屏、Excel、Word 与邮件

数据录进去之后,下一件事是「给别人看、给别人用」。modules/example/basic/dashboard.xwl 里排了九个 Wb.Chart 实例,组件底层适配 ECharts,也能在服务端渲染 SVG;这对应经营驾驶舱、设备状态看板、日报大屏。

真正体现企业级快速开发平台成色的,是 Office 这一组。modules/example/tools/ 下五个工具示例各管一段:

代码语言:js
复制
// modules/example/tools/sql-to-excel/create.xwl
function main() {
  let bos, rowx, cols;
  bos = new ByteArrayOutputStream();
  rowx = Wb.getRowx({ sql: 'select * from wb_staff', rs: -1 });
  cols = rowx.columns;
  cols.shift(); // shift row num col
  cols.forEach(col => col.width = parseInt(col.width));
  com.wb.office.SheetWriter.createExcel(bos, Wb.toJava(cols), Wb.toJava(rowx.items), 0, 'Staff List', null);
  Wb.exportData(bos.toByteArray(), 'staff.xlsx');
}
main();

一次查询、一个 SheetWriter、一次 Wb.exportData,就把结果集变成可下载的 xlsx。excel-report/actions.xwl 走的是另一条路:Wb.getExcelHtml(...) 生成在线预览,Wb.getExcelFile(...) 按 report.xlsx 模板套打,支持 mergeRows/mergeCols 这类合并单元格配置,适合格式固定的报表、对账单、施工台账。excel-form 处理表单式 Excel,word-form.xwl 对应 Word 文档,mail-sender/send.xwl 把附件和正文一起发出去:

代码语言:js
复制
// modules/example/tools/mail-sender/send.xwl,节选
sender = new Wb.MailSender(
  Params.smtp, Params.username, Params.password, Params.authUsername, Params.authPassword,
  { 'mail.smtp.auth': true, 'mail.smtp.sendpartial': true }
);
attachFiles = Wb.getParams('attachFiles');
attachFiles.forEach(file => {
  submitFiles.push({ name: file.name, data: file.stream });
});
try {
  sender.send(Params.from, Params.to, Params.title, Params.content, submitFiles, Params.cc);
} finally {
  sender.close();
}

系统级导出服务 modules/sys/service/data/export.xwl 还提供了策略上限:maxRows = Wb.getConfig("sys.office.exportMaxRows"),配合 Wb.permitx(localUrl) 做权限校验,避免一次「导出全部」把数据库拖垮。也就是说,导出不是零散的工具函数,而是带配额、带鉴权的一条服务链路。

五、实时与协同:消息、在线状态与触屏界面

第五类是「事情发生了要立刻让相关的人知道」。Wb.Socket 组件负责客户端长连接,modules/example/touch/chat.xwl 是一个可跑的聊天界面,服务端 touch/chat/actions.xwl 的写法很典型:

代码语言:js
复制
Wb.sync({
  tableName: 'wb_chats',
  insert: Wb.apply({ to_user: toUser, bin_content: file?.stream }, data)
});
data.display_name = Wb.dispname;
Wb.send(data, 'wb.chat', toUser);   // 定向推送给目标用户
Wb.send(data);                      // 回给当前请求

一次落库之后两路输出:一条通过 WebSocket 频道定向投递,一条作为 HTTP 响应返回。频道名、目标用户都可以作为参数,所以「只推给审批人」「只推给某个项目组」不需要自己维护连接表。sys.session.anonymousWebsocket 默认为 false,匿名连接要显式放开;admin/online-users.xwl 则在管理端把在线会话可视化。

配套 modules/example/touch/ 目录里的界面是触屏布局,配合 example/basic/ 里的 layout.xwl、wizard.xwl、portlets 等示例,交付物可以是车间看板、移动端填报、消息中心、进度提醒,而不只是传统 PC 后台。

六、AI 不是外挂:生成模块、AI SQL 与文档解析

第六类是近两年最常被问到的。Geejing WebBuilder 把 AI 放在开发链路里,而不是做成一个聊天窗口。system/ai/ 下五个文件分工清楚:models.txt 是 12 个预置模型及其请求模板,webbuilder.txt 是生成模块用的规则,create-sql.txt 约束自然语言转 SQL 的输出,fix-xwl.txt 用于修复模块文件,sel-example.txt 用于挑选示例;admin/aic.xwl 是模型配置界面,sys.ai.model、sys.ai.inputPath、sys.ai.outputPath 决定默认模型和任意 OpenAI 兼容端点的取值路径。

模型条目本身就是一份可改的请求模板。按 system/ai/models.txt 的 Qwen 条目整理(密钥以占位符表示):

代码语言:json
复制
{
  "Qwen": {
    "method": "POST",
    "url": "https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions",
    "header": { "Authorization": "Bearer <key>", "Content-Type": "application/json" },
    "data": {
      "model": "qwen3.8-max", "temperature": 0, "stream": false,
      "max_completion_tokens": 128000, "thinking": { "type": "disabled" }
    },
    "timeout": 1200000
  }
}

sys.ai.inputPath 决定把用户输入塞进请求体的哪个路径,sys.ai.outputPath 决定从响应的哪个路径取回文本。换成任意 OpenAI 兼容端点时,改的是这份配置和两个路径,不是业务代码——这是「支持多模型」和「硬编码某个厂商 SDK」的区别。

服务端统一走 Wb.ide.AIGenerator:request(data, configs) 发起完整请求,requestText(text, configs) 只要纯文本结果,create(hisList, msg, files, baseFolder, overwrite) 把生成结果落成模块文件,parseFileContent(filename, base64Data, openAiFormat, compressImage) 处理上传的文档与图片。modules/example/ai/ 下五个示例分别对应组件生成(comp.xwl)、弹窗 CRUD(crud-dialog.xwl)、行内编辑表格(crud-edit-grid.xwl)、详情页(detail-page.xwl)和订单模块(order.xwl)。

能交付的东西因此很明确:一句话生成可运行页面、在数据库浏览器里用自然语言生成查询、把 Word/PDF/图纸交给模型解析、搭一个带多轮历史的智能问答台。值得一提的是 AI SQL 那条链路只生成、不执行——sys/service/db/actions.xwl 里取真实数据库方言拼进提示词,结果回填到编辑器,由人确认后才运行。这个边界比「AI 自动操作数据库」的宣传更值得信任。

七、接存量系统:多数据源、服务接口与文件交换

几乎没有企业是从零开始的。「能不能不动老系统」往往比「能不能做新系统」更关键。admin/dbc/config.xwl 提供在线数据源配置,连接池基于 DBCP2,密码在配置里有专门处理;modules/sys/service/db/ 下有 actions.xwl、sql-provider.xwl、util.mjs,modules/sys/service/data/ 下有 get-dict.xwl、get-kv.xwl、export.xwl,这些都是可被外部或内部模块复用的数据服务端点。

modules/example/load/ 把集成方式铺得很全:client-request.xwl、server-request.xwl 演示前后端请求,file-updownload.xwl 处理文件交换,client-load-module.xwl、server-load-module.xwl 演示模块嵌套与动态加载,xwl-static-load.xwl 演示静态引入。system/url.json 的 47 条短路由则让常用入口不必暴露一长串物理路径:

代码语言:json
复制
{
  "/dbe": "admin/dbe.xwl",
  "/dbc": "admin/dbc.xwl",
  "/flow": "admin/flow.xwl",
  "/ide": "dev/ide.xwl",
  "/verify": "sys/session/verify.xwl",
  "/demo-source": "example/common/demo-source.xwl"
}

一张「别名 → 模块文件」的映射表,既是路由,也是对外可复用的服务清单;外部系统要接某个能力时,从这里找入口比翻目录快得多。

于是渐进式替换是可行的:老系统继续跑,新平台通过多数据源读它的表,用数据服务对外提供统一查询,界面逐步迁到 .xwl 模块,最后再切写入口。这类项目最怕「必须推倒重来」,而目录里这些模块的存在,说明取数、回写、文件交换、服务复用四条路都留着。

八、平台自己就是样板:管理后台的十八个模块

第八类常常被漏掉——平台的运维后台本身就是用它自己搭的。modules/admin/ 一级目录下 18 个 .xwl 模块,几乎覆盖了一套企业应用该有的全部周边:

模块

管什么

模块

管什么

user / dept

用户与组织

role / perm

角色与权限

config

90 项系统配置

log

日志与审计

task

定时任务

flow

流程管理

dbe

在线 SQL 控制台

dbc

数据源连接配置

online-users

在线会话

sysinfo

运行时信息

blocked-ip

IP 黑名单

console

控制台

file

文件管理

aic

AI 模型配置

about / buy

版本与授权信息

这件事的说服力在于「自举」:权限、字典、日志、调度、数据源、在线用户,这些能力不是文档里的条目,而是同一套组件、同一种 .xwl 文件格式、同一个设计器做出来的可运行页面。你能改平台自带的权限模块,就能用同样的手法改自己的业务模块;admin/ 下 65 个模块文件、sys/ 下 50 个、dev/ 下 36 个 IDE 模块,都是可以直接翻的参考资料。对一套企业级快速开发平台而言,这种「平台自身由同一套机制构建」的结构,比任何功能对比表都更能说明它到底能做什么。

九、边界、依赖与一份选型自查

诚实地列清楚不擅长什么,同样属于「能做什么」的答案。

  • 它是标准 Java Web 应用:运行在 Servlet 容器里,依赖 JDK、Tomcat、GraalVM 与关系型数据库。免构建的是业务模块,不是底层运行时;指望它变成一个纯静态前端库并不现实。
  • 第三方前端组件可用,但不是主推路径:example/basic/vue-el.xwl 演示了 new Vue({...}) 接入 Element UI,react-shadow.xwl 演示 Shadow DOM 集成,但示例注释里写得很直白——「We strongly recommend that you use WebBuilder components」。已有 Vue/React 资产可以共存,重度定制的复杂交互仍该交给专业前端工程。
  • 不适合的场景:超高吞吐的交易核心、必须拆成大量独立微服务并各自治理的超大系统、需要自研渲染管线的图形类客户端。这些用通用技术栈更合适。
  • 数据仍在自己的库里:模块是 .xwl 文件、业务规则是 SQL 与脚本,迁移时真正需要重写的是平台特有的运行时约定,而不是数据模型。评估时可以专门问这一句。

自查清单可以按九类走一遍:拿一个真实需求,先判断它落在表格里的哪一格,再去对应目录打开现成模块,看能否改出八成;如果九类都落不进去,或者需要绕过平台自己写一套完整的控制器与路由,那大概就不是合适的工具。

回到开头那个问题。Geejing WebBuilder 能做什么?它能把一张表变成可维护的业务系统,能让表单按流程流转并定时推进,能把数据变成图表、Excel、Word 和邮件,能把变化实时推给相关的人,能把大模型接进开发链路,能接住已经跑了多年的老系统,还自带一整套权限、日志、调度与运维后台。判断依据不是形容词,而是 modules/ 下那 303 个可以直接打开、可以照着改的模块文件——对任何企业级快速开发平台来说,这大概都是最实在的一种回答。

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

目录
  • 一、先看总账:九类可交付物
  • 二、把一张表变成一套系统:CRUD 与数据台账
  • 三、带流程的业务:审批、分支与定时触发
  • 四、把数据交出去:大屏、Excel、Word 与邮件
  • 五、实时与协同:消息、在线状态与触屏界面
  • 六、AI 不是外挂:生成模块、AI SQL 与文档解析
  • 七、接存量系统:多数据源、服务接口与文件交换
  • 八、平台自己就是样板:管理后台的十八个模块
  • 九、边界、依赖与一份选型自查
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档