編輯 Java 設定

本節將說明為所選配置編輯 Java 相關設定所涉及的程序。請參閱以下連結：

• 編輯一般設定

• 編輯路徑設定

• 編輯 JVM 設定

• 編輯 JVM 選項

• 增加 JVM 效能評測器

• 增加新的 JVM 效能評測器

• Java 除錯設定

• 啟用 JVM 除錯

• 編輯資源設定

• 之JDBC 資源

• 一般 JDBC 驅動程式

• 增加 JDBC 資源

• 自訂資源

• 增加自訂資源

• 自訂資源的特性

• 外部 JNDI 資源

• 增加外部 JNDI 資源

• 外部 JNDI 資源的特性

• 郵件資源

• 增加新的郵件資源

• 郵件資源的特性

• 伺服器生命週期

• 增加新的生命週期模組

• 刪除生命週期模組

• 編輯生命週期模組

• 編輯認證設定

• 認證範圍的必要特性

• 編輯 Servlet 容器設定

• Servlet 容器參數

• 編輯階段作業複製設定

• 階段作業複製參數

• 編輯 SOAP 認證設定

• SOAP 認證提供者參數

編輯一般設定

本節可讓您啟用 Java，並為所選配置設定 Java 主目錄變數。

編輯一般 Java 設定

1. 選取配置。

   從配置清單中選取配置。按一下 [配置] 標籤以取得可用配置的清單。

2. 按一下 [Java] > [一般] 標籤。

一般 Java 設定的參數

下表將說明在配置一般 Java 設定時可以使用的參數。

表 23 欄位說明 > 一般 Java 設定

編輯路徑設定

本節可讓您為所選配置增加 JVM 類別路徑。

編輯路徑設定

1. 選取配置。

   從配置清單中選取配置。按一下 [配置] 標籤以取得可用配置的清單。

2. 按一下 [Java] > [一般] 標籤。請至 [路徑設定] 區段。

路徑設定的參數

下表將說明在修改配置的 JVM 路徑設定時可以使用的參數。

表 24 欄位說明 > 路徑設定

編輯 JVM 設定

若要在管理介面中設定 JVM 指令行選項，請執行以下工作﹕

編輯 JVM 設定

1. 選取配置。

   從配置清單中選取配置。按一下 [配置] 標籤以取得清單。

2. 按一下 [Java] > [JVM 設定] 標籤。

編輯 JVM 選項

您可以在此處指定值，以增加/刪除指令行 JVM 選項。按一下 [增加 JVM 選項] 按鈕，來增加 JVM 選項。

JVM 選項的一些範例如下： -Djava.security.auth.login.config=login.conf、-Djava.util.logging.manager=com.iplanet.ias.server.logging. ServerLogManager 與 -Xms128m -Xmx256m。

增加 JVM 效能評測器

JVM 效能評測器可協助您診斷並解決 Java 應用程式中的效能問題、記憶體發生的錯誤、多執行緒問題以及系統資源使用問題，以確保您的應用程式具有最高級的穩定性和延伸性。

您可以使用效能評測器對 Sun Java System Web Server 執行遠端評測，以找到伺服器端的效能瓶頸。

增加新的 JVM 效能評測器

1. 選取配置。

   從配置清單中選取配置。按一下 [配置] 標籤以取得可用配置的清單。

2. 按一下 [Java] > [JVM 設定] 標籤。

3. 按一下 [效能評測器] 區段中的 [新增] 按鈕。

4. 提供以下參數的值：

   • 名稱 — 提供新 JVM 效能評測器的簡稱。

   • 已啟用 — 決定是否在執行階段啟用效能評測器。

   • 類別路徑 — 為效能評測器提供有效的類別路徑。(選擇性)。

   • 原生庫路徑 — 提供有效的原生庫路徑。(選擇性)。

   • JVM 選項 — 您可以為 CLI 指定其他 JVM 選項。

     例如 —Xrunhprof:file=log.txt,options

     HPROF 是 Java 2 SE 隨附的一個簡單效能評測器代理程式。它是一個動態連結的程式庫，可與 JVMPI (Java 虛擬機器效能評測器介面) 進行互動式操作，並且可以將評測資訊以 ASCII 或二進位格式寫入檔案或通訊端。效能評測器前端工具可對此資訊進行進一步處理。

     如需有關各種商業效能評測器及其選項的更多資訊，請參閱「Sun Java System Web Server 7.0 Developer's Guide to Java Web Applications」。

Java 除錯設定

JVM 能夠以除錯模式啟動，並可以附加 JPDA (Java 平台除錯程式架構) 除錯程式。您啟用除錯時，會同時啟用本機和遠端除錯。

Sun Java System Web Server 的除錯功能以 JPDA 軟體為基礎。若要啟用除錯，請執行以下作業。

啟用 JVM 除錯

1. 選取配置。

   從配置清單中選取配置。按一下 [配置] 標籤以取得可用配置的清單。

2. 按一下 [Java] > [JVM 設定] 標籤。

3. 選取 [Java 除錯設定] 中的 [啟用除錯] 核取方塊。

4. 按一下 [新增] 按鈕，以提供必要的 JVM 選項。

   預設 JPDA 選項如下：

   -Xdebug -Xrunjdwp:transport=dt_socket,server=y,suspend=n,address=7.0896

   
   

   如果您取代 suspend=y，則 JVM 將以暫停模式啟動，並在除錯程式與其相連接以前，一直處於暫停模式。但如果您希望在 JVM 啟動時便立即啟動除錯，該指令會非常有用。若要指定將 JVM 連接至除錯程式時使用的連接埠，請指定 address=port_number。請查閱 JPDA 文件，以取得除錯選項的清單。

編輯資源設定

此頁面可讓您配置與管理 JDBC、郵件、JNDI 以及其他基於 Java 的資源。

Web 應用程式可以存取多種資源，例如資源管理員、資料來源 (如 SQL 資料來源)、郵件階段作業以及 URL 連線工廠。J2EE 平台透過 Java 命名與目錄介面 (JNDI) 服務向應用程式展示此類資源。

Sun Java System Web Server 能讓您建立與管理以下 Java EE 資源：

• JDBC 資料來源。

• JDBC 連線池。

• Java 郵件階段作業。

• 自訂資源。

• 外部 JNDI 資源。

之JDBC 資源

JDBC 資料來源是一種 Java EE 資源，可以使用 Sun Java System Web Server 建立與管理。

JDBC API 是用於連線關聯式資料庫系統的 API。JDBC API 具有兩個組件﹕

• 應用程式元件用於存取資料庫的應用程式層級介面。

• 將 JDBC 驅動程式連結到 Java EE 平台的服務提供者介面。

JDBC 資料來源物件是採用 Java 程式設計語言的資料來源實作。從基本上來看，資料來源是儲存資料的設備。可以如大公司複雜的資料庫一樣複雜，也可以如具有列和欄的檔案一樣簡單。JDBC 資料來源是 Java EE 資源，可以透過 Sun Java System Web Server 建立與管理。

JDBC API 提供具有標準 SQL 資料庫存取介面的 Java 類別集，以確保對廣泛關聯式資料庫的統一存取權限。

透過使用 JDBC，可以將 SQL 描述傳送至任何虛擬資料庫管理系統 (DBMS)。它同時作為關聯式 DBMS 與物件 DBMS 的介面。

一般 JDBC 驅動程式

下表將提供在增加新的 JDBC 資源時，需要配置的一般 JDBC 驅動程式及其特性清單。請參閱增加 JDBC 資源。

備註 – 以下清單僅列出所有支援之 JDBC 驅動程式的子集。

表 25 一般與受支援的 JDBC 驅動程式清單

增加 JDBC 資源

1. 選取配置。

   從配置清單中選取配置。按一下 [配置] 標籤以取得清單。

2. 按一下 [Java] > [資源] 標籤。

3. 在 [JDBC 資源] 區段中，按一下 [新增] 按鈕。

4. 選取驅動程式供應商。

   指定唯一 JNDI 名稱值，並從可用清單中選取 JDBC 驅動程式供應商。

5. 提供 JDBC 資源特性。

   根據上一步選取的 JDBC 驅動程式供應商，自動寫入驅動程式的類別名稱和 JDBC 資源特性。如需某些常用 JDBC 驅動程式的建議特性清單，請參閱一般 JDBC 驅動程式。

6. 檢視摘要。

   檢視摘要，然後按一下 [完成]，以建立新的 JDBC 資源。

自訂資源

您可以使用此選項向配置實例註冊自訂資源。

增加自訂資源

1. 選取配置。

   從配置清單中選取配置。按一下 [配置] 標籤以取得清單。

2. 按一下 [Java] > [資源] 標籤。

3. 在 [自訂資源] 區段中，按一下 [新增] 按鈕。

自訂資源的特性

下表說明了可用於建立自訂資源的特性。

表 26 欄位說明 > 自訂資源

外部 JNDI 資源

此選項可讓您建立外部 Java Naming and Directory Interface (JNDI) 資源。您需要外部 JNDI 資源，才可存取儲存在內部 JNDI 儲存庫中的資源。

增加外部 JNDI 資源

1. 選取配置。

   從配置清單中選取配置。按一下 [配置] 標籤以取得清單。

2. 按一下 [Java] > [資源] 標籤。

3. 在 [外部 JNDI 資源] 區段中，按一下 [新增] 按鈕。

外部 JNDI 資源的特性

下表說明了在增加新的外部 JNDI 資源時可以使用的特性。

表 27 欄位說明 > 外部 JNDI 資源

郵件資源

JMS 目標是 Java EE 資源，可透過 Sun Java System Web Server 建立與管理。

許多網際網路應用程式都需要傳送電子郵件通知的功能。因此，Java EE 平台包括 JavaMail API 以及 JavaMail 服務提供者，可讓應用程式元件傳送網際網路郵件。

增加新的郵件資源

1. 選取配置。

   從配置清單中選取配置。按一下 [配置] 標籤以取得清單。

2. 按一下 [Java] > [資源] 標籤。

3. 在 [郵件資源] 區段中，按一下 [新增] 按鈕。

郵件資源的特性

下表說明了在增加新的郵件資源時可以使用的特性。

表 28 欄位說明 > 郵件資源特性

伺服器生命週期

• 初始化 — 此階段包括讀取配置、初始化內建子系統；命名、安全性和記錄服務；以及建立 Web 容器。

• 啟動 — 此階段包括載入和初始化已部署的應用程式。

• 服務 — 伺服器已可處理服務請求。

• 關機 — 此階段會停止和銷毀載入的應用程式。系統正在準備關機。

• 終止 — 此階段會終止內建子系統和伺服器執行階段環境。此階段之後不會再有任何作業。

• 重新配置 — 暫態伺服器狀態，在此狀態下會動態重新配置伺服器執行緒 (而伺服器處於服務狀態)。此階段可在伺服器生命週期中出現多次。

增加新的生命週期模組

1. 選取配置。

   從配置清單選取配置。若要檢視配置清單，請按一下 [配置] 標籤。

2. 按一下 [Java] > [生命週期模組] 標籤。

3. 按一下 [新增] 按鈕。

   提供以下參數的值：

   • 名稱 ─ 為新生命週期模組提供有效的唯一名稱。

   • 已啟用 ─ 若要啟用此生命週期模組，請使用此選項。

   • 類別名稱 ─ 完全合格的 Java 類別名稱。該類別應實作 LifecycleListener 介面。如需有關使用此介面的更多資訊，請參閱「Developer's Guide」。

   • 類別路徑 ─ 選擇性。您可以指定偵聽程式類別的類別路徑。

   • 載入次序 — > 100。載入生命週期事件偵聽程式的順序 (依數字順序)。建議選擇大於或等於 100 的載入順序，以避免與內部生命週期模組發生衝突。

   • 載入失敗時 ─ 啟用此選項時，伺服器不會將偵聽程式類別丟出的異常視為嚴重異常，因此將繼續正常啟動。依預設停用。

   • 說明 — 提供關於生命週期模組的簡短說明。

   • 特性 — 這些特性可用來將引數傳送至 Java 生命週期模組。若要增加新的特性，請按一下 [增加特性] 按鈕，然後輸入名稱、值和說明的文字。

   ---

   注意 – 將從主伺服器執行緒同步呼叫各伺服器生命週期偵聽程式類別，因此必須特別謹慎，以確保偵聽程式類別不會阻斷伺服器。如果合適，偵聽程式類別會建立執行緒，但在關機/終止階段必須將其停止。

   ---

刪除生命週期模組

1. 選取配置。

   從配置清單選取配置。若要檢視配置清單，請按一下 [配置] 標籤。

2. 按一下 [Java] > [生命週期模組] 標籤。

3. 選取生命週期模組，然後按一下 [刪除生命週期模組] 按鈕。

編輯生命週期模組

Java 伺服器生命週期模組是 Java 類別，它們偵聽伺服器生命週期事件，以在發生伺服器事件 (如啟動或停止) 時執行特定作業。

伺服器支援在 Web 伺服器環境下執行的持續時間較短或較長的 Java 作業。這些作業在伺服器啟動時會自動初始化，並會在伺服器關機時收到通知。因此，現在您可以立刻得知諸如實例化 singleton、RMI 伺服器等作業。

以下是關於伺服器生命週期的簡要說明：

編輯認證設定

您可以從此頁面增加與刪除認證範圍。基於 Java EE 的安全模型提供用於識別和認證使用者的安全性範圍。

該認證程序會透過 Java 範圍對使用者進行驗證。每個範圍都是由一組使用者、選擇性的群組對映以及用於驗證認證請求的認證邏輯組成。認證請求通過配置範圍的驗證，並建立安全性環境之後，便會將該身份識別套用於所有後續授權決定。

Java 範圍類似於 auth-db (認證資料庫)， 不同的是 auth-db 由 ACL 引擎 (根據 ACL 檔案中的規則) 來使用，而 Java 範圍由 Java Servlet 存取控制規則 (在每一個 Web 應用程式的 web.xml 中指定) 來使用。

一個伺服器實例可以具有任意數量的配置範圍。配置資訊位於 server.xml 檔案的 auth-realm 元素中。

下表定義了 Sun Java System Web Server 7.0 中支援的各種範圍類型。

表 29 範圍類型

以下小節說明了有關增加新認證範圍的步驟。

增加認證範圍

1. 選取配置。

   選取您需要為其增加新的認證範圍的配置。按一下 [配置] 標籤，然後選取配置。

2. 按一下 [Java] > [認證] 標籤。

3. 按一下 [Servlet 認證] 中的 [新增]。

4. 提供範圍詳細資訊。

   • 名稱 — 輸入範圍的簡稱。此名稱用於參考範圍，例如 web.xml 中的範圍。

   • 類別 — 如果您要 配置自訂範圍，請輸入實作自訂範圍的完整 Java 類別名稱。不必為每個內建範圍輸入類別。

   • 類型 — 選取範圍的類型。請參閱表 29。

   • 特性 — 增加範圍特定的特性。例如 property name="file" value="instance_dir/config/keyfile" 與 property name="jaas-context" value="fileRealm。

認證範圍的必要特性

每個認證範圍都需要增加必要的特性。下表中列出一些必要的特性：

表 30 認證範圍的必要特性

編輯 Servlet 容器設定

本節說明配置 Servlet 容器的程序。

編輯 Servlet 容器設定

1. 選取配置。

   從配置清單中選取配置。按一下 [配置] 標籤以取得清單。

2. 按一下 [Java] > [Servlet 容器]。

Servlet 容器參數

下表說明了 Servlet 容器頁面上的參數。

表 31 欄位說明 > Servlet 容器

編輯階段作業複製設定

本節說明了為所選配置設定階段作業複製特性的步驟。

編輯階段作業複製設定

1. 選取配置。

   從配置清單中選取配置。按一下 [配置] 標籤以取得清單。

2. 按一下 [Java] > [階段作業複製]。

階段作業複製參數

下表說明了階段作業複製頁面上的參數。

表 32 欄位說明 > 階段作業複製

編輯 SOAP 認證設定

容器規格的 Java 認證服務提供者介面可定義標準服務提供者介面，認證機制提供者可透過該介面與容器整合。您可以使用管理主控台增加新的 SOAP 認證提供者。

增加 SOAP 認證提供者

1. 選取配置。

   從配置清單中選取配置。按一下 [配置] 標籤以取得清單。

2. 按一下 [Java] > [認證] 標籤。

3. 在 [SOAP 認證] 區段中，按一下 [新增] 按鈕。

SOAP 認證提供者參數

下表說明了新的 SOAP 認證提供者頁面上的參數。

表 33 欄位說明 > SOAP 認證提供者