WebBuilder开发手册.doc

WebBuilder开发手册WebBuilder开发手册目 录1.关于WebBuilder51.1.WebBuilder的构成51.2.WebBuilder运行的原理52.系统的安装、部署和管理62.1.WebBuilder的安装62.1.1.WebBuilder服务器的安装62.1.2.WebBuilder集成开发环境的安装62.2.WebBuilder与集他系统的相互集成72.2.1.把其他系统集成到WebBuilder72.2.2.把WebBuilder集成到别的系统72.3.调试环境的构建72.4.系统部署和权限设置72.5.系统的管理82.6.应用系统的发布82.7.运行环境93.集成开发环境的使用93.1.编辑器的使用103.2.表单设计器的使用104.WebBuilder开发基础114.1.开发我的第一个Hello World程序114.2.系统的目录结构124.3.WebBuilder中的参数机制124.4.系统的配置134.5.运行时变量144.6.xwl文件的body描述144.7.多域运行及初始帐户154.8.系统数据库表说明154.8.1.用户表WB_USER154.8.2.计划任务表WB_TASK154.8.3.日志信息表WB_LOG164.8.4.键值对照表WB_KEY164.8.5.文本表WB_TEXT164.8.6.桌面保存信息表WB_PORTALET165.页面的布局和容器组件175.1.容器组件175.1.1.viewPort显示容器175.1.2.panel面板175.1.3.extWindow窗口175.1.4.extForm表单185.1.5.tab页185.1.6.fieldSet字段集185.2.border边界布局195.3.fit适配布局205.4.absolute绝对位置布局205.5.accordion折叠布局206.数据库的访问216.1.查询组件216.1.1.返回结果集216.1.2.参数的使用216.1.3.事务226.1.4.跨数据库开发226.1.5.示例236.2.数据更新组件236.2.1.数据来源236.2.2.SQL语句的批运行246.3.数据生成器组件246.3.1.生成json格式的数据246.3.2.生成图片数据256.3.3.生成二进制流257.组件的使用257.1.目录257.2.标签267.3.编辑框、数字框和按钮267.4.菜单及工具条267.4.1.菜单制作267.4.2.制作面板嵌入式菜单277.4.3.制作常规菜单277.4.4.制作内置工具条菜单277.5.日期和时间277.6.单选框和复选框287.7.ajax和store组件287.7.1.ajax组件287.7.2.store组件297.8.下拉框297.8.1.通过预置的下拉项使用297.8.2.通过关联store的方式异步引用下拉项297.8.3.通过关联query的方式同步引用下拉项297.8.4.类似于google的异步搜索提示下拉项297.9.树组件307.9.1.同步树307.9.2.异步树307.10.表格317.10.1.同步表格317.10.2.异步表格317.10.3.表格列的定义317.10.4.可编辑表格317.11.组合组件327.11.1.DualList双重列表327.11.2.TreeList树列表327.11.3.ComboTree下拉树327.12.图表327.12.1.Chart图表容器327.12.2.ChartContent图表内容337.13.辅助组件337.13.1.mail电子邮件347.13.2.action动作组件347.13.3.excepter异常触发器347.13.4.validator验证器347.13.5.defaultValue默认值347.13.6.keyMap按键映射347.14.actionFile文件组件357.15.html组件的使用357.15.1.直接添加357.15.2.通过面板的content属性添加358.后台Java与前台JavaScript的使用368.1.调用后台Java类方法368.1.1.Request使用368.1.2.Response使用368.1.3.method组件的属性378.1.4.示例378.2.编写JavaScript和HTML脚本378.2.1.使用脚本组件378.2.2.body的script属性388.2.3.脚本的直接输出388.2.4.系统提供的实用JavaScript函数381. 关于WebBuilder WebBuilder是一款跨平台、数据库和浏览器的Web可视化应用开发和部署平台。使用WebBuilder可开发ERP、OA、CRM、HR、MIS以及电信、银行、政府、企业等各行业的行业应用系统，帮助信息化管理系统的快速构建。WebBuilder帮助提高应用系统的开发效率，并降低成本。完善的基础架构，具有应用系统必须的完整功能，使系统的开发仅需致力于业务的开发。应用开发：提供可视化的WebBuilder集成开发环境，帮助应用系统的快速开发，支持使用Eclipse等开发工具的开发和调试，可以在您原有使用的技术框架上混合使用。应用部署：使用基于Web的资源管理器进行应用的部署，支持Java，.Net，PHP等大部分Web应用的部署。自定义的应用描述语言：基于XML的Web应用描述语言，屏蔽不同平台、数据库和浏览器之间的差异。完整的组件框架：提供应用开发所需的经过封装的前后台组件、开发框架以及应用模块，集成封装了大量Ext、Dhtml、FusionCharts、标准HTML和JS组件以及包括数据访问、流程引擎、计划任务、系统调度等框架在内的Java后台组件。使用WebBuilder可快速开发出功能强大的各种企业级应用系统，也可以基于应用系统平台做深度的二次开发。关于WebBuilder的更多信息请访问：WebBuilder开发交流论坛请访问：/main?action=webbuilder/application/bbs/bbs.xwl1.1. WebBuilder的构成WebBuilder由基于JEE的WebBuilder服务器和基于桌面应用的集成开发环境构成。WebBuilder服务器是运行应用系统的引擎；WebBuilder集成开发环境是开发应用系统的工具，用于生成应用xwl文件。最新版本的WebBuilder服务器和集成开发环境请到如下网址下载：/main?action=webbuilder/application/about/download.xwl1.2. WebBuilder运行的原理WebBuilder使用集成开发环境生成应用描述文件xwl，使用服务器来解析运行xwl文件。xwl文件是基于xml的描述应用逻辑的文件，类似于jsp文件。通过使用集成开发环境可视化地设计应用的前后台组件、属性、方法和事件，来构建整个应用的大部份功能和框架，可以通过编写前台html/JavaScript脚本和后台java代码来扩充业务功能的开发。xwl文件内的组件是有先后顺序的，服务器解析xwl文件时，会根据组件的先后顺序来执行。比如xwl文件内包含query组件和grid组件，其中grid组件引用了query组件，那么query组件必须在grid组件之前定义，可通过编辑器拖动组件来调整同一层次上组件的先后顺序。2. 系统的安装、部署和管理2.1. WebBuilder的安装2.1.1. WebBuilder服务器的安装 安装和配置目标系统的Java运行环境、Web应用服务器和数据库系统； 解压缩WebBuilderServer.zip，并复制META-INF、WEB-INF和WebBuilder三个目录至应用服务器的应用目录，如Tomcat6/webapps/wb； 编辑META-INF/context.xml配置数据库连接信息，如MySql可配置wb_mysql项，Sql Server可配置wb_mssql项，Oracle可配置wb_oracle项。在配置数据库连接信息之前，请确保指定名称的数据库已经创建，如配置目标数据库为wb，则名称为wb的数据库必须已经创建； 复制指定的数据库驱动jar包至应用服务器lib目录，如Tomcat6/lib。MySql复制软件包中的attachment/mysql51.jar(适用5.1，其他版本请自行从网上下载)，Sql Server复制软件包中的attachment/sqljdbc4.jar(适用2008，其他版本请自行从网上下载)，Oracle复制软件包中的attachment/ojdbc14.jar(适用9i，其他版本请自行从网上下载)； 打开webbuilder/system/main.xml，修改main/var/jndi项为实际使用的jndi，如java:comp/env/jdbc/wb_oracle，修改main/var/dbType项为实际使用的数据库类型，如MySql、MsSql(MsSql表示Sql Server)、Oracle等； 配置完以上所有信息后，打开数据库安装和配置程序，配置程序URL地址为：http:/ip:8080/wb/main?action=webbuilder/application/portal/setup.xwl，ip为ip地址；wb为应用目录名称，如安装在ROOT目录，则取消此项；如果端口为80可取消:8080，点击重新安装按钮，即可完成所有的安装；提示：如果安装过程中发生错误，请确认META-INF/context.xml和webbuilder/system/main.xml配置是否正确，如有必要可重启应用服务器再进行安装； 登录系统Portal的地址：http:/ip:8080/wb，首次登录系统管理员用户为：用户名称system，密码system；登录后请阅读首次使用的帮助信息：帮助中心-帮助说明-使用系统-开始使用系统。 2.1.2. WebBuilder集成开发环境的安装 解压缩WebBuilderIDE.rar至指定目录，并运行setup.exe；根据提示进行下一步操作，直至安装完成； 双击桌面WebBuilder图标打开IDE，点击【工具】-【选项】菜单，打开【常规】选项卡配置Web相关信息，在【本地目录】中配置WebBuilder服务器的应用根目录，如：【D: ApacheTomcat6webappswebbuilder】或【D:ProjectwebbuilderWebContent】；在【服务器URL】中配置运行xwl的WebBuilder服务器URL地址，如：【http:/localhost:8080/webbuilder/main】；【Web路径变量】如无特殊情况，请勿配置此项，设置为空即可。2.2. WebBuilder与集他系统的相互集成WebBuilder具有比较灵活的扩展性和伸缩性，能方便地集成其他系统或集成到其他系统。2.2.1. 把其他系统集成到WebBuilder把其他系统的相关文件，如JSP、PHP、HTML等文件部署到WebBuilder的webbuilder/application目录，即可把别的系统无缝地集成到WebBuilder。如其他系统带jar包，复制这些jar包至lib目录。2.2.2. 把WebBuilder集成到别的系统复制WebBuilderServer.zip包中的WEB-INF/lib/webbuilder2.jar文件及其他公共jar文件至目标系统lib目录，复制webbuilder目录至目标系统应用目录；融合WEB-INF/web.xml中的配置信息至目标系统web.xml，以及融合META-INF/context.xml中的配置信息至目标系统context.xml即可。此方法同样适用于部署使用开发工具的调试工程项目。2.3. 调试环境的构建基于WebBuilder的调试环境可通过如下方法构建，具体的构建方式请参考开发论坛中的相关视频。 在指定开发工具如Eclipse中新建web动态项目； 把安装包中的webbuilder目录复制到项目的应用目录； 把安装包中的META-INF/ context.xml中的jndi配置信息融合到项目的context.xml中； 把安装包中的WEB-INF/lib下的jar文件复制到项目的lib目录中，把WEB-INF/web.xml的配置信息融合到项目的web.xml中即可。2.4. 系统部署和权限设置开发完成的xwl、jsp、html等文件，可以部署在webbuilder/application目录。系统会自动根据配置，把所组织的模块展现到portal中，并控制指定模块的访问权限。使用【系统管理】-【资源管理器】可以部署用户开发的应用系统。在【资源管理器】中可以设置应用的指定目录或文件在portal中的显示样式以及角色权限等属性。系统默认带了一些应用模块功能，如果不需要这些模块，可以在资源管理器中设置隐藏或直接删除。建议保留【管理工具】和【系统管理】两大模块。资源管理器中模块的设置在【资源管理器中】配置应用模块的属性时，先选择需要配置的目录或文件，然后点击属性进行设置。当需要移去指定的目录或文件时，可选择【在列表中隐藏】选项或直接删除目录或文件。当需要对目录或文件排序时，可选择属性下拉菜单【排序】。在排序对话框中，可拖动选择的模块来设置排序。当配置指定目录或文件的角色属性时，设置的目录或文件将只允许选择的角色的用户访问。设置目录的权限具有继承性，父目录设置的角色权限将自动赋予所有子目录和文件。角色名称为“管理员”的角色必须保留，其他角色可自行配置或更名。管理员及管理员所属的角色不允许通过【用户管理】来设置角色，管理员用户操作该模块除外。2.5. 系统的管理系统默认提供了应用系统的一些管理功能，这些功能包括管理工具及系统管理功能。管理工具包括：登录用户管理、部门组织、角色管理和模块管理，管理工具的功能适用于所有域。系统管理包括：资源管理器、数据库浏览器、系统日志、系统设置、系统任务等功能。系统管理功能只有系统域用户的管理员才有权限访问。在【资源管理器】中可组织开发的应用模块的架构及权限。通过【管理工具】-【模块管理】也可设置权限。两者的区别在于前者是组织所有域原始默认的应用架构和权限，后者是在当前域对默认设置的补充。新开发的模块必须先在【资源管理器】中进行设置。2.6. 应用系统的发布使用WebBuilder开发的应用是一个标准的JEE Web应用。应用的发布可直接把开发的应用目录下的所有子目录和文件复制到目标系统应用目录，也可以打成WAR包的格式部署到目标系统。如果需要WebBuilder安装用户定义的数据库表，请按照如下步骤操作： 配置webbuilder/data/init目录下的指定数据库类型脚本文件，比如oracle类型编辑名称为oracle.txt的脚本文件；mysql类型编辑名称为mysql.txt的脚本文件；sql server类型编辑名称为mssql.txt的脚本文件。 如果需要导入静态表数据，把文件名称为表名且扩展名为dat的utf-8格式的文本文件或扩展名为xls的Excel文件复制至webbuilder/data/init； 复制安装包中的如下3个文件至webbuilder/application/portal目录。webbuilder/application/portal/setup.xwlwebbuilder/application/portal/installSystem.xwl、webbuilder/application/portal/updateSystem.xwl该3个文件用于首次系统的安装，安装完成之后系统会自动删除这3个文件，以禁止未授权的访问。 压缩应用目录下的所有子目录和文件为zip格式的文件，即可制成应用包。该应用包可通过webbuilder【系统管理】-【系统安装升级】模块安装或升级。2.7. 运行环境操作系统：Windows，Linux，Unix，Apple；JEE环境：JDK 6.0以上；Web服务器：Tomcat，Resin，WebLogic，WebSphere，BES等大部份服务器；浏览器：IE，Firefox，Safari，Opera，Chrome等；数据库：Oracle，MySql，DB2，MS SQL，Sybase，Teradata，JavaDB，PostgreSQL等；内存：最小32MB，推荐大于64MB；存储空间：程序占用空间小于100MB，数据库空间根据数据规模大小而定。3. 集成开发环境的使用WebBuilder集成开发环境是开发WebBuilder应用模块xwl文件的工具，由工具及菜单区、功能面板区和设计及开发区构成。系统采用动态可扩展的插件技术来配置系统，可通过xml文件的配置来改变集成开发环境的功能。 3.1. 编辑器的使用编辑器是设计xwl文件的工具，通过配置属性和事件来描述应用功能。编辑器的左侧视图为组件树，以树状结构的形式来展现xwl文件内的所有组件。右侧的属性和事件编辑器显示当前选择的组件的属性和事件。xwl文件编辑器在左侧组件树中，可复制、剪切和粘贴所选择的组件，也可在同一层级的组件之间相互拖动。点击组件库中的组件，能在当前选择的组件下创建新的指定组件，如需创建同一层级的组件，可通过按CTRL键+点击需添加的组件来实现。xwl文件的编辑可通过【文件】-【打开】菜单选择指定的文件来打开，或直接双击左侧的文件列表来实现。3.2. 表单设计器的使用表单设计器是设计容器组件内的组件绝对坐标位置的工具。当容器的布局为绝对位置布局时，表单设计器设计的组件位置才有效。当容器未显式指定layout布局属性时，启用表单设计器将自动设置该容器的layout属性为absolute。表单设计器仅适用于指定的容器为absolute布局，否则设计的布局将无效。表单设计器表单设计器的打开，可通过选择指定的容器组件，点击工具条上的表单设计器或点击右键选择表单设计器来实现。提示：在使用表单设计器设计时，界面元素之间可适当间隔，避免过于紧凑。这样的设计，一方面保持了界面的美观，另外也屏蔽了不同浏览器之间的细微差异。4. WebBuilder开发基础4.1. 开发我的第一个Hello World程序打开WebBuilder集成开发环境，点击新建按钮，新建一个xwl文件。点击组件箱中的【常用】-【窗口】组件，并设置窗口组件的属性：caption：Hellow World，autoShow：true点击保存按钮，保存该xwl文件至webbuilder/application/mytest/helloWorld.xwl，点击运行按钮，运行该xwl文件。4.2. 系统的目录结构WebBuilder目录是一个标准的JEE Web应用目录，其结构如下：META-INF目录：配置元数据信息的目录，主要包含context.xml文件，可用于配置数据库jndi连接信息。webbuilder目录：webbuilder应用的主目录。 application：部署xwl应用文件的目录，系统会自动把部署在该目录下的目录和文件显示在portal中。 controls：组件库目录，包括ext组件、fc组件、dhtml组件等。 css：样式表目录，在wbstyle.css文件中定义了一些常用的样式，包括字体、图标和链接的样式等。如需扩充样式，比如添加图标等，可编辑该文件。 data：应用的数据目录，存放数据库表的初始化数据和sql脚本等。 download：存放供下载的文件目录。 image：存放图像文件的目录。 script：存放脚本文件的目录，在wbutil.js文件中定义了一些常用的javaScript函数，可在该文件中添加新的javaScript函数。 system：存放系统运行所需的xwl文件以及配置设置文件。在main.xml文件中定义了系统运行的参数及变量，可在此文件中添加用户自定义的变量。WEB-INF目录：存放web相关的文件，主要包含lib文件和class文件。用户开发的jar包可放置在lib子目录。4.3. 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? ，表示转换为日期时间；文本：?charstream.para?，表示转换为文本流；二进制：?blob.param?，表示转换为二进制。更多信息请参考数据库访问组件中sql的使用。4.4. 系统的配置WebBuilder服务器运行的重要参数配置保存在webbuilder/system/main.xml文件中。系统运行时会自动把这些变量存储为内部参数，存储方法是变量名称前加前缀“sys.”。如title变量的值为“abc”，则内部参数“#sys.title#”为“abc”。注意引用时在变量名称前加“sys.”。系统预定义的一些变量说明如下： title：表示应用的标题； version：应用的当前版本号； portal：系统默认的入口模块URL地址； needLogin：指定系统默认是否需要登录，各个模块可以单独设定是否登录； needRole：指定系统是否需要按角色验证当前用户对各个模块是否具有访问权限； recordSession：是否记录所有用户的在线状态； exceptionType：指定系统默认的异常类型，各个模块可以单独设定异常类型，设置为system表明使用系统的异常提示； logType：指定系统默认记录日志的类型，各个模块可以单独设定，设置为none表明不记录日志； startTask：是否在应用启动时自动启动计划任务，使用此设置可在集群模式下停止自动运行冗余的计划任务； loginVerify：登录时是否需要输入验证码； runMode：系统运行模式，可为open，normal和debug，分别表示开放，标准和调试模式； sessionTimeout：用户需要重新登录的不活动时长，单位为秒； ajaxTimeout：默认进行ajax操作时的等待时长，单位为毫秒，大数据量操作的时间溢出系统将自动进行判断； jndi：默认采用的jndi； dbType：系统默认使用的数据库类型，如Oracle, MySql, MsSql, DB2, Sybase, Teradata, JavaDB, PostgreSQL或其它指定的类型等； fieldSeparator：指定导入或导出的文本文件，字段之间的分隔符，如“Tab”、“,”、“ ”、“-”等； longDateFormat：导出文件时，包含时间的日期输出格式，如yyyy-MM-dd HH:mm:ss； shortDateFormat：导出文件时，不包含时间或时间部分为零的日期输出格式，如yyyy-MM-dd； webFile：指定需要解析为web文件的文件扩展名列表，否则将视为下载对象； pagedRecords：指表格中分页显示数据时，允许分页的的最多记录数； bufferSize：处理upload文件时，默认的缓存大小，单位为字节； charset：字符使用的编码，默认为根据操作系统。注：系统内部均采用utf-8编码，字符编码仅作用于系统外部，比如导出至文本文件时的字符编码。 fileCharset：输出文件名使用的编码，默认为根据操作系统。 dbCharset：数据库系统采用的编码，默认为根据操作系统。用户可在main.xml中配置自定义的变量，在引用时通过加前缀“sys.”即可访问。比如定义了变量myJndi，值为“java:comp/env/jdbc/myjndi”，在query的jndi属性中设置为#sys.myJndi#即可引用。4.5. 运行时变量系统运行时的变量是系统运行期间自动生成的变量，通过读取这些变量的值，能方便系统的开发。这些运行时的变量存储在系统的内部变量当中。运行时变量包括以下一些常用的变量：sys.path：web应用的根目录地址；sys.ip：当前请求的客户端ip地址；sys.now：当前请求的日期和时间，包括时间部分；sys.nowdate：当前请求的日期，未包括时间部分；sys.user：当前请求用户的用户名称；sys.role：当前请求用户的角色；sys.scope：当前请求用户的域名称；sys.realname：当前请求用户的姓名；sys.code：当前请求用户的编号；sys.lastaccess：当前请求用户的上次登录时间；sys.rootpath：当前用户的私有文件空间根目录；sys.runmode：当前系统的运行模式。4.6. xwl文件的body描述每个xwl文件都具有一个默认的根节点body，body是对xwl文件的整体信息的描述。当xwl文件作为前台页面文件时body可以对页面的文档体进行描述，比如引用指定的js文件、css文件，创建页面的框架html脚本，声明全局的js变量和函数等。另外，也可设置body其他一些属性来设置xwl的行为，比如是否需要登录，是否需要记录日志，初始化时执行的方法，发生异常时执行的方法等。系统默认xwl文件的body是自动创建的，当指定的xwl文件不需要生成body时，可以设置createBody属性为false。此种情况往往用于xwl文件返回json、xml、图片或纯文本的内容。比如xwl需要返回json：para1:123,para2:abc，系统默认是创建body的，返回的内容可能包含html的body信息，为了返回纯json脚本，必须设置createBody属性为false。如果xwl文件为页面文件，可在headerScript属性中定义全局的函数和变量，在extLastScript属性中定义页面加载完成之后执行的JavaScript脚本。4.7. 多域运行及初始帐户域是指独立运行的空间，webbuilder支持多域运行。在同一系统中，不同的域可以设置不同的权限体系、角色设置和组织架构等。多域为不同空间的用户群在同一系统内的独立运行创造了条件，比如可以为多个不同的单位用户群在同一系统中运行。系统默认创建了3个域，包括系统域system、测试域test和设置域webbuilder。系统域所在的管理员具有最多的权限，用户开发的应用系统可在system域内进行组织。webbuilder域中的一些设置将影响所有域用户的一些默认设置，比如可以通过webbuilder用户登录来修改默认的portal界面。系统域内包括用户system，默认密码为system。webbuilder域内包括用户webbuilder，默认密码为webbuilder。test域内包括用户test，默认密码为空，以及其他多个用户。系统默认禁止除system域以外的域用户的运行，如需允许所有域用户的运行可设置【系统管理】-【运行模式】为开放模式。4.8. 系统数据库表说明WebBuilder自带了一些系统运行所需的数据库表，这些表用于存放用户信息、日志信息、系统任务等重要信息。这些表的结构说明如下：4.8.1. 用户表WB_USER存放用户的相关信息。该表包括如下一些重要字段：USERNAME：用户名称，用于登录的用户名称；PASSWORD：登录密码，密码经过加密处理；ROLENAME：设置的角色信息，包含一个或多个角色；SCOPE：指定用户属于哪个域；CODE：编号信息。4.8.2. 计划任务表WB_TASK系统提供计划任务功能，可通过【系统管理】-【系统任务】来添加和管理计划任务。该表字段信息描述如下：TASK_NAME：计划任务名称； INTERVAL_TYPE：周期类型； INTERVAL_EXPRESS：周期表达式； START_DATE：起始时间； END_DATE：结果时间； CLASS_NAME：运行的任务类名称； STATUS：任务状态； DESCRIPTION：任务描述信息。4.8.3. 日志信息表WB_LOG日志信息用于存放自动记录的系统运行日志。该表字段信息描述如下： LOG_DATE：日志信息记录日期； USERNAME：当前登录用户名称信息； IP：当前登录用户IP地址； MSG：日志信息； LOG_TYPE：日志类型。4.8.4. 键值对照表WB_KEY键值对照表用于配置键值的对照信息，该对照信息可用于某些组件的键值字动转换。比如配置1-男，2-女的性别信息，可直接用于下拉框、列转义或统计分析转义。该表字段信息描述如下： KEY_TYPE：键值对的类型名称； KEY_ID：编号信息； KEY_TEXT：编号对应的值信息4.8.5. 文本表WB_TEXT文本表用于存储指定域特定类别的文本信息，系统把一些以特定文本组织的数据存储于该表中。比如部署组织结构文本、角色组织结构文本、系统的公告文本等均存储于该表中。该表字段信息描述如下：SCOPE：域名称；KEY_NAME：存储文本的名称标识；KEY_VALUE：存储文本的内容。4.8.6. 桌面保存信息表WB_PORTALET系统的Portal桌面提供基于用户的个性化设置和保存功能。用户的桌面信息保存在该表中。该表字段信息描述如下：USERNAME：用户名称；TITLE：标题；HEIGHT：高度；FILENAME：模块文件名称；ICON_CLS：样式；PX：X坐标信息；PY ：Y坐标信息；COLLAPSED：是否收缩。5. 页面的布局和容器组件页面的布局是指整个页面框架的划分和设计，良好的布局不仅能美化页面，还能使页面自适应客户端的不同分辨率。可使用页面容器组件来实现对页面的布局。常用的页面容器组件包括viewPort（显示容器）、panel（面板）、extWindow（窗口）、extForm（表单）、tab（Tab页）、fieldSet（字段集）。页面的布局通过设置容器的layout属性来指定容器内组件的布局。5.1. 容器组件容器组件不仅能放置和容纳其他页面组件，还能实现布局、美化和方便管理的效果。5.1.1. viewPort显示容器基于浏览器对象的显示容器，显示区域为整个浏览器客户区。ViewPort组件是对Ext中的Viewport组件的封装。该组件不能嵌套使用，如需嵌套布局，请使用panel组件。5.1.2. panel面板面板是最常用的容器，用于构建面向应用的用户界面。面板的作用非常广泛：可作为组件的容器；可以作为布局容器使用；可以作为装饰或功能性地使用，比如在tbar添加工具条等。panel组件包含tbar顶部条、body面板体和bbar底部条3部分。在tbar和bbar中可关联菜单工具条组件。可以设置panel的title属性来指定标题，frame属性来指定是否生成背景色，border属性来指定是否生成边框，collapsible来指定是否可收缩。5.1.3. extWindow窗口窗口继承自panel面板组件，提供可拖动的交互式界面。可通过设置窗口的dialog属性来指定窗口是否为对话框模式，默认窗口为对话框模式。窗口为对话框时，可编写onOk事件来表示点击确定按钮执行的事件。窗口即可以用作对话框，也可以用作显示的容器。通常窗口以模式对话框使用，系统默认的窗口样式为隐藏的模式对话框。如果要自动显示窗口，设置autoShow属性为true；如果设置为非对话框，设置dialog为false；窗口为对话框时，可编写onOk事件来表示点击确定按钮执行的事件。onShow事件为窗口显示时的事件，可在该事件中初始化窗口或设置焦点等。可以在窗口的onHide事件使用extResetAllControlsValue(window)来重置窗口内组件的值。5.1.4. extForm表单带有默认form布局及文件提交功能的面板容器。通常情况下在WebBuilder内对于数据的提交可使用Ajax组件，因此使用表单组件提交数据不常用。例外情况是提交带有上传文件的数据必须采用extForm表单组件。上传文件时，需要在表单组件下添加text编辑框组件，并设置text组件的inputType属性为file；设置Ajax组件form属性为extForm组件名称，设置isUpload为true，设置Ajax指向的后台处理模块body的exceptionType属性为mark；然后调用Ajax控件同名的函数，如ajax()来提交表单内所有的数据。5.1.5. tab页分页显示内容的容器。通过在tab页组件下添加panel面板组件，来实现Tab控件的各页，每个panel即为每个页。必须设置panel组件的caption属性来设置各页的标题。tab页的设计5.1.6. fieldSet字段集归纳组件的容器，可用于把业务功能相近的一组组件放在一个容器中。容器会生成边框及控制伸缩的按钮。字段集效果图5.2. border边界布局边界面局是一种将页面划分为若干个区的布局方式，一个页面可划分为东、南、西、北和中5个区域。其中，中间区域是必须包含的，其他区域可根据需要选择划分。边界布局效果图除中间区外，其他各个区可设置默认的宽度或高度，中间区是自动适配的。同时可设置除中间区之外的其他区容器组件的split属性为true，来生成指定区域可拖拉的分割条。每个被划分的区可以单独设置包含border边界布局在内的任意布局，从而实现布局的嵌套设计。示例： 新建xwl文件，添加viewPort显示容器组件； 在viewPort组件下添加3个panel面板组件，设置name属性分别为northPanel，westPanel和centerPanel；设置caption属性分别为北、西和中；设置region属性分别为north、west和center；设置frame属性都为true；设置northPanel和westPanel的split属性为true，collapsible属性为true； 点击保存按钮，保存至webbuilder/application/myTest/border.xwl，然后点击运行按钮。示例设计图5.3. fit适配布局适配布局指定子组件布满整个容器，通常此布局下的子组件仅有一个。可通过设置容器的layout属性为fit，指定首个子组件布满容器。示例： 新建xwl文件，添加viewPort显示容器组件，设置layout属性为fit； 在viewPort组件下添加panel面板组件，设置panel的caption属性分“fit布局”，设置frame属性为true； 点击保存按钮，保存至webbuilder/application/myTest/fit.xwl，然后点击运行按钮。5.4. absolute绝对位置布局该布局指定容器的子组件通过坐标来定位，并可指定各个子组件的宽度和高度。当设置容器的layout属性为absolute时，可通过表单设计器来调整子组件的位置和大小。示例： 新建xwl文件，添加panel面板组件； 点击panel右键，选择表单设计器（如未设置layout属性，系统将自动设置layout为absolute）； 通过表单设计器，调整panel至合适大小，并添加标签和编辑框至表单设计器（点击要添加的组件再在表单设计器的任意位置点击即可添加）； 点击保存按钮，保存至webbuilder/application/myTest/absolute.xwl，然后点击运行按钮。5.5. accordion折叠布局折叠布局类似于outlook中的功能条面板，通过点击来展开其中的一个面板，并折叠其他面板。accordion布局示例： 打开前例的border.xwl文件； 选择westPanel，设置layout属性为accordion，在westPanel下添加3个面板组件，分别设置标题为面板1、面板2和面板3； 点击保存按钮，保存至webbuilder/application/myTest/accordion.xwl，然后点击运行按钮。6. 数据库的访问在webbuilder中封装了3个数据库访问组件来提供对数据库的快速访问。6.1. 查询组件提供通过sql语句对数据库表、视图、存储过程和函数等的访问能力。查询仅执行sql语句，本身不返回任何结果，但可把查询组件绑定到前端组件来显示数据。通过设置sql属性，来指定查询执行的sql语句；设置jndi属性来指定数据库连接jndi，如果为空则默认取自sys.jndi变量。如果sql语为update类语句，比如insert、update和delete语句，须设置type属性为update，如果sql语句执行存储过程和函数设置type属性为execute。6.1.1. 返回结果集执行查询时如果返回结果集，比如执行select语句，系统会自动生成一个名称为name属性的ResultSet对象，并放在内部参数中（request的attribute属性中）。当查询返回结果集时，默认使用单向游标，即查询结果只能使用一次；当一个查询需要多次使用，比如绑定到多个组件时，需设置fastMode为false。可设置loadData属性为true，指定自动获取query第一行各字段的值，并存储在内部参数中。可通过【查询名称.字段名称】来访问各个字段的值，例如通过#query.myField#来获取query组件第一行myField的值。6.1.2. 参数的使用在sql语句中分为两种参数：一类是输入参数，一类是输出参数。输入参数可引用内部参数或外部参数。输入参数输入参数的格式为：?name?或??系统能根据对象的类型自动指定输入类型，也可以在变量名前加类型的方式显式地强制指定类型以转换不同类型的数据，比如?integer.textEdit?表示把前台传来的textEdit控件的值转换成整数，类似地还有：VARCHAR：表示字符串；INTEGER：表示整数；SMALLINT：表示短整数；BIGINT：表示长整数；FLOAT：表示浮点数；DOUBLE：表示双精度浮点数；TIMESTAMP：表示日期时间类型的时间戳；DATE：表示日期；TIME：表示时间；CHARSTREAM：表示字符串流；超过一定长度的varchar类型，比如text等；BLOB：表示二进制对象。输出参数输出参数往往用于有参数返回时的sql调用，