基于的项目移植.doc

基于基于 uap2.04uap2.04 的的 sotowersotower 项目移植项目移植 一.新建模块项目.2(一)新建 IAS 容器.2 A.安装 UAP Studio-1.1.exe。.2 B.启动 sguap-service.2 C.新建 UAP 项目.3 D.增加数据库连接.4 E.去除统一权限.5 F.添加模块项目.5 G.在 UAP 中引入 sguap-server.7 H.Jar 包引入.9(二)新建 IAS 模块项目.12 A.新建模块项目.12 B.去除统一权限.13 C.引入 jar 包.14 二.将 EIC1.0 项目移植到 uap2.0 模块项目.15(一)整体目录迁移.15(二)Flex 前台移植.15 三.将 sotower 项目迁移到模块项目.16(一)整体目录迁移.16(二)配置文件新增与修改.17 A.修改项目的 web.xml 文件.17 A.修改 config 下的 xml 文件.24 B.创建 configs 文件夹.25(三)缓存的修改.26(四)修改项目中应用 sotower 包的 java 代码.28(五)配置文件修改.29(六)jar 包调整.30(七)配置.springBeans 文件.30(八)前端移植.31 四.集成 Flex.32(一)Jar 包添加.32(二)配置模块依赖关系.32(三)Spring 配置文件.33(四)Flex 配置文件.35(五)Flex 程序文件.36 五.项目移植总结.38 基于基于 uap2.04uap2.04 的的 sotowersotower 项目移植项目移植 一.新建模块项目 创建 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_modules.properties 配置文献中，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 项目迁移到模块项目(一)整体目录迁移 将 sotower 项目下 src、javatest、javasrc、html-template 直接复制到 uap 模块项目根目录中。将 sotower 项目下 WebContent 中除 WEB-INF 外所有复制到 uap 模块项目下的 face中。将 sotower 项目下 WEB-INF 中的 conf 复制到 uap 模块项目下的 config 中。将 sotower 项目下的所有的 spring 配置文献,复制到 uap 模块项目下的 config 下。将 sotower 项目下 libs 里的 swc 文献复制到 uap 模块项目下的 libs 中。将sotower项目下WebContentWEB-INFlib里的jar包复制到uap模块项目下的libs中。将sotower项目下WebContentWEB-INF中的flex目录复制到uap模块项目下的face中。sotower 项目目录结构图与迁移后的 uap 模块项目目录结构图如下：(二)配置文献新增与修改 A.修改项目的 web.xml 文献 修改之前 sotower 项目的 web.xml 文献,在模块项目的在 config 下新增 web-flex.xml，修改之前项目的 Servlet、Listener,注意标签头,具体格式如下：flex.messaging.HttpFlexSession MessageBrokerServlet flex.messaging.MessageBrokerServlet/messagebroker/*services.configuration.file /flex/services-config.xml URLAccessReport pomentservice.access.servlet.URLAccessReport /URLAccessReport FileExport com.ylkj.ias.export.dowland.servlet.FileExport /FileExport.action UiDesignerUploadServlet com.ylkj.ias.export.upload.servlet.UiDesignerUploadServlet /UiDesignerUploadServlet ExcelUploadServlet com.ylkj.ias.datacollection.datamodel.servlet.ExcelUploadServlet /ExcelUploadServlet ExcelDownloadServlet com.ylkj.ias.datacollection.datamodel.servlet.ExcelDownloadServlet /ExcelDownloadServlet exportImg com.ylkj.ias.export.dowland.servlet.ExportImg /exportImg CommonIOServlet monio.servlet.CommonIOServlet /common-io/*exportXLS com.ylkj.ias.export.dowland.servlet.ExportXLS /exportXLS exportPDF com.ylkj.ias.export.dowland.servlet.ExportPDF /exportPDF reportPageServlet com.ylkj.ias.servlet.ReportPageServlet /json/reportPage FileDownLoadUds com.ylkj.ias.export.dowland.servlet.FileDownLoadUds /FileDownLoadUds WordExportServlet com.ylkj.ias.wordexport.servlet.WordExportServlet /WordExportServlet.action EhCacheServlet com.ylkj.ias.servlet.ReportEhCacheServlet /EhCacheServlet.action uploadImg com.ylkj.ias.export.upload.servlet.ImageUpload /uploadImg ImageServlet com.ylkj.ias.servlet.ImageServlet /ImageServlet zipServlet com.ylkj.ias.servlet.ZipServlet /ZipAction udsUploadServlet com.ylkj.ias.export.upload.servlet.FileUpLoadUds /udsUploadServlet A.修改 config 下的 xml 文献 所有singleton=true 修改为：scope=singleton 所有singleton=false 修改为：scope=prototype B.创建 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.HttpFlexSession MessageBrokerServlet flex.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 文献.actionScriptProperties 重要是让 Flex 编译之后的文献在 WebRoot 下修改如下:.flexProperties 文献修改上下文的途径 serverContextRoot(这里的 IAS-UAP 是UAP 容器,IAS_MODULE 是模块化的项目),尚有 servroot 的途径(这里是 eclipse 下的 WebRoot 途径),以及 serverRootURL 是发布的 uap 的途径,具体修改如下:重新编译 Eclipse 下的 Flex 项目,保证文献都编译到了 WebROOT 下 最后将除了 WEB-INF 这个文献夹,其他的 WebRoot 下的文献所有拷贝到 uap 模块项目的 face 目录下;注意:假如项目还是犯错起不来,必须重写这个SpringFactory.java文献,将这个文献导入到 uap 模块项目中,并在模块项目中添加如下配置文献:五.项目移植总结 到这里项目已经基本移植完毕了,尚有些 java 代码报错的需要自己调整,本项目移植的过程中最重要还是得注意以下几点问题:A.jar 包的冲突,uap 底层使用 spring,hibernate 在项目集成的时候,要注意是否会冲突;B.在 flex 集成的时候,出现无法访问 servler 的方法,在这里要修改com.eic.core.springflex.SpringFactory 这个方法获取 bean 的方式;C.原项目的一些项目级的 servlet,listen 配置文献必须按照 uap 的格式来改造,具体见二(二)A 的修改方式;D.集成 flex 的时候必须注意,flex 的上下问途径必须重写修改(可根据需求来修改),即重新编译 flex 项目,将对于的 swf 文献拷贝到模块项目的 face 目录下;E.最后的注意一些项目的配置文献的加载途径是否对的;