Пакет java.awt.im.spi

Предоставляет интерфейсы, которые позволяют разрабатывать методы ввода, которые могут использоваться с любой средой выполнения Java. Методы ввода — это программные компоненты, которые позволяют пользователю вводить текст иными способами, помимо простого набора на клавиатуре. Они обычно используются для ввода японского, китайского или корейского языков — языков, использующих тысячи различных символов — на клавиатурах с гораздо меньшим количеством клавиш. Однако этот пакет также позволяет разрабатывать методы ввода для других языков и использовать совершенно другие механизмы ввода, такие как распознавание рукописного ввода.

Упаковывание методов ввода

Методы ввода могут быть доступны, добавив их в путь к классам приложения. Основной JAR-файл метода ввода должен содержать файл:

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

Файл должен содержать список полных квалифицированных имен классов, реализующих интерфейс java.awt.im.spi.InputMethodDescriptor, по одному на строку. Пробелы и символы табуляции вокруг каждого имени, а также пустые строки игнорируются. Символ комментария — '#' (\u0023); в каждой строке все символы после первого символа комментария игнорируются. Файл должен быть закодирован в формате UTF-8.

Например, если полное квалифицированное имя класса, который реализует java.awt.im.spi.InputMethodDesciptor для метода ввода Foo, равно 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, можно было отложить до фактической необходимости.

Загрузка методов ввода

Фреймворк методов ввода обычно откладывает загрузку классов методов ввода до тех пор, пока они не понадобятся. Он загружает только реализации InputMethodDescriptor во время инициализации AWT. Он загружает реализацию InputMethod при выборе метода ввода.

Методы ввода Java и связанные текстовые компоненты

Фреймворк методов ввода Java нацелен на поддержку всех комбинаций методов ввода (хостовые методы ввода и методы ввода Java) и компонентов (связанные и облегченные). Однако из-за ограничений в базовой платформе не всегда возможно установить связь между методами ввода Java и связанными компонентами AWT. Поддержка этой конкретной комбинации поэтому зависит от платформы. В средах выполнения Java SE от Sun данная комбинация поддерживается в Windows, но не в Solaris.

Документация по теме

Для обзоров, руководств, примеров, справочных материалов и документации по инструментам, пожалуйста, обратитесь к Обзору фреймворка методов ввода.