Пользовательские компоненты Visual Mobile Designer: создание обозревателя файлов мобильных устройств
Visual Mobile Designer (VMD) - это графический интерфейс NetBeans Mobility, позволяющий разрабатывать мобильные приложения с использованием перетаскивания компонентов. VMD позволяет определять поток операций в приложении и разрабатывать собственный графический интерфейс с использованием компонентов, предусмотренных в среде IDE или спроектированных самостоятельно. VMD содержит большое количество стандартных компонентов пользовательского интерфейса (UI), которые можно использовать для создания таких приложений, как списки, предупреждения, формы и изображения. В него также включены пользовательские компоненты, упрощающие создание более сложных функций, например экранов ожидания, заставок, элементов таблицы и т.д.
Обозреватель файлов — это пользовательский компонент, предоставляющий пользовательский интерфейс для работы с файловой системой устройства. Он предоставляет базовые функциональные возможности для просмотра содержимого в памяти устройств. В этом компоненте используется интерфейс API FileConnection, являющийся частью спецификации JSR-75 для дополнительных пакетов PDA для платформы Java ME. JSR-75 не входит в спецификацию MIDP 2.0, поэтому данный пользовательский компонент может использоваться только для устройств с поддержкой JSR-75.
В данном учебном курсе описано использование обозревателя файлов в мобильном приложении для устройств с поддержкой JSR-75. В нем рассматриваются основные функции компонентов, возможности просмотра содержимого памяти устройства и отображения содержимого выбранных текстовых файлов. Помимо пользовательского компонента "Обозреватель файлов", в данном руководстве описано использование двух других компонентов MIDP: заставки и текстового поля.
Примечание. В случае использования среды IDE NetBeans 6.8 обратитесь к учебному курсу Создание обозревателя файлов мобильных устройств в среде IDE NetBeans 6.8.
Содержание
Для работы с этим учебным курсом требуются программное обеспечение и ресурсы, перечисленные ниже.
Установка и выполнение примера приложения
Перед началом изучения учебного курса можно ознакомиться с итоговым результатом.
Для установки приложения FileBrowserExample выполните следующие действия:
- Загрузите файл filebrowserexample.zip.
- Распакуйте файл.
- Выберите в среде IDE в меню Файл команду Открыть проект и перейдите к папке, содержащей распакованные файлы с проектом FileBrowserExample.
- Нажмите кнопку "Open Project".
Диалоговое окно "Проекты" должно выглядеть следующим образом:
- Щелкните в диалоговом окне "Проекты" узел проекта правой кнопкой мыши и выберите команду Выполнить проект (или нажмите клавишу F6). После запуска приложения откроется окно эмулятора, отображающее это приложение, которое выполняется в эмуляторе устройства по умолчанию.
- В окне эмулятора нажмите кнопку под элементом Launch.
В сером эмуляторе отображается заставка, а затем обозреватель проектов, как показано на рисунке:
- Переход между доступными файлами и папками происходит при перемещении курсора вверх и вниз.
- Для открытия папки или файла нажмите кнопку "Выбрать", расположенную внизу.
- Для закрытия приложения нажмите кнопку под элементом Exit.
В начало
Создание приложения с пользовательским компонентом "Обозреватель файлов"
После ознакомления с компонентом "Обозреватель файлов" вернемся к началу и создадим приложение самостоятельно. Для создания приложения выполните следующие действия:
- Создание проекта FileBrowserExample
- Добавление пакетов и визуального мидлета к проекту FileBrowserExample
- Добавление компонентов в FileBrowserExample
- Добавление команд в текстовое поле и обозреватель файлов
- Соедините компоненты для создания потока операций в приложении.
- Вставка метода loadTextFile в исходный код
- Запустите проект.
Создание проекта FileBrowserExample
- Выберите в меню Файл команду Создать проект (CTRL+SHIFT+N). В разделе "Категории" выберите "JavaME". В разделе "Проекты" выберите "Приложение Mobile" и нажмите кнопку "Далее".
- Введите в поле "Имя проекта" имя
FileBrowserExample. В поле "Project Location" укажите локальный каталог. Далее в тексте этот каталог будет называться $PROJECTHOME.
- Снимите флажок с параметра "Создать мидлет Hello". Нажмите кнопку "Далее".
- Оставьте "Sun Java Wireless Toolkit " в качестве выбранной платформы эмулятора. Нажмите кнопку "Далее".
- Нажмите кнопку "Готово".
Примечание. Папка проекта содержит все исходные файлы и метаданные проекта, например сценарий Ant для проекта. Само приложение отображается в диалоговом окне "Flow Design" в Visual Mobile Designer.
Добавление пакетов и визуального мидлета к проекту FileBrowserExample
- Выберите в диалоговом окне "Проект" проект
FileBrowserExample, а затем выберите в меню Файл команду Создать файл (СTRL+N). Выберите в разделе "Категории" элемент "Классы Java". Выберите в разделе "Типы файлов" элемент "Пакеты Java". Нажмите кнопку "Далее".
- В поле "Имя пакета" введите
filebrowserexample. Нажмите кнопку "Готово".
- Выберите в диалоговом окне "Проект" проект
filebrowserexample, а затем выберите в меню Файл команду Создать файл (СTRL+N). Выберите в разделе "Категории" элемент "MIDP". Выберите в разделе "Типы файлов" элемент "Визуальный мидлет". Нажмите кнопку "Далее".
- В полях "Имя мидлета" и "Имя класса MIDP" введите значение
FileBrowserExample. Нажмите кнопку "Готово".
Добавление компонентов в FileBrowserExample
- Переключите визуальный мидлет на диалоговое окно Flow Designer. Перетащите следующие компоненты из палитры компонентов в Flow Designer:
- заставка;
- текстовое поле;
- обозреватель файлов.
- Щелкните компонент заставки и измените в диалоговом окне "Свойства" значение свойства текст с null на FileBrowserExample.
Добавление команд в FileBrowserExample
- Откройте диалоговое окно Flow Designer.
- Выберите команду Exit в разделе "Команды" на палитре компонентов. Перетащите ее в окно Flow Designer (компонент "Обозреватель файлов").
- В разделе "Команды" палитры компонентов выберите команду Back и перетащите ее в текстовое поле.
Подключение компонентов для создания потока операций в приложении
Выберите в диалоговом окне Flow Designer начальную точку для мобильного устройства и перетащите ее в компонент заставки. Аналогичным образом соедините другие компоненты, как показано на следующем рисунке.
Вставка действия по предварительной обработке в исходный код
- Перейдите в диалоговое окно "Исходный код".
-
Вставьте в конце исходного кода следующий код. Этот метод обеспечивает чтение выбранных файлов:
/**
* Чтение файла
*/
private void readFile() {
try {
FileConnection textFile = fileBrowser.getSelectedFile();
getTextBox().setString("");
InputStream fis = textFile.openInputStream();
byte[] b = new byte[1024];
int length = fis.read(b, 0, 1024);
fis.close();
if (length > 0) {
textBox.setString(new String(b, 0, length));
}
} catch (IOException ex) {
ex.printStackTrace();
}
}
Найдите в исходном коде метод commandAction:
Вставьте readFile(); в раздел предварительного действия FileBrowser.SELECT_FILE_COMMAND (сразу после кода if (command == FileBrowser.SELECT_FILE_COMMAND) вместо комментария //write pre-action code here):
Выполнение проекта
Нажмите клавишу <F6> для выполнения главного проекта или выберите команды Выполнить > Выполнить главный проект.
В начало
Документация Javadoc для компонента "Обозреватель файлов"
В среде IDE NetBeans содержится документация Javadoc для компонента "Обозреватель файлов", а также для других компонентов, которые можно использовать в VMD. Для чтения документации Javadoc для обозревателя файлов выполните следующие шаги:
- Установите курсор на компоненте обозревателя файлов в исходном коде и нажмите сочетание клавиш CTRL+SHIFT+SPACE (или выберите команды Источник > Просмотреть документацию).
Во всплывающем окне появится документация Javadoc по этому элементу.
- Для просмотра подробной информации о компоненте обозревателя файлов в веб-обозревателе щелкните во всплывающем окне значок "Показать документацию во внешнем веб-обозревателе" (
).
В начало
Дополнительные сведения
В начало
