文件编号：P01-01分 册 号：1/1页 码：5密 级：CInforGuard项目开发手册中创软件商用中间件股份有限公司2010年05月请不要删除后面的分节符变更记录变更版本日期图表、表格、段落号A/M/D原因与修改情况描述修订人审核人1.02010-1-1ALLA创建文档李铭注：A 增加 M 修改 D 删节请不要删除后面的分节符II目录目录第1章 概述11.1. 开发场景11.2. 基本概念1第2章 搭建开发环境22.1. 准备开发工具22.2. 工具安装及环境配置22.2.1. 安装jdk及配置java环境22.2.2. 安装maven及配置仓库32.2.3. Eclipse中安装m2eclipse插件42.2.4. Eclipse中安装RAP开发环境42.2.5. Eclipse中安装国际化编辑插件52.2.6. Eclipse中导入编码样式52.2.7. 设置Eclipse的默认编码5第3章 开发案例73.1. 开发前准备73.2. 组织结构73.2.1. 目录结构73.2.2. 源码组织83.3. 开发流程83.3.1. 建立Eclipse插件工程83.3.2. 添加依赖93.3.3. 添加导出包103.3.4. 开发声明式服务(DService)11第4章 常见问题解答23第5章 参考24附录一 SETTING.XML25附录二 常用动名词33附录三 本地化资源文件的创建方法34附录四 MANIFEST.MF35附录五 POM.XML36附件六OSGI命令说明39附件七 METADATA.XML41请不要删除后面的分节符核高基6-1项目 使用手册1开发案例第1章 概述该文档是为InforGuard UTMP开发人员开发新功能所编写的规范性文档。1.1. 开发场景当UTMP添加新的功能时，开发人员可以根据该文档更快更有效的进行开发。1.2. 基本概念w OSGi：OSGi(JSR 291)也叫Java语言的动态模块系统，它为模块化应用的开发定义了一个基础架构。OSGi容器已有多家开源实现，比如Knoflerfish、Equinox和Apache的Felix。更多信息可以访问：http:/www.osgi.org/Main/HomePage、http:/www.javaeye.com/wiki/OSGi。w Equinox：Equinox是Eclipse中的项目之一，Equinox是作为OSGI R4 RI而知名的，同时由于Equinox有Eclipse IDE这么个成功案例，反应出了Equinox作为OSGI框架的优势。更多信息可以访问：http:/www.eclipse.org/equinox/、http:/www.riawork.org/。w Bundle：OSGi服务框架定义的模块化单元，称之为一个Bundle。一个Bundle由java的类和其他资源组成，可以为终端用户提供功能。Bundle的描述信息存放在一个manifest文件中，这个文件包含在JAR文件中的META-INF目录下，命名为MANIFEST.MF。通过Bundle的符号名称和版本号可以在框架中惟一的确定一个Bundle。w Eclipse RAP： Eclipse RAP项目的目的是让开发人员能够利用Eclipse开发模型来构建Rich，Ajax-enabled Web应用程序。主要运用著名的Eclipse平台扩展点插件机制和一个包含SWT/JFace API的widget工具包。RAP 项目旨在使开发人员能够使用 Eclipse 开发模型构建富 Internet 应用程序。RAP 允许开发人员使用丰富的 Java 库和 Eclipse API 构建基于浏览器的 Ajax 应用程序。它通过提供 SWT、JFace 和 Eclipse Workbench 的基于 Web 的实现来提供此项功能。 更多RAP信息可访问：http:/www.eclipse.org/rap/。第2章 搭建开发环境2.1. 准备开发工具w JDK 1.5或以上版本，下载地址：ftp:/192.168.51.11/Tools/Program/JDK/jdk-1_5_0_16-windows-i586-p.exe/ w Maven 2.0.9或以上版本，下载地址：ftp:/192.168.51.11/Tools/Program/maven/apache-maven-2.2.1-bin.zip w Eclipse 3.5或以上版本，下载地址：ftp:/192.168.51.11/Tools/Program/%B1%E0%BC%AD%C6%F7/Eclipse/eclipse-java-galileo-SR2-win32.zip 注：192.168.51.11的用户名/密码：user/1232.2. 工具安装及环境配置2.2.1. 安装jdk及配置java环境1. 安装Windows操作系统上的JDK安装程序是一个exe可执行程序，直接安装即可，在安装过程中可以选择安装路径以及安装的组件等，如果没有特殊要求，选择默认设置即可。程序默认的安装路径在C:Program FilesJava目录下。2. 环境变量设置：配置步骤为：1) 右击“我的电脑”，点击“属性”：选择“高级”选项卡，点击“环境变量”。2) 在“系统变量”中，设置3项属性，JAVA_HOME,PATH,CLASSPATH(不分大小写) JAVA_HOME指明JDK安装路径，假设JDK的版本为1.6.0_16，安装路径为默认路径， 则该值应设为C:Program FilesJavajdk1.6.0_16，此路径下包括lib，bin，jre等文件夹（此变量最好设置，因为以后运行一体化管理平台，eclipse等都需要此变量）； PATH使得系统可以在任何路径下识别java命令，设为：%JAVA_HOME%bin; CLASSPATH为java加载类(class or lib)路径，只有类在classpath中，java命令才能识别，设为：.;%JAVA_HOME%libdt.jar;%JAVA_HOME%libtools.jar (要加.表示当前路径)，%JAVA_HOME%就是引用前面指定的JAVA_HOME。3. 验证安装成功：1) 打开“开始”“运行”cmd java version 屏幕输出java版本信息说明安装成功，否则说明配置错误，需要重新进行配置。2.2.2. 安装maven及配置仓库1. 安装1) 下载并解压至想要安装的目录2) 设置Maven系统环境变量，例如：MAVEN_HOME=E:apache-maven3) 添加%MAVEN_HOME%bin至系统环境变量PATH中。4) 确认Maven的安装：cmd mvn version屏幕输出maven版本说明安装成功。2. 配置本地Repository本地Repository的默认值是$user.home/.m2/repository/。可以在user configuration(即在$MAVEN_HOME/conf/setting.xml）中改变本地Repository的位置。例如本地仓库的位置在硬盘的位置为：E:Repository。在setting.xml可以进行如下配置： E:Repository注意：本地Repository 必须是绝对路径。3. 配置代理可以在user configuration(即在$MAVEN_HOME/conf/setting.xml）中配置代理，配置如下： cvicseproxy true http 192.168.2.20 80 localhost releases admin loong2009 snapshots admin loong2009 Trustie Repository1 central Human Readable Name for this Mirror. http:/58.20.54.58/content/groups/treleases Trustie Snapshots Repository1 public-snapshots Human Readable Name for this Mirror. http:/58.20.54.58/content/groups/tsnapshots 注：setting.xml配置文件见附件一2.2.3. Eclipse中安装m2eclipse插件在eclipse中选择Help Install New Software .，在弹出的Install对话框的Work with文本框中添加m2eclipse插件的安装地址http:/m2eclipse.sonatype.org/sites/m2e，选择“Maven Integration for Eclipse (Required)”进行安装。安装完成之后需要在eclipse中自行指定在本机中maven的