森锐开发框架使用手册

务JSONJSONXML、JSON或其它格式将业务处理数据返回到客户端，客户端进行各URL的请求将不再被服务端所接受。服务端也不再考虑前端页面的跳转关系，而只负URL或者静态资源文件，如果是静态资源文件，由控制中心负责想客户端输出结果数据，如（URLJSP、普通文本文件。Struts2来管理动态资源，Struts2提供了很好的业务处理与数据结果输出分离的架构，在框架中通过采用Marker模板引擎，实现业务逻辑控制与数据输Struts2Action级别统一进行处理。SpringSpring来实现可配 结表格控件同的表格控件之间进行切换。目前整合的表格控件是JqGrid（基于JQuery的一个功能强大dataSource,gridParams,TD的参数为：colNames, multiselect,width,ID（id参数相同获取选中行数未实现要选中的行号（1开始您选择了<未封装inputName:"useraccount",tname:"sys_pa_code",lcol:vcol:scol:selected:})数据资源在服务端的数据资源配置文件中要装载数据的表单名附加参数，可选。data请求设置的参postget还需要传入ruleId数装载下拉框该数据资源在服务端的数据资源配置文件data（数），可选参数：type(请求类型get)、（返回的数据类型表单提交（提供自该数据资源在服务端的数据资源配置文件data（表单提交的数，可选参数：（提交方式：post成功后向用户弹出提表单验证Form 请求params,callback)参数，分别是data、formName,callback)参数，分别是dataJavaScript 功能功能包括：列表、表单工具、资源请求接口，要使用这些功能必须在页面中framework.js文件Filterweb.xmlFilter进行配置，如数据资源映射配置存放于 -location所指定数据资源映射配置存放于 -location所指定type=”url”urlStruts2ActionStruts2Action注意，该Filter的dispatcher应设置为FORWARD，这样可外部（浏览器）直接对ActionFilter的配置需要在数据资源控制中心Filter后面进行配置。demo<暂略Struts2框架ActionActionAction等。Actionstruts.xmlstruts/framework.xml配置文件，如下图：支 Marker的框架通过采用Marker实现业务处理结果与输出格式的分离。Action中不需要对结果进行输出，只需要按照要求返回业务处理结果，由MarkerResult来根据模板对结xml、json等多种格式的输出。 Marker的Result进行结果输出result的type为Temte，接收两个参数：temteFile和temteRes。temteFile指基于WEB-INF 板文件，temteRes则基于classpath的模板文件。example-list.ftl文件如下：JSONObjectJSONObjectJsonStrutsResult的数据传输对象，JsonStrutsResultJSONObject对nullJsonStrutsResult处理数据。{"header":":"":""isAlert是否弹出信息，该值为":"}模板的配置请参考Marker的相关说明文档。这里只描述基于 Marker进行封装框架 不增加“,—2010-10-—2010-10-01式数据校验功能，ActionBaseAction，否则需要另外编写调用数据校验功能的代码。的配置和管理）。如使用Spring，则业务逻辑处理类应当实现com.sunrise.framework.spring.IService接口。hibernateORM（dbutildbutil如上图所示，dbutil的作用主要是将连接、执行查询、结果处理分开由不同的部分dbutildbutil还提供了对数据库表进行日志记录的功能。dbutil主要的类是QueryRunner，QueryRunner的所有功能都通过静态方法提供。QueryRunner提供的查询方法分为三种类型：查询类型、更新类型、调用类型。select语句DBManager负责数据库连接、事务控制等工作，perties配置文件的装载也DBManager负责。情况下不需要由开发人员实现的ResultSetHandler，但是在某些场合可能仍然需要开发ResultSetHandler。行选择使用（参考perties的配置。#connecttypejdbc、datasource、provider #BoneCP连接池参数#Proxool连接池参数#DBCP连接池参数QueryRunnerSQLIntqueryCount(StringsqlSQLIntqueryCount(Stringsql,Object[]params)sql查询结果集sqlSQL语IntqueryCount(Connectioncon,Stringsql,Object[]sql查询结果集传入连接（表示不通过DBManager连接sql成一个JavaBean对<T>TqueryBean(Stringsql,Object[]params,Class<T>Class<T>的实例sql要将结果集转换成成一个JavaBean对<T>TqueryBean(Connectioncon,Stringsql,Object[]params,Class<T>clz)Class<T>的实例传入连接（表示不通过DBManager连接sql要将结果集转换成成一个JavaBean象<T>TqueryBean(Stringsql,Class<T>clz)Class<T>的实例要将结果集转换成成一个JavaBean对<T>TqueryBean(Connectioncon,Stringsql,Class<T>clz)Class<T>的实例传入连接（表示不通过DBManager连接要将结果集转换成成一个JavaBean对 Object[]params,Class<T>Class<T>的实例sql要将结果集转换成成一个JavaBean对 con,Stringsql,Object[]params,Class<T>clz)Class<T>的实例传入连接（表示不通过DBManager连接sql要将结果集转换成成一个JavaBean Class<T>clz)Class<T>的实例要将结果集转换成成一个JavaBean对 con,Stringsql,Class<T>clz)Class<T>的实例传入连接（表示不通过DBManager连接要将结果集转换成<T>T handler的处理自定义的 handler的处理传入连接（表示不通过DBManager连接自定义的<T>TqueryResultSet(Stringsql,Object[]params,handler的处理sql自定义的 con,Stringsql,Object[]params,ResultSetHandler<T>handler的处理传入连接（表示不通过DBManager连接sql自定义的 queryPageList(Stringsql,PageInfopageInfo,Class<T>分页的结果数据（PageList对要将结果集转换成 queryPageList(Stringsql,PageInfopageInfo,分页的结果数据（PageList对sql询params,Class<T>要将结果集转换成 con,Stringsql,PageInfopageInfo,Object[]params,Class<T>clz)分页的结果数据（PageList对传入连接（表示不通过DBManager连接sql要将结果集转换成句intupdate(String句intupdate(Stringsql,sqlintupdate(Connectioncon,Stringsql,Object[]params)传入连接（表示不通过DBManager连接sqlintupdate(Connectioncon,Stringsql)传入连接（表示不通过DBManager连接<T>Tcall(Stringcall,Object[]handler处理的<T>Tcall(Connectioncon,Stringcall,Object[]params,handler处理的传入连接（表示不通过DBManager连接<暂略通用查询。查询配置实现了将查询语句置于文件中进行配置，配置的SQL语句可使用Marker语法（实现动态条件的时候很有用；函数框架提供一种灵活的查询条件处理方type<#ifanduser_name Marker表达式，表示如果参数中存在username且username不为空，则添anduser_name)]like‘%?%’username参数整合到查询参数值中。[useraccount]也是函[函数名称(<,2参数目标类型：file pagelist 执行分页语句，返回列表数据结果或者输出Exceljs表格控件使用的数据，jsonExcel执行器参数含义（marker语法markermarkerupdatebatchbatchqueryform_dataform_mapcallbatchcallauto-updatetreeresultsetform_beanbean<空 执行分页语句，返回列表数据结果或者输出Excel?SQL是否分页。如果为true则查询框架会OracleSqlServer、MySqllike like参数SQLstartwith like参数SQLendwith like参数SQLin SQL sql无SQL)…eval方法返回的对象为IQueryFunction口SQL子句分析整合预/、行一些同名检测检测等无法简单通过SQL语句来进行的逻辑判断后处理可以对一SQL语句来执行的逻辑处理。、 update了]]></param>是查询数量的SQL语句，支 Marker语否否否否否是否要传递的参数，采用QueryString否SQLSQL1是是SQLselectupdate否否typebean当UTF-8否commonQuery.xml配置文件是提供给项目开发时对查询框架的相关功能进行扩展的配commonQuery.xml/后处理JEE=QueryContextcxt=QueryContext.createContext(config);Map<String,Object>params=newHashMap<String,Object>();ResultSetHandler来实现特殊的逻辑处理功能，dbutilAPI来执行查询语句。如： X轴，生成X轴的数系列，生成系列的数report查询执行器来实现的。该执行器的详细信息如下表：注意已知问题jqGridHTMLOpenFlashChart输出，OpenFlashChart执行器参数含义（marker语法X轴数据提供者，如果不指定且没series参数，则表示只有一个resultset-typeY轴数据来源，如果不指定，则使用第一个出现的数据，该参数在X轴的数据，如果没有指定，则只按照顺序来对应数据，该参数在Xlabelvalue考虑系列。此参数在resultset-typestatic列分别对应各字段。dynamic是指结果报表的类型：gridpie,linebar，默认为Xxaxis-provider的情况下生效。格式{"values":["1","2"],"labels":["1月份月份"]}，label情况下生效。格式年","2010年"]}