基于uap2.04的sotower项目移植.doc

基于uap2.04的sotower项目移植一.新建模块项目2(一)新建IAS容器2A.安装UAP Studio-1.1.exe。2B.启动sguap-service2C.新建UAP项目3D.增加数据库连接4E.去除统一权限5F.添加模块项目5G.在UAP中引入sguap-server7H.Jar包引入9(二)新建IAS模块项目11A.新建模块项目11B.去除统一权限12C.引入jar包13二.将EIC1.0项目移植到uap2.0模块项目14(一)整体目录迁移14(二)Flex前台移植14三.将sotower项目迁移到模块项目14(一)整体目录迁移14(二)配置文件新增与修改16A.修改项目的web.xml文件16A.修改config下的xml文件20B.创建configs文件夹21(三)缓存的修改22(四)修改项目中应用sotower包的java代码24(五)配置文件修改24(六)jar包调整25(七)配置.springBeans文件25(八)前端移植26四.集成Flex27(一)Jar包添加27(二)配置模块依赖关系27(三)Spring配置文件28(四)Flex配置文件29(五)Flex程序文件31五.项目移植总结32基于uap2.04的sotower项目移植一. 新建模块项目创建SGUAP容器IAS及模块项目IAS。(一) 新建IAS容器A. 安装UAP Studio-1.1.exe。B. 启动sguap-service单独使用一个tomcat将http端口设置为8888（其他端口不能与UAP默认tomcat冲突即可，这个看个人电脑环境自行配置），将sguap-server1.2在tomcat中启动。启动结果如下无异常：C. 新建UAP项目填写项目名称，直接下一步：D. 增加数据库连接E. 去除统一权限在client_exclude_perties配置文件中，F. 添加模块项目打开policy.xml:设置path（模块项目存放的工作空间目录），设置module（模块项目名称） （该配置可以在新建模块项目后回来修改，或者直接先定好模块项目名再去创建）G. 在UAP中引入sguap-server设置Location：:8888/sguap-server/environment/platform/Version2.0.0 Reload加载包到UAP中，保存地址到IAS中：H. Jar包引入在IAS中添加如下3个包：将包添加到Target Platform(二) 新建IAS模块项目A. 新建模块项目填写模块项目名称：默认直接完成：B. 去除统一权限将统一权限的两个引用包Remove掉：C. 引入jar包将之前添加进Target Platform的包引入，如下两个：二. 将EIC1.0项目移植到uap2.0模块项目(一) 整体目录迁移在uap2.0上重新建立uap2.0的模块项目,将原1.0的目录原封不动拷贝进来就可以了,如果个别包报错,稍做调整.(二) Flex前台移植主要是修改上下文文件:.flexProperties文件修改如下(只修改黄色部分):重新编译flex文件,将编译后的文件拷贝到模块项目上的face下,移植完后如下:三. 将sotower项目迁移到模块项目(一) 整体目录迁移n 将sotower项目下src、javatest、javasrc、html-template直接复制到uap模块项目根目录中。n 将sotower项目下WebContent中除WEB-INF外全部复制到uap模块项目下的face中。n 将sotower项目下WEB-INF中的conf复制到uap模块项目下的config中。n 将sotower项目下的所有的spring配置文件,复制到uap模块项目下的config下。n 将sotower项目下libs里的swc文件复制到uap模块项目下的libs中。n 将sotower项目下WebContentWEB-INFlib里的jar包复制到uap模块项目下的libs中。n 将sotower项目下WebContentWEB-INF中的flex目录复制到uap模块项目下的face中。sotower项目目录结构图与迁移后的uap模块项目目录结构图如下： (二) 配置文件新增与修改A. 修改项目的web.xml文件修改之前sotower项目的web.xml文件,在模块项目的在config下新增web-flex.xml，修改之前项目的Servlet、Listener,注意标签头,具体格式如下：flex.messaging.HttpFlexSessionMessageBrokerServletflex.messaging.MessageBrokerServlet/messagebroker/*services.configuration.file/flex/services-config.xmlURLAccessRpomentservice.access.servlet.URLAccessReport/URLAccessReportFileExportcom.ylkj.ias.export.dowland.servlet.FileExport/FileExport.actionUiDesignerUploadServletcom.ylkj.ias.export.upload.servlet.UiDesignerUploadServlet/UiDesignerUploadServletExcelUploadServletcom.ylkj.ias.datacollection.datamodel.servlet.ExcelUploadServlet/ExcelUploadServletExcelDownloadServletcom.ylkj.ias.datacollection.datamodel.servlet.ExcelDownloadServlet/ExcelDownloadServletexportImgcom.ylkj.ias.export.dowland.servlet.ExportImg/exportImgCommonIOSmonio.servlet.CommonIOServlet/common-io/*exportXLScom.ylkj.ias.export.dowland.servlet.ExportXLS/exportXLSexportPDFcom.ylkj.ias.export.dowland.servlet.ExportPDF/exportPDFreportPageServletcom.ylkj.ias.servlet.ReportPageServlet/json/reportPageFileDownLoadUdscom.ylkj.ias.export.dowland.servlet.FileDownLoadUds/FileDownLoadUdsWordExportServletcom.ylkj.ias.wordexport.servlet.WordExportServlet/WordExportServlet.actionEhCacheServletcom.ylkj.ias.servlet.ReportEhCacheServlet/EhCacheServlet.actionuploadImgcom.ylkj.ias.export.upload.servlet.ImageUpload/uploadImgImageServletcom.ylkj.ias.servlet.ImageServlet/ImageServletzipServletcom.ylkj.ias.servlet.ZipServlet/ZipActionudsUploadServletcom.ylkj.ias.export.upload.servlet.FileUpLoadUds/udsUploadServletA. 修改config下的xml文件所有singleton=true 修改为：scope=singleton所有singleton=false 修改为：scope=prototypeB. 创建configs文件夹部分文件发布后无法找到目录，所以需要创建这样一个目录查找到所有classpath后的文件，修改路径， 将这些文件存放到新建的configs目录中(三) 缓存的修改Sotower使用的eache的缓存,我们要将项目移植到uap就必须使用uap的缓存,现在我们来修改缓存的引用了net.sf.ehcache.Cache;net.sf.ehcache.Element;的java文件: 修改使用uap缓存文件,如下图修改了uap的缓存,也要修改对应的java代码如下:修改相应的缓存配置文件:(四) 修改项目中应用sotower包的java代码A. commandFactory的修改方式B. org.sotower.bsp.*包引用的解决方法 将sotower这个包的源码拷贝出来放在项目中,后续修改 (五) 配置文件修改基于sotower的项目,引用了较多sotower的东西,尤其要注意配置文件,以本项目为例子,要将framework_reference.xml, framework_service.xml, indice.xml ,uds_file.xml的配置文件都注释掉.(六) jar包调整将lib中如下包删除（这些包与sguap-server中Reload到项目中的包冲突）：注：如果项目运行中有提示jar包冲突，查看是否libs中是否有包与sguap-server中Reload到项目中的包重复，如果重复就把libs中的删掉。或者有些包不兼容UAP，需要重新在UAP中引入。UAP平台集成的第三方jar包路径如下(uap的安装目录)sguap-serverWEB-INFrepositoryplatformVersionX.0.0thirdparty程序启动前，需要将自带jar包（libs下的包）引入UAP中，如下操作：(七) 配置.springBeans文件使用Navigator视图，查看项目的.springBeans 文件：将移植的配置文件配置进该文件，如下:(八) 前端移植将前端文件（如：jsp、html等）移植到UAP模块项目的face下，如下：进行必要调错修改四. 集成Flex(一) Jar包添加将BlazeDS所需要相关Jar包放置在模块项目的lib目录下：(二) 配置模块依赖关系在MANIFEST.MF文件的Classpath部分，将这些Jar添加到模块的类路径中：在MANIFEST.MF文件的Required Plug-ins部分，添加对mons.httpclient，mons.logging模块的依赖。(三) Spring配置文件在config目录下增加一个Spring配置文件，如flex-web.xml，通过模块化标签配置与BlazeDS相关的Servlet、Listener。注：该配置文件的内容与BlazeDS配置在传统Web应用web.xml中的内容相对应，如下示例：flex.messaging.HttpFlexSessionMessageBrokerServletflex.messaging.MessageBrokerServlet/messagebroker/*services.configuration.file/flex_xml/services-config.xml注：messageBrokerServlet中要配置加载services-config.xml文件，路径要正确。(四) Flex配置文件将BlazeDS配置文件放置在模块项目face目录下：修改services-config.xml文件中channels标签体的内容，在endpoint的URL属性中加上模块上下文。修改为：注：黄色字体部分为当前应用的应用上下文路径和模块上下文路径。在BlazeDS远程调用时会访问该URL。在services-config.xml文件中的配置属于全局配置，如果全局配置不生效，可以在swf源文件mxml程序的RemoteObject标签里配置endpoint属性（属于局部配置，局部配置的优先级高于全局配置），如下：(五) Flex程序文件首先将Flex项目文件导入到Eclipse里面,修改.actionScriptProperties以及.flexProperties文件.n .actionScriptProperties主要是让Flex编译之后的文件在WebRoot下修改如下:n .flexProperties文件修改上下文的路径serverContextRoot(这里的IAS-UAP是UAP容器,IAS_MODULE是模