第1页 / 共30页
第2页 / 共30页
第3页 / 共30页
第4页 / 共30页
第5页 / 共30页
第6页 / 共30页
第7页 / 共30页
第8页 / 共30页
WebBuilder开发手册.doc
1.1.WebBuilder运行的原理
1.系统的安装、部署和管理
1.1.WebBuilder的安装
1.2.创建示例应用
1.3.WebBuilder与其他系统的相互集成
1.3.1.把其他系统集成到WebBuilder
1.3.2.把WebBuilder集成到别的系统
1.4.调试环境的构建
1.5.系统的目录结构
1.6.WebBuilder中的参数机制
1.7.系统的配置
1.8.运行时变量
1.9.xwl文件的module描述
1.10.系统数据库表说明
1.10.1.用户表WB_USER
1.10.2.计划任务表WB_TASK
1.10.3.日志信息表WB_LOG
1.10.4.键值对照表WB_KEY
2.页面的布局和容器组件
2.1.容器组件
2.1.1.viewPort显示容器
2.1.2.panel面板
2.1.3.extWindow窗口
2.1.4.extForm表单
2.1.5.tab页
2.1.6.fieldSet字段集
2.2.border边界布局
2.3.fit适配布局
2.4.absolute绝对位置布局
2.5.accordion折叠布局
3.数据库的访问
3.1.查询组件 Query
3.1.1.返回结果集
3.1.2.参数的使用
3.1.3.事务
3.1.4.示例
3.2.数据生成器组件dataProvider
3.2.1.生成json格式的数据
3.2.2.生成图片数据
3.2.3.生成文件下载
4.组件的使用
4.1.目录 folder
4.2.标签 label
4.3.编辑框、数字框和按钮 text number button
4.4.菜单及工具条
4.4.1.菜单制作
4.4.2.制作面板嵌入式菜单
4.4.3.制作常规菜单
4.4.4.制作内置工具条菜单
4.5.日期和时间
4.6.单选框和复选框
4.7.ajax和store组件
4.7.1.ajax组件
4.7.2.store组件
4.8.下拉框
4.8.1.通过预置的下拉项使用
4.8.2.通过关联store的方式异步引用下拉项
4.8.3.通过关联query的方式同步引用下拉项
4.8.4.类似于google的异步搜索提示下拉项
4.9.树组件
4.10.表格
4.10.1.表格列的定义
4.10.2.可编辑表格
4.11.图表
4.11.1.keyMap按键映射
5.后台Java与前台JavaScript的使用
5.1.调用后台Java类方法
5.1.1.Request使用
5.1.2.Response使用
5.1.3.method组件的属性
5.1.4. 示例
5.2.ServerScript使用
5.3.编写JavaScript和HTML脚本
5.3.1.使用脚本组件
5.3.2.系统提供的实用JavaScript函数
WebBuilder 开发手册
开发手册
- 1 -
WebBuilder 开发手册
目 录
1.1.
1.1.
1.2.
1.3.
1.4.
1.5.
1.6.
1.7.
1.8.
1.9.
1.10.
WebBuilder 运行的原理 ............................................................................................4
1. 系统的安装、部署和管理........................................................................................................4
WebBuilder 的安装 ....................................................................................................4
创建示例应用 ............................................................................................................ 4
WebBuilder 与其他系统的相互集成 ....................................................................... 5
1.3.1. 把其他系统集成到 WebBuilder....................................................................... 5
1.3.2. 把 WebBuilder 集成到别的系统...................................................................... 5
调试环境的构建........................................................................................................6
系统的目录结构........................................................................................................6
WebBuilder 中的参数机制 ........................................................................................7
系统的配置................................................................................................................ 8
运行时变量................................................................................................................ 9
xwl 文件的 module 描述...........................................................................................9
系统数据库表说明 ..................................................................................................10
1.10.1. 用户表 WB_USER .......................................................................................... 10
1.10.2. 计划任务表 WB_TASK.................................................................................. 10
1.10.3. 日志信息表 WB_LOG .................................................................................... 11
1.10.4. 键值对照表 WB_KEY .................................................................................... 11
2. 页面的布局和容器组件 .......................................................................................................... 11
容器组件 .................................................................................................................. 12
viewPort 显示容器 .......................................................................................... 12
panel 面板 ........................................................................................................ 12
extWindow 窗口 .............................................................................................. 12
extForm 表单 ................................................................................................... 13
tab 页................................................................................................................ 13
fieldSet 字段集.................................................................................................14
border 边界布局 .......................................................................................................14
fit 适配布局..............................................................................................................15
absolute 绝对位置布局 ............................................................................................16
accordion 折叠布局................................................................................................. 16
3. 数据库的访问 .......................................................................................................................... 17
查询组件 Query......................................................................................................17
3.1.1. 返回结果集......................................................................................................17
3.1.2. 参数的使用......................................................................................................17
3.1.3. 事务 .................................................................................................................. 19
3.1.4. 示例 .................................................................................................................. 19
数据生成器组件 dataProvider................................................................................ 19
3.2.1. 生成 json 格式的数据..................................................................................... 20
3.2.2. 生成图片数据 ..................................................................................................21
3.2.3. 生成文件下载 ..................................................................................................21
4. 组件的使用.............................................................................................................................. 21
目录 folder...............................................................................................................21
标签 label................................................................................................................ 21
2.1.1.
2.1.2.
2.1.3.
2.1.4.
2.1.5.
2.1.6.
2.2.
2.3.
2.4.
2.5.
3.1.
2.1.
3.2.
4.1.
4.2.
- 2 -
WebBuilder 开发手册
4.3.
4.4.
4.7.1.
4.7.2.
4.5.
4.6.
4.7.
编辑框、数字框和按钮 text number button......................................................... 21
菜单及工具条 ..........................................................................................................22
4.4.1. 菜单制作 ..........................................................................................................22
4.4.2. 制作面板嵌入式菜单......................................................................................22
4.4.3. 制作常规菜单 ..................................................................................................23
4.4.4. 制作内置工具条菜单......................................................................................23
日期和时间.............................................................................................................. 23
单选框和复选框......................................................................................................23
ajax 和 store 组件 .....................................................................................................24
ajax 组件 .......................................................................................................... 24
store 组件......................................................................................................... 24
下拉框...................................................................................................................... 25
4.8.1. 通过预置的下拉项使用 ..................................................................................25
4.8.2. 通过关联 store 的方式异步引用下拉项 ........................................................25
4.8.3. 通过关联 query 的方式同步引用下拉项 ...................................................... 25
4.8.4. 类似于 google 的异步搜索提示下拉项 .........................................................25
树组件...................................................................................................................... 25
表格 .......................................................................................................................... 26
4.10.1. 表格列的定义 ..................................................................................................26
4.10.2. 可编辑表格......................................................................................................26
图表 .......................................................................................................................... 26
keyMap 按键映射 ............................................................................................27
5. 后台 Java 与前台 JavaScript 的使用...................................................................................... 27
调用后台 Java 类方法.............................................................................................27
Request 使用 .................................................................................................... 27
5.1.1.
Response 使用 ..................................................................................................28
5.1.2.
5.1.3.
method 组件的属性.........................................................................................28
5.1.4. 示例 .................................................................................................................. 28
ServerScript 使用 .....................................................................................................28
编写 JavaScript 和 HTML 脚本 ..............................................................................29
5.3.1. 使用脚本组件 ..................................................................................................29
5.3.2. 系统提供的实用 JavaScript 函数 ...................................................................30
5.2.
5.3.
4.8.
4.9.
4.10.
4.11.
5.1.
4.11.1.
- 3 -
WebBuilder 开发手册
1.1.WebBuilder 运行的原理
WebBuilder 使用集成开发环境生成应用描述文件 xwl，使用服务器来解析运行 xwl 文件。
xwl 文件是基于 xml 的描述应用逻辑的文件，类似于 jsp 文件。
通过使用集成开发环境可视化地设计应用的前后台组件、属性、方法和事件，来构建整
个应用的大部份功能和框架，可以通过编写前台 html/JavaScript 脚本和后台 java 代码来扩充
业务功能的开发。
xwl 文件内的组件是有先后顺序的，服务器解析 xwl 文件时，会根据组件的先后顺序来
执行。比如 xwl 文件内包含 query 组件和 grid 组件，其中 grid 组件引用了 query 组件，那么
query 组件必须在 grid 组件之前定义，可通过编辑器拖动组件来调整同一层次上组件的先后
顺序。
1. 系统的安装、部署和管理
1.1.WebBuilder 的安装
1、安装任意类型的一款 JAVA Web 应用服务器（如 Tomcat）和数据库（如 MySql），并且
在 Web 应用服务器中创建一个 JNDI 链接串，以访问所创建的数据库。
2、解压缩下载的安装包 webbuilder.zip，并把 wb 目录部署到 Web 应用服务器。例如，您
使用 Tomcat， 那么可直接复制 wb 目录至 Tomcat 的 webapps/wb 目录。
3、打开浏览器并访问 [http://ip:port/wb]，使用安装向导来完成 WebBuilder 的安装。例如，
访问 http://localhost:8080/wb
4、使用管理员帐户登录到系统，管理员默认用户名称和密码均为 admin。
1.2. 创建示例应用
下面我们创建一个空白的窗口模块来演示集成开发环境的使用：
1.1. 打开浏览器并登录 WebBuilder，访问[开发套件]->[集成开发环境]模块；
1.2. 在顶部工具条中，点击新建模块按钮，在弹出窗口中设置模块标题并点击
- 4 -
WebBuilder 开发手册
确定按钮，创建一个新的模块；
1.3. 在集成开发环境右侧控件列表中双击或拖动[General]->[Window]控件，把
该控件添加至模块中；
1.4. 设置 Window 控件的 autoShow 属性为 true，设置 title 属性为 Hello World；
1.5. 在顶部工具条中，点击运行按钮，就可以看到我们刚才创建的空白窗体。
1.3.WebBuilder 与其他系统的相互集成
WebBuilder 具有灵活的扩展性和伸缩性，能方便地集成其他系统或集成到其他系统。
1.3.1. 把其他系统集成到 WebBuilder
把其他系统的相关文件，如 JSP、PHP、HTML 等文件部署到 WebBuilder 的应用目录，
即可把别的系统无缝地集成到 WebBuilder。如其他系统带 jar 包，复制这些 jar 包至 lib 目录。
1.3.2. 把 WebBuilder 集成到别的系统
复制 WebBuilder 软件包中的 WEB-INF/lib/webbuilder6.jar 文件及其他公共 jar 文件至目
标系统 lib 目录，复制 webbuilder 目录至目标系统应用目录；融合 WEB-INF/web.xml 中的配
置信息至目标系统 web.xml，以及融合 META-INF/context.xml 中的配置信息至目标系统
context.xml；安装 WebBuilder 或复制数据库中 WB_开头的所有表至目标系统。此方法同样
适用于部署使用开发工具的调试工程项目。
- 5 -
WebBuilder 开发手册
1.4. 调试环境的构建
基于 WebBuilder 的调试环境可通过如下方法构建：
在指定开发工具如 Eclipse 中新建 web 动态项目；
把安装包中的 webbuilder 目录复制到项目的应用目录；
把安装包中的 META-INF/ context.xml 中的 jndi 配置信息融合到项目的 context.xml
中；
把 安 装 包 中 的 WEB-INF/lib 下 的 jar 文 件 复 制 到 项 目 的 lib 目 录 中 ， 把
WEB-INF/web.xml 的配置信息融合到项目的 web.xml 中即可。
系 WebBuilder 开发基础
1.5. 系统的目录结构
WebBuilder 目录是一个标准的 JavaEE Web 应用目录，其结构如下：
META-INF 目录：配置元数据信息的目录，主要包含 context.xml 文件，可用于配置数据库
jndi 连接信息。
webbuilder 目录：webbuilder 应用的主目录。
controls：组件库目录，包括 ext 组件、cm 组件和其他组件等。
css：样式表目录，在 style.css 文件中定义了一些常用的样式，包括字体、图标和
链接的样式等。如需扩充样式，比如添加图标等，可编辑该文件。
data：应用的数据目录，存放数据库表的初始化数据和 sql 脚本等。
docs：系统附带的文档目录。
- 6 -
WebBuilder 开发手册
images：存放图像文件的目录。
script：存放脚本文件的目录，在 wb.js 文件中定义了一些常用的 javaScript 函数，
可在该文件中添加新的 javaScript 函数。
WEB-INF 目录：存放 web 相关的文件，主要包含 lib 文件和 class 文件。用户开发的 jar 包
可放置在 lib 子目录。
1.6.WebBuilder 中的参数机制
WebBuilder 中的参数分为两种，包括外部参数和内部参数。
外 部 参 数 ： 外 部 参 数 存 储 于 HttpServletRequest 对 象 的 Parameters 中 ， 可 通 过
HttpServletRequest 的 getParameter 方法获取。
内部参数：内部参数存储于 HttpServletRequest 对象的 Attributes 中，内部参数可通过
HttpServletRequest 的 getAttribute 方法获取。
在 WebBuilder 的 xwl 文件的任何位置，包括任何属性和事件中，可通过两种方式方便
地引用参数，这两种方式分别为无条件替换引用和 jdbc sql 参数引用：
无条件替换引用：该方式使用大括号加井号的方式来引用参数，系统会自动无条件替换
名称所指的参数。如设置 panel 的 caption 属性为：【条件设置 – {#para#}】，系统首先会在内
部参数中查找名称为 para 的参数，如未找到，则在外部参数中查找名称为 para 的参数，如
仍未找到则返回空，如找到名称 para 所指的参数值为“abc“，则替换{#para#}为 abc，最终
结果为【条件设置 – abc】。
jdbc sql 参数引用：该方式使用大括号加问号的方式来引用参数，该引用方式仅适用于
sql 语句。如设置 query 的 sql 语句为：【select * from table where field={?para?}】，系统首先
会在内部参数中查找名称为 para 的参数，如未找到，则在外部参数中查找名称为 para 的参
数，如仍未找到则返回空，如找到名称 para 所指的参数值为“abc“，则把{?para?}转换为
sql 参数并设置值为 abc。
如果 para 为非字符串类型的参数，可通过在参数名称前加前缀的方式来转换参数的类
型，常用的类型有：
整数：{?integer.para?}，表示转换为整数；
双精度浮点数：{?double.para?} ，表示转换为双精度浮点数；
日期时间：{?timestamp.para?} ，表示转换为日期时间；
- 7 -
WebBuilder 开发手册
文本：{?charstream.para?}，表示转换为文本流；
二进制：{?blob.param?}，表示转换为二进制。
更多信息请参考数据库访问组件中 sql 的使用。
1.7. 系统的配置
WebBuilder 服务器运行的重要参数配置保存在系统变量中。系统运行时会自动把这些
变量存储为内部参数，存储方法是变量名称前加前缀“sys.”。如 title 变量的值为“abc”，则
内部参数“{#sys.title#}”为“abc”。注意引用时在变量名称前加“sys.”。
系统预定义的一些变量说明如下：
title：表示应用的标题；
version：应用的当前版本号；
portal：系统默认的入口模块 URL 地址；
loginRequired：指定系统默认是否需要登录，各个模块可以单独设定是否登录；
logType：指定系统默认记录日志的类型，各个模块可以单独设定，设置为 none 表明不
记录日志；
startTask：是否在应用启动时自动启动计划任务，使用此设置可在集群模式下停止自动
运行冗余的计划任务；
loginVerify：登录时是否需要输入验证码；
debugMode：指定系统是否为调试模式；
sessionTimeout：用户需要重新登录的不活动时长，单位为秒；
ajaxTimeout：默认进行 ajax 操作时的等待时长，单位为毫秒，大数据量操作的时间溢
出系统将自动进行判断；
jndi：默认采用的 jndi；
dbType：系统默认使用的数据库类型，如 Oracle, MySql, MsSql, DB2, Sybase, Teradata,
JavaDB, PostgreSQL 或其它指定的类型等；
language：指定系统使用的语言种类；
cacheCheckModified：指定缓存时是否检查文件修改状态；
cacheEnabled：指定是否采用缓存机制，缓存后系统会把资源文件缓存到内在中以加快
访问速度。
- 8 -
相关推荐
2023年江西萍乡中考道德与法治真题及答案.doc
2012年重庆南川中考生物真题及答案.doc
2013年江西师范大学地理学综合及文艺理论基础考研真题.doc
2020年四川甘孜小升初语文真题及答案I卷.doc
2020年注册岩土工程师专业基础考试真题及答案.doc
2023-2024学年福建省厦门市九年级上学期数学月考试题及答案.doc
2021-2022学年辽宁省沈阳市大东区九年级上学期语文期末试题及答案.doc
2022-2023学年北京东城区初三第一学期物理期末试卷及答案.doc
2018上半年江西教师资格初中地理学科知识与教学能力真题及答案.doc
2012年河北国家公务员申论考试真题及答案-省级.doc
2020-2021学年江苏省扬州市江都区邵樊片九年级上学期数学第一次质量检测试题及答案.doc
2022下半年黑龙江教师资格证中学综合素质真题及答案.doc
