本文檔介紹了如何將現有的 J2EE（J2EE培訓 ） 企業應用程序導入到 NetBeans IDE 項目中。我們將通過導入 J2EE 1.4 SDK Samples 中包含的 cmpcustomer 示例應用程序來加以說明。
cmpcustomer 應用程序包含一個 src 文件夾（包含企業應用程序部署描述符）、一個 cmpcustomer-ejb 文件夾（包含 EJB 模塊源）以及一個 cmpcustomer-war 文件夾（包含 Web 應用程序客戶機源）。
cmpcustomer 樣例源代碼位於 Sun/AppServer/samples/ejb/cmp/aPPS/cmpcustomer 文件夾中。如果您沒有 J2EE 1.4 SDK Samples，可以從 http://Java.sun.com/J2EE/1.4/download.Html 下載。請確保將樣例提取到 Sun/APPServer/Samples 文件夾中。
入門指南
在開始之前，我們先准備好所有必需的軟件並設置好環境。
安裝軟件
開始之前，需要在計算機中安裝以下軟件：
NetBeans IDE 4.1
Sun Java System (SJS) Application Server Platform Edition 8 2005Q1
Java Standard Development Kit (JDKTM) 1.4.2 版或 5.0 版
注冊 Sun Java System Application Server
在使用 J2EE 項目之前，必須先注冊 SJS Application Server 的實例。如果安裝了 NetBeans IDE 4.1/SJS Application Server 包，則會自動注冊本地應用服務器。
1 從主窗口中選擇“工具”>“服務器管理器”。
2 單擊“添加服務器”。選擇 Sun Java Systems Application Server 8.1，並為此實例指定一個名稱。然後單擊“下一步”。
3 指定應用服務器的安裝目錄（例如 C:\Sun\APPServer），然後單擊“下一步”。
4 從“位置”組合框中，選擇應用服務器本地實例的位置。
5 （可選）輸入管理員用戶名和口令。如果不希望在 IDE 用戶目錄中存儲用戶名和口令，可以將這些字段保留為空。IDE 在每次需要此信息時會提示您輸入。
注意：缺省的管理員口令是 adminadmin。
6 單擊“運行環境”窗口，然後展開“服務器”節點。此時將列出 SJS Application Server。
7 右鍵單擊應用服務器的節點並選擇“啟動/停止服務器”，然後單擊“啟動服務器”。服務器立即被啟動。
導入整個企業應用程序
如果企業應用程序符合以下規則，則可以一次性導入整個應用程序：
遵循 Java BluePrints 對企業應用程序項目結構的建議。
您不希望使用現有的 Ant 生成腳本來生成企業應用程序的模塊，則 IDE 會為每個模塊創建生成腳本。
注意：有些舊版本的 cmpcustomer 示例與 BluePrints 不相符。如果 IDE 不允許將示例作為項目打開，請轉至 http://Java.sun.com/J2EE/1.4/download.Html 下載最新版本的 J2EE 樣例。
創建並配置項目
1 選擇“文件”>“新建項目”(Ctrl-Shift-N)。
2 選擇“企業”>“包含現有源的企業應用程序”。單擊“下一步”。
3 在“位置”字段中，鍵入或找到包含企業應用程序的文件夾。此文件夾應包含企業應用程序的 src 文件夾，並且是各應用程序模塊的頂層文件夾。在本示例中，應輸入 cmpcustomer 文件夾。
4 將項目命名為 cmpcustomer（或指定任意名稱），然後指定項目文件夾的位置。我們將此位置稱為 NetBeans_projects。對於“包含現有源的企業應用程序”，不能在與源文件夾相同的位置創建項目文件夾。
5 選擇項目的 J2EE 版本。此設置定義了 IDE 將使用哪一版本的 J2EE 規范來生成代碼及維護部署描述符。
6 設置項目的目標應用服務器，然後單擊“完成”。IDE 將為企業應用程序及其各個模塊創建標准 IDE 項目。
注意：IDE 將顯示一條警告，提示您檢查 sun-application.XML 文件中的 context-root 元素。這是因為 IDE 不知道模塊的 JAR 文件和 WAR 文件所使用的名稱，因此為它們指定了其自身的名稱。
7 展開 cmpcustomer 項目的“配置文件”節點，右鍵單擊 sun-application.XML，然後選擇“編輯”。
8 將 web-uri 元素更改為 cmpcustomer-war.war。保存並關閉文件。
設置項目類路徑
由於企業應用程序的部署描述符不包含應用程序模塊間的類路徑關系的任何信息，因此您必須自己配置類路徑。
1 在“項目”窗口中，右鍵單擊 cmpcustomer-war 項目節點，然後選擇“屬性”。在對話框的左面板中選擇“庫”。
2 單擊“添加項目”，為 cmpcustomer-ejb 項目選擇項目文件夾 (NetBeans_projects/cmpcustomer/cmpcustomer-ejb)，然後單擊“確定”。此時會將 EJB 模塊的類添加到 Web 模塊的類路徑中。
注意：必須為 cmpcustomer-ejb 項目選擇項目文件夾，而不是 cmpcustomer-ejb 源文件夾。
配置數據庫和 JDBC 資源
SJS Application Server 帶有一個預先配置的 PointBase 數據庫（名為 sun-aPPServer-samples），該數據庫中包含此示例所需的表。如果更改或刪除了這些表，則可以使用 SQL 腳本在 cmpcustomer/setup 文件夾中重新創建它們。
為使 EJB 模塊能夠訪問此數據庫，必須在服務器上為數據庫創建連接池和數據庫資源。可以在 EJB 模塊項目中使用服務器資源文件執行此操作。
1 右鍵單擊 cmpcustomer-ejb 項目並選擇“新建”>“文件/文件夾”。從“Sun 資源”類別中，選擇“JDBC 連接池”模板並單擊“下一步”。
2 在“JDBC 連接池名稱”字段中，鍵入 cmpcustomerPool。選擇“從現有的連接提取”單選按鈕，然後從組合框中選擇 sun-aPPServer-samples 數據庫。單擊“下一步”。
3 鍵入 pbpublic 作為“口令”屬性的值，然後單擊“完成”。此時，連接池節點將出現在項目的“服務器資源”節點下。
現在，我們將創建連接到連接池的數據庫資源。
1 右鍵單擊 cmpcustomer-ejb 項目並選擇“新建”>“文件/文件夾”。從“Sun 資源”類別中，選擇“JDBC 資源”模板並單擊“下一步”。
2 選擇“使用現有的 JDBC 連接池”，然後從組合框中選擇 cmpcustomerResource。
3 在“JNDI 名稱”字段中鍵入 jdbc/cmpcustomer，然後單擊“完成”。此時，資源節點將出現在項目的“服務器資源”節點下。
最後，我們必須對 EJB 模塊進行配置，以便在查找數據庫時使用正確的 JNDI 名稱。
1 展開“配置文件”節點並雙擊 sun-ejb-jar.XML。
2 在“CMP 資源”部分的“Jndi 名稱”字段中，鍵入 jdbc/cmpcustomer。保存並關閉文件。
運行應用程序
1 如果 cmpcustomer 項目不是主項目，請右鍵單擊項目節點，然後選擇“設置主項目”。
2 選擇“運行”>“運行主項目”。IDE 將為項目生成 EAR 文件，並將其部署到應用服務器中。
導入單個模塊
在以下情況中，可能需要導入單個模塊：
企業應用程序不符合 BluePrints 建議。
模塊是獨立的 EJB 模塊或 Web 應用程序。
您希望使用自己的 Ant 生成腳本來生成、部署及調試模塊。
我們將通過單獨導入 cmpcustomer-ejb 模塊來加以說明。可以使用兩個模板來導入單個 EJB 模塊：
包含現有源的 EJB 模塊
使用此項目模板可創建標准的 EJB 模塊項目。標准的 EJB 模塊項目使用 IDE 來編譯、運行和調試 EJB 模塊。
包含現有 Ant 腳本的 EJB 模塊
使用此項目模板可創建自由格式的 EJB 模塊項目。自由格式的 EJB 模塊項目使用您自己的 Ant 腳本來編譯和運行 EJB 模塊，以及啟動 NetBeans 調試器。
注意：不能在多個 IDE 項目中使用一個源文件夾。如果您已經按如上所述為 cmpcustomer 示例創建了“包含現有源的企業應用程序”項目，則必須關閉該項目，退出 IDE，刪除該項目的項目文件夾，然後重新啟動 IDE。
使用 IDE 進行生成、部署和調試
在創建標准的 EJB 模塊項目時，IDE 會創建一個 Ant 生成腳本和一些屬性文件，這些屬性文件控制項目的生成和部署方式。在設置項目選項時，IDE 會更新 Ant 腳本。
創建項目
1 選擇“文件”>“新建項目”(Ctrl-Shift-N)。
2 選擇“企業”>“包含現有源的 EJB 模塊”。單擊“下一步”。
3 在“位置”字段中，鍵入或找到包含 EJB 模塊源的文件夾。通常，此文件夾應包含 EJB 模塊的 src 文件夾，但它也可以是任意文件夾。IDE 可以滿足任何 EJB 模塊結構的需要。在本示例中，應輸入 cmpcustomer/cmpcustomer-ejb 文件夾。
4 將項目命名為 cmpcustomer-ejb（或指定任意名稱），然後指定項目文件夾的位置。
5 設置項目的目標應用服務器。
6 選擇項目的 J2EE 版本。此設置定義了 IDE 將使用哪一版本的 J2EE 規范來生成代碼及維護部署描述符。
7 單擊“下一步”。在“現有的源和庫”頁中，可以配置較復雜的 EJB 模塊項目。可以添加多個源目錄，指定代碼文件夾的位置（如果它不在常規位置上），還可以指定庫文件夾。創建項目時，庫文件夾中的所有文件夾和 JAR 文件會添加到項目的類路徑中。
注意：如果 cmpcustomer-ejb 模塊的源目錄以紅色突出顯示，並且“完成”按鈕處於禁用狀態，則說明源根目錄已經是某個打開項目的一部分。如果您已經按如上所述為 cmpcustomer 示例創建了“包含現有源的企業應用程序”項目，則必須關閉該項目，退出 IDE，刪除該項目的項目文件夾，然後重新啟動 IDE。
8 單擊“完成”而不更改“現有的源和庫”頁中的任何設置。IDE 將創建該 EJB 模塊項目。
注意：如果要運行該模塊，可能必須配置數據庫和 JDBC 資源。
使用您自己的 Ant 腳本進行生成、部署和調試
在創建自由格式的 EJB 模塊項目時，IDE 將使用您的 Ant 生成腳本來生成和部署項目。在 IDE 中，您必須對項目進行設置，以鏡像項目的 Ant 腳本中包含的設置。此外，您還必須編寫自己的目標，以便在 NetBeans 中調試項目。
創建項目
1 選擇“文件”>“新建項目”(Ctrl-Shift-N)。
2 選擇“常規”>“包含現有 Ant 腳本的 EJB 模塊”。單擊“下一步”。
3 鍵入或找到包含 EJB 模塊源的文件夾。通常，此文件夾應包含 EJB 模塊的 src 文件夾，但它也可以是任意文件夾。IDE 可以滿足任何 EJB 模塊結構的需要。在本示例中，應輸入 cmpcustomer/cmpcustomer-ejb 文件夾。IDE 將自動填充生成腳本的名稱。
注意：cmpcustomer-ejb 的生成腳本將導入 Sun/AppServer/samples/ 目錄中的標准 common-ant.xml 生成腳本。該生成腳本假定樣例目錄也位於 APPServer 目錄中。如果單獨下載了樣例，並將其安裝在不同的位置上，IDE 將提示 cmpcustomer-ejb 項目的 build.xml 不是有效的生成腳本。在文本編輯器中打開生成腳本，並對以下行進行編輯，以指向 common-ant.XML 的正確位置：
]>
4 指定項目名稱及項目文件夾的位置，然後單擊“下一步”。
將 Ant 目標與 IDE 命令鏈接在一起
1 在向導的“生成和運行”頁中，指定 IDE 應為項目命令運行哪些目標。IDE 會為每項操作提供建議的目標。請為每項操作指定以下目標：
生成項目：core
清除項目：clean
生成 Javadoc：Javadocs
運行項目：update
配置源文件夾
1 在向導的“EJB 源”頁中，指定包含模塊部署描述符的文件夾。在本示例中，配置文件的文件夾為 cmpcustomer/cmpcustomer-ejb/src/conf。
2 在“服務器資源文件夾”字段中，可以指定一個包含 IDE 生成的所有服務器資源文件的文件夾。服務器資源文件是 XML 文件，IDE 將使用這些文件在 SJS Application Server 中自動配置資源（如 JDBC 連接池和數據源）。在“服務器資源文件夾”字段中鍵入 cmpcustomer/cmpcustomer-ejb/setup。
注意：在 IDE 中，模塊的類路徑設置不用於編譯或執行操作。Ant 腳本將處理這些任務的類路徑。這些設置向 IDE 表明哪些類包含在代碼完成和重構中。
3 在“服務器類型”組合框中，選擇 "Sun Java Systems Application Server 8.1"。
4 在“J2EE 版本”組合框中，選擇 "J2EE 1.4"。此設置定義了 IDE 將使用哪一版本的 J2EE 規范來生成代碼及維護部署描述符。
5 單擊“下一步”。
6 在向導的“源包”頁中，可以添加其他源根目錄，並對包根目錄進行測試。由於本示例只有一個源根目錄，因此不必在此頁中進行任何配置。
7 在“源級別”組合框中，選擇 "JDK 1.4"。此設置會通知 IDE 在代碼完成和錯誤突出顯示中使用 J2SE 平台的哪些類。它不會設置項目的目標 JDK。您必須在 Ant 腳本中設置目標 JDK。
注意：IDE 將在其注冊的所有 Java 平台中查找具有匹配版本號的平台，並使用此平台提供用於調試的 Javadoc 和源代碼。要注冊 Java 平台並指定平台的源代碼和 Javadoc 位置，請選擇“工具”>“平台管理器”。
8 單擊“完成”。cmpcustomer-ejb 項目將同時顯示在“項目”窗口和“文件”窗口中。
配置項目類路徑
在自由格式項目中，Ant 腳本將管理所有類路徑設置。在 IDE 中，可以聲明項目的類路徑，以便與 Ant 腳本中定義的設置相匹配。這些設置用於為項目提供代碼完成、錯誤突出顯示以及重構功能。
對於所有自由格式的 EJB 模塊項目，必須將 J2EE.jar 庫從本地 SJS Application Server 安裝添加到類路徑中。
1 在“項目”窗口中，右鍵單擊 cmpcustomer-ejb 項目節點，然後選擇“屬性”。
2 在對話框的右面板中單擊“Java 源代碼類路徑”。單擊“添加 JAR/文件夾”。在應用服務器的安裝文件夾中找到 lib 文件夾，選擇 J2EE.jar，然後單擊“打開”。
配置項目輸出
要設置項目間的依賴關系，IDE 需要了解生成輸出以及 Javadoc 輸出目錄的名稱和位置。應在項目的屬性中聲明這些內容。
1 在“項目”窗口中，右鍵單擊 cmpcustomer-ejb 項目節點，然後選擇“生成項目”以產生生成輸出。
2 右鍵單擊 cmpcustomer-ejb 項目節點，然後選擇“為項目生成 Javadoc”以生成 Javadoc 輸出目錄。
3 右鍵單擊 cmpcustomer-ejb 項目節點，然後選擇“屬性”。
4 在對話框的右面板中單擊“輸出”。指定各個生成輸出及 Javadoc 輸出目錄，然後單擊“關閉”。
更多後續步驟：
NetBeans IDE 4.1 快速入門指南：
用於 J2SE 應用程序
用於 Web 應用程序
用於 Web 服務
用於 J2EE 應用程序
用於 J2ME MIDP 應用程序
NetBeans IDE 4.1 導入指南：
用於 J2SE 應用程序
用於 Web 應用程序
用於 J2ME MIDP 應用程序
NetBeans IDE 支持和文檔頁
