Sun ONE Application Server 7, Update 1 管理員指南 |
佈署應用程式本 module 描述了佈署各種 Sun ONE Application Server 模組與應用程式的方式。
Sun ONE Application Server 模組與應用程式包括 J2EE 標準元素和 Sun ONE Application Server 的特定元素。本 module 僅詳細描述了 Sun ONE Application Server 的特定元素。
若要瞭解有關封裝、組譯模組與應用程式以進行佈署的資訊,請參閱「Sun ONE Application Server Developer's Guide」。
本 module 包括下列主題:
- 關於 J2EE 模組
- 關於 J2EE 應用程式
- J2EE 標準描述元
- Sun ONE Application Server 描述元
- 命名標準
- 佈署目錄結構
- 執行環境
- 關於類別載入器
- 佈署模組與應用程式
- 應用程式佈署描述元檔案
關於 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 佈署描述元在 UNIX 系統上必須具有 600 層存取權限。
所有 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 模組以及用戶端模組的簡單應用程式的目錄結構範例。
+ converter_1/
|--- converterClient.jar
|--+ META-INF/
| |--- MANIFEST.MF
| |--- application.xml
| '--- sun-application.xml
|--+ war-ic_war/
| |--- index.jsp
| |--+ META-INF/
| | |--- MANIFEST.MF
| '--+ WEB-INF/
| |--- web.xml
| '--- sun-web.xml
|--+ ejb-jar-ic_jar/
| |--- Converter.class
| |--- ConverterBean.class
| |--- ConverterHome.class
| '--+ META-INF/
| |--- MANIFEST.MF
| |--- ejb-jar.xml
| '--- sun-ejb-jar.xml
'--+ app-client-ic_jar/
|--- ConverterClient.class
'--+ META-INF/
|--- MANIFEST.MF
|--- application-client.xml
'--- sun-application-client.xml
以下是一個個別佈署的連接器模組的目錄結構範例。
+ MyConnector/
|--- readme.html
|--- ra.jar
|--- client.jar
|--- win.dll
|--- solaris.so
'--+ META-INF/
|--- MANIFEST.MF
|--- ra.xml
'--- sun-ra.xml
執行環境
無論您將組件作為個別佈署的模組,還是作為應用程式進行佈署,都會影響檔案系統與伺服器配置。請參閱圖「模組執行環境」與「應用程式執行環境」。
模組執行環境
下圖「模組執行環境」展示了個別佈署基於模組之佈署的環境。
   模組執行環境
對於檔案系統項目,依如下所示擷取模組:
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」。
應用程式執行環境
下圖「應用程式執行環境」圖解了基於應用程式的佈署環境。
   應用程式執行環境
對於檔案系統項目,依如下所示擷取應用程式:
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 中的各種方法。它涵蓋下列主題:
- 佈署名稱與錯誤
- 佈署生命週期
- 佈署模組或應用程式
- 佈署 WAR 模組
- 佈署 EJB JAR 模組
- 佈署生命週期模組
- 佈署 RMI/IIOP 用戶端
- 佈署 J2EE CA 資源配接卡
- 佈署靜態內容
- 存取共用框架
佈署名稱與錯誤
當您佈署應用程式或模組時,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」。
動態重新載入
如果啟用了動態重新載入,您便無須在變更應用程式或模組的程式碼時將其重新佈署。您所要做的全部工作就是將已變更的類別檔案複製到應用程式或模組的佈署目錄下。伺服器會定期檢查變更,然後自動地動態重新佈署應用程式,並套用變更。
這在開發環境中非常有用,因為它能快速測試程式碼變更。但是,不建議在生產環境中使用動態重新載入,因為這樣做可能會降低效能。此外,一旦重新載入完成之後,瞬時的階段作業便會無效。用戶端必須重新啟動階段作業。
若要啟用動態重新載入,您可執行下列其中一個動作:
- 使用管理介面:
核取 [Reload Enabled] 方塊以啟用動態重新載入。
在 [Reload Poll Interval] 欄位中,輸入一定的秒數以設定檢查 (查看程式碼是否變更) 與動態重新載入應用程式和模組的間隔時間。
移往伺服器實例頁面,並選取 [Apply Changes] 按鈕。
- 編輯 server.xml 檔案中 applications 元素的下列屬性:
dynamic-reload-enabled="true" 啟用動態重新載入。
dynamic-reload-poll-interval-in-seconds 設定檢查 (查看程式碼是否變更) 與動態載入應用程式與模組的間隔時間。
如需關於 server.xml 的詳細資訊,請參閱「Sun ONE Application Server Administrator's Configuration File Reference」。
此外,若要載入新 Servlet 檔案,重新載入 EJB 相關的變更,或重新載入佈署描述元的變更,您必須執行下列動作:
- 在已佈署應用程式的根處建立名為 .reload 的空檔案:
instance_dir/applications/j2ee-apps/app_name/.reload
或在個別佈署模組的根處建立空檔案:
instance_dir/applications/j2ee-modules/module_name/.reload
- 每次進行上述變更時,請明確更新 .reload 檔案的時間標記 (在 UNIX 中為 touch .reload)。
對於 JSP,變更會依在 sun-web.xml 檔案內 jsp-config 元素的 reload-interval 特性中設定的頻率自動重新載入。若要停用 JSP 動態重新載入,請設定 reload-interval="-1"。
佈署工具
此節討論了可用於佈署模組與應用程式的各種工具。佈署工具包括:
asadmin 公用程式
您可以使用 asadmin 公用程式,在本端伺服器上佈署或取消佈署應用程式與個別佈署的模組。不支援在多台機器上同時進行佈署。此節僅簡要描述了 asadmin 公用程式。
若要佈署生命週期模組,請參閱「佈署生命週期模組」。
asadmin deploy
asadmin deploy 指令用於佈署 WAR、JAR、RAR 或 EAR 檔案。若要佈署應用程式,請在指令中指定 --typeapplication。若要佈署個別模組,請指定 --typeejb、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 指令用於取消佈署應用程式或模組。若要取消佈署應用程式,請在指令中指定 --typeapp。若要取消佈署模組,請指定 --typeejb、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 位置。若要使用此工具,請採取下列步驟:
- 開啟伺服器實例之下的應用程式組件。
- 移往 [Enterprise Applications]、[Web Applications]、[Connector Modules] 或 [EJB Modules] 頁面。
- 按一下 [Deploy] 按鈕。
- 輸入模組或應用程式的完整路徑 (或按一下 [Browse] 來查找該路徑),然後按一下 [OK] 按鈕。
- 輸入模組或應用程式名稱。
如果模組或應用程式已經透過核取適當的方塊而存在,則您也可以重新佈署它。此項是選擇性的。
- 透過核取虛擬伺服器名稱旁邊的方塊,可以將應用程式或模組指定給一個或多個虛擬伺服器。
- 按一下 [OK] 按鈕。
若要佈署生命週期模組,請參閱「佈署生命週期模組」。
Sun ONE Studio
您可以使用 Sun ONE Studio 4 佈署 J2EE 應用程式與模組。如需有關使用 Sun ONE Studio 的更多資訊,請參閱「Sun ONE Studio 4, Enterprise Edition Tutorial」。
注意 在 Sun ONE Studio 中,佈署模組或應用程式是指執行該模組或應用程式。執行也包括確定伺服器正在執行並顯示正確的 URL,以啟動模組或應用程式。
佈署模組或應用程式
您可以佈署應用程式或獨立於應用程式的個別模組。「執行環境」描述了在基於應用程式或個別模組的佈署中,執行期間與檔案系統的含意。
當組件需要由下列項目存取時,更應該使用基於個別模組的佈署:
- 其他模組
- J2EE 應用程式
- RMI/IIOP 用戶端 (基於模組的佈署允許經由 RMI/IIOP 用戶端、Servlet 或 EJB 共同存取 Bean。)
所有模組可以結合為一個 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
管理介面
您也可以使用管理介面佈署生命週期模組。請依照下列步驟執行:
- 開啟伺服器實例之下的應用程式組件。
- 移往 [Life Cycle Modules] 頁面。
- 按一下 [Deploy] 按鈕。
- 輸入下列資訊:
Class Name (必填) - 完整的生命週期模組類別檔案名稱。
Classpath (可選) - 生命週期模組的類別路徑。指定模組的位置。預設位置在應用程式的根目錄下。
Load Order (可選) - 決定生命週期模組在啟動時載入的次序。具有較小整數值的模組可以更快地載入。值的範圍從 101 到作業系統的 MAXINT。保留從 1 到 100 的值。
Failure Fatal (可選) - 決定在生命週期模組失敗時,是否關閉伺服器。預設值為 false。
Enable (可選) - 決定是否啟用生命週期模組。預設值為 true。
- 按一下 [OK] 按鈕。
佈署 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 應用程式包括兩個佈署描述元檔案:
- 一個是 J2EE 標準檔案 (application.xml),在 Java Servlet 規格,v2.3,第 13 章「佈署描述元」中對其進行了描述。
- 一個是選擇性的 Sun ONE Application Server 特定檔案 (sun-application.xml),在本節中對其進行了描述。
如需有關應用程式佈署描述元檔案的更多資訊,請參閱「Sun ONE Application Server Developer's Guide」。