SoTower DE开发指南.docx

1、SoTower DE开发指南SoTower DE开发指南北京中电普华信息技术有限公司创新研究中心文档内容变更记录序号版本号修改单号修改章节内容修改人/日期核对人/日期123456789101 各资源类型扩展方案如果业务应用子系统需要修改过SoTower平台的文件，就需要创建扩展模块，用子系统中修改过的平台文件覆盖或者新增平台默认的文件。1.1 JSP1. 获得要修改的SoTower平台的原JSP文件；2. 了解要修改的SoTower平台的JSP文件属于哪个模块；3. 创建扩展模块；4. 把原JSP文件按照所属模块的原有目录结构放置在扩展模块中；5. 对JSP文件进行修改；6. 部署扩展模块到应

2、用中。说明：JSP文件只能进行整个文件的覆盖。1.2 静态资源文件模块化后的SoTower平台的静态资源文件（包括*.js,*.css,*.gif,*.jpg, *.html 等等）存放在2个地方，大部分资源文件都统一放在sotower-skins中，少量的文件分散放在各个模块中。1. 获得要修改的SoTower平台的原静态资源文件；2. 了解要修改的SoTower平台的静态资源文件是属于sotower-skins还是各个模块中；3. 创建相应模块的扩展模块；4. 把原静态资源文件按照所属模块的原有目录结构放置在扩展模块中；5. 对静态资源文件进行修改；6. 部署扩展模块到应用中。说明：静态资

3、源文件只能进行整个文件的覆盖。1.3 Spring配置文件1. 获得要修改的SoTower平台的原Spring配置文件；2. 了解要修改的SoTower平台的Spring配置文件属于哪个模块；3. 创建扩展模块；4. 把原Spring配置文件按照所属模块的原有目录结构放置在扩展模块中；5. 新创建的Spring配置文件的名称不能和被覆盖的Spring配置文件名相同，但是要修改的Spring Bean的ID必须相同；6. 对Spring配置文件进行修改；7. 部署扩展模块到应用中。说明：Spring配置文件的扩展可以实现Bean级别的覆盖。扩展模块的Spring配置文件中可以只维护需要修改的Be

4、an，其他不需要修改的Bean可以不用维护，即可以增加、修改一个Bean，不支持删除Bean。1.4 属性配置文件1. 获得要修改的SoTower平台的原属性配置文件；2. 了解要修改的SoTower平台的属性配置文件属于哪个模块；3. 创建扩展模块；4. 把原属性配置文件按照所属模块的原有目录结构放置在扩展模块中；5. 对属性配置文件进行修改；6. 部署扩展模块到应用中。说明：属性配置文件只能进行整个文件的覆盖。2 配置项说明1 2 3 4 2.1 数据库相关2.1.1 更改数据库类型 Sotower平台（3.0.4）支持Oracle、DB2和SqlServer三种数据库，在sotower-

5、persistence模块WEB-INFappconfbeansdatasourcedatasource.properties文件中定义：# oracle,达梦,KingBasesessionFactory.hibernatePropertieshibernate.dialect = org.hibernate.dialect.Oracle9Dialect# sqlserver#sessionFactory.hibernatePropertieshibernate.dialect = org.hibernate.dialect.SQLServerDialect# db2#sessionFact

6、ory.hibernatePropertieshibernate.dialect = org.hibernate.dialect.DB2Dialect 可以看到配置文件中提供了其他两种数据库方言的设置，可以根据实际情况启用需要的数据库类型，删除或者注释掉不要的。2.1.2 相关配置 在sotower-persistence模块的WEB-INFappconfbeansdatasourcedatasource.properties文件中，还定义了hibernate相关配置，例如是否显示SQL，JDBC抓取数量、批量更新值等，可以根据实际情况进行优化。sessionFactory.hibernate

7、Propertieshibernate.show_sql = truesessionFactory.hibernatePropertieshibernate.jdbc.fetch_size = 50sessionFactory.hibernatePropertieshibernate.jdbc.batch_size = 100sessionFactory.hibernatePropertieshibernate.cache.use_query_cache = false2.1.3 持久层错误页面sotower-persistence模块/config/hibernate/persistence

8、.xml，设定持久层错误提示页面。 2.2 前台页面相关2.2.1 flexgrid自定义 flexgrid每页记录数在sotower-config模块/config/global.properties中#表示flexgrid每页的纪录数flexgrid.pageSize = 10 flexgrid隔行反色颜色设定在sotower-config模块/config/global.properties中：#flexgrid隔行反色 odd：奇数行背景颜色； even：偶数行背景颜色flexgrid.item.backgroudColor.odd=#FFFFFFflexgrid.item.backg

9、roudColor.even=#EEEEEE 翻页按钮、查询按钮、文本类默认图片在sotower-config模块/config/global.properties中#翻页按钮的图片web.taglib.pagepolit.bgimg=buttonbg.gif#查询图片url地址web.taglib.flexgrid.searchimg=search.gif#图片文本列的默认图片web.tablib.imagetextcol.defaultimg=liulan.gif2.2.2 tree自定义设定 在sotower-config模块/config/global.properties中，自定义t

10、ree相关属性：#tree的配置开始#打开节点图片web.taglib.tree.openflag=NodeImg1.gif#关闭节点图片web.taglib.tree.closeflag=closeflag.gif#ref节点图片web.taglib.tree.urlimage=openflag.gif#背景颜色web.taglib.tree.backgroundcolor=#CECFCE2.3 工具类相关 Sotower平台提供了一系列开发中常用的工具类，例如邮件、加解密等，下面列出相关Bean的配置，可以参照实际情况使用可配置。2.3.1 压缩解压工具类 sotower-presenta

11、tion模块WEB-INFappconfbeansbizcomponentcompress.xml，soti压缩解压缩构件bean配置，分别包括数组、输入输出流和文件压缩解压缩的接口和实现类；2.3.2 数据库操作类 sotower-presentation模块WEB-INFappconfbeansbizcomponentdatabase.xml，soti数据库操作相关bean配置，包括对象CRUD操作，SQL、存储过程执行等的接口和实现类；2.3.3 数据字典类 sotower-presentation模块WEB-INFappconfbeansbizcomponentdatadictiona

12、ry.xml，soti数据字典相关bean配置，包括从支持文件、数据库和用户Map格式数据获取数据字典，通过文件和数据库获取级联下拉框两种；2.3.4 SoTI文件类 sotower-presentation模块WEB-INFappconfbeansbizcomponentfile.xml，soti文件处理相关bean配置，包括文件路径映射（*unix与windows转换）、文件ContentType解析、文件下载等；2.3.5 SoTI邮件类 sotower-presentation模块WEB-INFappconfbeansbizcomponentmail.xml，soti邮件发送相关bea

13、n配置，包括简单文本邮件、带附件邮件两种；2.3.6 SoTI加解密类 sotower-presentation模块WEB-INFappconfbeansbizcomponentpwd.xml，soti加密解密相关bean配置，包括md5PwdBizC、shaPwdBizC、desPwdBizC、rsaPwdBizC四种，分别通过MD5、SHA、DES和RSA算法进行加解密操作。2.4 WebService相关2.4.1 修改Axis 2默认模块路径 默认情况下，使用Axis2发布WebService默认的模块名为axis2，在axis_osgi模块/deploy.xml文件中配置/axis2

14、3 附录1：SoTower开发平台模块模块说明1. sotower_dm_brokeClient端加载机制2. sotower_dm_web加载平台应用模块3. sotower_dmDm相关平台基础启动加载项集合4. sotower_dm_commandDm命令相关设置集合5. sotower_dm_environmentDm相关环境处理6. sotower_dm_exception处理异常模块集合7. sotower_dm_guide提供sotower-dm相关教程8. sotower_dm_hook为Weblogic环境下对象的序列化/反序列化提供类加载9. sotower_dm_http

15、service负责处理DM请求10. sotower_dm_ilistener提供监听事件基类11. sotower_dm_io提供接口12. sotower_dm_jsp在模块环境下处理jsp资源13. sotower_dm_license平台授权处理14. sotower_dm_mm模块相关属性处理包15. sotower_dm_model根据创建模块类型的相关处理集合16. sotower_dm_policy部署应用模块相关集合17. sotower_dm_resourcecache应用资源缓存处理集合18. sotower_dm_utilDm基础辅助类集合19. sotower_dm_

16、verificationDm模块校验辅助类集合20. sotower_dm_webext提供Dm相关jsp页面以及图片资源21. sotower_config提供SoTower开发平台的原有默认配置22. sotower_core_wafSoTower 0.9版本中的部分代码23. sotower_datasource提供数据源24. sotower_jdbc_db2Driver提供db2数据库驱动25. sotower_jdbc_dmDriver提供达梦数据库驱动26. sotower_jdbc_kingbaseDriver提供kingbase数据库驱动27. sotower_persist

17、ence提供访问数据库的持久层28. sotower_presentation统一注册SoTower开发平台的展现构件29. sotower_skins提供SoTower开发平台的原有js、css以及图片30. sotower_webtlds支持TLD标签31. sotower_sotiSoTower开发平台soti部分的所有jar文件集合32. sotower_bss业务服务套件模块，提供了组织结构、权限模型、菜单、财务区间、工作日历等等业务组件。33. sotower_bss_cachebss的缓存管理模块。34. xfire_osgi对xFire Web服务框架的支持35. axis_o

18、sgi对axis2 Web服务框架的支持4 附录2：第三方模块模块说明36. antlr语言转换工具，hibernate用他将hql语句转换为sql语句37. aopalliance实现从jpg、bmp、gif图片到txt、html文本的转换38. cglib-nodepcglib代理 实现AOP的一种方式39. com.springsource.org.quartzspring的任务调度40. commons-fileupload添加强大的，高性能，文件上传到servlet和Web应用程序的能力41. commons-io有开发功能的实用程序库42. commons-langJava实用程序

19、类为包类在java.lang中的层次结构，或者被认为是标准，以证明存在java.lang中43. geronimo-stax-api_1.0_spec44. javax.activation45. javax.mail提供处理mail相关的jar46. javax.servlet创建基于web的应用47. javax.servlet.jsp创建显示动态web页面48. javax.wsdl49. javax.xml提供处理XML的相关jar50. jta51. ognlognl 表达式所需包52. ojdbc14数据库驱动53. mons.beanutils包含了一些Bean工具类的集合54.

20、 mons.codec接口和类使用的各种实现的子类55. mons.collections包含了一些数据类型工具类，是java.lang.*的扩展。必须使用的jar56. mons.dbcpDBCP数据库连接池57. mons.digester提供了以规则为基础的任意XML文档的处理58. mons.elApache 组织中一个用来解析 JSP 2.0 的表达式语言的 Java 类库59. mons.httpclient一个HTTP的“用户代理”，包含一个HTTP状态和一个或多个HTTP连接，可应用于HTTP方法60. mons.logging日志功能61. mons.poolDBCP数据库连

21、接池，62. org.apache.jasper保存所有具体的JSP引擎的初始化参数63. org.apache.log4j日志功能64. org.apache.oro65. org.apache.poi读写Excel、WORD等微软OLE2组件文档的项目66. org.apache.tools.ant提供打包的功能67. org.apache.xalan68. org.apache.xml.security为安全框架提供类和接口69. org.apache.xmlbeans70. org.bouncycastle.bcprovider71. org.codehaus.stax72. org.

22、dom4jXML配置和映射解释器 73. org.eclipse.osgiOsgi核心框架74. org.eclipse.osgi.services75. org.eclipse.osgi.services.source76. org.eclipse.osgi.source77. org.hibernatehibernate核心库78. org.jgroupshibernate核心库79. org.objectweb.asm80. org.springframework.bundle.spring提供spring框架81. org.springframework.bundle.spring.webmvcSpring MVC 框架相关的所有类 82. xerces解析XML文件的工具包83. xmlresolver提供的Apache托管的其他基于XML的项目中使用DOM，SAX和JAXP接口的设置