Пакет 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.

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

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