Пакет 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. Поэтому поддержка этой конкретной комбинации зависит от платформы. В средах выполнения Sun Java SE эта комбинация поддерживается в Windows, но не в Solaris.

Связанная документация

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