課程內容
利用NC-UAP提供的幾個插件包,放入Eclipse(本次課件內容以Eclipse3.2版本為准)的plugins中,搭建NC-UAP的開發環境。在上一章節中,演示了怎么搭建NC產品的應用環境,但作為開發人員,日常的工作都是在Eclipse開發環境中進行。在Eclipse中如何建立開發環境,請看本章詳細介紹。
實例講解
加入NC開發所需的MDE插件
在Eclipse插件中加入NC開發所需的MDE插件如下插件:
- nc.uap.mde.editor_1.0.1.jar
- nc.uap.mde_1.0.2.jar
- nc.uap.mde.wstools_1.0.3.jar
- nc.uap.mde_1.0.12.11.jar
- NCMDP_1.0.8.6b.jar
- NCPlugin_1.0.5.3a.jar
以上插件可以在教程附帶的“配套示例\插件包”目錄中找到,拷貝到eclipse安裝路徑下的plugins目錄下即可。
Eclipse中JRE設置
占擊Eclipse的菜單Preferences進行 Installed JREs的設置。如下圖所示
在上圖中點“Add”按鈕如下圖所示:
點擊Browser選擇安裝NCHome目錄下找到ufjdk目錄並確定后的結果如下圖志示:
在上圖中再點擊“Add External JARs”按鈕分別加載NCHome下的ufjdk\lib\tolls.jar和 ufjdk\jre\lib\ plugin.jar后如下圖所示:
點擊“OK”按鈕完成JRE設置。
取得NC Home、數據源設置和模塊的選擇
NC Home包含了開發環境所需的所有jar包, NC Home就是安裝完NC產品的主目錄。具本操作如如下:點擊Eclipse的Preferences,彈出如下圖,選中MDE Development頁簽,在其可設置NC Home,同時還可以設置數據源和模塊的選擇。
- 第一步:取得NC Home及數據源設置,如下圖所示:
說明:
ü NC Home 通過點擊Browse...按鈕選擇您本機所安裝NC產品所在的NC Home目錄。
ü DriverList 通過下拉框選擇數據源,默認design。
ü Database Type 選擇你所使用數據庫類型,一般選用ORACLE 或 SQL Server的最高版本。
ü Driver Type 通常選擇JDBC,也建議選JDBC。
ü HostName 輸入所使用數據庫安裝機器的IP地址(如裝在本機則為127.0.0.1)。
ü ConnectPort 一般在選擇在數據類型后,系統會自動帶出數據的默認連接端口(除非數據庫連接端口修改過,建議不要手工修改他)。
ü DB/ODBCName 對SQL Server來說就是數據庫實例名,對於Oracle數據庫來說就是SID。
ü OIDMark 是一個由數字或字母 (0-9、A-Z)組成兩位NC系統生成數據ID標識區別符。
ü UserName 數據庫用戶句
ü Password 數據庫口令
- 第二步:開發環境所用到的模塊的選擇,如下圖所示:
說明:
ü 此處比較關鍵,在此選擇大家在開發時所用到的哪些模塊,通常UAP模塊是必需選擇的,其他產品的模塊需要大家結合項目情況進行判斷是否選擇。
- 第三步:Client Connection設置,如下圖所示:
Eclipse中Error/Warnings設置
由於我們開發過程中,特別是在開發環境中引用原有產品的某個模塊private下的某個類時,經常提示錯誤,所以建議將此頁簽中的Forbidden Reference (Access rules)設置成Warning。如下圖所示
新建NC Module Project
打開Eclipse,點擊菜單“新建/項目”,彈出下面的對話框:
選擇MDE Development下的Moudle Project項后,點擊下一步,開始創建Moudle Project,在下面的對話框中填入項目信息和所要創建的Moudle Name如下圖所示:
點擊完成后,會創建項目,形成下圖所示的目錄結構:
至此,開發環境已建立完畢。
在Eclipse中創建中間件、客戶端兩個調試程序
在開發環境中調試程序,一般需要首先啟動NC中間件,然后啟動客戶端調試器。下面我們介如何創建兩個調試程序。
中間件調試程序創建如下圖所示,在所建項目NC_DEMO圖標上點擊右鍵在彈出的快捷菜單上選擇Debug As->NC Middleware就創建了一個NC_DEMO_Server的中間件調試程序。MDE插件會為它設置默認參數,建議一般情況下不需要去修改他。
客戶端調試程序創類似下圖所示,在所建項目NC_DEMO圖標上點擊右鍵在彈出的快捷菜單上選擇Debug As->NC Client就創建了一個NC_DEMO_JStarter的客戶端調試程序。MDE插件會為它設置默認參數,建議一般情況下不需要去修改他。
在Eclipse中運行參數設置
在運行中間件中配置如下參數解決內存不足的問題:
-Xms512M -Xmx1024M -XX:PermSize=128M -XX:MaxPermSize=512M
實例如下圖所示:
當本機內存有限時,為了在運行過程中不會溢出,也可以在Debug的VM Arguments 里添加-Xms512M -Xmx1024M -XX:PermSize=128M -XX:MaxPermSize=512M 如下圖所示
注意:
在設立這兩個調試點之后,要注意兩個問題。
1、你的項目所使用的JRE的安全策略必須是:
grant {
permission java.security.AllPermission;
};
這可以通過修改 {$JRE根目錄}/jre/lib/security下的java.policy文件來實現,否則在啟動中間件時會出現java.security.AccessControlException;
2、要成功運行UAP客戶端調試器(JStarter),必須將jre/lib下的plugin.jar,Tools.jar也加入到項目默認的JRE的classpath中(詳見:2.2.2節描述)
此時即可先啟動NC Middleware,之后運行NC Client,就可以得到如下圖所示的界面了:
至此,NC-UAP的開發環境完全建立起來了!