xFrame框架formDefine配置方法

xframe3.8.2下载地址：
http://download.csdn.net/detail/qixf1011/4447460

FormDefine详细配置手册
1. 适用人群
FormDefine是xFrame框架中最具特色的功能。若需大幅度提升开发效率，务必熟悉本手册中的操作过程。
本文以车辆管理系统为例，介绍FormDefine配置方式。
2. 准备工作
 已安装Oracle8i以上版本（含Oracle8i）；
 已安装tomcat；
 已安装eclipse，建议同时安装myeclipse；
 xFrame框架已配置完毕，且正常工作；
 已安装后toad或sqldev等oracle前台工具；
3. 配置过程
2.1 创建表
在车辆管理系统中，需要使用一个表t_car_fee来存放车辆交费记录。
T_car_fee表

 在创建Table时，请填写各字段的comments，它们是显示在界面的必要信息，对FormDefine是必需的。
 每个表中都需要createby,createdate,lastmodifyby,lastmodifydate, status,id共六个字段，如果是子表还需要填写baseid字段关联主表。
创建表格之后，使用soft/soft（系统初始用户和密码）登录到Oracle前台工具（本文指sqldev），如下图。右击Procedures，点击Test，运行一次。



图 1刷新comments的存储过程
若此Procedure显示为编译错误，可通过sys账号执行授权：
grant select on sys.dba_objects to soft;
再用soft登录即可。
2.2 进入FormDefine
使用管理员账号登录系统，验证码全是英文，且不分大小写。


图 2 xFrame登录
登录成功页码如下图：


图 3 xFrame登录成功后界面
2.3 配置FormDefine
a) Form级
直接输入下面地址进入配置页，如下图所示：
http://yourip:8080/xframe/formAction.do?actionFlag=preFormDefine


图 4 FormDefine工具首页
在表名中填写t_car_fee，按回车，并按下图填写表单级信息：

当前主要使用的模板有如下几类：
模板名 跳转路径 功能
formDefine /formAction.do 新增、查看、修改
queryFormDefine /query.do 新增、查看、删除
multiFormDefine /formAction.do 修改
queryMultiFormDefine /query.do 审核
若需要创建如下图所示的查询界面，填写模板queryFormDefine。


图 5配置查询界面的效果一例
层样式表示界面展示几列，选择3列表示三个字段并列展示。缺省值为2。
b) Field级
填写表名按回车后，将带出如下图所示的界面，它们是创建表时指定的字段及comments。


图 6 Field级配置1



图 7 Field级配置2
说明：
序号：数字类型，“可见”字段将按此数字从小到大展示。
只读：在界面上此字段不可修改，“可见”时生效。
可空：非必填字段。若不可空，界面显示此字段后有一个红色“*”。
查询：使用queryFormDefine模板时生效。
缺省查询：在查询条件中显示。
类型：必需指定。同一字段，在不同模板中可以有几种类型。如在查看界面中，除textarea外，所有字段均可以采用text类型。
下拉选择：当类型为select时，即为下拉列表时，下拉项的名称。定义为check_status之后，需要在基础数据表中新增check_status项，具体操作见脚注 。
缺省值：对下拉选择项，指定一个默认选项。
关联方法：用户自定义的方法名，需要继承BaseAction并实现。由于涉及二次开发编码部分，此处不深入说明。
显示文本：通常使用comments即可。
小数位：用来指定数字类型的长度。
c) Button级
界面上需要按钮时，点击“新增”，如下图：



图 8 Button级配置
按钮文本当前只支持“保存”、“关闭”、“新增”、“修改”、“删除”、“查看”、“审核”、“驳回”、“同意”等名称，且不能填写空格。
跳转路径：表示点击按钮后执行的动作。可参照DB中附带的FormButton表配置。
路径参数：在页面之间跳转时，通过queryString传递，采用“名称1=名称1,名称2=名称2”的形式。若本页面中的baseid需要传到主页中作为id使用，则填写id=baseid。此处是二次开发的扩展点。
按钮类型：主要有两类，即查询界面中的datalist行级button，以及界面中保存类型。
2.4 修改FormDefine配置
若需要修改已配置好的FormDefine，需提供formId，并在地址栏直接输入下面地址进入配置页，如下图所示。xxx表示formId。
http://yourip:8080/xframe/formAction.do?actionFlag=preFormDefine&formId=xxx
修改操作步骤与初始配置相同。
2.5 配置功能菜单
 设置功能名称
用管理员登录，进入系统管理->功能模块管理->点击<新增>，找出上面配置的formId及跳转类型，参照下图填写：


图 9 新增功能点
功能名称：新增车辆缴费。
功能地址URL：注意区分大小写。
 将功能点加入菜单
用管理员登录，进入系统管理->操作菜单配置->子节点配置。如下图所示：


图 10 配置菜单项1
点击“新增车辆缴费”，加入右侧模块，点提交。


图 11 配置菜单项2
点击提交，退出。
 授权给角色
用管理员登录，进入系统管理->人员权限配置。点击“权限配置”，将功能点授权角色。


图 12 将功能点授权给角色
 将用户加入角色
用管理员登录，进入系统管理->人员权限配置。点击“人员配置”，将用户加入角色。


图 13 将人员加入角色
4. 验收效果
配置完毕后，点击左侧cache管理，分别刷新base和FormDefine两类缓存,再退出IE，重新使用已授权的用户（或管理员）登录。可看到上面配置的效果。


图 14 生成页面效果图

小结：
 使用xFrame框架，配置出来的界面简洁美观，5分钟即可配置一个复杂的界面，且能满足MIS系统的基本应用需求。
 xFrame稳定性强，易扩展。
 xFrame学习成本非常低，二次开发非常容易。
若需要学习在此基础上的二次开发，请参见《xFrame框架二次开发手册》。[size=large]

评论

1 楼 wood123 2012-07-27  

二次开发手册呢？下载包中没有。