IBM(R) Runtime Environment for Windows(R), Java (TM) 2 Technology Edition, Version 1.3.1, 32-bit version
- README -


附註:在使用本資訊及其支援的產品之前,請務必閱讀注意事項下的一般資訊。

本修訂版 README 適用於 IBM Developer Kit for Windows, Java 2 Technology Edition, Version 1.3.1, 32-bit version,以及所有後續版次與修正,直到修訂版中另有指示為止。

(c) Copyright Sun Microsystems, Inc. 1997, 2001, 901 San Antonio Rd., Palo Alto, CA 94303 USA. All rights reserved.

(c) Copyright International Business Machines Corporation, 1999, 2002. All rights reserved.

U.S. Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.


本 README 檔中提供關於由 IBM(R) Developer Kit for Windows(R), Java(TM) 2 Technology Edition, Version 1.3.1, 32-bit version 所提供的 Runtime Environment 套件的資訊。如果您想要將 Runtime Environment 含在您的產品中分送,便可以使用本 README 檔。

下列產品上支援 Runtime Environment:


目次

  • 總覽
  • Runtime Environment 中所內含的檔案
  • Just-In-Time (JIT) 編譯器
  • 停用 JIT
  • 啟用 JIT
  • 判斷是否已啟用 JIT
  • 取得 IBM 建置和版本號碼
  • 呼叫 Runtime Environment
  • 重新分送基本要求
  • Java Runtime Interpreter
  • 系統內容
  • Runtime 範例
  • 在使用者系統中安裝應用程式
  • 指定垃圾收集原則
  • 暫停時間
  • 暫停時間縮短
  • 資料堆近乎飽和的環境
  • 關於垃圾收集進一步的資訊
  • 使用原生協助技術來執行 Java 應用程式
  • Runtime 文件
  • 注意事項
  • 商標

  • 總覽

    在 Runtime Environment 中包含 Java Virtual Machine (JVM)、Sun Microsystems Java 類別及支援檔案。在 Runtime Environment 中,並未包含全部在 Developer Kit 套件中可以找到的類別。


    Runtime Environment 中所內含的檔案

    Runtime Environment 中已併入 .dll 檔和類別,在執行時期可以支援 Java 程式。Runtime Environment 並未包括任何開發工具,如 appletviewer 或 javac,或是專屬於某個開發系統的類別。

    請參閱重新分送基本要求,以取得關於必須和 Java 程式一起重新分送之檔案的資訊。


    Just-In-Time (JIT) 編譯器

    JIT 編譯器在執行期間,會以動態方式來產生於 Java 應用程式或 Applet 中,常用的位元組碼序列的機器碼。依預設,會啟用 JIT 編譯器 (jitc.dll)。

    停用 JIT

    您可以停用 JIT,以便於找出 Java 應用程式、Applet 或編譯器本身的問題。

    共有兩個方式可以停用 JIT:

    啟用 JIT

    如果要啟用 JIT,請在指令提示中輸入下列指令:

        set JAVA_COMPILER=jitc
    

    判斷是否已啟用 JIT

    如果要驗證否是已啟用 JIT,請在指令提示中輸入下列指令:

        java -version
    

    如果 JIT 在使用中,便會顯示一則包含下列內容的訊息:

        JIT enabled: jitc
    

    如果 JIT 不在使用中,便會顯示下列的訊息:

        JIT disabled
    

    取得 IBM 建置和版本號碼

    如要取得 IBM 建置和版本號碼,可以在指令提示中輸入下列指令:

        java -version
    

    呼叫 Runtime Environment

    如果要執行 Java 應用程式,請在指令提示中輸入下列指令:

        java classname
    

    其中 classname 是您要執行的 Java 類別檔(Java 應用程式)的名稱。如需關於在呼叫 Java 工具時您可以使用參數之資訊,請參閱 Java Runtime Interpreter

    附註:如果您沒有安裝 Runtime Environment 作為 System JVM,您必須先設定路徑加入適當的目錄。 如果要更新路徑,請在指令提示中輸入下列指令:

        set path=javadir\jre\bin;%path%
    

    其中 javadir 是 Runtime Environment 套件的安裝目錄。依預設,這個目錄會是 C:\Program Files\IBM\Java131.


    重新分送基本要求

    當您在重新分送 Runtime Environment 時,必須併入下列套件中的檔案:

    如果需要必須重新分送之檔案的相關資訊,請參閱產品所檢附的授權合約。

    必須一辭是表示取得授權可以分送 Runtime 的人,不論其程式是否使用那些檔案,都必須在其程式中併入那些檔案。

    在 Runtime Environment 中包括 \bin 與 \lib 目錄及其子目錄。這兩個目錄及其子目錄必須位於同一個目錄中。bin 目錄中包含可執行檔和原生程式庫。lib 目錄中則包含類別和內容檔。

    所有在 bin 與 lib 目錄中的檔案,在重新分送時均為必須的項目。

    附註:原生程式碼 C 執行程式庫,即 msvcrt.dll,位於 Windows 系統目錄中。請確定在您的 Windows 系統目錄中具有該檔案。此目錄的位置視作業系統而定,不過,通常是在:


    Java Runtime Interpreter

    這個 Java 工具可以呼叫 Java Runtime Interpreter,以便執行 Java 應用程式。啟動此 Java 工具的語法如下:

    除了 Java 工具外,還有另一種替代方案,即 javaw。這個 javaw 工具除了無法呼叫主控台視窗之外,與 Java 工具完全相同。而啟動此 javaw 工具的語法如下:

        javaw [options] classname <args>
    

    Java 工具的選項如下:


    系統內容

    您可以利用 Java Runtime Interpreter 一節所說明的 -D 選項,來設定系統內容的 ibm.jvm.bootclasspath。這個內容值用來作為其他搜尋路徑,插入 -Xbootclasspath/p: 所定義的任何值和 bootclass 路徑之間。bootclass 路徑是預設值或利用 -Xbootclasspath: 選項所定義者。

    Runtime 範例

    在 Sun 網頁中包含了 "Hello World" 範例。這個範例會示範如何建立一個簡單的 Java 應用程式,讓它可以在 Java Runtime Environment 上執行並與之連結在一起。此 Sun 網站為:http://java.sun.com,而且您可以搜尋 "Hello World" 和 "Notes for Developers",來找到 "Hello World" 範例。

    這個範例顯示如何執行簡單無縫的移轉,讓您從使用 Developer Kit 開發應用程式,移轉至使用 Runtime Environment 來部署。


    在使用者系統中安裝應用程式

    在您的產品中,必須提供方法,以:

    如果您重新分送 Runtime Environment 時,必須確定您的安裝程序不會改寫現有的安裝(除非現有的 Java Runtime Environment 是舊的版本)。

    較好的方法,是採用可重新分送的 Runtime Environment 中所包含的 zip 檔案,即 ibm-jre-n131p-win32-x86.zip,並將其安裝到相同的目錄結構中。請務必併入在 bin 與 lib 目錄及它們子目錄中所有的檔案。這些目錄在重新分送基本要求中有說明。只有在您併入所有的這些檔案後,才能重新分送 Runtime Environment 軟體。事實上,在您的應用程式出貨時,便會有其本身的一份 Runtime Environment 複本。

    如果您採用此方法,請勿試著去模擬由 Runtime Environment 安裝程式所執行的安裝步驟。

    附註:當您在安裝 Runtime Environment 時,必須將程式資訊記錄在 Windows 登錄中,如下所示:


    指定垃圾收集原則

    在 Developer Kit 中採用指定垃圾收集原則的 -Xgcpolicy JVM 執行時期選項。

    -Xgcpolicy 可以採取兩個值,optthruput(預設值)及 optavgpause。該選項會控制垃圾收集器的行為,在應用程式和整體系統的產量以及因垃圾收集所造成的暫停次數之間找到平衡點。

    該選項及其值的格式為:

    -Xgcpolicy:optthruput
    -Xgcpolicy:optavgpause

    暫停時間

    當應用程式嘗試建立一個物件,但資料堆中的可用空間無法立即滿足要求時,垃圾收集器便會負責來識別未參照的物件(垃圾)、刪除它們,並讓資料堆返回到可以快速滿足即時及後續配置要求的狀態。這類的垃圾收集循環,在應用程式碼執行時會造成偶發性非預期的暫停。隨著應用程式增大及複雜,以及資料堆相對地變大,此垃圾收集暫停時間也會變得較長、較重要。預設的垃圾收集值 optthruput,會對應用程式提供非常高的產量,但是所需的這些偶發性暫停成本,視資料堆的大小及垃圾的數量而定,其長度會從幾毫秒到數秒不等。

    暫停時間縮短

    optavgpause 值會大幅縮短垃圾收集暫停的時間,並且在垃圾收集暫停時間內,限制增加資料堆大小。這項目尤其與大型資料堆的配置息息相關。(大小至少為 1 GB 時,即視為大型的資料堆)。暫停次數可在正常程式執行時,利用重疊垃圾收集活動的方法來減少。這種重疊會造成應用程式的產量小幅度地減少。

    資料堆近乎飽和的環境

    如果 Java 資料堆變得近乎飽和,並且只收回非常少量的垃圾時,對於新物件的要求便可能無法立即滿足,因為並沒有立即可用的空間。如果資料堆在操作時其容量接近飽和,則不論使用的是上述的何種選項,應用程式的效能可能會變糟;而且,如果持續要求更多的資料堆空間,應用程式便會收到「記憶體不足」的異常狀況,如果無法掌握及處理這個異常狀況,便會造成 JVM 的終止。在這些狀況下,建議您使用 -Xmx 選項來增加資料堆的大小,或是減少使用中應用程式物件的數目。

    關於垃圾收集進一步的資訊

    如需關於資料堆大小調整及應用程式效能之垃圾收集含意的資訊時,請參閱:


    使用原生協助技術來執行 Java 應用程式

    Sun 提供 Java Access Bridge 來賦予原生 Windows 協助技術,例如螢幕讀取器,以便在 Java 應用程式中存取 Java Accessibility 支援。必須加以寫入這些原生 Windows 協助技術,才能呼叫 Java Access Bridge。

    從 SUN 所取得的 Java Access Bridge 會包含安裝程式,會將下列五個檔案放在正確的目錄中:access-bridge.jar、jaccess.jar、accessibility.properties、JavaAccessBridge.dll 與 WindowsAccessBridge.dll。

    如果您已經安裝 IBM Accessibility Bridge (JawBridge),便可允許 Windows 2000 Magnifier 與 Swing 應用程式一起運作,而且您可以讓它與 Java Access Bridge 同時來執行,並編輯 accessibility.properties 檔中的一行以便讀取:

    assistive_technologies=com.sun.java.accessibility.AccessBridge, JawBridge 在作成註解時,請在該行的前面加上 #,以便停止啟用這兩個橋接器。

    這個網站會告訴您如何下載 Java Access Bridge:


    Runtime 文件

    每個內容檔都含有說明檔案用途與修改方式的註解。


    注意事項

    本資訊乃是針對在美國提供的產品及服務而撰寫。

    IBM 可能不會在其他國家提供本文件討論的產品、服務或功能。要知道在您所在之區是否可用到這些產品與服務時, 請向當地的 IBM 服務代表查詢。本書在提及 IBM 的產品、程式或服務時,不表示或暗示只能使用 IBM 的產品、程式或服務。只要未侵犯 IBM 的智慧財產權,任何功能相當的產品、程式或服務都可以取 代 IBM 的產品、程式或服務。 不過,其他非 IBM 產品、程式或服務在運作上的評價 與驗證,其責任屬於使用者。

    在這文件中包含著 IBM 所擁有之專利或暫准專利。使用者不享有本文件內容之專利權。您可以用書面方式來查詢授權,來函請寄到:

    如果要查詢有關二位元組 (DBCS) 資訊的特許權限事宜, 請聯絡您國家的 IBM 智慧財產部門,或者用書面方式寄到:

    下列段落若與該國之法律條款抵觸,即視為不適用:

    IBM 僅以現狀提供本書,而不提供任何明示或默示之保證 (包括但 不限於可商用性或符合特定效用的保證。) 有些地區在某些固定的交易上並不接受明示或默示保證的放棄聲明,因此此項 聲明不見得適用於您。

    本資訊中可能會有技術上或排版印刷上的訛誤。因此,IBM 會定期修訂; 並將修訂後的內容納入新版中。同時,IBM 得隨時改進並 (或) 變動本資訊中所 提及的產品及 (或) 程式。

    本資訊中任何對非 IBM 網站的敘述僅供參考,IBM 對該網站並不提供保證。該網站上的資料,並非本 IBM 產品所用資料的一部分,如因使用該網站 而造成損害,其責任由 貴客戶自行負責。

    IBM 得以各種適當的方式使用或散佈由 貴客戶提供的任何資訊,而無需對您負責。

    本程式之獲授權者若希望取得相關資料, 以便使用下列資訊者可洽詢 IBM。 其下列資訊指的是: (1) 獨立建立的程式與其他程式 (包括此程式) 之間更換資訊的方式; (2) 相互使用已交換之資訊方法。 若有任何問題請聯絡:

    上述資料得遵循適當條款而取得,在某些情況下必須付費方得使用。

    IBM 基於雙方之「IBM 客戶合約」、「國際程式授權合約」或任何同等合約之條款,提供本文件中所述之授權程式與其所有適用的授權資料。

    任何此處涵蓋的執行效能資料都是在一個受控制的環境下決定出來的。因此,若在其他作業環境下,所得的結果可能會大大不同。有些測定已在開發階段系統上做過, 不過這並不保證在一般系統上會出現相同結果。再者,有些測定可能已透過推測方式評估過。但實際結果可能並非如此。 本書的使用者應依自己的特定環境,查證適用的資料。

    本書所提及之非 IBM 產品資訊,係一由產品的供應商,或其出版的聲明或其他 公開管道取得。IBM 並未測試過這些產品,也無法確認這些非 IBM 產品的執行效能、 相容性或任何對產品的其他主張是否完全無誤。如果您對非 IBM 產品的性能有任何的疑問, 請逕向該產品的供應商查詢。


    商標

    IBM 是 International Business Machines Corporation 在美國和(或)其他國家的商標。

    Java 以及所有以 Java 為基礎的商標及標誌圖都是 Sun Microsystems, Inc. 在美國和(或)其他國家的商標或註冊商標。Java 技術是 Sun Microsystems, Inc. 所擁有並負責提供其專用授權。

    Microsoft、Windows、Windows NT 和 Windows 標誌是 Microsoft Corporation 在美國和(或)其他國家的商標。

    其他公司、產品和服務名稱,可能是第三者的商標或服務標記。