JavaTM 2 Platform
Standard Ed. 6

軟體套件 java.awt.im.spi

提供啟用可以與 Java 運行時環境一起使用的輸入方法開發的介面。

請參見:
          描述

介面摘要
InputMethod 定義支持複雜文本輸入的輸入方法介面。
InputMethodContext 提供輸入方法可以用來與其客戶端元件通信或用來請求其他服務的方法。
InputMethodDescriptor 定義提供足夠的關於輸入方法啟用選擇和該輸入方法載入資訊的方法。
 

軟體套件 java.awt.im.spi 的描述

提供啟用可以與 Java 運行時環境一起使用的輸入方法開發的介面。輸入方法是一些軟體元件,允許使用者以其他方式輸入文本,而不僅僅局限於簡單的鍵盤輸入。使用它們,通常可用非常有限的幾個鍵盤鍵即可完成日語、漢語或韓語的輸入——這些語言都使用了數千個不同的字元。不過,此套件還允許開發其他語言的輸入方法和使用完全不同的輸入機制,如手寫識別。

套件規範

打包輸入方法

輸入方法被打包為已安裝的擴展,這由 Extension Mechanism 指定。輸入方法的主要 JAR 檔案必須包含檔案:

    META-INF/services/java.awt.im.spi.InputMethodDescriptor

該檔案應該套件含一個實作 java.awt.im.spi.InputMethodDescriptor 介面的類別的完全限定類別名稱的列表(每行一個名稱)。忽略各名稱周圍的空格字元和製表符以及空行。註釋字元為 '#' (\u0023);將忽略每行的第一個註釋字元後面的所有字元。檔案必須使用 UTF-8 編碼。

例如,如果實作 Foo 輸入方法的 java.awt.im.spi.InputMethodDesciptor 的類別的完全限定名稱為 com.sun.ime.FooInputMethodDescriptor,則檔案 META-INF/services/java.awt.im.spi.InputMethodDescriptor 套件含這樣一行:

    com.sun.ime.FooInputMethodDescriptor

輸入方法還必須提供至少兩個類別:一個實作 java.awt.im.spi.InputMethodDescriptor 介面的類別,一個實作 java.awt.im.spi.InputMethod 介面的類別。輸入方法必須分別實作這些介面,以便推遲到實際需要時才載入實作 InputMethod 的類別。

載入輸入方法

輸入方法框架通常會推遲到絕對需要時才載入輸入方法類別。它在 AWT 初始化期間只載入 InputMethodDescriptor 實作。在已選定輸入方法時載入 InputMethod 實作。

Java 輸入方法和同級文本元件

Java 輸入方法框架意在支持所有輸入方法(主機輸入方法和 Java 輸入方法)和元件(同級或輕量級)的撰寫。不過,因為基礎平臺的限制,它不會總是能夠啟用 Java 輸入方法和同級 AWT 元件之間的通信。因此,對具體撰寫的支持與平臺有關。在 Sun 的 Java SE 運行時環境中,此撰寫在 Windows 上受支持,但在 Solaris 上不受支持。

相關文檔

有關概觀、教程、範例、指南和工具文檔的資訊,請參閱: