Sun ONE logo      上一個      目錄      索引      下一個     

Sun ONE Web Server 6.1 管理員指南

第 12 章
配置命名與資源

基於元件的 Java™ 2 平台企業版 (J2EE™) 技術提供了用於 Web 服務的基礎架構，從而簡化了企業的開發和部署工作。

本章描述了 Sun ONE Web Server 提供的 J2EE 資源，並論述了建立與管理這些資源所使用的方法。

如需關於 Java 安全性和基於範圍認證的論述，請參閱「Web 容器與 Web 應用程式之基於 J2EE 的安全性」。

本章包含以下主題：

啟用與停用 Java

您可在全域範圍內 (即每個 Sun ONE Web Server 的實例) 或針對某個特定虛擬伺服器類別啟用或停用 Java。依預設，會在 Sun ONE Web Server 中啟用 Java，並且以下行會增加至 magnus.conf 檔案﹕

Init fn="load-modules" shlib="<server-root>/bin/https/lib/libj2eeplugin.so"

您也可以針對特定的虛擬伺服器啟用 Java。如這樣做，伺服器會使用必備的 J2EE 指令更新虛擬伺服器類別的 obj.conf 檔案。

如需有關 obj.conf 和 magnus.conf 檔案的更多資訊，請參閱「Sun ONE Web Server 6.1 Administrator's Configuration File Reference」與「Sun ONE Web Server 6.1 NSAPI Programmer's Guide」。

在某些情況下，您可能要在全域範圍內或者針對特定的虛擬伺服器類別停用 Java (例如，您的整個伺服器或該類別僅提供靜態內容時)。

若要啟用或停用 Java，請執行以下作業﹕

  1. 存取 [Server Manager] 並選擇 [Java] 標籤。
  2. 按一下 [Enable/Disable Servlets/JSP]。

    3. [Enable/Disable Servlets/JSP] 介面
    顯示 [Enable/Disable Servlets/JSP] 頁面的圖。

  3. 若要全域啟用或停用 Java，請核取或取消核取 [Enable/Disable Java Globally]。

    4. 或

    若要針對特定虛擬伺服器類別啟用或停用 Java，請核取或取消核取對應於虛擬伺服器類別的 [Enable/Disable Java] 核取方塊。

  4. 按一下 [OK]。

配置 JVM 設定

與先前發行版本的產品不同，Sun ONE Web Server 6.1 不再支援獨立的 Java 執行環境 (JRE)。相反，JDK 1.4.1 或更高版本是伺服器必備的。當您安裝伺服器時，如果選取預設的 JDK 選項，Java 開發工具 (JDK) 版本 1.4.1_03 會安裝在 <server-root>/bin/https/jdk 目錄中。

可以為您的伺服器實例配置 Java 虛擬機器 (JVM) 設定。這些設定包括您的 Java Home 位置、編譯程式選項、除錯選項以及效能評測器資訊。配置這些設定的一個原因是為了提昇效能。如需有關效能的更多資訊，請參閱「Sun ONE Web Server 6.1 Performance Tuning, Sizing, and Scaling Guide」。

配置一般設定

若要編輯 JDK 的位置與指定除錯選項﹕

  1. 存取 [Server Manager] 並選擇 [Java] 標籤。
  2. 按一下 [JVM General]。

    3. [JVM General] 介面
    顯示 [JVM General] 頁面的圖。

  3. 設定 Java Home。

    4. Java Home 是安裝 Java Developer's Kit (JDK) 的目錄路徑。Sun ONE Web Server 支援 Sun JDK 1.4.1_03。

  4. 選擇啟用除錯還是設定除錯選項。

    5. 除錯選項的清單位於﹕http://java.sun.com/products/jpda/doc/conninv.html#Invocation

  5. 按一下 [OK]。

配置路徑設定

您可能會由於某些原因想要配置 JVM 路徑設定。例如，您可能要選擇系統類別路徑的後綴，以置換系統類別 (如 XML 剖析器類別)；或者您可能要忽略環境類別路徑，以防止環境變數對生產環境的副作用。

若要在管理介面中配置 JVM 路徑設定，請執行以下工作﹕

  1. 存取 [Server Manager] 並選擇 [Java] 標籤。
  2. 按一下 [JVM Path Settings]。
  3. 選擇系統類別路徑的後綴
  4. 選擇是否忽略環境類別路徑。

    5. 如果不忽略此類別路徑，系統將讀取 CLASSPATH 環境變數，並將其附加至 Sun ONE Web Server 類別路徑。CLASSPATH 環境變數於 classpathsuffix 之後增加，恰在其結尾處。

    對於開發環境，應該使用類別路徑。對於生產環境，應該忽略該類別路徑以防止環境變數副作用。

  5. 設定本端程式庫路徑的前綴和後綴。

    6. 本端程式庫路徑是 Web Server 安裝相對路徑 (用於其本端共用程式庫)、標準 JRE 本端程式庫路徑、Shell 環境設定 (UNIX 上的 LD_LIBRARY_PATH ) 以及 profiler 元素中指定的任何路徑的自動建構之鏈結。由於該本端程式庫路徑是合成的，因此不在伺服器配置中明確出現。

  6. 按一下 [OK]。

配置 JVM 選項

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

  1. 存取 [Server Manager] 並選擇 [Java] 標籤。
  2. 按一下 [JVM Options] 並進行必要的變更。

    3. 如需關於特定 JVM 選項的資訊，請參閱：

    http://java.sun.com/docs/hotspot/VMOptions.html

  3. 按一下 [OK]。

配置 JVM 效能評測器

您可以使用效能評測器執行 Sun ONE Web Server 上的遠端設定檔，以找到伺服器端效能中的瓶頸。

若要在管理介面中配置 JVM 效能評測器，請執行以下工作﹕

  1. 存取 [Server Manager] 並選擇 [Java] 標籤。
  2. 按一下 [JVM Profiler]。
  3. 指定類別路徑、本端程式庫路徑以及是否啟用效能評測器。
  4. 增加、刪除或編輯效能評測器的 JVM 選項，然後按一下 [OK]。

如需有關效能評測器的更多資訊，請參閱「Sun ONE Web Server 6.1 Programmer's Guide」。

關於 J2EE 命名服務與資源

Web 應用程式可以存取各種資源，例如資源管理員、資料來源 (如 SQL 資料來源)、郵件階段作業以及 URL 連線工廠。J2EE 平台透過 Java Naming and Directory Interface (JNDI) 服務向應用程式展示此類資源。

Sun ONE Web Server 允許您建立與管理以下 J2EE 資源：

JDBC 資料來源

JDBC 資料來源是可以使用 Sun ONE Web Server 來建立與管理的 J2EE 資源。

JDBC API 是與關係資料庫系統具有連接性的 API。JDBC API 具有兩個組件﹕

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

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

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

如需有關建立自訂資源的資訊，請參閱建立 JDBC 資源。

JDBC 連線池

JDBC 連線池是資料庫的 JDBC 連線之已命名群組。啟動 Sun ONE Web Server 後，當對池發出第一個連線請求時，將建立這些連線。

JDBC 連線池定義用來建立連線池的特性。每個連線池會在伺服器啟動時，使用 JDBC 驅動程式建立實體資料庫的連線。

基於 JDBC 的應用程式或資源從池建立一個連線並加以使用，不再需要時會透過關閉此連線將其傳回連線池。如果兩個或多個 JDBC 資源指向同一個池定義，在執行時會使用同一個連線的池。

如需有關如何建立新 JDBC 連線池的資訊，請參閱建立新的 JDBC 連線池。

Java 郵件階段作業

JMS 目標是可以透過 Sun ONE Web Server 建立與管理的 J2EE 資源。

許多網際網路應用程式需要傳送電子郵件通知的功能。因此，J2EE 平台包括 JavaMail API 及其 JavaMail 服務供應程式，允許應用程式元件傳送網際網路郵件。JavaMail API 具有兩個組件﹕

Java 郵件階段作業是可以透過 Sun ONE Web Server 建立與管理的 J2EE 資源。

備註

Sun ONE Web Server 不提供 Administration Server 介面來建立 Java 郵件階段作業。您可以使用指令行介面來執行此作業。如需有關如何使用指令行公用程式建立郵件資源的更多資訊，請參閱建立郵件資源。

自訂資源

自訂資源存取本機 JNDI 儲存庫。在 server.xml 中定義的 customresource 元素提供了指定自訂伺服器範圍資源物件工廠的方式。這類物件工廠執行 javax.naming.spi.ObjectFactory 介面。此元素與伺服器範圍名稱空間中使用的 JNDI 名稱 (與其他 Sun ONE Web Server 資源一樣透過 jndiname 子元素指定)、JNDI 類型、資源工廠類別名稱以及用於實例化同一資源工廠類別的標準特性集關聯。

您需要確保資源參照的環境參照連結至使用 server.xml 中的 customresource 和 externaljndiresource 標籤定義的配置伺服器範圍資源。應用程式元件的動態重新部署是 JNDI 命名環境的問題。Sun ONE Web Server 將釋放所有特定應用程式參照，並將所有新參照重新連結至新安裝的應用程式命名環境。

如需有關建立自訂資源的資訊，請參閱建立自訂資源。

外部 JNDI 資源

在 Sun ONE Web Server 中經常執行的應用程式需要具有對外部 JNDI 儲存庫中儲存資源的存取權限。例如，一般 Java 物件可以作為每個 Java 綱目儲存在 LDAP 伺服器中。當自訂資源允許存取本機 JNDI 儲存庫時，若要存取外部 JNDI 儲存庫，您必須使用外部 JNDI 資源。外部 JNDI 工廠必須執行 javax.naming.spi.InitialContextFactory 介面。

如需有關建立外部 JNDI 資源的資訊，請參閱建立外部 JNDI 資源。

關於 Java Naming and Directory Interface (JNDI)

本節論述了 Java Naming and Directory Interface (JNDI)，該介面是存取各種命名與目錄服務的應用程式設計介面 (API)。J2EE 元件透過呼叫 JNDI 查找方法來尋找物件。

本節包含以下主題：

J2EE 命名服務

JNDI 名稱是一個易懂的物件名稱。透過 J2EE 伺服器提供的命名與目錄服務，這些名稱與其物件相對應。因為 J2EE 元件透過 JNDI API 存取此服務，通常物件的易懂名稱指的是物件 JNDI 名稱。例如，Oracle 資料庫的 JNDI 名稱可以是 jdbc/Oracle。該資料庫啟動後，Sun ONE Web Server 會從配置檔案中讀取資訊，並自動在名稱空間中增加 JNDI 資料庫名稱。

此應用程式元件命名環境是在部署或組合時允許自訂應用程式元件企業邏輯的一種機制。使用此應用程式元件環境可自訂應用程式元件，而無需存取或變更應用程式元件來源碼。

J2EE 容器實現 Web 應用程式元件環境，並將其作為 JNDI 命名環境提供給應用程式元件實例。應用程式元件環境使用如下：

每個應用程式元件均定義了自身的環境項目集。在同一容器中應用程式元件的所有實例共用相同的環境項目。不允許應用程式元件實例在執行期間修改此環境。

命名參照與連結資訊

資源參照是部署描述元中識別資源元件編碼名稱的元素。更具體地來說，編碼名稱參照資源的連線工廠。在下面一節所提供的範例中，資源參照名稱為 jdbc/SavingsAccountDB。

資源的 JNDI 名稱與資源參照的名稱不相同。此命名方法需要您在部署之前對映這兩個名稱，但是也會分離資源中的元件。由於此分離作用，以後元件需要存取另一個資源時，您不必變更程式碼中的名稱。這種靈活性也可讓您更容易從優先存在的元件中組合 J2EE 應用程式。

下表列示了建議的 JNDI 查找以及與其關聯的、由 Sun ONE Web Server 使用的 J2EE 資源之參照。

表 12-1  JNDI 查找及其關聯的參照

JNDI 查找名稱

關聯的參照

java:comp/env

應用程式環境項目

java:comp/env/jdbc

JDBC DataSource 資源

java:comp/env/mail

JavaMail 階段作業連線工廠

java:comp/env/url

URL 連線工廠

J2EE 標準部署描述元中的命名參照

命名參照是應用程式用來查找給定命名環境中物件的字串。對於每個 Web 應用程式而言，均具有命名環境，並且在標準元件部署描述元中配置了參照。本節描述了在 Sun ONE Web Server 中使用的標準部署描述元特性。本節包含以下主題：

應用程式環境項目

使用 <env-entry> 定義的環境項目提供了指定 J2EE Web 應用程式部署時間參數的一種方法。請注意，可以使用 <context-param> 定義 Servlet 環境初始化參數，但是使用 <env-entry> 是優選的方法，因為應用程式部署程式可以透過明確地指定這些應用程式的名稱、類型與值來對其進行配置。

以下範例描述了在 J2EE 標準部署描述元中指定的 <env-entry> 語法：

<env-entry>

<description> Send pincode by mail </description>

<env-entry-name> mailPincode </env-entry-name>

<env-entry-value> false </env-entry-value>

<env-entry-type> java.lang.Boolean </env-entry-type>

</env-entry>

<env-entry-type> 標籤指定此項目的完整類別名稱。此處為 snippet 碼，使用 Servlet 中的 JNDI 或 JSP 查找 <env-entry>﹕

Context initContext = new InitialContext();

Boolean mailPincode = (Boolean)

initContext.lookup("java:comp/env/mailPincode");

// 一個使用者可以在子環境中使用相對名稱

Context envContext = initContext.lookup("java:comp/env");

Boolean mailPincode = (Boolean)

envContext.lookup("mailPincode");

資源參照

工廠是應需要建立其他物件的物件。資源工廠可以建立資源物件 (例如資料庫連線或訊息服務連線)。透過標準部署描述元中的 <resource-ref> 元素來配置這些連線。

以下範例描述了使用工廠的資訊：

範例

宣告對 JDBC 連線工廠的參照，此工廠會傳回 javax.sql.DataSource 類型的物件：

<resource-ref>

<description> Primary database </description>

<res-ref-name> jdbc/primaryDB </res-ref-name>

<res-type> javax.sql.DataSource </res-type>

<res-auth> Container </res-auth>

</resource-ref>

<res-type> 是資源工廠的完整類別名稱。<res-auth> 變數的值可以指定為 Container 或 Application。

如果指定 Container，則 Web 容器會在將資源工廠連結至 JNDI 查找登錄之前處理此認證。如果指定 Application，則 Servlet 必須以程式化方式處理認證。在描述資源類型的單獨子環境下，查找的不同資源工廠如下所示﹕

以下為 snippet 碼，用於取得自應用程式元件與處理認證的容器之間的 JDBC 連線：

InitialContext initContext = new InitialContext();

DataSource source =

(DataSource) initContext.lookup("java:comp/env/jdbc/primaryDB");

Connection conn = source.getConnection();

請注意，為了確保這些資源參照可以使用，在執行期間，res-ref-name 必須對映至有效的資源工廠。

資源環境參照

資源環境參照提供了透過 JNDI 查找來存取與資源關聯的管理物件之方法。在標準部署描述元中定義的 <resource-env-ref> 元素可讓應用程式宣告資源需求。

<resource-env-ref> 與 <resource-ref> 元素之間的主要區別在於不存在特定的資源認證需求，資源工廠描述元必須備份這兩個元素。

範例

<resource-env-ref>

<description> My Topic </description>

<res-env-ref-name> jdbc/MyTopic </res-ref-name>

<res-env-ref-type> javax.jdbc.Topic </res-type>

</resource-env-ref>

此處為用來存取 JMS Topic 物件的 snippet 碼﹕

InitialContext initContext = new InitialContext();

javax.jms.Topic myTopic = (javax.jdbc.Topic) initContext.lookup("java:comp/env/jdbc/MyTopic");

初始命名環境

Sun ONE Web Server 中的命名支援主要以 J2EE 1.3 (具有一些增加的增強功能) 為基礎。應用程式元件透過 InitialContext() 建立初始環境時，Sun ONE Web Server 會傳回作為 Web 應用程式的命名環境處理的物件。進而此物件為 java:comp/env 名稱空間提供子環境。每個應用程式取得自己的名稱空間，即每個應用程式具有 java:comp/env 名稱空間，並且在某個 Web 應用程式名稱空間中連結的物件與其他 Web 應用程式中連結的物件不相衝突。

JNDI 連線工廠

對於 J2EE Web 應用程式，web.xml 檔案中的部署描述元是定義應用程式環境項目參照或資源管理員 (如 SQL 資料來源) 連線工廠參照的版面配置區。應用程式使用由 J2EE 容器提供的 JNDI InitialNamingContext 查找這類參照。透過僅對部署描述元進行變更，即不需存取或修改應用程式來源碼，不同的 Web 應用程式伺服器環境就可攜帶這些應用程式。

連線工廠是產生連線物件的物件，其中連線物件可讓 J2EE 元件存取資源。資料庫的連線工廠是 javax.sql.DataSource 物件，該物件可建立 java.sql.Connection 物件。

在 Sun ONE Web Server 中，您可以配置存取以下資源與資源工廠的方法：

server.xml 的 <resources> </resources> 標籤中指定了所有 Sun ONE Web Server 資源 Fatory，並且這些工廠具有使用 jndiname 屬性 (沒有 jndiname 的 jdbconnectionpool 除外) 指定的 JNDI 名稱。此屬性用於註冊伺服器範圍名稱空間中的工廠。部署程式可以使用 sun-web.xml 中的 resource-ref 元素，將使用者指定的特定應用程式資源參照名稱 (在 resource-ref 或 resource-env-ref 元素中宣告) 對映至這些伺服器範圍的資源工廠。這樣可作出關於在給定的應用程式中使用哪個 JDBC 資源 (與其他資源工廠) 的部署時間決定。

自訂資源存取本機 JNDI 儲存庫，而外部資源存取外部 JNDI 儲存庫。兩種類型的資源均需要使用者指定的工廠類別元素、JNDI 名稱屬性等。

在本節中，我們將論述如何建立各種 J2EE 資源以及如何存取這些資源。

建立基於 Java 的資源

本節描述了使用管理介面建立基於 J2EE 的不同資源的方式︰

建立新的 JDBC 連線池

您可以透過以下方式建立新的 JDBC 連線池：

使用管理介面

若要使用管理介面建立新的 JDBC 連線池，請執行以下工作：

  1. 存取 [Server Manager] 並選擇 [Java] 標籤。
  2. 按一下 [JDBC Connection Pools]。
  3. 按一下 [New]。

    4. [JDBC Connection Pool] 介面
    顯示 [JDBC Connection Pool] 頁面的圖。

  4. 從 [Database Vendor] 下拉式清單，選取要連線至的資料庫類型。如果未列示 DBMS，請選取 [Other]。

    5. [New JDBC Connection Pool] 介面
    顯示 [New JDBC Connection Pool] 頁面的圖，已於其中選取了資料庫供應商。

  5. 按一下 [Next]。

    6. 螢幕上會顯示 [Add New JDBC Connection Pool] 頁面。

  6. 指定新連線池的特性，然後按一下 [OK]。

    7. 以下列示的為您必須指定的連線池特性：

    General

    • Pool Name。輸入新連線池的名稱。
    • DataSource Classname。執行資料來源的供應商特定類別名稱。如果在 [New JDBC Connection Pool] 頁面上的 [Database Vendor] 清單中選取了 [Other]，則必須輸入計劃使用之資料來源的供應商特定類別名稱。請注意，此類別必須執行 javax.sql.DataSource。

      • Properties

      指定標準特性與專用的 JDBC 連線池特性；許多特性是選擇性的。依預設，會提供所有標準特性的名稱。您需要查閱資料庫供應商文件，以決定需要哪些標準特性與供應商特定特性。

      Pool Settings

    • Steady Pool Size。指定池應保持的最小連線數。當連線指定給請求的執行緒時，會從池中移除該連線，從而減少了目前池的大小。固定的池大小也指啟動伺服器時增加至池的連線數。
    • Max Pool Size。指定某時某點上池中所允許的最大連線數。
    • Pool Resize Quantity。池向固定池大小縮小時，是以批次來重調大小的。此值決定了批次的大小。值太大會延遲連線的再循環；值太小會使效率非常低。請注意，池容量僅在一段時間內的一次連線時增加，因此該欄位不會影響池容量的增加。
    • Idle Timeout (secs)。連線可以在池中閒置的最大時間 (以秒表示)。這一時間過後，池執行可以關閉此連線。
    • Max Wait Time (milli secs)。呼叫者在取得連線逾時之前要等待的時間。預設等待時間很長，即呼叫者可能等待很長一段時間。如果此值設定為 0，將阻止呼叫者，直到連線可用時為止。

      • Connection Validation

    • Connection Validation Required。如果核取此欄位，則連線在傳送至應用程式之前會得到驗證。這可讓 Web 伺服器自動重新建立資料庫連線 (由於網路故障或資料庫伺服器當機，資料庫不可用時)。對連線進行驗證會耗用額外的時間，並且會略微降低效能。
    • Validation Method。指定 Web 伺服器可以用來驗證資料庫連線的方法。從以下值中選擇﹕
      • auto-commit。在此模式中，查詢描述作為個別異動執行與確定。當停用 auto-commit 時，可將查詢描述群組為異動，這些異動可以透過確定機制或回轉機制終止。
      • meta-data。在此模式中，連線的資料庫可以提供描述其表格、儲存程序等的複合資訊。每個 meta-data 物件實例均將具有一個與其關聯的特定查詢。此 meta-data 物件將執行該查詢並快取查詢結果。
      • table。此方法需要 Web 伺服器對使用者指定的表格執行查詢。
    • Table Name。如果您從 [Validation Method] 下拉式清單中選取驗證選項 [table]，請在此處指定表格名稱。
    • Fail All Connections。指定如果決定單一連線無效，是否要使池中的所有連線無效，然後重新建立連線。如果未核取此選項，則只有在使用這些連線時才會個別重新建立這些連線。

      • Transaction Isolation

      異動使用的隔離層級決定應用程式對其他使用者異動所做變更的敏感程度，以及異動必須需要保持鎖定以保護這些變更的時間。

    • Transaction Isolation。允許您選取此連線的異動隔離層級。從以下值中選擇﹕
      • read-uncommitted。也稱為壞讀取，此隔離層級可讓異動讀取目前資料頁面上的任何資料，無論資料是否已經確定。
      • read-committed。此處以這種方式 (資料的另一異動已變更，但仍未確定) 共用資料的鎖定，將永遠不可以被讀取。由於不讀取未確定資料，因此，如果透過 read-committed 隔離執行的異動再次查詢資料，該資料可能已變更，或顯示符合原始查詢條件的其他資料。
      • repeatable-read。這可確保將鎖定置於查詢中使用的所有資料中。只要您仍未確定或回轉異動，任何其他使用者都不可以修改您異動造訪的資料。
      • serializable。此選項鎖定了資料的範圍，因此重新執行查詢時，在第一個查詢與第二個查詢之間的時間間隔內，任何資料均不會變更，也不會顯示任何其他的資料列。
    • Guarantee Isolation Level。這確保了從池中取得的任何連線均具有相同的隔離層級。例如，如果在上次使用隔離層級時程式化變更了連線的隔離層級 (例如 con.setTransactionIsolation)，這種機制會將其變回至指定的隔離層級。

使用指令行介面

如需關於如何使用指令行介面建立新 JDBC 連線池的資訊，請參閱「指令行公用程式」中的建立 JDBC 連線池。

建立 JDBC 資源

JDBC 資源 (也稱為資料來源) 可讓您使用 getConnection() 建立與資料庫的連線。使用以下方式之一建立 JDBC 資源：

使用管理介面

若要使用管理介面建立 JDBC 資源，請執行以下工作﹕

  1. 存取 [Server Manager] 並選擇 [Java] 標籤。
  2. 按一下 [JDBC Resources]。
  3. 按一下 [New] 按鈕。
  4. 輸入下列資訊：
    • JNDI Name (必需的)。輸入應用程式元件存取 JDBC 資源所必須使用的 JNDI 名稱。
    • Pool Name (必需的)。從此清單中，選取此 JBDC 資源使用的連線池之名稱 (或 ID)。如需更多資訊，請參閱建立新的 JDBC 連線池。
  5. 若要啟用 JDBC 資源，請從 [Data Source Enabled] 下拉式清單選取 [On]。

    6. 如果停用 JDBC 資源，則沒有應用程式元件可以與之連線，但是其配置仍保留在伺服器實例中。

  6. 按一下 [OK]。
  7. 按一下 [Apply Changes]。

使用指令行介面

如需關於如何使用指令行介面建立新 JDBC 資源的資訊，請參閱「指令行公用程式」中的建立 JDBC 資源。

建立自訂資源

您可以透過以下任一方式建立自訂資源﹕

使用管理介面

  1. 存取 [Server Manager] 並選擇 [Java] 標籤。
  2. 按一下 [Custom Resources]。
  3. 按一下 [New] 按鈕。
  4. 輸入下列資訊：
    • JNDI Name (必需的)。輸入應用程式元件存取自訂資源所必須使用的 JNDI 名稱。
    • Resource Type (必需的)。輸入自訂資源的完整類型。
    • Factory Class (必需的)。輸入使用者寫入的工廠類別之完整名稱，該名稱執行 javax.naming.spi.ObjectFactory。
    • Custom Resource Enabled (可選)。選取 [On] 以在執行期間啟用自訂資源。
  5. 按一下 [OK]。
  6. 按一下 [Apply Changes]。

使用指令行介面

如需關於如何使用指令行介面建立新自訂資源的資訊，請參閱「指令行公用程式」中的建立自訂資源。

建立外部 JNDI 資源

您可以透過以下方式建立外部資源﹕

使用管理介面

  1. 存取 [Server Manager] 並選擇 [Java] 標籤。
  2. 按一下 [JNDI Resources]。
  3. 按一下 [New] 按鈕。
  4. 輸入下列資訊：
    • JNDI Name (必需的)。輸入應用程式元件存取自訂資源所必須使用的 JNDI 名稱。
    • Resource Type (必需的)。輸入自訂資源的完整類型。
    • Factory Class (必需的)。輸入使用者寫入的工廠類別之完整名稱，該名稱執行 javax.naming.spi.ObjectFactory。
    • JNDI Lookup (必需的)。輸入要在外部儲存庫中查找的 JNDI 值。例如，如果您要建立連線至外部儲存庫、測試郵件類別的外部資源，[JNDI Lookup] 可以讀取 cn=testmail。
    • External Resource Enabled (可選)。選取 [On ] 以在執行期間啟用外部資源。
  5. 按一下 [OK]。
  6. 按一下 [Apply Changes]。

使用指令行介面

如需關於如何使用指令行介面建立新自訂資源的資訊，請參閱「指令行公用程式」中的建立外部 JNDI 資源。

修改基於 Java 的資源

本節描述了使用管理介面修改您建立的基於 Java 資源之特性的方式：

修改 JDBC 連線池

修改 JDBC 連線池特性的步驟︰

  1. 存取 [Server Manager] 並選擇 [Java] 標籤。
  2. 按一下 [JDBC Connection Pools] 連結。
  3. 按一下表示您要編輯的 JDBC 連線池的連結。
  4. 依需要修改設定。
  5. 按一下 [OK]。

修改 JDBC 資源

修改 JDBC 資源特性的步驟︰

  1. 存取 [Server Manager] 並選擇 [Java] 標籤。
  2. 按一下 [JDBC Resources] 連結。
  3. 按一下表示您要編輯的 JDBC 資源的連結。
  4. 依需要修改設定。
  5. 按一下 [OK]。

修改自訂資源

修改自訂資源特性的步驟︰

  1. 存取 [Server Manager] 並選擇 [Java] 標籤。
  2. 按一下 [Custom Resources] 連結。
  3. 按一下表示您要編輯的自訂資源的連結。
  4. 依需要修改設定。
  5. 按一下 [OK]。

修改外部 JNDI 資源

修改外部 JNDI 資源特性的步驟︰

  1. 存取 [Server Manager] 並選擇 [Java] 標籤。
  2. 按一下 [External JNDI Resources] 連結。
  3. 按一下表示您要編輯的外部 JNDI 資源的連結。
  4. 依需要修改設定。
  5. 按一下 [OK]。

刪除基於 Java 的資源

本節描述了使用管理介面刪除基於 Java 的資源的方式︰

刪除 JDBC 連線池

您可以使用以下任一種方法刪除 JDBC 資源︰

使用 Administration Server

使用 Administration Server 刪除 JDBC 連線池的步驟︰

  1. 存取 [Server Manager] 並選擇 [Java] 標籤。
  2. 按一下 [JDBC Connection Pools] 連結。
  3. 核取與您要刪除的 JDBC 連線池對應的核取方塊。
  4. 按一下 [OK]。
使用指令行公用程式

如需有關您可以使用的指令行選項語法的資訊，請參閱指令行公用程式。

刪除 JDBC 資源

您可以使用以下任一種方法刪除 JDBC 資源︰

使用 Administration Server

使用 Administration Server 刪除 JDBC 資源的步驟︰

  1. 存取 [Server Manager] 並選擇 [Java] 標籤。
  2. 按一下 [JDBC Resources] 連結。
  3. 核取與您要刪除的 JDBC 資源對應的核取方塊。
  4. 按一下 [OK]。
使用指令行公用程式

如需有關您可以使用的指令行選項語法的資訊，請參閱指令行公用程式。

刪除自訂資源

您可以使用以下任一種方法刪除自訂資源︰

使用 Administration Server

使用 Administration Server 刪除自訂資源的步驟︰

  1. 存取 [Server Manager] 並選擇 [Java] 標籤。
  2. 按一下 [Custom Resources] 連結。
  3. 核取與您要刪除的自訂資源對應的核取方塊。
  4. 按一下 [OK]。
使用指令行公用程式

如需有關您可以使用的指令行選項語法的資訊，請參閱指令行公用程式。

刪除外部 JNDI 資源

您可以使用以下任一種方法刪除外部 JNDI 資源︰

使用 Administration Server

使用 Administration Server 刪除外部 JNDI 資源的步驟︰

  1. 存取 [Server Manager] 並選擇 [Java] 標籤。
  2. 按一下 [External JNDI Resources] 連結。
  3. 核取與您要刪除的外部 JNDI 資源對應的核取方塊。
  4. 按一下 [OK]。
使用指令行公用程式

如需有關您可以使用的指令行選項語法的資訊，請參閱指令行公用程式。



上一個      目錄      索引      下一個     

Copyright 2004 Sun Microsystems, Inc. 版權所有。