SSH简化持久层编程模组_概要设计及调用说明.doc

版本：1.0 Beijing Targsoft Co.,Ltd TG-R-MB-XM- SSH简化持久层编程模组概要设计及调用说明文件状态：草稿正式发布正在修改当前版本V1.0作者缑融完成时间2011/4/28文件修订记录版本号变更类型简要说明（变更内容）变更日期变更人1.0新建初版2011/4/28缑融*变更类型：A新增，M修改，D删除1 概述功能：利用Struts 1.2 及 Spring 2.0.8 和 Hibernate 3.2 的组合，实现简化数据查询、检索、提交持久化的编程实现。对于基本的CRUD操作提供不编程或少编程的方案。局限性：本框架模组仅应用于简单获取及检索数据或简单提交存储没有其它业务的情景。当然，您也可以直接在DataService层使用actionDao的实现类，去编程实现复杂业务。2 功能模块设计及调用说明1 DelegatingActionProxy 这是Struts的委派代理Action，实现在URL上直接可以访问Spring的管理Bean；如：只要访问的URL为/XXX.do，在Spring里配置的bean name可以为/XXX即实现通过Struts直接访问ActionDao的各种实现的目的。2 ActionDao是Struts的委派代理Action调用后台持久层实现各种数据操作的接口，意味着各种数据操作实现类都执行一个统一的executeData方法，来实现数据操作。这个接口的各种实现类可以在Spring中配置属性；实现不编程的操作数据。3 各种数据操作类BaseGetAction 实现通过参数配置执行 hibernateTemplate 的get方法；它是一个抽象类；子类必须实现如何将从持久层得到的数据对象转为需要的字串，用于将数据对象以流的方式 response 回到浏览器端；当然；得到的PO通过BaseGetAction也注入到了Request里。属性名为ActionForm。可配置的属性可选值备注sessionFactoryHibertate的Session工厂必设elexpression正确的EL表达式必设（用于从请求中得到get方法所需的主键值）classnamePO的全限定类名必设returnScriptStruts的forward计算用Groovy表达式选设（已将返回的PO以变量“ActionForm”形式打入Groovy计算环境）；如果设置了此值；则forward的值由returnScript计算得出；如果没有设置，则forward=nullBaseListAction 实现通过参数配置执行 hibernateTemplate 的execute方法获得数据集；它是一个抽象类；子类必须实现如何将从持久层得到的数据对象转为需要的字串，用于将数据对象的列表以流的方式 response 回到浏览器端；主要用于Ajax加载数据的使用方式；当然；得到的WebPage对象已通过BaseListAction注入到了Request里。属性名为WebPage。可配置的属性可选值备注sessionFactoryHibertate的Session工厂必设startelexpression正确的EL表达式选设（用于从请求中得到数据集的开始位置start）limitelexpression正确的EL表达式选设（用于从请求中得到数据集的记录数limit）hqlstring正确的HQL语句必设（获得数据集的HQL语句）hqlcountstring正确的HQL语句必设（获得总数据量的HQL语句）elparametersElparameter的列表List选设（用于从请求中得到所需的参数和用于设置条件的Where子句）Elparameter的参数为：index 是Where子句的位置序列。name 是参数名。expression必须是正确的EL表达式。subhqlstring是正确的Where子句段或”用于仅注入参数值的情况。type是参数的类型；必须是正确的java值类型orderbyelexpression正确的EL表达式选设（用于从请求中得到排序用 PO字段值）descorascelexpression正确的EL表达式选设（用于从请求中得到增序、简序值必须是 ASC 或 DESC）returnScriptStruts的forward计算用Groovy表达式选设（已将返回的PO以变量“ActionForm”形式打入Groovy计算环境）；如果设置了此值；则forward的值由returnScript计算得出；如果没有设置，则forward=nullBaseSaveAction 实现通过参数配置执行 hibernateTemplate 的save方法；它是一个抽象类；子类必须实现如何将从ActionForm和Request得到的表单提交值转为可用于存储的PO 。可配置的属性可选值备注sessionFactoryHibertate的Session工厂必设classnamePO的全限定类名选设BaseSaveOrUpateAction 实现通过参数配置执行 hibernateTemplate 的saveOrUpate方法；它是一个抽象类；子类必须实现如何将从ActionForm和Request得到的表单提交值转为可用于存储的PO 。可配置的属性可选值备注sessionFactoryHibertate的Session工厂必设classnamePO的全限定类名选设BaseUpateAction 实现通过参数配置执行 hibernateTemplate 的Upate方法；它是一个抽象类；子类必须实现如何将从ActionForm和Request得到的表单提交值转为可用于存储的PO 。可配置的属性可选值备注sessionFactoryHibertate的Session工厂必设classnamePO的全限定类名选设BulkUpdateAction实现通过参数配置执行 hibernateTemplate 的BulkUpdate方法；执行一条HQL语句 实现多条记录的更新、删除操作。 合法的HQL语句参考hibernate_reference 3.31 文档的 13.4. DML-style operations 相关章节 。可配置的属性可选值备注sessionFactoryHibertate的Session工厂必设hqlstring正确的HQL语句必设（执行批量的HQL语句）elparametersElparameter的列表List选设（用于从请求中得到所需的参数和用于设置条件的Where子句）Elparameter的参数为：index 是Where子句的位置序列。name 是参数名。expression必须是正确的EL表达式。subhqlstring是正确的Where子句段或”用于仅注入参数值的情况。type是参数的类型；必须是正确的java值类型DeleteAction实现通过参数配置执行 hibernateTemplate 的delete方法。可配置的属性可选值备注sessionFactoryHibertate的Session工厂必设elexpression正确的EL表达式必设（用于从请求中得到delete方法所需的主键值；可以是多条主键值，中间用”,”隔开）classnamePO的全限定类名必设3 配置说明直接举例说明：Struts里：如：URL可以是 /targsoft20/getnews.do?newsID=b686643fb49d11dfa59c69fb3f88b84b如：URL可以是 /targsoft20/listnews.do?start=0&limit=15&keyword=123&orderby=np.createDate&descorasc=DESCSpring里：PROPAGATION_REQUIRED,readOnlyPROPAGATION_REQUIRED,readOnlyfrom NewsPublish np where 1=1select count(*) from NewsPublish