某軟件項目開發(fā)手冊

1、文件編號：p01-01 分 冊 號：1/1 頁 碼：51 密 級：c inforguard 項項目目 開開發(fā)發(fā)手手冊冊 中創(chuàng)軟件商用中間件股份有限公司 2010 年 05 月 變更記錄變更記錄 變更版本日期圖表、表格、段落號 a/m/d 原因與修改情況描述修訂人審核人 1.02010-1-1alla創(chuàng)建文檔李銘 注：a 增加 m 修改 d 刪節(jié) 目錄目錄 第第 1 章章 概述概述.1 1.1. 開發(fā)場景.1 1.2. 基本概念.1 第第 2 章章 搭建開發(fā)環(huán)境搭建開發(fā)環(huán)境.2 2.1. 準備開發(fā)工具.2 2.2. 工具安裝及環(huán)境配置.2 2.2.1. 安裝jdk及配置java環(huán)境.2 2.2.

2、2. 安裝maven及配置倉庫.3 2.2.3. eclipse中安裝m2eclipse插件.4 2.2.4. eclipse中安裝rap開發(fā)環(huán)境.4 2.2.5. eclipse中安裝國際化編輯插件.5 2.2.6. eclipse中導入編碼樣式.5 2.2.7. 設置eclipse的默認編碼.5 第第 3 章章 開發(fā)案例開發(fā)案例.7 3.1. 開發(fā)前準備.7 3.2. 組織結構.7 3.2.1. 目錄結構.7 3.2.2. 源碼組織.8 3.3. 開發(fā)流程.8 3.3.1. 建立eclipse插件工程.8 3.3.2. 添加依賴.9 3.3.3. 添加導出包.10 3.3.4. 開發(fā)聲明式

3、服務(dservice).11 第第 4 章章 常見問題解答常見問題解答.23 第第 5 章章 參考參考.24 附錄一附錄一 setting.xml.25 附錄二附錄二 常用動名詞常用動名詞.33 附錄三附錄三 本地化資源文件的創(chuàng)建方法本地化資源文件的創(chuàng)建方法.34 附錄四附錄四 manifest.mf .35 附錄五附錄五 pom.xml.36 附件六附件六 osgi 命令說明命令說明.39 附件七附件七 metadata.xml.41 第第 1 章章 概概述述 該文檔是為 inforguard utmp 開發(fā)人員開發(fā)新功能所編寫的規(guī)范性文檔。 1.1. 開開發(fā)發(fā)場場景景 當 utmp 添加

4、新的功能時，開發(fā)人員可以根據該文檔更快更有效的進行開發(fā)。 1.2. 基基本本概概念念 osgi：osgi(jsr 291)也叫 java 語言的動態(tài)模塊系統，它為模塊化應用的開發(fā)定義了一個 基礎架構。osgi 容器已有多家開源實現，比如 knoflerfish、equinox 和 apache 的 felix。 更多信息可以訪問： /main/homepage、http:/ equinox：equinox 是 eclipse 中的項目之一，equinox 是作為 osgi r4 ri 而知名的，同時 由于 equinox 有 eclipse ide 這么個成

5、功案例，反應出了 equinox 作為 osgi 框架的優(yōu)勢。 更多信息可以訪問：/equinox/、/。 bundle：osgi 服務框架定義的模塊化單元，稱之為一個 bundle。一個 bundle 由 java 的類 和其他資源組成，可以為終端用戶提供功能。bundle 的描述信息存放在一個 manifest 文件 中，這個文件包含在 jar 文件中的 meta-inf 目錄下，命名為 manifest.mf。通過 bundle 的符號名稱和版本號可以在框架中惟一的確定一個 bundle。 eclipse

6、 rap： eclipse rap 項目的目的是讓開發(fā)人員能夠利用 eclipse 開發(fā)模型來構建 rich，ajax-enabled web 應用程序。主要運用著名的 eclipse 平臺擴展點插件機制和一個包 含 swt/jface api 的 widget 工具包。rap 項目旨在使開發(fā)人員能夠使用 eclipse 開發(fā)模 型構建富 internet 應用程序。rap 允許開發(fā)人員使用豐富的 java 庫和 eclipse api 構 建基于瀏覽器的 ajax 應用程序。它通過提供 swt、jface 和 eclipse workbench 的基于 web 的實現來提供此項功能。 更多

7、rap 信息可訪問：/rap/。 第第 2 章章 搭搭建建開開發(fā)發(fā)環(huán)環(huán)境境 2.1. 準準備備開開發(fā)發(fā)工工具具 jdk 1.5 或以上版本，下載地址： 1/tools/program/jdk/jdk-1_5_0_16-windows-i586-p.exe/ maven 2.0.9 或以上版本，下載地址： 1/tools/program/maven/apache-maven-2.2.1-bin.zip eclipse 3.5 或以上版本，下載地址： 1/

8、tools/program/%b1%e0%bc%ad%c6%f7/eclipse/eclipse-java-galileo- sr2-win32.zip 注：1 的用戶名/密碼：user/123 2.2. 工工具具安安裝裝及及環(huán)環(huán)境境配配置置 2.2.1. 安裝安裝 jdk 及配置及配置 java 環(huán)境環(huán)境 1.安裝 windows 操作系統上的 jdk 安裝程序是一個 exe 可執(zhí)行程序，直接安裝即可，在安裝過程中 可以選擇安裝路徑以及安裝的組件等，如果沒有特殊要求，選擇默認設置即可。程序默認的安裝路 徑在 c:program filesjava 目錄下。 2.環(huán)境變

9、量設置： 配置步驟為： 1)右擊“我的電腦”，點擊“屬性”：選擇“高級”選項卡，點擊“環(huán)境變量”。 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_ho

10、me%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)下載并解壓至想要安裝的目錄

11、2)設置 maven 系統環(huán)境變量，例如：maven_home=e:apache-maven 3)添加%maven_home%bin 至系統環(huán)境變量 path 中。 4)確認 maven 的安裝： cmd mvn version 屏幕輸出 maven 版本說明安裝成功。 2.配置本地 repository 本地 repository 的默認值是$user.home/.m2/repository/。可以在 user configuration(即在 $maven_home/conf/setting.xml）中改變本地 repository 的位置。例如本地倉庫的位置在硬盤 的位置為：e:repo

12、sitory。在 setting.xml 可以進行如下配置： e:repository 注意：本地 repository 必須是絕對路徑。 3.配置代理 可以在 user configuration(即在$maven_home/conf/setting.xml）中配置代理，配置如下： cvicseproxy true http 0 80 localhost releases admin loong2009 snapshots admin loong2009 trustie repository1 central human readable name for this m

13、irror. 8/content/groups/treleases trustie snapshots repository1 public-snapshots human readable name for this mirror. 8/content/groups/tsnapshots 注：setting.xml 配置文件見附件一 2.2.3. eclipse 中安裝中安裝 m2eclipse 插件插件 在 eclipse 中選擇help install new software .，在彈出的 install 對話框的 wor

14、k with 文本框中 添加 m2eclipse 插件的安裝地址 /sites/m2e，選擇“maven integration for eclipse (required)”進行安裝。 安裝完成之后需要在 eclipse 中自行指定在本機中 maven 的 repository 位置。打開 window/proferences 菜單，點擊 maven 配置項的 installations，去掉默認的 launch maven，添加機器 上的 maven 并選擇使用，點擊 maven 配置項的 user settings，選擇$maven

15、_home /conf/setting.xml 文件，完成配置。 2.2.4. eclipse 中安裝中安裝 rap 開發(fā)環(huán)境開發(fā)環(huán)境 打開 eclipse，選擇help install new software . 菜單。 在彈出的 install 對話框的 work with 文本框中輸入 rap 的安裝地址，如 1.3 版本為： /rt/rap/1.3/tooling。 選擇列表中出現的 rich ajax platform 并點擊下一步。 在詳細頁面點擊下一步。 在許可證頁面選擇同意并點擊完成按鈕。 安裝完成后確認重啟 eclipse

16、。 eclipse 重啟后會出現歡迎頁面，選擇 rich ajax platform(rap) 選擇 install target platform 選擇確定按鈕。 2.2.5. eclipse 中安裝國際化編輯插件中安裝國際化編輯插件 打開 eclipse，選擇help install new software . 菜單。 在彈出的 install 對話框的 work with 文本框中輸入 jinto 的安裝地址： http:/www.guh- software.de/eclipse/。 選擇列表中出現的 opensource tools 并點擊下一步。 在詳細頁面點擊下一步。 在許可證頁

17、面選擇同意并點擊完成按鈕。 安裝完成后確認重啟 eclipse。 2.2.6. eclipse 中導入編碼樣式中導入編碼樣式 打開 eclipse，選擇window preferencesjavacode stylecode templates 菜單。 點擊界面右面的 import 按鈕，選擇 idccodetemplates.xm 文件，點擊 apply 按鈕。 當新建 java 接口/類時，需要選擇 generate comments，如下圖： 2.2.7. 設置設置 eclipse 的默認編碼的默認編碼 打開 eclipse，選擇window preferencesgeneralwork

18、space菜單。 在 text file encoding 中選擇 other，并且把編碼改成 utf-8。 第第 3 章章 開開發(fā)發(fā)案案例例 3.1. 開開發(fā)發(fā)前前準準備備 參照第 2 章搭建好開發(fā)環(huán)境。 3.2. 組組織織結結構構 3.2.1. 目錄結構目錄結構 目錄目錄說明說明 cloud-ui界面原型的 web 工程 cloud-flexflex 開發(fā)工程 cloud -web 存放展示層構件工程 user-management 存放用戶管理工程 3.2.2. 源碼組織源碼組織 本項目主要的包結構如下：rguard.utmp.模塊名.構件名.分組名 3.3

19、. 開開發(fā)發(fā)流流程程 3.3.1. 建立建立 eclipse 插件工程插件工程 啟動 eclispe, 從 eclispe 的 file 菜單創(chuàng)建一個 eclipse 插件工程，file new project plug-in development plug-in project，輸入工程名 cloud-userman-impl，選擇合適的工程目錄，點 擊 next，進入 plug-in project 向導，配置完成后點擊 finish，完成建立工作。 參考上圖設置，點擊 finish 按鈕完成工程創(chuàng)建。 注意：（1）由于我們開發(fā)的是第一個版本，所以 version 先寫成 0.0.1。（

20、2）需要把”generate an activator, a java class that controls the plug-ins life cycle”取消勾選狀態(tài)。（3）如果開發(fā)的是 web 插件，需要把”this plug-in will make contributions to the ui”勾選上。 3.3.2. 添加依賴添加依賴 用 plug-in manifest edit 打開 manifest.mf 文件，切換到 dependecies 視圖，如下圖。 在 required plug-ins 中加入依賴的插件。 在 imported packages 中加入依賴的包。

21、 3.3.3. 添加導出包添加導出包 用 plug-in manifest edit 打開 manifest.mf 文件，切換到 runtime 視圖，如下圖： 在 exported packages 中添加要導出的包。 3.3.4. 開發(fā)聲明式服務開發(fā)聲明式服務(dservice) 在這里我們將開發(fā)一個簡單的例子，這個例子包括以下部分： 發(fā)布一個 osgi 服務。 引用一個 osgi 服務。 使用構件實例生命周期控制方法來激活和去活構件實例。 為了舉例說明 dservice 功能，我們將開發(fā)一個簡單的程序來展現它。這個例子包括 3 個 bundle， 其一是服務接口（hello servic

22、e），對應 pojo project 其二是服務實現，作為一個單獨的構件位于單獨的 bundle 中，并且該構件提供 osgi 服務 （pojo-impl），對應 pojo-impl project 其三是服務使用方，也是作為一個單獨的構件位于單獨的 bundle 中，并且該構件需要使用 hello service 接口的 osgi 服務，對應 pojo client project。 首先，創(chuàng)建一個 hello-api 的服務接口工程（創(chuàng)建過程見 3.3.1. ），添加一個接口類： rguard.utmp.example.hello.ihello，代碼如下： /

23、* * * inforguard copyright 2010 cvicse, co.ltd . * all rights reserved. * * package: rguard.utmp.example.hello * filename: ihello.java * */ package rguard.utmp.example.hello; /* * * 描述： * * 服務接口 * * 創(chuàng)建日期 2010-6-1 * * author li_ming * version 1.0 * */ public interface ih

24、ello /* * 打招呼 * param name 姓名 * return 打招呼語句 */ public string sayhello(string name); 使 hello-api 工程支持 maven，操作如下圖： 點擊“enable dependency managerment”，彈出配置界面，填寫如下： 填寫完后，點擊“finish”，這時候 pom.xml 文件會報錯，你需要把下面的代碼加入 pom.xml 的標簽后面： org.codehaus.mojo build-helper-maven-plugin 1.1 add-source generate-sources a

25、dd-source src org.apache.felix maven-bundle-plugin 2.0.0 true $pom.artifactid rguard.utmp.example.hello pom.xml 中各標簽的詳細說明見附錄五。 雙擊 manifest.mf，在 runtime 中把 rguard.utmp.example.hello 包暴露出來， 詳見 3.3.3. 。 接下來只需要在 eclipse 中右擊工程或者 pom 文件，選擇 run as maven install 即完成工程的構建 工作。當 m

26、aven 報告info build successful 則 hello service 服務構件的 jar 包已經安裝到 maven 的本地庫中，同時生成一個副本位于工程根目錄的 target 下。 第二步創(chuàng)建 hello 接口的實現工程：hello-impl，雙擊 manifest.mf，在 dependencies 中添加 hello-api 插件的依賴，詳見 3.3.2. 。 添加一個 ihello 接口的實現類：rguard.utmp.example.hello.impl. helloimpl，代碼 如下： /* * * inforguard copyr

27、ight 2010 cvicse, co.ltd . * all rights reserved. * * package: rguard.utmp.example.hello.impl * filename: helloimpl.java * */ package rguard.utmp.example.hello.impl; import rguard.utmp.example.hello.ihello; /* * * 描述： * * 服務的實現 * * 創(chuàng)建日期 2010-6-1 * * autho

28、r li_ming * version 1.0 * */ public class helloimpl implements ihello /* * 構造函數 */ public helloimpl() system.out.println(helloimpl starting.); /* (non-javadoc) * see rguard.utmp.example.hello.ihello#sayhello(java.lang.string) */ public string sayhello(string name) string result = hell

29、o + name; return result; 為了能夠管理這些構件和讓 dservice 框架識別我們寫的 pojo 并將之發(fā)布為 hello 的 osgi 服務， 我們還必須要定義一個元數據文件，名稱為 metadata.xml(詳見附件七)，位于本 project 的根目錄下。 其內容如下： component 節(jié)點聲明了一個構件，classname 聲明了該構件實現類，immediate 聲明該構件不是 即時構件，也就是說當 osgi 框架中發(fā)現需要該服務時才實例化該構件。 component 下的 service 節(jié)點表示本構件會以構件實例為服務對象對外提供 osgi 服務，服務的

30、 接口默認暴露出當前構件實現的所有接口，也可以在 service 節(jié)點下加入 provide 節(jié)點來決定該暴露 的詳細的接口，以及對應的服務屬性等，詳見附件七。 instance 節(jié)點表示在當前構件在運行時被 dservice 框架初始化完畢之后，根據配置來確定實例 化構件的次數，即有多少個 instance 就會有多少個構件實例（注意不是指服務對象）。 源代碼和元數據定義完成之后，還需要使 hello-impl 工程支持 maven，并修改 pom.xml： org.codehaus.mojo build-helper-maven-plugin 1.1 add-source generate

31、-sources add-source src org.apache.felix maven-bundle-plugin 2.0.0 true $pom.artifactid rguard.utmp.example.hello.impl metadata.xml org.trustie.loong.modules.loong-dservice loong-dservice-plugin 1.0.0 dservice-bundle rguard.utmp.example hello-api 0.0.1 bundle 本 project

32、所有工作做完之后，同樣只需要在 eclipse 中右擊 project，run as maven install，maven 會為我們將 project 打包成為 dservice bundle 安裝到 maven 本地庫中，并在 target 目 錄下生成同樣一份 jar 文件。 最后建立一個服務消費工程 hello-client，雙擊 manifest.mf，在 dependencies 中添加 rguard.utmp.example.hello的依賴，詳見 3.3.2. 。 添加一個服務使用類：rguard.utmp.examp

33、le.hello.client.helloclient，代碼如下： /* * * inforguard copyright 2010 cvicse, co.ltd . * all rights reserved. * * package: rguard.utmp.example.hello.client * filename: helloclient.java * */ package rguard.utmp.example.hello.client; import rguard.utmp.example

34、.hello.ihello; /* * * 描述： 服務消費類 * 創(chuàng)建日期 2010-6-1 * author li_ming * version 1.0 * */ public class helloclient implements runnable /* * 兩個調用之間的延遲。 */ private static final int delay = 5000; /* * hello 服務。 * 通過容器注入。 * */ private ihello m_hello; / 需要引用的服務。 /* * 結束標志。 */ private boolean m_end = false; /*

35、* 名稱屬性。 * 通過容器注入。 */ private string m_name; public helloclient() system.out.println(helloclient starting.); /* * run 方法。 * see java.lang.runnable#run() */ public void run() while (!m_end) try invokehelloservices(); thread.sleep(delay); catch (interruptedexception ie) /* 將重新檢查 */ /* * 調用 hello 服務。 */

36、 public void invokehelloservices() for (int i = 0; m_hello != null i+) system.out.println(m_helloi.sayhello(m_name); /* * 啟動。 */ public void starting() system.out.println(hello client is starting in mathod starting.); m_end = false; new thread(this).start(); /* * 停止。 */ public void stopping() system

37、.out.println(hello client is stopping in mathod stopping.); m_end = true; 該構件將會創(chuàng)建一個線程，循環(huán)調用服務對象的 sayhello 方法。當該構件在 dservice 框架中 初始化之后，只要發(fā)現有 hello 接口的服務存在，就會馬上創(chuàng)建一個構件實例，并啟動之，調用構 件實例生命周期控制方法（即 helloclient 的 starting 方法，該方法在元數據中聲明。）啟動一個新 的線程并循環(huán)調用服務對象的 sayhello 方法。當服務提供提供者去活之后，即服務對象消失時， dservice 框架也會停止構件實

38、例，同時也會調用構件的聲明周期控制方法設置線程啟動標識，停止 線程。 在 dservice 構件中，如果需要使用 osgi 服務，只需要在構件實現類中定義一個成員變量，類 型為服務接口類型，并在元數據中聲明引用 osgi 服務，就可以在下面的代碼中直接使用該變量了， 因為 dservice 框架會將具體的服務對象引用動態(tài)的注入到當前構件實例，或者通過元數據中聲明 的方法將服務對象綁定到構件實例。 dservice 框架的服務對象注入本身是考慮了同步的，所以開發(fā)人員并不需要關注對于服務對象 的同步控制。從構件的公共方法進入一直到該方法完成，只要該服務提供者存在，引用的服務對象 都不會中途改變，但

39、是由于 osgi 環(huán)境的動態(tài)性，服務對象隨時都有可能因為服務不再提供而消失 （或其他服務對象變更），如果在調用服務的構件中服務對象消失的話，構件調用服務對象的方法 處會收到一個 runtimeexception，表示服務對象已經不存在了；而且如果還有其他的該服務的使用 者的話，dservice 框架也有機制保證基于之前已銷毀的服務對象的操作不會再繼續(xù)做下去，而其他 使用者的操作也會等到新的服務對象注入完成之后，基于新的服務對象來完成后續(xù)的內容。 在上面的構件中還定義了 2 個構件實例生命周期控制方法，starting 和 stoping 方法，這些方法 是被 dservice 框架調用，用來通

40、知構件實例生命周期變化的。構件啟動之后包括 2 種時期： 當構件實例生命周期到為 valid 時期，表示構件在元數據中所有的聲明的方面都已經準備好， 可以對外提供服務或者使用服務了。在 pojo-client 這個構件中，當構件實例生命周期到 valid 時期，dservice 框架調用 starting 方法啟動線程，線程直接使用服務對象循環(huán)打印出一句“hello loong loong loong”，之后當服務引用不滿足時，構件的 stopping 方法會被調用，并停止該線程。 pojo-client 構件同樣需要元數據，因為一個僅有一個 pojo 的 bundle 是無法被 dservi

41、ce 框架 識別出并自動部署的。為了讓 dservice 框架能夠識別當前構件的需求，必須為構件定義元數據， 元數據文件必須位于 project 的根目錄下，名稱為 metadata.xml，具體的元數據內容如下： 聲明的元數據意義按照 xml 中注釋的序號標注，依次為： 1.聲明一個名稱為helloclient的構件，構件實現類為 rguard.utmp.example.hello.client.helloclient ,是即時構件（即所有聲明的 方面狀態(tài)為可用時即刻激活構件實例）。 2.聲明構件實例生命周期控制的 2 個方法，當狀態(tài)變?yōu)?valid 時調用 s

42、tarting 方法，當狀 態(tài)變?yōu)?invalid 時調用 stopping 方法。 3.聲明配置屬性，該屬性名稱為helloc，與字段 m_name 關聯，但是沒有聲明 屬性值。如果屬性是與字段關聯的話，則是由 dservice 框架注入到具體的構件實例對象中的。 4.聲明引用 osgi 服務，該服務對象直接關聯到 pojo 的字段m_hello，服務的接口類型此 處沒有聲明，則是直接通過反射字段的類型取得，因為該字段是數組，所以接口類型 dservice 框 架已知。引用的基數是至少有一個服務，最多不限，即當服務提供者少于一個時，構件會變?yōu)?invalid 的狀態(tài)，而多

43、于 1 個時，會將所有的服務對象以數組的形式交給構件實例。此處引用服務 是關聯到字段，所以 dservice 框架會通過注入的方式將服務對象傳遞給構件實例對象。 5.聲明一個構件實例，構件和構件實例的關系好比 java 的類和對象的關系，當聲明一個 component 之后只定義了一個構件類型，而具體的構件實例則需要通過聲明 instance 來定義。此 處聲明的 instance 表示需要創(chuàng)建構件helloclient的一個構件實例。 6.聲明在構件中定義的名稱為helloc的屬性的值是loong loong loong。構 件實例節(jié)點下的屬性會覆蓋掉構件中聲明的同名的屬

44、性的值。 源代碼和元數據定義完成之后，還需要使 hello-client 工程支持 maven，并修改 pom.xml： 完成以上步驟之后請執(zhí)行 run as maven install。當 maven 提示構建成功之后，本 jar 包會安裝到 本地 maven 庫中，并且位于 project 根目錄下的 target 目錄下同時產生打包成 bundle 的 jar 文件。 第第 4 章章 常常見見問問題題解解答答 【列出開發(fā)過程中的常見問題清單。 】 格式： 清單 1：清單項描述； 清單 2：清單項描述。 第第 5 章章 參參考考 此處列出本文檔的參考文獻 格式： 編號 文獻名稱 版本號清單

45、（多個需用逗號間隔）,組織名清單（多個需用逗號間隔）, 時間 url 地址 舉例： 1 the standard for the format of arpa internet text messages std 11, rfc 822, udel, august 1982 /rfc/rfc822.txt 引用舉例： 2 the standard for the format of arpa internet text messages 附附錄錄一一 setting.xml !- localrepository | the path to the local

46、 repository maven will use to store artifacts. | | default: /.m2/repository /path/to/local/repo - e:rapworkspacerepository !- interactivemode | this will determine whether maven prompts you when it needs input. if set to false, | maven will use a sensible default value, perhaps based on some other s

47、etting, for | the parameter in question. | | default: true true - !- offline | determines whether maven should attempt to connect to the network when executing a build. | this will have an effect on artifact downloads, artifact deployment, and others. | | default: false false - !- plugingroup | spec

48、ifies a further group identifier to use for plugin lookup. com.your.plugins - cvicseproxy true http 0 80 localhost !- server | specifies the authentication information to use when connecting to a particular server, identified by | a unique name within the system (referred to by the id att

49、ribute below). | | note: you should either specify username/password or privatekey/passphrase, since these pairings are | used together. | deploymentrepo repouser repopwd - !- another sample, using keys to authenticate. siteserver /path/to/private/key optional; leave empty if not used. - releases ad

50、min loong2009 snapshots admin loong2009 !- mirror | specifies a repository mirror site to use instead of a given repository. the repository that | this mirror serves has an id that matches the mirrorof element of this mirror. ids are used | for inheritance and direct lookup purposes, and must be uni

51、que across the set of mirrors. | mirrorid repositoryid human readable name for this mirror. http:/ - trustie repository1 central human readable name for this mirror. 8/content/groups/treleases trustie snapshots repository1 public-snapshots human readable name for this mirror. http:/5

52、8/content/groups/tsnapshots !- profile | specifies a set of introductions to the build process, to be activated using one or more of the | mechanisms described above. for inheritance purposes, and to activate profiles via | or the command line, profiles have to have an id that is unique. |

53、| an encouraged best practice for profile identification is to use a consistent naming convention | for profiles, such as env-dev, env-test, env-production, user- jdcasey, user-brett, etc. | this will make it more intuitive to understand what the set of introduced profiles is attempting | to accompl

54、ish, particularly when you only have a list of profile ids for debug. | | this profile example uses the jdk version to trigger activation, and provides a jdk-specific repo. jdk-1.4 1.4 jdk14 repository for jdk 1.4 builds http:/ default always - !- | here is another profile, activated by the system p

55、roperty target-env with a value of dev, | which provides a specific path to the tomcat instance. to use this, your plugin configuration | might hypothetically look like: | | . | | org.myco.myplugins | myplugin | | | $tomcatpath | | | . | | note: if you just wanted to inject this configuration whenev

56、er someone set target-env to | anything, you could just leave off the inside the activation- property. | env-dev target-env dev /path/to/tomcat/instance - !- activeprofiles | list of profiles that are active for all builds. | alwaysactiveprofile anotheralwaysactiveprofile - 附附錄錄二二 常常用用動動名名詞詞 常用名稱：常用

57、名稱： 用戶user角色role 知識庫knowledge流程workflow 策略rule 資產asset 報表report 工單order 配置config組group 代理agent 視圖view 區(qū)域zone 機房machine room 線line節(jié)點node 機架frame 動作action 風險risk 拓撲topology 模板template中心center 適配器adapter 權限popedom 日志log 狀態(tài)state 威脅threat 常用動詞：常用動詞： 添加add 刪除del 修改modify 查詢（返回一個對象）load 查詢（返回一組對象且查 詢包含過濾條件

58、） query枚舉enum 分析analyse 統計stat 關聯correlate評估assess 獲取get設置set 附附錄錄三三 本本地地化化資資源源文文件件的的創(chuàng)創(chuàng)建建方方法法 首先需在 eclipse 中安裝 jinto 插件，安裝地址為 http:/www.guh-software.de/eclipse/。 在 src 中新建一個 resourcebundle file 文件 打開的對話框中 設置屬性文件前綴名 name 比如 eventinfo 選擇 language chinese 選擇 country china 點擊添加，添加一個文件為 eventinfo_zh_cn.p

59、roperties 之后可以多次選擇 language conntry 點擊添加 創(chuàng)建多個 properties 文件 點擊完成 finish 打開剛才創(chuàng)建的文件 keys 列設置鍵 chinese(china)列設置相應的值 附附錄錄四四 manifest.mf manifest-version: 1.0 bundle-manifestversion: 2 bundle-name: %bundle-name bundle-vendor: %bundle-vendor bundle-localization: localization/eventinfo bundle-symbolicname

60、: loong-admin-tools-event;singleton:=true bundle-version: 1.0.0.qualifier require-bundle: org.eclipse.rap.ui,loong-integration-commons;bundle-version=1.0.0 bundle-activationpolicy: lazy bundle-requiredexecutionenvironment: javase-1.6 import-package: org.osgi.service.event;version=1.2.0,org.trustie.l