1 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. Java 2 Micro Edition Лаборатория информационных технологий (ИТЛаб) При поддержке фирмы. - презентация

1 1 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. Java 2 Micro Edition Лаборатория информационных технологий (ИТЛаб) При поддержке фирмы Intel Проект ТЭЛМА Mobile Information Device Profile (MIDP) Жерздев С.В.

2 2 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. Mobile Information Device Profile Профиль MIDP базируется на конфигурации CLDC и обеспечивает динамическую загрузку новых приложений и сервисов на устройство пользователя. MIDP - общеиндустриальный стандартный профиль для мобильных устройств, который не зависит от разработчика и производителя устройства. Это полноценная основа для разработки мобильных приложений.

3 3 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. Mobile Information Device Profile MIDP состоит из пакетов, часть которых унаследована от CLDC, а три определены в самом MIDP: javax.microedition.lcdui Управление интерфейсом пользователя, как высокого, так и низкого уровня. javax.microedition.midlet Содержит класс MIDlet. javax.microedition.rms Набор классов, обеспечивающих механизм постоянного хранения данных.

4 4 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. Область действия MIDP MIDP охватывает следующий минимум API для обеспечения совместимости на широком наборе устройств: – Приложения (семантика, общая структура и метод управления) – Интерфейс пользователя (ввод/вывод) – Постоянное хранение данных – Сетевые средства – Таймеры

5 5 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. Область действия MIDP Следующие вопросы не относятся к компетенции MIDP: – Системное программирование. MIDP не обеспечивает средств доступа к системным функциям устройства, таким как управление питанием или голосовой кодек. – Загрузка и управление приложениями. В MIDP не определяет средст загрузки, хранения и запуска пользовательских приложений. – Безопасность. MIDP не определяет дополнительных к CLDC средств обеспечения безопасности приложений.

6 6 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. Архитектура MIDP

7 7 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. Аппаратные требования Экран – Размер 96*54 пиксель – Глубина цветности 1 бит – Форма пискеля (отношение сторон) примерно 1:1 Ввод: по крайней мере один из следующих механизмов – Клавиатура «для одной руки» (стандартные телефонные клавиши) – Клавиатура «для двух рук» (клафиатура QWERTY) – Сенсорный экран

8 8 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. Аппаратные требования Память (дополнительно к требованиям CLDC) – 128 Кб неоперативной памяти для хранения компонент MIDP – 8 Кб неоперативной памяти для хранения данных, созданных приложениями – 32 Кб оперативной памяти для кучи Java Сетевое соединение – Двунаправленное – Беспроводное – Возможно непостоянное – С ограниченной пропускной способностью

9 9 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. ПО управления приложениями Под ПО управления приложениями будем понимать ПО, которое управляет установкой, обновлением и удалением мидлетов на устройстве.

10 10 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. ПО управления приложениями Загрузка. Загрузить мидлет из некоторого источника. Устройство может поддерживать различные способы загрузки (кабель, инфракрасный порт, беспроводная сеть передачи данных). Установка. Устанавливает мидлет на устройство. На этом этапе может осуществляться проверка и преобразование мидлета.

11 11 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. ПО управления приложениями Запуск. Обеспечивает отображение пользователю списка установленных мидлетов и вызов выбранного пользователем мидлета. Управление версиями. Позволяет обновлять установленные мидлеты до более новых версий. Удаление. Удаляет предварительно установленный мидлет и связанные с ним ресурсы, например, записи в постоянном хранилище.

12 12 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. MIDlet Приложение, исполняемое в среде MIDP, называется мидлет (MIDlet) - это класс Java, который наследуется от абстрактного класса javax.microedition.midlet.MIDlet и реализует методы startApp(), pauseApp(), destroyApp(). Приложение MIDP, как правило, содержит и другие классы, которые вместе с ресурсами могут быть упакованы в jar-файл - комплект MIDlet (MIDlet suite). Один комплект может содержать и несколько мидлетов, которые могут совместно использовать ресурсы jar-файла.

13 13 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. Среда исполнения MIDP Среда исполнения разделяется всеми мидлетами одного комплекта и позволяет им взаимодействовать между собой. ПО управления приложениями инициализирует приложения и делает доступными для них: – Классы и код, реализованные в рамках CLDC, включая виртуальную машину Java – Классы и код, реализованные MIDP – Все классы из соответствующего jar-файла для выполнения – Все остальные файлы (в том числе декларация) из jar- архива в качестве ресурсов – Содержимое файла-описания

14 14 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. Среда исполнения MIDP Один jar-файл содержит все классы мидлета. Мидлет может загружать и вызывать методы любого класса в jar-файле, в MIDP или в CLDC. Все классы из этих трех областей являются разделяемыми в исполняющей среде мидлетов одного jar-файла. Все состояния, доступные через эти классы, доступны любому классу, исполняемому как часть мидлета. Для решения проблем совместного доступа следует использвать стандартные средства блокировки и синхронизации Java.

15 15 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. Среда исполнения MIDP Файлы классов мидлета доступны только для исполнения и не могут быть прочитаны как ресурсы. Остальные файлы, в том числе файл- декларация (manifest) доступны с использованием метода java.lang.Class.getResourceAsStream. Содержимое файла-описания, если он представлен, доступно с использованием метода javax.microedition.midlet.MIDlet.getAppProperty.

16 16 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. Архив комплекта мидлета Один или более мидлетов упаковываются в один jar-файл, который содержит: – Декларацию (manifest), описывающую содержимое комплекта – Классы мидлета(ов) и вспомогательные классы, разделяемые мидлетами – Файлы ресурсов, используемых мидлетом(ами) Разработчик является ответственным за создание и распространение jar-файлов с учетом целевого устройства, пользователей, сети, локализации и т.п.

17 17 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. Атрибуты В декларации и файле описания используются одни и те же атрибуты. MIDlet-Name Имя комплекта мидлетов, которое используется для идентификации его пользователем. MIDlet-Version Номер версии комплекта. Формат версии major.minor.micro. Может использоваться при установке, обновлении приложения и при взаимодействии с пользователем. Часть micro может отсутствовать, в этом случае подразумевается 0.

18 18 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. Атрибуты MIDlet-Vendor Организация-поставщик комплекта. MIDlet-Icon Имя файла PNG в jar-архиве, изображение из которого будет использовано как иконка для представления комплекта ПО управления приложениями. MIDlet-Description Описание комплекта. MIDlet-Info-URL Сетевой адрес (URL) подробного описания комплекта.

19 19 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. Атрибуты MIDlet- Имя, иконка и класс (через запятую) n-го мидлета в jar-файле. Мидлеты должны нумероваться с 1 последовательно. – Имя используется для отображения пользователю. – Иконка - имя изображения (PNG) в jar-файле, используемого как иконка для мидлета. – Класс - имя класса, унаследованного от класса MIDlet и представляющего мидлет. Класс должен иметь конструктор без параметров, объявленный как public. MIDlet-Jar-URL Сетевой адрес (URL), с которого может быть загружен этот jar-файл.

20 20 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. Атрибуты MIDlet-Jar-Size Объем jar-файла в байтах. MIDlet-Data-Size Минимальное объем постоянной памяти, требуемый мидлетом, в байтах. Значение по умолчанию - ноль. MicroEdition-Profile Требуемый профиль J2ME, например "MIDP-1.0". MicroEdition-Configuration Требуемая конфигурация J2ME, например "CLDC-1.0".

21 21 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. Декларация jar-файла Декларация определяет атрибуты, используемые ПО управления приложениями для идентификации и установки комплектов мидлетов и как значения по умолчанию для атрибутов, не заданных в файле описания приложения.

22 22 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. Декларация jar-файла Декларация комплекта должна содержать: – MIDlet-Name – MIDlet-Version – MIDlet-Vendor – MIDlet- для каждого мидлета – MicroEdition-Profile – MicroEdition-Configuration Декларация может содержать: – MIDlet-Description – MIDlet-Icon – MIDlet-Info-URL – MIDlet-Data-Size

23 23 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. Пример декларации Например, декларация для гипотетического комплекта карточных игр могла бы выглядеть так: MIDlet-Name: CardGames MIDlet-Version: MIDlet-Vendor: CardsRUS MIDlet-1: Solitaire, /Solitare.png, com.cardsrus.org.Solitare MIDlet-2: JacksWild, /JacksWild.png, com.cardsrus.org.JacksWild MicroEdition-Profile: MIDP-1.0 MicroEdition-Configuration: CLDC-1.0

24 24 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. Файлы классов Все классы Java, необходимые для мидлета, размещаются в jar-файле с использованием стандартной структуры каталогов, соответствующей полным именам классов. Ккаждая точка в полном имени заменяется на прямой слэш ( / ) и добавляется расширение.class. Например, класс com.sun.microedition.Test следует разместить в jar-файле под именем com/sun/microedition/Test.class.

25 25 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. Описатель приложения Описатель приложения используется ПО управления приложениями для проверки приложения на соответствие устройству до его загрузки и самим мидлетом для настройки различных атрибутов. Каждый jar-файл может быть укомплектован описателем приложения. ПО управления приложениями распознает файл описателя по его расширению и MIME-типу. Расширение файла описателя приложения должно быть jad. MIME-тип описателя должен иметь значение text/vnd.sun.j2me.app-descriptor.

26 26 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. Описатель приложения Набор атрибутов, используемых ПО управления приложениями, приведен выше. Все атрибуты файла описателя доступны мидлету. В дополнение к стандартным, разработчик может определить собственные атрибуты, которые не должны начинаться с "MIDlet-". Имена атрибутов чувствительны к регистру и должны точно соответствовать стандарту. Мидлет может получить значение атрибута с помощью вызова метода MIDlet.getAppProperty().

27 27 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. Описатель приложения Описатель приложения должен содержать: – MIDlet-Name – MIDlet-Version – MIDlet-Vendor – MIDlet-Jar-URL – MIDlet-Jar-Size Описатель может содержать: – MIDlet-Description – MIDlet-Icon – MIDlet-Info-URL – MIDlet-Data-Size – Собственные атрибуты, не начинающиеся с "MIDlet-»

28 28 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. Описатель приложения Обязательные атрибуты MIDlet-Name, MIDlet- Version, MIDlet-Vendor должны присутствовать и в описателе и в декларации. Если они не совпадают, jar-файл не может быть инсталлирован на устройство. Значения других атрибутов могут отличаться. В этом случае значение из описателя переопределяет значение из декларации.

29 29 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. Описатель приложения В общих чертах, формат описателя приложения - набор строк, состоящих из имени атрибута, двоеточия, значения атрибута и символа перевода строки. Пробелы перед и после значения игнорируются. Порядок атрибутов произвольный. Описатель может быть в различных кодировках на этапе хранения или передачи, но перед обработкой переводится в Unicode.

30 30 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. Пример описателя приложения Например, описатель приложения для гипотетического комплекта карточных игр может иметь следующий вид: MIDlet-Name: CardGames MIDlet-Version: MIDlet-Vendor: CardsRUS MIDlet-Jar-URL: MIDlet-Jar-Size: 7378 MIDlet-Data-Size: 256

31 31 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. Жизненный цикл приложения Комплект мидлета установлен на устройство, его классы, файлы ресурсов, атрибуты и постоянное хранилище хранятся на устройстве и готовы к применению. Мидлет(ы) доступны пользователю через ПО управления приложениями устройства. Мидлет запущен, создается экземпляр основного класса мидлета с использованием его конструктора без параметров. Методы мидлета вызываются в зависимости от смены его состояний. Кроме того, мидлет может запросить изменение своего состояния или уведомить ПО управления приложениями о изменении своего состояния.

32 32 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. Жизненный цикл приложения Когда мидлет завершен или прерван ПО управления приложениями, он уничтожается с освобождением всех ресурсов, включая объекты и классы мидлета. Мидлет в жизненном цикле приложения может находиться в одном из трех возможных состояний: активный, приостановленный или уничтоженный.

33 33 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. Жизненный цикл приложения Активное состояние (active) означает, что мидлет запущен. Мидлет переходит в это состояние, когда вызван метод startApp(). Метод public static void main() может отстутсвовать, более того, он будет проигнорирован при запуске приложения.

34 34 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. Жизненный цикл приложения В приостановленном состоянии (paused) ресурсы, захваченные мидлетом, освобождаются, но он готов к активизации. Мидлет попадает в это состояние: – Непосредственно после создания с помощью new. Вызван конструктор без параметров и он завершился без возбуждения исключений. Как правило, на этом этапе производится минимум инициализации. Если произошло исключение, приложение немедленно переходит в состояние destroyed. – Из состояния active после успешного завершения работы метода MIDlet.pauseApp(). Этот метод может быть вызван ПО управления приложениями. – Из состояния active после успешного завершения работы метода MIDlet.notifyPaused(). – Из состояния active, если произошло возбуждение исключения MIDletStateChangeException при вызове метода MIDlet.startApp().

35 35 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. Жизненный цикл приложения В состоянии уничтоженного (destroyed) мидлет полностью завершил работу, освободил все ресурсы и ожидает сборщик мусора. Переход в это состояние происходит в следующих случаях: – Метод MIDlet.destroyApp() завершил работу. В этом методе следует освободить все захваченные ресурсы. Этот метод может быть вызван ПО управления приложениями. – Метод MIDlet.notifyDestroyed() успешно завершился. Мидлет должен выполнить аналог метода MIDlet.destroyApp() перед вызовом MIDlet.notifyDestroyed().

36 36 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. Состояния мидлета

37 37 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. Порядок состояний мидлета 1. ПО управления приложениями создает новый экземпляр мидлета. Вызывается конструктор мидлета по умолчанию (без параметров). Мидлет находится в состоянии paused. 2. ПО управления приложениями принимает решение о запуске мидлета и вызывает метод MIDlet.startApp() для перевода его в состояние active. Мидлет захватывает необходимые ресурсы и начинает выполнение своих задач.

38 38 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. Порядок состояний мидлета 3. ПО управления приложениями больше не имеет необходимости в исполнении мидлета и сигнализирует об этом вызовом метода MIDlet.pauseApp(). Мидлет прекращает выполнение задач, может освободить часть ресурсов. 4. ПО управления приложениями трубуется завершить работу мидлета, оно сигнализирует об этом вызовом метода MIDlet.destroyApp(). Если необходимо, мидлет сохраняет некоторые данные о своем текущем состоянии и освобождает ресурсы.

39 39 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. Пример мидлета import javax.microedition.midlet.*; /** * Пример мидлета, измеряющего производительность * При запуске мидлет создает отдельный поток для выполнения теста */ public class MethodTimes extends MIDlet implements Runnable { Thread thread;

40 40 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. Пример мидлета /** * При запуске мидлет создает поток для основной работы. * Не следует выполнять здесь большой объем работы, * чтобы не задерживать диспетчер программ */ public void startApp() { thread = new Thread(this); thread.start(); }

41 41 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. Пример мидлета /** * Получив команду Pause, останавливаем и освобождаем поток. * Если работа еще не завершена, она будет возобновлена позже */ public void pauseApp() { thread = null; }

42 42 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. Пример мидлета /** * По команде Destroy надо очистить все */ public void destroyApp(boolean unconditional) { thread = null; }

43 43 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. Пример мидлета /** * Проверка производительности, замеряем время на вызов пустого метода 1000 раз * Завершаем досрочно, если поток перестал быть текущим */ public void run() { Thread curr = Thread.currentThread(); // Текущий поток long start = System.currentTimeMillis(); for (int i =0;i < && thread == curr; i++) empty();

44 44 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. Пример мидлета long end = System.currentTimeMillis(); // Проверка на досрочное прерывание if (thread != curr) return; long millis = end - start; // Здесь следует вставить вывод результата. // Все завершено, очищаем ресурсы и завершаем работу destroyApp(true); notifyDestroyed(); } void empty() {} }

45 45 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. javax.microedition.midlet.MIDlet Приложение профиля MIDP должно наследоваться от класса MIDlet для обеспечения возможности управления им со стороны ПО управления приложениями, получения информации из описателя приложения и управления состояниями. Методы этого класса позволяют ПО управления приложениями создать, запустить, приостановить и уничтожить мидлет. Путем изменения состояний мидлетов осуществляется управление несколькими мидлетами в среде исполнения.

46 46 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. javax.microedition.midlet.MIDlet Некоторые изменения состояния могут быть инициированы самим мидлетом, при этом следует уведомить ПО управления приложениями. protected abstract void destroyApp (boolean unconditional) Указывает мидлету прекратить работу и перейти в состояние destroyed. В этом методе мидлет должен освободить все ресурсы и сохранить необходимые данные в постоянном хранилище. Этот метод может быть вызван из состояний paused и active.

47 47 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. javax.microedition.midlet.MIDlet Мидлет может отказаться входить в состояние destroyed, возбудив исключение MIDletStateChangeException. Однако, это допустимо только если флаг unconditional установлен в false. В противном случае мидлет будет переведен в состояние destroyed при любом завершении метода. Все остальные исключения, выброшенные этим методом, игнорируются и мидлет переводится в состояние destroyed.

48 48 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. javax.microedition.midlet.MIDlet public final String getAppProperty (String key) Обеспечивает механизм получения именованых параметров от ПО управления приложениями. Параметры являются комбинацией атрибутов описателя приложения и декларации комплекта. Метод возвращает строковое значение параметра. Если параметр не задан, возвращается null.

49 49 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. javax.microedition.midlet.MIDlet public final void notifyDestroyed () Используется мидлетом для оповещения ПО управления приложениями о переходе мидлета в состояние destroyed. ПО управления приложениями будет считать все ресурсы свободными и не будет выызывать метод destroyApp().

50 50 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. javax.microedition.midlet.MIDlet public final void notifyPaused () Используется мидлетом для оповещения ПО управления приложениями о переходе мидлета в состояние paused. Вызов этого метода не будет иметь эффекта, если мидлет уже уничтожен или еще не запущен.

51 51 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. javax.microedition.midlet.MIDlet protected abstract void pauseApp () Указывает мидлету приостановить работу и перейти в состояние paused. В этом состоянии мидлет должен освободить совместно используемые ресурсы. Если при выполнении этого метода произойдет исключение, мидлет будет немедленно уничтожен (метод destroyApp() будет вызван).

52 52 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. javax.microedition.midlet.MIDlet public final void resumeRequest () Используется мидлетом для оповещения ПО управления приложениями о желании перейти в активное состояние. Когда будет принято решение о переводе мидлета в активное состояние, ПО управления приложениями вызовет его метод startApp(). Как правило, метод resumeRequest()вызывается приложением в состоянии paused. Даже в этом состянии приложение может обрабатывать асинхронные события, например, таймеры.

53 53 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. javax.microedition.midlet.MIDlet protected abstract void startApp () Указывает мидлету, что он переведен в active. Метод вызывается только в состоянии paused. Предусмотрено два вида отказов от перехода в активное состояние. – Временные. Реализуются выбросом исключения MIDletStateChangeException. – Постоянные. Реализуются вызовом метода notifyDestroyed(). Если произошло любое другое исключение, мидлет будет немедленно уничтожен (метод destroyApp() будет вызван).

54 54 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. Пользовательский интерфейс API низкого уровня обеспечивает полный доступ к экрану устройства, а также к аппаратным кнопкам и другим средствам ввода. Тем не менее, API низкого уровня не содержит элементов интерфейса пользователя. Приложение должно самостоятельно отрисовывать кнопки, поля ввода и другие элементы.

55 55 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. Пользовательский интерфейс API высокого уровня обеспечивает простые компоненты интерфейса пользователя, но не позволяет осуществлять прямой доступ к устройствам ввода-вывода. Компоненты интерфейса независимы от размеров экрана и средств ввода конкретного устройства. Конкретная реализация MIDP определяет способ их отображения и обеспечивает реакцию на действия пользователя.

56 56 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. Архитектура интерфейса Учитывая ограничения аппаратных средств, интерфейс пользователя MIDP не поддерживает концепции перекрывающихся окон. Пользователь взаимодействует с мидлетом на основе экранов. Способ отображения и компоновки экрана зависит от реализации MIDP. Существует два выда экранов - структурированные и неструктурированные. Структурированные экраны обладают лучшей переносимостью, но не допускают доступа приложения к низкоуровневым средствам ввода и управления отображением.

57 57 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. Структурированный экран

58 58 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. Примеры различной реализации

59 59 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. Неструктурированный экран Неструктурированный экран создается с использованием API низкого уровня, который обеспечивает доступ к средствам ввода/вывода устройства. Такой интерфейс является в большей степени устройство-ориентированным и, соответственно, обладает меньшей способностью к переносимости.

60 60 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. Классы интерфейса пользователя Связующая абстракция интерфейса пользователя в MIDP - экран (screen). Экран является объектом, который инкапсулирует зависящий от устройства пользовательский ввод/вывод. В каждый момент времени отображается только один экран и пользователь имеет доступ только к элементам этого экрана. Экран обслуживает все события, возникающие при взаимодействии с пользователем, передавая приложению только высокоуровневые события.

61 61 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. Классы интерфейса пользователя В основе такой архитектуры лежат различия в реализации экрана и клавиатуры различных устройств MIDP. Эти различия приводят к тому, что размещение элементов, прокрутка и переключение фокуса ввода должны быть реализованы по-разному на различных устройствах. Кроме того, простые экраны организуют интерфейс в управляемые фрагменты, делая интерфейс пользователя проще для изучения и использования.

62 62 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. Классы интерфейса пользователя Существует три вида экранов, представленных классами, наследуемыми от абстрактного класса Displayable: – Экраны, содержащие сложный элемент интерфейса пользователя (например, List или TextBox). Структура таких экрано фиксирована и приложение не может добавить на экран другие компоненты. – Экраны общего вида (Form), которые приложение может наполнять текстом, изображениями и простыми наборами элементов интерфейса. – Экраны, которые используются в контексте низкоуровневого API (подклассы Canvas).

63 63 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. Классы интерфейса пользователя Каждый экран, кроме низкоуровнего Canvas, наследуется от абстрактного класса Screen и может включать бегущую строку (Ticker). Класс Display действует как менеджер экрана, который устанавливается для каждого активного мидлета и предоставляет методы получения информации о возможностях экрана устройства. Экран (Displayable) отображается с помощью вызова метода setCurrent() класса Display.

64 64 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. Классы интерфейса пользователя Ожидается, что большинство приложений будет использовать экраны фиксированной структуры, такие как: – List - используется для организации выбора пользователем из определенного набора вариантов. – TextBox - используется для текстового ввода. – Alert - используется для отображения временных сообщений, содержащих текст и изображения. Особый класс Form определен для случаев, когда экран предопределенной структуры не удобен. Например, приложение может иметь два поля ввода(TextField) или поле ввода и простую группу выбора (ChoiceGroup).

65 65 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. Классы интерфейса пользователя Формы могут содержать небольшое количество элементов. Эти элементы являются подклассами класса Item: ImageItem, StringItem, TextField, ChoiceGroup, Gauge. Если не все компоненты помещаются на экране, в зависимости от реализации, может быть предусмотрена прокрутка формы или создание вспомогательных экранов или другой вариант.

66 66 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. Классы интерфейса пользователя Интерфейс пользователя, как и любой другой ресурс, должен управляться в соответствии с принципами построения приложения MIDP. Выполняются следующие условия: – Метод getDisplay() можно вызывать с момента startApp() до завершения работы destroyApp(). – Объект Display сохраняется до вызова метода destroyApp(). – Объект Displayable, установленный с помощью setCurrent() не изменяется ПО управления приложениями.

67 67 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. Классы интерфейса пользователя ПО управления приложениями ожидает следующего поведения в ответ на события: – startApp() - приложение может вызвать setCurrent() для первого экрана. Объект Displayable становится действительно видимым после завершения работы метода startApp(). Поскольку startApp() может быть вызван неоднократно, в нем не следует размещать инициализацию или переключаться на другой экран вызовом setCurrent(). – pauseApp() - приложение может приостановить свои потоки и, возможно, установить новый стартовый экран для последующей активации. – destroyApp() - приложение может уничтожить созданные объекты.

68 68 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. Обработка событий Действия пользователя приводят к возникновению событий (events), о которых приложение уведомляется с помощью соответствующих обратных вызовов (callbacks). Существует четыре вида обратных вызовов интерфейса пользователя: – Абстрактные команды (abstract commands), которые являются частью высокоуровневого API. – Низкоуровневые события, представляющие отдельные нажатия и отпускания клавиш, а также события позиционирующего устройства, если оно присутствует. – Вызовы метода paint() класса Canvas. – Вызовы метода run() объектов Runnable, запрошенные методом callSerially() класса Display.

69 69 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. Обработка событий Все обратные вызовы интерфейса пользователя сериализуются, т.е. они никогда не происходят параллельно. Вместо этого, обратные вызовы пользовательского интерфейса происходят последовательно, по мере завершения обработки предыдущего. (События таймера не относятся к обратным вызовам интерфейса и могут происходить параллельно с вызовами интерфейса. Тем не менее, обратные вызовы таймера для одного объекта TimerTask сериализуются между собой.)

70 70 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. Обработка событий Также гарантируется, что вызов метода run() по запросу callSerially() будет произведен после обработки всех ожидающих запросов на перерисовку экрана.

71 71 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. Обработка событий Поскольку пользовательский интерфейс MIDP обладает высоким уровнем абстракции, конкретная технология взаимодействия с пользователем не определена и низкоуровневые действия (переключение между элементами, прокрутка) не доступны приложению. Приложение MIDP определяет команды (commands), и реализация может предоставить их пользователю через кнопки, меню, или любым другим способом, который поддерживается устройством.

72 72 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. Команды Команды представлены объектами класса Command и устанавливаются для экрана Displayable (Canvas или Screen) с помощью метода addCommand(). Класс Command предоставляет приложению возможность определить семантическое значение команды для более эффективной привязки к интерфейсу устройства (например, команда отмены может быть привязана к правой программной кнопке телефона).

73 73 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. Команды Класс Command имеет три параметра конструктора: – Label - отображается как подсказка для пользователя. – CommandType - значение команды. Часто используемое значение BACK, что означает возврат приложения на предыдущий этап. Многие телефоны придерживаются стандартного соглашения, какая кнопка длжна использоваться для такого класса команд. – Priority - используется для лучшей привязки к возможностям устройства.

74 74 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. Приемники Обработка событий высокоуровневым API базируется на модели приемника (listener). Экраны (Screen и Canvas) могут иметь приемник команд. Объект, используемый в качестве приемника, должен реализовать интерфейс CommandListener, котрый имеет один метод: void commandAction(Command c, Displayable d) Приложение получает события, если экран имеет привязанные команды и если существует зарегистрированный приемник. В каждый момент времени экран может иметь только один приемник.

75 75 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. Приемники событий элементов Также существует интерфейс приемника для обработки изменения состояния элементов формы. Метод, определенный в интерфейсе ItemStateListener, вызывается при изменении значения компонентов Gauge, ChoiceGroup, TextField. Не следет ожидать, что приемник будет вызываться после каждого изменения, но предполагается, что он будет вызван по крайней мере после потери фокуса элементом. Вызов может производится только при действительном изменении значения элемента. void itemStateChanged(Item item)

76 76 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. Пример приложения Этот пример мидлета отображает на экране устройства строку "Hello World!" и кнопку выхода, которая прерывает исполнение приложения. import javax.microedition.midlet.MIDlet; import javax.microedition.lcdui.Command; import javax.microedition.lcdui.CommandListener; import javax.microedition.lcdui.Display; import javax.microedition.lcdui.Displayable; import javax.microedition.lcdui.Form;

77 77 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. Пример приложения Класс HelloWorld наследуется от класса MIDlet, поскольку является приложением MIDP. Кроме того, он реализует интерфейс CommandListener для обработки событий: public class HelloWorld extends MIDlet implements CommandListener

78 78 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. Пример приложения Конструктор создает форму и отображает ее: private Form form; public HelloWorld() { form = new Form("Test App"); form.append("Hello World!"); // Добавить кнопку "Exit" form.addCommand( new Command( "Exit", Command.EXIT, 1 ) ); // Зарегистрировать этот объект, как обработчик событий form.setCommandListener( this ); }

79 79 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. Пример приложения Метод startApp() вызывается для запуска приложения, он может быть вызван несколько раз на протяжении исполнения приложения. Если мидлет приостанавливается, будет вызван метод pauseApp(). Для возобновления выполнения будет вызван startApp(). Таким образом, основной инициализирующий код, который должен быть выполнен только один раз, следует размещать в кострукторе.

80 80 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. Пример приложения public void startApp() { // Получить доступ к экрану и отобразить форму Display display = Display.getDisplay(this); display.setCurrent( form ); } public void pauseApp() { }

81 81 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. Пример приложения Метод destroyApp() вызвается для завершения работы приложения и перевода его в состояние уничтоженного. В примере мы освобождаем ссылку на форму. public void destroyApp(boolean unconditional) { form = null; }

82 82 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. Пример приложения Метод commandAction() является обработчиком событий, необходимым для реализации интерфейса CommandListener. В этом примере этот метод уничтожает приложение и оповещает об этом ПО управления приложениями. public void commandAction(Command c, Displayable d) { destroyApp(true); notifyDestroyed(); }

83 83 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. Классы экранов

84 84 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. javax.microedition.lcdui.Display public void callSerially (javax.microedition.lcdui.Runnable r) Сериализует вызов метода run() объекта r с потоком событий. Метод run() будет вызван после обработки текущих событий и завершения перерисовки экрана. Метод run() будет вызван строго один раз для каждого вызова callSerially(), порядок вызовов сохраняется.

85 85 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. javax.microedition.lcdui.Display Метод callSerially() может быть вызван из любого потока, он не является блокирующим. Метод r.run() должен завершить свою работу быстро, чтобы не блокировать очередь событий. Если необходимо, длительную обработку следует вынести в отдельный поток. Метод callSerially() может быть использован, например, для организации анимации, синхронизированной со скоростью прорисовки кадров.

86 86 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. javax.microedition.lcdui.Display public Displayable getCurrent () Возвращает текущий объект Displayable для мидлета. Возвращаемый объект Displayable может не отображаться на экране, если, например, приложение является фоновым. Для определения этого используется метод isShown() объекта Displayable. Значение, возвращаемое getCurrent(), может быть null - до первого вызова setCurrent().

87 87 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. javax.microedition.lcdui.Display public static Display getDisplay (javax.microedition.midlet m) Возвращает объект Display для заданного мидлета. public boolean isColor () Возвращает true, если экран устройства поддерживает цвет, иначе false. public int numColors () Возвращает число цветов или оттенков серого, отображаемых устройством. Для черно-белых экранов возвращается 2.

88 88 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. javax.microedition.lcdui.Display public void setCurrent (Alert alert, Displayable nextDisplayable) Устанавливает в качесте текущего экрана объект класса Alert и задает экран, который станет текущим после закрытия сообщения - nextDisplayable. Объект nextDisplayable не должен быть класса Alert, и должен быть не null. Метод неблокирующий, независимо от времени отображения сообщения Alert.

89 89 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. javax.microedition.lcdui.Display public void setCurrent (Displayable nextDisplayable) Запрашивает изменение текущего экрана. Операция может быть отложена, пока обрабатываются события из очереди, что влияет на результат setCurrent(). Метод неблокирующий. Метод setCurrent() всегда следует вызывать в процессе инициализации мидлета. Параметр null не меняет текущего экрана, но может быть трактовано ПО управления приложениями как запрос на переход в фоновый режим.

90 90 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. javax.microedition.lcdui.Display Если объект Displayable, установленный как текущий, принадлежит классу Alert, по закрытии сообщения будет осуществлен возврат к предыдущему активному Displayable. Если текущий Displayable тоже принадлежит классу Alert, произойдет исключение. Чтобы избежать такой ситуации, используйте специальную форму этого метода.

91 91 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. javax.microedition.lcdui.Display Если происходит переключение на не-Alert экран в момент, когда отображается Alert, последний будет сброшен. Если в момент вызова этого метода отображается системное сообщение, операция смены экрана может быть приостановлена до закрытия этого сообщения.

92 92 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. javax.microedition.lcdui.Displayable Абстрактный класс, представляющий объекты, отображаемые на экране устройства. Объект Displayable может иметь связанные с ним активные команды и приемник команд. Отображаемое содержимое и его взаимодействие с пользователем определяется в подклассах.

93 93 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. javax.microedition.lcdui.Displayable public void addCommand (Command cmd) Добавляет абстрактную команду объекту Displayable. В зависимости от реализации, команды могут привязываться к кнопкам устройства, помещаться в меню и т.д. public void removeCommand (Command cmd) Удаляет абстрактную команду.

94 94 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. javax.microedition.lcdui.Displayable public boolean isShown () Проверяет объект Displayable на видимость для пользователя. Для отображения объекта Displayable должны быть выполнены следующие условия: – мидлет не должен быть в фоновом режиме; – объект Displayable должен быть текущим; – на экране нет системных сообщений. public void setCommandListener (CommandListener l) Установить приемник команд для объекта Displayable. Если параметр равен null, существующий приемник будет отключен.

95 95 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. javax.microedition.lcdui.Screen Абстрактный суперкласс всех экранов, реализующих высокоуровневый интерфейс пользователя. Обладает необязательными заголовком и бегущей строкой. Содержимое экрана определяется в подклассах. При изменении этого содержимого обновление и перерисовка экрана производится автоматически. Однако, изменение экрана при его отображении не рекомендуется из соображений производительности на некоторых устройствах и эргономичности пользовательского интерфейса.

96 96 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. javax.microedition.lcdui.Screen public void setTitle (java.lang.String s) Устанавливает заголовок экрана. Если параметр null, удалает заголовок. public java.lang.String getTitle () Возвращает текущий заголовок экрана или null.

97 97 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. javax.microedition.lcdui.Screen public void setTicker (Ticker ticker) Устанавливает бегущую строку, заменяя текущую. Если параметр null, удалает текущую бегущую строку. Один объект Ticker может совместно использоваться несколькими экранами. Переключение экранов с одним объектом Ticker сохраняет текущую позицию прокрутки. public Ticker getTicker () Возвращает бегущую строку для данного экрана (или null, если она не задана).

98 98 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. javax.microedition.lcdui.Ticker Реализует бегущую строку (ticker-tape). Направление и скорость прокрутки определяется реализацией. public Ticker (java.lang.String str) Конструктор, задается начальное содержимое бегущей строки. public void setString (java.lang.String str) Изменить текст бегущей строки. Изменение отображаемого текста происходит немедленно после вызова этого метода. public java.lang.String getString () Получить текущий текст бегущей строки.

99 99 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. javax.microedition.lcdui.Alert Класс Alert представляет информационное сообщение, содержащее текст и изображение. Данные отображаются на заданный период времени, после чего происходит переход на следующий экран. Обычное использование этого класса - информирование пользователя об ошибках и других исключительных ситуациях, краткие информационные сообщения о результатах операций.

100 100 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. javax.microedition.lcdui.Alert Время отображения сообщения может быть задано бесконечно большим, в этом случае сообщение считается модальным и пользователю предоставляется возможность «закрыть» его, после чего отображается следующий экран. Если сообщение содержит большое количество информации и требует прокрутки, оно становится модальным автоматически.

101 101 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. javax.microedition.lcdui.Alert С объектом Alert может быть связан определенный объект AlertType, который определяет тип сообщения. В зависимсти от реализации, тип сообщения может использоваться для воспроизведения определенного звука. К объекту Alert не могут быть привязаны абстрктные команды. Обновление содержимого объекта Alert отображается автоматически.

102 102 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. javax.microedition.lcdui.Alert public static final int FOREVER Константа, определяющая неограниченный период времени. Используется как параметр при вызове метода setTimeout(). public Alert (java.lang.String title) Создает новый пустой объект Alert с заданным заголовком.

103 103 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. javax.microedition.lcdui.Alert public Alert (String title, String alertText, Image alertImage, AlertType alertType) Создает новый объект Alert с заданным заголовком, текстом и изображением. Определяет тип сообщения. Таймаут устанавливается в значение, возвращаемое getDefaultTimeout(). Если изображение задано, оно должно быть неизменяемым. Типы сообщений рассматриваются в описании класса AlertType. Значение null задает обычное сообщение.

104 104 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. javax.microedition.lcdui.Alert public int getDefaultTimeout () Значение таймаута по умолчанию в миллисекундах или FOREVER. Существенно зависит от реализации.

105 105 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. javax.microedition.lcdui.Alert public Image getImage () public java.lang.String getString () public int getTimeout () public AlertType getType () public void setImage (Image img) public void setString (java.lang.String str) public void setTimeout (int time) public void setType (AlertType type) Методы читают и устанавливают свойства сообщения.

106 106 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. javax.microedition.lcdui.Alert public void addCommand (Command cmd) Метод всегда выбрасывает исключение IllegalStateException, т.к. команды в сообщениях не поддерживаются. public void setCommandListener (CommandListener l) Метод всегда возбуждает исключение IllegalStateException.

107 107 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. javax.microedition.lcdui.AlertType Класс AlertType представляет тип сообщения Alert. Кроме того, AlertType может использоваться для сигнализирования пользователю без изменения содержимого экрана. Константы класса задают несколько предопределенных типов сообщений: INFO, WARNING, ERROR, ALARM, CONFIRMATION.

108 108 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. javax.microedition.lcdui.AlertType public static final AlertType ALARM События, привязанные к определенным моментам. public static final AlertType CONFIRMATION Подтверждение действий пользователя. Индицирует успешное выполнение операции. public static final AlertType ERROR Сообщения об ошибках. public static final AlertType INFO Отображение общеинформационных сообщений. public static final AlertType WARNING Предупреждения об опасных действиях.

109 109 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. javax.microedition.lcdui.AlertType protected AlertType () Конструктор для классов-потомков. public boolean playSound (Display display) Воспроизвести звук, соответствующий данному типу сообщения. Конкретные звуки определяются реализацией устройства и могут отстутствовать. Возвращает true, если звук был воспроизведен, иначе false.

110 110 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. javax.microedition.lcdui.List Класс List это экран (Screen), содержащий список вариантов для выбора пользователем. В основном поведение и методы определяются реализуемым интерфейсом Choice и наследуются от класса Screen. Перемещение по элементам списка и его прокрутка не отображаются в события приложения. Система оповещает о выборе некоторой команды через вызов метода commandAction().

111 111 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. javax.microedition.lcdui.List В соответствии с функциональностью существуют три типа объектов List: – IMPLICIT - выбор пользователя вызывает немедленное оповещение приложения через зарегистрированный приемник CommandListener с параметром SELECT_COMMAND. Устанавливает элемент как помеченный. – EXCLUSIVE - изменяет (устанавливает) статус выбранного элемента без оповещения приложения. – MULTIPLE - изменяет (инвертирует) статус выбранного элемента без оповещения приложения. Режим IMPLICIT может быть использован для организации меню.

112 112 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. javax.microedition.lcdui.List Приложение может установить выбранный элемент(ы) перед отображением списка. public static final Command SELECT_COMMAND Константа SELECT_COMMAND определяет команду, используемую для оповещения приложения о выборе при использовании режима IMPLICIT. При распознавании команды следует отслеживать совпадение объектов Command и Displayable (List).

113 113 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. javax.microedition.lcdui.List public List (java.lang.String title, int listType) Создает новый пустой объект List, определяет его заголовок и тип (IMPLICIT, EXCLUSIVE, MULTIPLE). public List (java.lang.String title, int listType, java.lang.String[] stringElements, Image[] imageElements) Создает новый объект List, определяет его заголовок, тип и массивы строк и изображений для начального содержимого.

114 114 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. javax.microedition.lcdui.List Параметр stringElements должен быть не null и каждый его элемент должен быть не null. Длина этого массива определяет число элементов в списке. Параметр imageElements может быть null, иначе он должен иметь тот же размер, что и массив stringElements. Отдельные элементы массива imageElements могут быть null, т.е. соответствующему элементу списка не будет привязано изображение. Все изображения в массиве должны быть неизменяемыми.

115 115 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. javax.microedition.lcdui.TextBox Класс TextBox представляет экран, который позволяет пользователю вводить и редактировать текст. Емкость объекта TextBox, т.е. максимальное количесто символов хранимых в объекте (а не отображаемых на экране), ограничена и играет роль при создании объекта, работе пользователя и изменнеии содержимого объекта из программы. Это значение устанавливается реализацией и может быть получено через метод getMaxSize().

116 116 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. javax.microedition.lcdui.TextBox В случае необходимости, реализация обеспечивает прокрутку текста на экране. Это происходит прозрачно для приложения. Класс TextBox поддерживает концепцию ограничителей ввода по аналогии с элементом TextField и используя константы этого класса.

117 117 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. javax.microedition.lcdui.TextBox public TextBox (String title, String text, int maxSize, int constraints) Создает новый объект TextBox с заданным заголовком, начальным содержимым, максимальным размером (в символах) и ограничителем. Если параметр text имеет значение null, TextBox создается пустым. Параметр maxSize должен быть больше 0. public void delete (int offset, int length) Удаляет length символов с позиции offset.

118 118 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. javax.microedition.lcdui.TextBox public int getCaretPosition () Текущая позиция курсора (0 - начало текста). На некоторых реализациях метод может быть блокирующим до указания пользователем позиции в тексте. public int getChars (char[] data) Копирует содержимое TextBox в массив символов. Возвращает число скопированных символов. public int getConstraints () Возвращает текущий ограничитель.

119 119 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. javax.microedition.lcdui.TextBox public int getMaxSize () Возвращает максимальную емкость объекта TextBox. public java.lang.String getString () Возвращает содержимое объекта в виде строки. public void insert (char[] data, int offset, int length, int position) public void insert (java.lang.String src, int position) Вставляет поддиапазон массива символов или строку в заданную позицию текста. Текст вставляется непосредственно перед заданным символом (0 - в начало текста).

120 120 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. javax.microedition.lcdui.TextBox public void setChars (char[] data, int offset, int length) Изменяет содержимое TextBox на данные из подмассива символов. Если параметр data имеет значение null, TextBox будет очищен. public void setConstraints (int constraints) Устанавливает ограничитель. Если текущее содержимое не удовлетворяет новому ограничителю, TextBox будет очищен. public int setMaxSize (int maxSize) Устанавливает максимальное число символов, сокращает текст при необходимости. Возвращает установленную максимальную емкость.

121 121 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. javax.microedition.lcdui.TextBox public void setString (java.lang.String text) Устанавливает содержимое TextBox, замеща предыдущее. public int size () Возвращает текущее число символов в TextBox.

122 122 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. javax.microedition.lcdui.Form Класс Form представляет экран, который содержит произвольный набор элементов, унаследованных от класса Item: изображения, текст, поля ввода, индикаторы и группы выбора. Отображение, навигация по элементам и прокрутка обеспечиваются реализацией. Элементы, не помещающиеся в рамки экрана будут пернесены (для текста) или обрезаны (для изображений).

123 123 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. javax.microedition.lcdui.Form Набор элементов формы может быть изменен путем добавления, удаления и изменения элементов. Изменение состава формы отображается немедленно и автоматически. Элементы формы индексированы целыми числами от 0 до size()-1. Каждый элемент может принадлежать только одной форме. При попытке разместить его на новой форме без удаления со старой, будет выброшено исключение IllegalStateException.

124 124 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. javax.microedition.lcdui.Form Система оповещает приложение о взаимодействии с элементами формы вызовом метода itemStateChanged() приемника, зарегистрированного для формы методом setItemStateListener(). Как и все объекты Displayable, форма может определить команды и приемник команд. Приемник команд и приемник событий элементов - разные объекты, они определяются и регистрируются отдельно.

125 125 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. javax.microedition.lcdui.Form public Form (java.lang.String title) public Form (java.lang.String title, Item[] items) Конструкторы создают новую форму, определяя ее заголовок и, возможно, содержимое. public int append (Image img) public int append (java.lang.String str) public int append (Item item) public void insert (int itemNum, Item item) Добавляет новый элемент на форму.

126 126 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. javax.microedition.lcdui.Form public void delete (int itemNum) Удаляет элемент формы. public Item get (int itemNum) Получить элемент формы. Содержимое формы не изменяется. public void set (int itemNum, Item item) Изменить элемент формы.

127 127 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. javax.microedition.lcdui.Form public void setItemStateListener (ItemStateListener iListener) Установить приемник сообщений от элементов, заменить старый или отключить старый приемник (параметр равен null). public int size () Возвращает число элементов формы.

128 128 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. Классы элементов интерфейса

129 129 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. javax.microedition.lcdui.Choice Интерфейс Choice определяет API для элементов интерфейса пользователя, обеспечивающих выбор из нескольких предложенных вариантов. К таким элементам относятся объекты List и ChoiceGroup. Каждый элемент объекта Choice представлен строкой и необязательным изображением. Изображение может быть проигнорировано, если устройство не обладает графическими возможностями.

130 130 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. javax.microedition.lcdui.Choice После создания объекта Choice, его элементы можно читать, менять, вставлять, добавлять, удалять. Элементы индексированы целыми числами от 0 до size()-1. Существует три типа объектов Choices: – неявные (implicit, действительно только для класса List), – исключающие (exclusive), – множественные (multiple).

131 131 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. javax.microedition.lcdui.Choice Для исключающих объектов, в каждый момент времени может быть выбран строго один элемент. Какой именно элемент помечается выбранным в начале работы или при удалении текущего выбранного, зависит от реализации. Неявный выбор - то же, что исключающий, но элемент неявно выбирается при вызове команды. Множественный выбор позволяет пользователю отметить произвольное число элементов в любом сочетании.

132 132 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. javax.microedition.lcdui.Choice Состояние элемента является свойством элемента и не изменяется при добавлении или удалении элементов, изменении их содержимого.Новые добавляемые элементы считаются невыбранными (кроме некоторых ситуаций для исключающего выбора).

133 133 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. javax.microedition.lcdui.Choice public static final int EXCLUSIVE public static final int IMPLICIT public static final int MULTIPLE Константы режимов работы. public int append (java.lang.String stringPart, Image imagePart) public void insert (int elementNum, String stringPart, Image imagePart) Добавляет новый элемент в конец или заданную позицию списка.

134 134 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. javax.microedition.lcdui.Choice public void set (int elementNum, java.lang.String stringPart, Image imagePart) Изменяет заданный элемент. public void delete (int elementNum) Удаляет элемент. public java.lang.String getString (int elementNum) public Image getImage (int elementNum) Получение описания элемента.

135 135 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. javax.microedition.lcdui.Choice public int getSelectedFlags (boolean[] selectedArray_return) public void setSelectedFlags (boolean[] selectedArray) Получить/установить массив флагов для элементов. Размер массива должен быть не менее числа элементов списка, лишние значения в массиве устанавливаются в false. В режиме MULTIPLE в true может быть установлено произвольное число элементов массива, в режимах EXCLUSIVE и IMPLICIT - строго один.

136 136 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. javax.microedition.lcdui.Choice public int getSelectedIndex () Получить индекс выбранного элемента или -1. В режиме MULTIPLE всегда возвращает -1. public boolean isSelected (int elementNum) public void setSelectedIndex (int elementNum, boolean selected) Проверить/установить флаг выделения заданного элемента. В режимах EXCLUSIVE и IMPLICIT позволяет только устанавливать выделение (не сбрасывать). Неявного вызова команды не производится.

137 137 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. javax.microedition.lcdui.Choice public int size () Получить количество элементов.

138 138 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. javax.microedition.lcdui.Item Абстрактный суперкласс для элементов пользовательского интерфейса, которые могут быть добавлены на форму Form или Alert. Все элементы Item имеют поле метки, т.е. строки, привязанной к элементу. Метка, как правило, отображается возле соответствующего элемента. Рекомендуется казывать метку для всех элементов, т.к. она используется как заголовок дополнительного экрана для некоторых реализаций элементов.

139 139 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. javax.microedition.lcdui.Item public java.lang.String getLabel () public void setLabel (java.lang.String label) Прочитать/установить метку элемента.

140 140 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. javax.microedition.lcdui.ChoiceGroup Класс ChoiceGroup задает группу элементов для выбора, которая может быть размещена на форме. Отображение зависит от реализации и от режима (см. интерфейс Choice). public ChoiceGroup (java.lang.String label, int choiceType) public ChoiceGroup (String label, int choiceType, String[] stringElements, Image[] imageElements) Создает новый объект. Режим IMPLICIT не поддерживается классом ChoiceGroup. Другие методы реализуют интерфейс Choice.

141 141 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. javax.microedition.lcdui.DateField Класс DateField определяет элемент интерфейса пользователя для ввода даты/времени. Для элемента может быть задан режим ввода, определяющий ввод даты, времени, или даты/времени. При вводе только времени, дата будет предполагаться равной 1 января 1970 года. public static final int DATE public static final int DATE_TIME public static final int TIME Константы, определяющие режим ввода.

142 142 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. javax.microedition.lcdui.DateField public DateField (java.lang.String label, int mode) public DateField (java.lang.String label, int mode, java.util.TimeZone timeZone) Создает новый объект, определяет текстовую метку, режим ввода, и, возможно, временную зону. Исходное значение даты/времени «неопределенное», при запросе будет возвращен null.

143 143 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. javax.microedition.lcdui.DateField public java.util.Date getDate () public void setDate (java.util.Date date) Прочитать/установить значение даты/времени для элемента. public int getInputMode () public void setInputMode (int mode) Прочитать/установить режим ввода.

144 144 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. javax.microedition.lcdui.Gauge Класс Gauge реализует прямоугольный индикатор заданного занчения. Опционально элемент интерактивен, т.е. позволяет пользователю изменять отображаемое значение. Значение имеет тип small в диапазоне от 0 до заданного максимального значения. При отображении может использоваться меньшее число элементов в диапазоне, что не влияет на значение в свойстве индикатора.

145 145 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. javax.microedition.lcdui.Gauge Приложение может использовать индикатор для отображения состояния операций и помощью метода setValue(). При этом желательно задать для формы команду STOP, обработчик которой остановит процесс. public Gauge (String label, boolean interactive, int maxValue, int initialValue) Создает новый объект Gauge с заданной меткой, интерактивным или неинтерактивным режимом, максимальным допустимым и начальным значениями.

146 146 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. javax.microedition.lcdui.Gauge public int getMaxValue () public int getValue () public boolean isInteractive () public void setMaxValue (int maxValue) public void setValue (int value) Читать/установить параметры индикатора.

147 147 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. javax.microedition.lcdui.StringItem Элемент для отображения строки. Метка и содержимое элемента могут изменяться программой, но не пользователем. public StringItem (java.lang.String label, java.lang.String text) Конструктор. public java.lang.String getText () public void setText (java.lang.String text) Читает/устанавливает отображаемое строковое значение.

148 148 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. javax.microedition.lcdui.TextField Поле для ввода и редактирования текста. По функциям и предоставляемым методам соответствует классу TextBox. Определяет константы ограничителей ввода: public static final int ANY Любой текст. public static final int CONSTRAINT_MASK Маска ограничителя. С помощью поразрядного AND позволяет извлечь значение ограничителя, отбросив флаги модификаторов (например, PASSWORD).

149 149 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. javax.microedition.lcdui.TextField public static final int ADDR Адреса электронной почты. public static final int NUMERIC Целочисленное значение. public static final int PASSWORD Делает вводимый текст невидимым, заменяя его символами "*" или другими. Может комбинироваться с другими ограничителями с помощью поразрядного OR, но поддерживается не для всех.

150 150 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. javax.microedition.lcdui.TextField public static final int PHONENUMBER Номер телефона. public static final int URL Сетевой адрес в форме URL.

151 151 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. javax.microedition.lcdui.TextField public TextField (String label, String text, int maxSize, int constraints) Создает новый объект с заданной меткой, содержимым, максимальным размером и ограничителем.

152 152 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. javax.microedition.lcdui.ImageItem Класс обеспечивает элемент-контейнер для размещения на форме изображения (Image). Изображение должно быть неизменяемое. Если в качестве изображения-содержимого задано значение null, элемент не отображается. Каждый элемент имеет свойство расположения, составляемое из констант выравнивания по горизонтали и начала строки перед/после элемента. В зависимости от свойств конкретного устройства и размеров изображения, это указание может игнорироваться.

153 153 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. javax.microedition.lcdui.ImageItem Параметр altText определяет строку, отображаемую вместо изображения на устройствах без поддержки графики. Может иметь значение null. public static final int LAYOUT_DEFAULT public static final int LAYOUT_CENTER public static final int LAYOUT_LEFT public static final int LAYOUT_RIGHT public static final int LAYOUT_NEWLINE_AFTER public static final int LAYOUT_NEWLINE_BEFORE Константы размещения элемента.

154 154 (с) ИТЛаб, ННГУ, ВМК, 2003г Java 2 Micro Edition Жерздев С.В. javax.microedition.lcdui.ImageItem public ImageItem (String label, Image img, int layout, String altText) Создает новый элемент ImageItem. public java.lang.String getAltText () public Image getImage () public int getLayout () public void setAltText (java.lang.String text) public void setImage (Image img) public void setLayout (int layout) Методы читают/устанавливают параметры элемента.