
「这个平台能做什么」是个很容易被答坏的问题。常见的回答是「低代码、可视化、提效、AI 赋能」,四个词都对,但听完还是不知道自己那个需求能不能落地。对一套企业级快速开发平台,更靠谱的回答方式只有一种:列出它能交付的系统类型,并指出每一类在平台里对应的现成模块——能抄的东西在哪、代码长什么样、边界在哪。
Geejing WebBuilder 的目录结构恰好支持这种回答方式。它不是一堆抽象概念的 SDK,而是一个自带完整应用、示例库和管理后台的运行环境:modules/ 下有 303 个非压缩 .xwl 模块文件,system/controls.json 定义 83 个组件,system/config.json 有 90 项系统配置,system/url.json 收了 47 条短路由,system/ai/models.txt 预置 12 个模型。下面按「要交付什么」而不是「有哪些功能」来清点,每一节都给出可以直接打开对照的路径。
要交付的东西 | 平台里的落点 | 现成模块举例 |
|---|---|---|
数据台账、增删改查系统 |
|
|
审批流、会签、报销 |
|
|
图表、大屏、报表 |
|
|
Excel / Word 导入导出与邮件 |
|
|
实时消息、在线协同 |
|
|
AI 生成、AI SQL、文档解析 |
|
|
存量系统对接与数据服务 |
|
|
权限、日志、定时任务等运维后台 |
|
|
自定义代码与第三方前端组件 |
|
|
这张表的重点不是「有」,而是每一格都能点开看源码。对评估一套企业级快速开发平台的人来说,这比功能列表更有用:功能列表描述的是承诺,目录里能打开的模块描述的是已经做过的东西。
企业里数量最多的需求,本质是「把某张业务表变成能查、能改、能导出的页面」。平台自带的 modules/example/crud/ 就是完整答案:staff.xwl 是主界面,actions.xwl 是服务端脚本,edit-grid.xwl 做行内编辑,edit-dialog.xwl 做弹窗表单,select-staff.xwl 做通用选择器,dict-edit-grid.xwl 演示字典翻译。
服务端脚本的结构很能说明问题:
// 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 整理(省略图形坐标与端口信息),它的关键部分长这样:
{
"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 服务要维护,流程定义和界面模块放在同一棵文件树里。
数据录进去之后,下一件事是「给别人看、给别人用」。modules/example/basic/dashboard.xwl 里排了九个 Wb.Chart 实例,组件底层适配 ECharts,也能在服务端渲染 SVG;这对应经营驾驶舱、设备状态看板、日报大屏。
真正体现企业级快速开发平台成色的,是 Office 这一组。modules/example/tools/ 下五个工具示例各管一段:
// 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 把附件和正文一起发出去:
// 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 的写法很典型:
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 后台。
第六类是近两年最常被问到的。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 条目整理(密钥以占位符表示):
{
"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 条短路由则让常用入口不必暴露一长串物理路径:
{
"/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 模块,几乎覆盖了一套企业应用该有的全部周边:
模块 | 管什么 | 模块 | 管什么 |
|---|---|---|---|
| 用户与组织 |
| 角色与权限 |
| 90 项系统配置 |
| 日志与审计 |
| 定时任务 |
| 流程管理 |
| 在线 SQL 控制台 |
| 数据源连接配置 |
| 在线会话 |
| 运行时信息 |
| IP 黑名单 |
| 控制台 |
| 文件管理 |
| AI 模型配置 |
| 版本与授权信息 |
这件事的说服力在于「自举」:权限、字典、日志、调度、数据源、在线用户,这些能力不是文档里的条目,而是同一套组件、同一种 .xwl 文件格式、同一个设计器做出来的可运行页面。你能改平台自带的权限模块,就能用同样的手法改自己的业务模块;admin/ 下 65 个模块文件、sys/ 下 50 个、dev/ 下 36 个 IDE 模块,都是可以直接翻的参考资料。对一套企业级快速开发平台而言,这种「平台自身由同一套机制构建」的结构,比任何功能对比表都更能说明它到底能做什么。
诚实地列清楚不擅长什么,同样属于「能做什么」的答案。
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 删除。