CZTZ-JavaEE开源应用开发平台介绍之二(Webwork+spring+hbernate+acegi)

CZTZ-JavaEE开源应用开发平台介绍(2)

第二部分 平台开发示例（上）
王保政
QQ:29803446
Msn:baozhengw999@hotmail.com


本文介绍如何利用应用开发平台实现一个后台增删改查的应用。以B2C网站的个人用户帐号为例。
企业应用的用户有B2B类用户（如企业内网用户），也有B2C类用户，即通过公司的外网门户注册的个人帐号，例如公司的网上商城注册会员。
本例的个人用户帐号表为eas_b2cuser，主要数据库字段有:
obj_id varchar(40) 唯一ID字段(隐藏字段，不需要用户输入数据，系统自动生成ID)
user_id varchar(30) 登录帐号
user_name varchar(30) 用户名称
is_enabled int 是否可用,0表示不可用1表示可用
user_type varchar(16) 标识是个人注册用户还是企业注册用户，可从数据字典取编码
sys_code varchar(16) 此用户隶属的应用系统，应用系统编码也从数据字典获取.
下面是其他隐含字段:
row_id varchar(40) 唯一行号
sort_no int 记录排序号
create_dt varchar(23) 创建时间
create_uid varchar(40) 创建人帐号
update_dt varchar(23) 最后修改时间
update_uid 最后修改人帐号

在数据库表设计好以后，按下面的具体步骤操作:
一、 通过MyEclipse工具将指定的数据库生成对应的POJO类和hbm文件，此表对应的hbm文件和POJO类已经生成，分别是org/apache/easframework/core/entity/ EasB2cuser.hbm.xml和同目录下的EasB2cuser.java文件，可在WEB-INF/lib/ eas-core.jar中找到这两个文件，由于本平台已经生成了这两个文件，所以可进行下一步。
二、 这一步需要在配置文件中配置hbm.xml文件，见WEB-INF/classes目录下的datasource.xml,,这里配置了大量的hbm.xml文件：
<property name="mappingResources">
<list>
<value>org/apache/easframework/core/entity/EasB2cuser.hbm.xml</value>
…
</list>
</property>
由于这一步也已经配置好了，所以大家可直接看下一步。
三、 在实体容器类org.apache.easframework.core.entity.EntityContainer中声明EasB2cUser类变量（此容器也主要是为了webwork的前台页面的实体变量在BaseAction中能自动找到对应的实体类，以便BaseAction能自动将不同的实体类的值插入到相应的数据库表），EntityContainer.java中增加的代码如下:

private EasB2cuser easB2cuser;
public void setEasB2cuser(EasB2cuser entity)
{
this.easB2cuser = entity;
}
public EasB2cuser getEasB2cuser()
{
return this.easB2cuser;
}
本平台已增加了上述代码。在实际开发中，以上的步骤作完后要用ant运行一次编译部署脚本。在本示例中上述步骤已经完成，大家可从下一步骤开始正式自己动手来实现一个增删改查功能(带翻页的，不用写一行翻页代码，很酷的哦)，由于本文书写的时候模板生成器还没做完，等做完后,下面的步骤基本都省略了，用户只需要通过配置工具来生成功能页面，可以自己定义列表页面要显示的数据项，自己定义查询列和排序列，等等。看下一步骤。
四、 配置xwork.xml:
在WEB-INF/classes目录下有一个xwork.xml文件，打开此文件，找到下面一段代码:
<action name="listEasMetaColumn" class="org.apache.easframework.core.webwork.action.BaseAction">
<result name="input">/module/platform/editEasMetaColumn.jsp</result>
<result name="success">/module/platform/listEasMetaColumn.jsp</result>
<result name="select">/listEasMetaColumn.action?operate=selectPageList</result>
<result name="edit">/module/platform/editEasMetaColumn.jsp</result>
<result name="showList">/module/platform/listEasMetaColumn.jsp</result>
<param name="serviceName">DBSupportService</param>
<param name="keyFieldName">objId</param>
<param name="entityClassName">org.apache.easframework.core.entity.EasMetaColumn</param>
<param name="codeColumns"></param>
<param name="sortColumns"></param>
</action>

上面的配置是一个维护表字段信息的功能。可在此段代码下复制上面的代码，更改相应的配置。这里要注意一下命名规则，name="listEasMetaColumn"是一个action的名字，在页面上可以通过http://host:port/myapp/listEasMetaColumn.action的格式访问,list是动作,后面的是实体类名，jsp文件的命名也是动作名+实体类名，例如列表页面为listXXX.jsp,编辑页面是editXXX.jsp,本例要配置的是EasB2user的功能，对应的表是eas_b2cuser,所以列表页面的命名为listEasB2cuser.jsp,编辑页面的命名为editEasB2cuser.jsp。
DBSupportService是一个通用的封装了增删改差的基础业务逻辑类，当然实际开发可以从此类继承，一般没有特殊处理时，用此类作为增删改查的业务逻辑类即可。
keyFieldName是主键字段的类名，例如eas_b2cuser表的主键为obj_id,对应Easb2cuser类的objId字段，注意表和字段对应的类和类属性的命名规则，表字段下划线后的第一字母改为大写，去掉下划线，就是对应的类的属性名。
<param name="entityClassName">配置了此action对应的实体类名，现在我们要配置Easb2cuser的维护功能，自然此参数的值就是org.apache.easframework.core.entity.EasB2cuser;
codeColumns参数指定列表页面哪些字段需要显示代码对应的文字，例如列表页上要显示应用系统名称，而不是编码，所以此字段要配置为sysCode(sysCode是EasB2cuser类的一个属性)，此参数可以逗号做间隔符配置多个字段。
sortColumns参数指定列表页面指定的排序顺序字段，例如userName asc,sysCode desc，指定排序规则后，页面打开时自动按此顺序排序，当然用户可通过点列标题来自己指定新的排序列（标题列中点一次按此列升序排列，再点一次按降序排列）。
下面是配置好的内容：
<action name="listEasB2cuser" class="org.apache.easframework.core.webwork.action.BaseAction">
<result name="input">/module/platform/editEasB2cuser.jsp</result>
<result name="success">/module/platform/listEasB2cuser.jsp</result>
<result name="select">/listEasB2cuser.action?operate=selectPageList</result>
<result name="edit">/module/platform/editEasB2cuser.jsp</result>
<result name="showList">/module/platform/listEasB2cuser.jsp</result>
<param name="serviceName">DBSupportService</param>
<param name="keyFieldName">objId</param>
<param name="entityClassName">org.apache.easframework.core.entity. EasB2cuser</param>
<param name="codeColumns">sysCode,userType</param>
<param name="sortColumns">sysCode asc,userName asc</param>
</action>
五、 在功能列表中添加一个连接：
打开module目录下的left_plat.jsp,随便找一个节点，添加对应的连接，，例如：
['B2C用户帐号维护','<%=request.getContextPath()%>/listEasB2cuser.action?operate=selectPageList']

六、 列表页面：
可从已有的列表页面复制一个文件，例如在module/platform目录下复制listEasMetaColumn.jsp，更名为listEasB2cuser.jsp,将此页面的所有EasMetaColumn替换为EasB2cuser,此jsp中有(new String[]{"开发平台","基础数据管理","表字段信息维护"})，是生成功能导航文字的，可将文字部分改为"开发平台","权限管理","B2C帐号维护"(导航文字以后也可以定义为一个参数在xwork.xml中配置).
下面需要设置列表页需要显示的字段列表，将文件中：
<td nowrap class="result_head_dock" width="21%"><a href="javascript:customSort('tableName');">表名</a></td>
<td nowrap class="result_head_dock" width="20%"><a href="javascript:customSort('columnName');">字段名</a></td>
<td nowrap class="result_head_dock" width="20%"><a href="javascript:customSort('columnCnName');">字段中文名</a></td>
<td nowrap class="result_head_dock" width="20%"><a href="javascript:customSort('classFieldName');">类属性名</a></td>
部分去掉，改为:
<td nowrap class="result_head_dock" width="9%">序号</td>
<td nowrap class="result_head_dock" width="21%"><a href="javascript:customSort('userId');">登录帐号</a></td>
<td nowrap class="result_head_dock" width="20%"><a href="javascript:customSort('userName');">用户名称</a></td>
<td nowrap class="result_head_dock" width="20%"><a href="javascript:customSort('userType');">用户类型</a></td>
<td nowrap class="result_head_dock" width="20%"><a href="javascript:customSort('sysCode');">所属系统</a></td>

其中userId,username,userType,sysCode是EasB2cuser类的属性。下面
<td align="center" width="21%"><ww:property value="tableName"/></td>
<td align="center" width="20%"><ww:property value="columnName"/></td>
<td align="center" width="20%"><ww:property value="columnCnName"/> </td>
<td align="center" width="20%"><ww:property value="classFieldName"/> </td>
替换为:
<td align="center" width="21%"><ww:property value="userId"/></td>
<td align="center" width="20%"><ww:property value="userName"/></td>
<td align="center" width="20%"><ww:property value="userType"/> </td>
<td align="center" width="20%"><ww:property value="sysCode"/> </td>

到这一步，点击功能连接中的B2C用户帐号维护：






即可以看到一个没有数据的功能页面，由于现在eas_b2cuser表还没有数据，编辑页面还没有实现，我们可以直接在数据中插入两三条数据(注意row_id这个非主键列要唯一值)，先看看这个列表页面的效果，大家可以看到，通过上述步骤，没有写java代码，但是排序、查询，翻页已经实现了(翻页需要多录入几条数据能看到效果)。大家点点列表标题连接，可以看到现在可以按照升序或降序来排列被点击的字段。不过目前我们看到两个问题：一是查询条件列的下拉列表为空，二是列表页的用户类型和所属系统两个字段为编码，应该显示名称，下面讲述如何在查询条件框中添加查询条件列和将编码（编码字段已在xwork.xml中定义了，为sysCode,userType）显示为名称。
首先我们为网站用户类型数据字典(WEBUSER_TYPE)和应用系统数据字典(SYSTEM_CODE)增加数据字典项：
网站用户类型数据字典增加USER,个人用户 COM单位用户
应用系统数据字典增加B2C电子商务BLOG博客HR人力资源网

以上数据字典和数据字典类型平台中已配置好。下面使用表字段基本信息维护功能增加eas_b2cuser表的几个字段的设置,增加内容(平台中已将这几个字段配置好，不用再配置了，这里为了说明操作步骤):



保存后再进入B2C用户帐号维护中可看到查询条件下拉中已有了用户ID字段.
然后添加用户名称的配置

user_type字段配置(此字段值从数据字典取,在上文已配置好对应的数据字典编码)：



sys_code配置：



这时候再回到B2C用户帐号维护，查询条件下拉框中已有了查询条件列，选择用户名和登录帐号时，右侧显示输入框可输入查询文字，当选择网站用户类型，右侧显示网站用户的下拉数据字典项，选择所属系统时，右侧显示应用系统的下拉列表。这是切换查询列，并选择或输入查询内容，然后点查询按钮，我们会发现，查询功能已经实现了！仍然是-没有Coding!查询功能已经实现了！！！
列表页面还有什么变化？看用户类型和所属系统字段，原来是显示的编码，现在已经显示文字了，见下图：



(由于本文篇幅较长，编辑页面的实现在下篇文档中继续。)