Idea下数据平台开发测试配置 说明.docx

1、Idea下数据平台开发测试配置 说明Idea下数据平台开发测试说明LatestUpdate:2012/6/14 by 钟锦源说明：为了使该说明的更新能够方便对比查找，任何修改后请到第八章更新说明部分记录更改信息。目录一、 当前使用软件版本 2二、 安装及使用SVN 21. 安装TortoiseSVN 22SVN使用说明： 2（1）检出代码 2（2）更新代码 2（3）修改并提交代码 2（4）新增文件、文件夹 2（5）其他注意事项 2三、 安装环境搭建 21. JDK安装 22. Maven配置 23. 测试工具相关配置 2（1）COBERTURA_HOME环境变量设置 2（2）ANT_HOME环

2、境变量设置 24. Idea配置 2四、开发说明 21. 数据平台开发运行目录结构说明 22. 数据平台模块新建及开发教程 2（1） 数据平台目录结构说明 2（2） 数据平台新建模块方法 2（3） 数据平台模块目录下pom.xml、osgi.bnd、build.xml说明 2（4） 新建模块获取元数据的方法 23. 日志使用说明 2（1）环境检查 2（2）在需要调用日志的类中增加私有变量 2（3）在需要记录日志的时候调用以下几个函数 2（4）参数化日志信息简介 2（5）数据平台日志记录规范 24. 关于断点调试 2五、测试工具使用说明 21. 检查环境变量 22. 修改相应模块中build.x

3、ml及osgi.bnd文件 23. 修改需要测试模块的stop（）方法 24. 测试运行及检验方法 25. 远程桌面测试说明 2六、虚拟机配置运行说明 2七、配置问题汇总 2八、更新说明 2一、 当前使用软件版本建议按当前版本设置：IntelliJ IDEA Community Edition 10.0maven-2.0.11felix-framework-3.2.2jdk-6-beta2-windows-i586cobertura-1.9.4.1apache-ant-1.8.2（虚拟机版本）VMware-workstation-full-7.0.0-203739二、 安装及使用SVN1. 安

4、装TortoiseSVN安装成功后，在Windows环境下，在文件夹窗口点击右键菜单可看到以下菜单项图 二12SVN使用说明：（1）检出代码初次使用TortoiseSVN的时候，你需要将服务器的代码下载到本地，这就是SVN Checkout（SVN检出）。检出的步骤如下：第一步，如图 二2，创建一个新文件夹作为本地工作目录(Working directory)，可以使用应用名为文件夹名。如工作目录DataPlatformWorkplace：（建议工作目录不要包含中文路径）图 二2第二步，从SVN仓库检出(checkout)一个应用的全部版本代码，如图 二3，右键点击“SVN Checkout”

5、。在弹出页面中填写仓库URL即可，其它默认参数即可，如图 二4图 二3图 二4Reversion处，“HEAD revision”是指最新版，也可以指定Revision为任意一个版本。 点击“OK”，出现下载界面，如图 二5图 二5如果一切顺利，DataPlatform仓库下的说明文档和代码将下载在DataPlatformWorkplace目录下。如图 二6图 二6（2）更新代码 每次修改代码前请务必运行一次右键点击“SVN Update”，获取最新代码（3）修改并提交代码本地使用你喜欢的编辑器，编辑任意文件，保存后该文件图标将会出现红色感叹号，表示这个文件修改过，没有提交，如图6所示： 刚刚

6、修改过的EFormatObtainerImpl.java变色了。下面需要提交(commit)最近的更新。在EFormatObtainerImpl.java上击右键，出现菜单 ，选择“SVN commit”，然后填写关于本次更新的日志（log message），日志中请说明在Jira中任务的编号。图 二7当出现下图时，表示提交成功。（4）新增文件、文件夹在 SVN工作目录下，对于文件修改，完成后只需要commit就ok了，但对于新增文件，或者从其它目录复制进来的文件或文件夹，需要在commit之前需 要做一步add操作，即将文件或文件夹添加到svn工作目录中来，否则SVN客户端不认它。（5）其他

7、注意事项1.svn上只上传代码文件和说明文档。非代码和说明文档的内容如IDEA项目的配置文件（如.iml后缀的文件，target文件夹等）。这些文件不该放到SVN中。可用add to ignore list排除。2.务必保证本地新增了文件后用本地svn的add操作添加文件，然后再commit，不能在repo_browser上add（这样会导致本地文件与svn上文件的版本不对应，之后再update就会被skip掉）3与add操作类似，诸如delete之类的操作都分为本地和svn两种，想要将本地文件的更改同步到svn上，都应该通过本地svn工具进行操作，而不是登上repo_browser进行操作。

8、三、 安装环境搭建1. JDK安装1.直接运行“jdk-6u4-windows-i586-p.exe”，按照安装向导进行安装。2.设置环境变量(Windows NT/2000/XP：控制面板/系统/高级/环境变量；Vista Win7：计算机（右键）/属性/高级系统设置/环境变量):JAVA_HOME= c:Program FilesJavajdk1.6.0 （jdk安装目录）PATH = %PATH%;%JAVA_HOME%bin;CLASSPATH = . ; %;%JAVA_HOME% LIB; 下面一win7为例详细说明此步骤：按照提示安装后选中系统属性。（对着桌面上的计算机图标点 右

9、键属性 也行）选择高级系统设置选择高级标签，打开环境变量新建三个环境变量，变量名和变量值分别如下：变量名变量值JAVA_HOMEC:Program FilesJavajdk1.6.0 （jdk安装目录）PATH%PATH%;%JAVA_HOME%bin;CLASSPATH. ; %;%JAVA_HOME% LIB;注意，第一项根据刚才的安装路径不同而略有不同，第二和第三项跟上表一致3.检查JDK配置打开命令行窗口，运行 java version，若能正确显示jdk版本上述配置完成，否则重新查看上述配置2. Maven配置下载maven。当前开发使用版本为maven-2.0.11，并如下配置2.

10、1.2 下载Maven请访问Maven的下载页面：http:/maven.apache.org/download.html，其中包含针对不同平台的各种版本的Maven下载文件。对于首次接触Maven的读者来说，推荐使用Maven 3.0，因此下载apache-maven-3.0-bin.zip。当然，如果你对Maven的源代码感兴趣并想自己构建Maven，还可以下载apache-maven-3.0 -src.zip。该下载页面还提供了md5校验和（checksum）文件和asc数字签名文件，可以用来检验Maven分发包的正确性和安全性。在本书编写的时候，Maven 2的最新版本是2.2.1，M

11、aven 3基本完全兼容Maven 2，而且较之于Maven 2它性能更好，还有不少功能的改进，如果你之前一直使用Maven 2，现在正犹豫是否要升级，那就大可不必担心了，快点尝试下Maven 3吧！ 2.1.3 本地安装将安装文件解压到你指定的目录中，如：D:binjar xvf C:UsersJuven XuDownloadsapache-maven-3.0-bin.zip这里的Maven安装目录是D:binapache-maven-3.0，接着需要设置环境变量，将Maven安装配置到操作系统环境中。打开系统属性面板（桌面上右键单击“我的电脑”“属性”），点击高级系统设置，再点击环境变量，

12、在系统变量中新建一个变量，变量名为M2_HOME，变量值为Maven的安装目录D:binapache-maven-3.0。点击确定，接着在系统变量中找到一个名为Path的变量，在变量值的末尾加上%M2_HOME%bin;，注意多个值之间需要有分号隔开，然后点击确定。至此，环境变量设置完成，详细情况如图2-2所示：图2-2 Windows中系统环境变量配置这里需要提一下的是Path环境变量，当我们在cmd中输入命令时，Windows首先会在当前目录中寻找可执行文件或脚本，如果没有找到，Windows会接着遍历环境变量Path中定义的路径。由于我们将%M2_HOME%bin添加到了Path中，而这

13、里%M2_HOME%实际上是引用了我们前面定义的另一个变量，其值是Maven的安装目录。因此，Windows会在执行命令时搜索目录D:binapache-maven-3.0bin，而mvn执行脚本的位置就是这里。明白了环境变量的作用，现在打开一个新的cmd窗口（这里强调新的窗口是因为新的环境变量配置需要新的cmd窗口才能生效），运行如下命令检查Maven的安装情况：C:UsersJuven Xuecho %M2_HOME%C:UsersJuven Xumvn-v 运行结果如图2-3所示：图2-3 Windows中检查Maven安装第一条命令echo %M2_HOME%用来检查环境变量M2_HO

14、ME是否指向了正确的Maven安装目录；而mvn version执行了第一条Maven命令，以检查Windows是否能够找到正确的mvn执行脚本。2.1.4 升级MavenMaven还比较年轻，更新比较频繁，因此用户往往会需要更新Maven安装以获得更多更酷的新特性，以及避免一些旧的bug。在Windows上更新Maven非常简便，只需要下载新的Maven安装文件，解压至本地目录，然后更新M2_HOME环境变量便可。例如，假设Maven推出了新版本3.1，我们将其下载然后解压至目录D:binapache-maven-3.1，接着遵照前一节描述的步骤编辑环境变量M2_HOME，更改其值为D:bi

15、napache-maven-3.1。至此，更新就完成了。同理，如果你需要使用某一个旧版本的Maven，也只需要编辑M2_HOME环境变量指向旧版本的安装目录。（1）.Unzip the distribution archive, i.e. apache-maven-2.0.11-bin.zip to the directory you wish to install Maven 2.0.11. These instructions assume you chose C:Program FilesApache Software Foundation. The subdirectory apache-maven-2.0.11 will be created from the archive.（2）Add the M2_HOME environment variable by opening up the system properties (WinKey + Pause), sel