| Sun ONE Application Server 7 管理員指南 |
第 13 章
部署應用程式本章描述部署各種 Sun ONE Application Server 模組與應用程式的方式。
Sun ONE Application Server 模組與應用程式包含 J2EE 標準元素和 Sun ONE Application Server 特定元素。本章僅詳細描述 Sun ONE Application Server 特定元素。
若要瞭解有關封裝、組譯模組與應用程式以進行部署的資訊，請參閱「Sun ONE Application Server Developer's Guide」。
本章包含以下主題：
關於 J2EE 模組J2EE 模組是一個或多個 J2EE 元件的集合，這些元件屬於同一種容器類型，並具有該類型的部署描述元。其中一個描述元是 J2EE 標準描述元，另一個則是 Sun ONE Application Server 特定描述元。J2EE 模組的類型有以下幾種：
- Web 應用程式歸檔檔案 (WAR)：Web 應用程式是可以附帶並部署於數個 J2EE 應用程式伺服器的 Servlet、HTML 頁、類別以及其他資源的集合。WAR 檔案可能包含下列項目：Servlet、JSP、JSP 標記庫、公用程式類別、靜態頁面、用戶端 applet、Bean、Bean 類別以及部署描述元 (web.xml 與可選的 sun-web.xml)。
- EJB JAR 檔案：EJB JAR 檔案是組譯企業 Bean 的標準格式。該檔案包含 Bean 類別 (本地、遠端、本機以及執行)、所有的公用程式類別以及部署描述元 (ejb-jar.xml 與可選的 sun-ejb-jar.xml)。如果 EJB 是一個具有容器管理持續性的實體 Bean，則也可能包括 CMP 部署描述元 sun-cmp-mapping.xml。
- 應用程式 (RMI/IIOP) 用戶端 JAR 檔案：RMI/IIOP 用戶端是 Sun ONE Application Server 特定 J2EE 用戶端類型。RMI/IIOP 用戶端支援標準的 J2EE 應用程式用戶端規格，此外，還支援直接存取 Sun ONE Application Server。其部署描述元為 application-client.xml 與可選的 sun-application-client.xml。
- 資源 RAR 檔案：RAR 檔案適用於 J2EE CA 連接器。連接器模組類似於裝置驅動程式。其為一種可攜式方法，可讓 EJB 存取外部企業系統。每個 Sun ONE Application Server 連接器都具有一個 J2EE XML 檔案 (ra.xml)。連接器還必須具有一個 Sun ONE Application Server 部署描述元 (sun-ra.xml)。
必須以全部模組的來源碼使用套裝軟體定義，這樣，類別載入器便可以在部署模組之後正確地尋找類別。
由於部署描述元中的資訊具有宣告性，因此可以變更該資訊，而不需要修改來源碼。在執行期間，J2EE 伺服器會讀取此資訊，並依此資訊進行作業。
EJB JAR 與 Web 模組也可以被組譯為獨立的 .jar 或 .war 檔案，並被單獨部署，獨立於任何應用程式，如下圖所示。
關於 J2EE 應用程式J2EE 應用程式是透過應用程式部署描述元連接在一起的一個或多個 J2EE 模組的邏輯集合。元件可以在模組層級或應用程式層級上進行組譯。元件還可以在模組層級或應用程式層級上進行部署。
元件首先組譯到模組中，然後組譯到 Sun ONE Application Server 應用程式 .ear 檔案中，以備部署。
每個模組具有一個 Sun ONE Application Server 部署描述元和一個 J2EE 部署描述元。Sun ONE Application Server 管理介面使用這些部署描述元來部署應用程式元件，並透過 Sun ONE Application Server 註冊資源。
每個應用程式包含一個或多個模組、一個選擇性 Sun ONE Application Server 部署描述元以及一個必備的 J2EE 應用程式部署描述元。所有項目以 Java 歸檔 (.jar) 檔案格式組譯到一個副檔名為 .ear 的檔案中。
J2EE 標準描述元J2EE 平台提供組譯與部署工具。這些工具將 JAR 檔案作為標準的元件、應用程式套裝軟體使用，並將基於 XML 的部署描述元作為自訂參數使用。如需有關 J2EE 組譯與部署程序的更多資訊，請參閱透過 J2EE 開發企業應用程式，v 1.0，第 7 章。
J2EE 規格，v1.3 中對 J2EE 標準部署描述元進行了描述。
若要在部署之前檢查這些部署描述元的正確性，請參閱「Sun ONE Application Server Developer's Guide」中有關部署描述元檢驗器的資訊。
下表 J2EE 標準描述元顯示尋找關於 J2EE 標準部署描述元更多資訊的位置。左欄列示部署描述元，右欄列示尋找關於這些描述元更多資訊的位置。
您可以在以下網站中找到規格：
Sun ONE Application Server 描述元Sun ONE Application Server 使用附加的部署描述元配置 Sun ONE Application Server 特定功能。除了連接器模組所需的 sun-ra.xml 檔案之外，這些功能均為選擇性的。
若要在部署之前檢查這些部署描述元的正確性，請參閱「Sun ONE Application Server Developer's Guide」中關於部署描述元檢驗器的資訊。
下表 Sun ONE Application Server 描述元顯示尋找關於 Sun ONE Application Server 部署描述元更多資訊的位置。左欄列示部署描述元，右欄列示尋找關於這些描述元更多資訊的位置。
所有 Sun ONE Application Server 部署描述元的 DTD 綱目檔均位於目錄 install_dir/appserv/lib/dtds 中。
命名標準應用程式與個別部署的 EJB JAR、WAR 以及連接器 RAR 模組 (由 server.xml 檔案中的 name 屬性指定) 的名稱在 Sun ONE Application Server 中必須是唯一的。如果您沒有明確地指定名稱，則會將預設名稱作為檔案名稱的第一部份 (沒有副檔名 .war 或 .jar)。如需關於 server.xml 的詳細資訊，請參閱「Sun ONE Application Server Administrator's Configuration File Reference」。
在同一個應用程式內，不同類型的模組可以具有相同的名稱，因為部署應用程式時，包含各類型模組的目錄使用 _jar、_war 或 _rar 字尾命名。一個應用程式內，類型相同的模組必須具有唯一的名稱。此外，在一個應用程式內，資料庫綱目檔的名稱必須是唯一的。
建議將類似於 Java 套裝軟體的命名機制用於在 ejb-jar.xml 檔案的 <module-name> 部分中找到的模組檔名、EAR 檔名、模組名稱，以及在 ejb-jar.xml 檔案的 <ejb-name> 部分找到的 EJB 名稱。使用這種類似於套裝軟體的命名機制可以確保不會發生名稱衝突。該命名慣例的優勢不僅適用於 Sun ONE Application Server，也適用於其他 J2EE 應用程式伺服器。
EJB 的 JNDI 查找名稱也必須是唯一的。在這裡，建立連續的命名慣例也會非常有用。例如，將應用程式名稱與模組名稱附加到 EJB 是保證名稱唯一性的一種方式。在這種情況下，mycompany.pkging.pkgingEJB.MyEJB 就是模組 pkgingEJB.jar 內 EJB 的 JNDI 名稱，該模組封裝於應用程式 pkging.ear 中。
請確定您的套裝軟體和檔案的名稱不含有空格或作業系統不支援的非法字元。
部署目錄結構部署應用程式時，包含各類型模組的目錄會以字尾 _jar、_war 和 _rar 命名。如果您使用 asadmin deploydir 指令部署目錄，而非部署 EAR 檔案，則您的目錄結構必須遵循此慣例。
模組與應用程式目錄結構遵循 J2EE 規格中概述的結構。
以下是一個包含 Web 模組、EJB 模組以及用戶端模組的簡單應用程式的目錄結構範例。
以下是一個個別部署的連接器模組的目錄結構範例。
+ MyConnector/
|--- readme.html
|--- ra.jar
|--- client.jar
|--- win.dll
|--- solaris.so
'--+ META-INF/
|--- MANIFEST.MF
|--- ra.xml
'--- sun-ra.xml
運行時間環境無論您將元件作為個別部署的模組，還是作為應用程式進行部署，都會影響檔案系統與伺服器配置。請參閱圖模組運行時間環境與應用程式運行時間環境。
模組執行環境
下圖模組運行時間環境展示個別部署基於模組之部署的環境。
圖 13-1 模組運行時間環境
對於檔案系統項目，依如下所示擷取模組：
instance_dir/applications/j2ee-modules/module_name
instance_dir/generated/ejb/j2ee-modules/module_name
instance_dir/generated/jsp/j2ee-modules/module_namegenerated/ejb 目錄包含存根與連接；generated/jsp 目錄包含已編譯的 JSP。
生命週期模組依如下方式擷取：
instance_dir/applications/lifecycle-modules/module_name
在 server.xml 中依如下所示加入配置項目：
<server>
<applications>
<type-module>
...module configuration...
</type-module>
</applications>
</server>在 server.xml 內，模組的 type 可以是 lifecycle、ejb、web 或 connector。如需關於 server.xml 的詳細資訊，請參閱「Sun ONE Application Server Administrator's Configuration File Reference」。
應用程式執行環境
下圖應用程式運行時間環境圖解基於應用程式的部署之環境。
圖 13-2 應用程式運行時間環境
對於檔案系統項目，依如下所示擷取應用程式：
instance_dir/applications/j2ee-apps/app_name
instance_dir/generated/ejb/j2ee-apps/app_name
instance_dir/generated/jsp/j2ee-apps/app_namegenerated/ejb 目錄包含存根與連接；generated/jsp 目錄包含已編譯的 JSP。
在 server.xml 中依如下所示加入配置項目：
<server>
<applications>
<j2ee-application>
...application configuration...
</j2ee-application>
</applications>
</server>如需關於 server.xml 的詳細資訊，請參閱「Sun ONE Application Server Administrator's Configuration File Reference」。
配置 server.xml 以使用 FastJavac 編譯器
依預設，Sun ONE Application Server 使用內建 JDK 編譯器在部署期間編譯應用程式。您也可以在部署期間使用 Sun One Studio's FastJavac 編譯器，其編譯速率更快。
在隨附式 Solaris 安裝版本中，FastJavac 編譯器的位置是不透明的。為了使用 FastJavac 編譯器，您需要透過編譯器的路徑來配置管理伺服器的 server.xml，如下所示：
在 server.xml 中的 java-config 元素內加入以下 jvm-option：
<java-config java-home="/<install-dir>/jdk" server-classpath="....." >
jvm-options>-Dcom.sun.aas.deployment.java.compiler=/<install-dir>/studio4/bin/fastjavac/fastjavac.sun</jvm-options>
<property name="com.sun.aas.deployment.java.compiler.options"
value="-jdk /<install-dir>/jdk" />
</java-config>
關於類別載入器瞭解 Sun ONE Application Server 類別載入器可協助您確定如何為模組與應用程式放置支援的 JAR 和資源檔，並確定放置的位置。
在 Java Virtual Machine (JVM) 中，類別載入器動態地載入解決相依性所需的特定 java 類別檔案。例如，若要建立一個 java.util.Enumeration 實例，某個類別載入器會將相關的類別載入到環境中。如需有關類別載入器的更詳細論述，請參閱「Sun ONE Application Server Developer's Guide」。
部署模組與應用程式本節描述將 J2EE 應用程式與模組部署到 Sun ONE Application Server 中的各種方法。它涵蓋下列主題：
部署名稱與錯誤
當您部署應用程式或模組時，server.xml 檔案中會產生一個唯一的名稱。請勿變更此名稱。部署期間，伺服器會偵測所有名稱衝突，並且不會載入具有非唯一名稱的應用程式或模組。發生這種情況後，訊息便會發送至伺服器日誌。如需有關命名的更多資訊，請參閱命名標準。
如果在部署期間發生錯誤，將無法部署應用程式或模組。如果應用程式中的某個模組包含一個錯誤，將無法部署整個應用程式。
如需關於 server.xml 的詳細資訊，請參閱「Sun ONE Application Server Administrator's Configuration File Reference」。
部署生命週期
應用程式在初始部署完畢之後，可能會被修改、重新載入、重新部署、停用、重新啟用，並最終被取消部署 (從伺服器中移除)。本節涵蓋下列與部署生命週期相關的主題：
動態部署
您可以在不重新啟動伺服器的情況下部署、重新部署或取消部署應用程式或模組。這稱為動態部署。
儘管動態部署主要針對開發人員，但是可以在不重新啟動伺服器的情況下，在作業環境中使用動態部署建立新的線上應用程式和模組。一旦重新部署完成之後，瞬時的階段作業便會無效。用戶端必須重新啟動階段作業。
停用已部署的應用程式或模組
您可以停用已部署的應用程式或模組，而不必將其從伺服器中移除。每個應用程式與模組在 server.xml 檔案中都具有一個 enabled 屬性，並在管理介面中有一個相應的選項，您可以變更該選項。如需關於 server.xml 的詳細資訊，請參閱「Sun ONE Application Server Administrator's Configuration File Reference」。
動態重新載入
如果啟用了動態重新載入，您便無須在變更應用程式或模組的程式碼時將其重新部署。您所要做的全部工作就是將已變更的類別檔案複製到應用程式或模組的部署目錄下。伺服器會定期檢查變更，然後自動地動態重新部署應用程式，並套用變更。
這在開發環境中非常有用，因為它能快速測試程式碼變更。但是，不建議在生產環境中使用動態重新載入，因為這樣做可能會降低效能。此外，一旦重新載入完成之後，瞬時的階段作業便會無效。用戶端必須重新啟動階段作業。
若要啟用動態重新載入，您可執行下列其中一個動作：
此外，若要載入新 Servlet 檔案，重新載入 EJB 相關的變更，或重新載入部署描述元的變更，您必須執行下列動作：
對於 JSP，變更會依在 sun-web.xml 檔案內 jsp-config 元素的 reload-interval 特性中設定的頻率自動重新載入。若要停用 JSP 動態重新載入，請設定 reload-interval="-1"。
部署工具
此節討論可用於部署模組與應用程式的各種工具。部署工具包括：
asadmin 公用程式
您可以使用 asadmin 公用程式，在本端伺服器上部署或取消部署應用程式與個別部署的模組。不支援在多台機器上同時進行部署。此節僅簡要描述 asadmin 公用程式。
若要部署生命週期模組，請參閱部署生命週期模組。
asadmin deploy
asadmin deploy 指令用於部署 WAR、JAR、RAR 或 EAR 檔案。若要部署應用程式，請在指令中指定 --type application。若要部署個別模組，請指定 --type ejb、web、connector。語法如下，其中顯示選擇性參數的預設值：
asadmin deploy --user admin_user [--password admin_password] [--host localhost] [-port 4848] [--secure | -s] [--virtualservers virtual_servers] [--type application|ejb|web|connector] [--contextroot contextroot] [--force=true] [--precompilejsp=false] [--name component_name] [--upload=true] [--retrieve local_dirpath] [--instance instance_name] filepath
例如，下列指令用於部署個別 EJB 模組：
asadmin deploy --user jadams --password secret --host localhost --port 4848 --type ejb --instance server1 packagingEJB.jar
asadmin deploydir
asadmin deploydir 指令用於在開放式目錄結構中部署應用程式或模組。結構必須為部署目錄結構中指定的結構。dirpath 位於 instance_dir/applications/j2ee-apps 之下，還是位於 instance_dir/applications/j2ee-modules 之下，決定了其為應用程式還是個別部署的模組。語法如下，其中顯示選擇性參數的預設值：
asadmin deploydir --user admin_user [--password admin_password] [--host localhost] [-port 4848] [--secure | -s] [--virtualservers virtual_servers] [--type application|ejb|web|connector] [--contextroot contextroot] [--force=true] [--precompilejsp=false] [--name component_name] [--instance instance_name] dirpath
例如，下列指令用於部署個別 EJB 模組：
asadmin deploydir --user jadams --password secret --host localhost --port 4848 --type ejb --instance server1 packagingEJB
asadmin undeploy
asadmin undeploy 指令用於取消部署應用程式或模組。若要取消部署應用程式，請在指令中指定 --type app。若要取消部署模組，請指定 --type ejb、web 或 connector。語法如下，其中顯示選擇性參數的預設值：
asadmin undeploy --user admin_user [--password admin_password] [--host localhost] [-port 4848] [--secure | -s] [--type application|ejb|web|connector] [--instance instance_name] component_name
例如，下列指令用於取消部署個別 EJB 模組：
asadmin undeploy --user jadams --password secret --host localhost --port 4848 --type ejb --instance server1 packagingEJB
管理介面
您可以使用管理介面將模組與應用程式部署到本機或遠端 Sun ONE Application Server 網站。若要使用此工具，請採取下列步驟：
若要部署生命週期模組，請參閱部署生命週期模組。
Sun ONE Studio
您可以使用 Sun ONE Studio 4 部署 J2EE 應用程式與模組。如需有關使用 Sun ONE Studio 的更多資訊，請參閱「Sun ONE Studio 4, Enterprise Edition Tutorial」。
部署模組或應用程式
您可以部署應用程式或獨立於應用程式的個別模組。運行時間環境描述在基於應用程式或個別模組的部署中，執行期間與檔案系統的含意。
當元件需要由下列項目存取時，更應該使用基於個別模組的部署：
所有模組可以結合為一個 EAR 檔案，然後作為單一模組進行部署。這類似於獨立部署 EAR 檔案中的模組。
部署 WAR 模組
您可以使用部署工具中描述的任何一種方法部署 WAR 模組。
您可以透過將 -keepgenerated 特性加入至 sun-web.xml 內的 jsp-config 元素中，以保留產生的 JSP 來源。如果您在部署 WAR 模組時納入了此特性，並且該特性位於應用程式中，則產生的來源會保留在 instance_dir/generated/jsp/j2ee-apps/app_name/module_name 下；或者，如果該特性位於個別部署的 web 模組中，則產生的來源會保留在 instance_dir/generated/jsp/j2ee-modules/module_name 下。如需關於 -keepgenerated 特性的更多資訊，請參閱「Sun ONE Application Server Developer's Guide to Web Applications」。
部署 EJB JAR 模組
您可以使用部署工具中描述的任何一種方法部署 EJB JAR 模組。
您可以透過將 -keepgenerated 旗標加入至 server.xml 檔案內 java-config 元素的 rmic-options 屬性中，以保留產生的存根與連接來源。如果您在部署 EJB JAR 模組時納入了此旗標，並且該旗標位於應用程式中，則產生的來源會保留在 instance_dir/generated/ejb/j2ee-apps/app_name/module_name 下；或者，如果該旗標位於個別部署的 EJB JAR 模組中，則產生的來源便保留在 instance_dir/generated/ejb/j2ee-modules/module_name 下。如需關於 -keepgenerated 標幟的更多資訊，請參閱「Sun ONE Application Server Administrator's Configuration File Reference」。
部署生命週期模組
如需關於生命週期模組的一般資訊，請參閱「Sun ONE Application Server Developer's Guide」。
您可以使用下列工具部署生命週期模組：
asadmin 公用程式
若要部署生命週期模組，請使用 asadmin create-lifecycle-module 指令。語法如下，其中顯示選擇性參數的預設值：
asadmin create-lifecycle-module --user admin_user [--password admin_password] [--host localhost] [-port 4848] [--secure | -s] [--instance instance_name] --classname classname [--classpath classpath] [--loadorder load_order_number] [--failurefatal=false] [--enabled=true] [--description text_description] [--property (name=value)[:name=value]*] modulename
例如︰
asadmin create-lifecycle-module --user jadams --password secret --host localhost --port 4848 --instance server1 --classname RMIServer MyRMIServer
若要取消部署生命週期模組，請使用 asadmin delete-lifecycle-module 指令。語法如下，其中顯示選擇性參數的預設值：
asadmin delete-lifecycle-module --user admin_user [--password admin_password] [--host localhost] [-port 4848] [--secure | -s] [--instance instance_name] module_name
例如︰
asadmin delete-lifecycle-module --user jadams --password secret --host localhost --port 4848 --instance server1 MyRMIServer
若要列示部署在伺服器實例上的生命週期模組，請使用 asadmin list-lifecycle-modules 指令。語法如下，其中顯示選擇性參數的預設值：
asadmin list-lifecycle-modules --user admin_user [--password admin_password] [--host localhost] [-port 4848] instance_name
例如︰
asadmin list-lifecycle-module --user jadams --password secret --host localhost --port 4848 server1
管理介面
您也可以使用管理介面部署生命週期模組。請依照下列步驟執行：
部署 RMI/IIOP 用戶端
只有與 EJB 通訊的用戶端才有必要部署。部署 RMI/IIOP 用戶端需要三個步驟：
- 部署 RMI/IIOP 用戶端將要存取的 EAR 或 EJB JAR。
- 組譯必要的用戶端檔案，並部署用戶端。
- 部署完畢之後，將會在下列位置建立用於應用程式的用戶端 JAR 檔案：
instance_dir/applications/j2ee-apps/app_name/app_nameClient.jar
或在下列位置建立用於個別部署模組的用戶端 JAR 檔案：
instance_dir/applications/j2ee-modules/module_name/module_nameClient.jar
用戶端 JAR 檔案包含連接以及 RMI/IIOP 用戶端必需的類別。將該檔案複製到用戶端機器上，並在用戶端上設定環境變數 APPCPATH，以指向該 JAR 檔案。
現在，您準備執行用戶端。如需更多資訊，請參閱「Sun ONE Application Server Developer's Guide to Clients」。
部署 J2EE CA 資源介面
您可以使用部署工具中描述的任何一種方法部署連接器模組。
部署靜態內容
靜態內容 (HTML、影像等) 可以駐留在 Web 伺服器以及 Sun ONE Application Server 之上。然而，註冊 WAR 檔案之後，會在應用程式伺服器上部署靜態內容。Sun ONE Application Server 隨附的全部範例之靜態內容均駐留在應用程式伺服器上。
例如，若要存取應用程式伺服器上的靜態檔案 index.html，請使用：
http://server:port/NASApp/<context_root/index.html
存取共用框架
當 J2EE 應用程式與模組使用共用框架類別 (例如元件與程式庫) 時，可將類別置入系統類別載入器或共用類別載入器的路徑中，而不是載入應用程式或模組中。如果您將一個大型的共用程式庫組譯到每個使用該程式庫的模組中，會導致檔案過大，透過伺服器註冊要佔用太長時間。此外，不同類別載入器中可能包含同一類別的數個版本，這會造成資源浪費。
如需關於系統類別載入器的更多資訊，請參閱關於類別載入器。
應用程式部署描述元檔案Sun ONE Application Server 應用程式包括兩個部署描述元檔案：
如需有關應用程式部署描述元檔案的更多資訊，請參閱「Sun ONE Application Server Developer's Guide」。
